Use BIDS schema in CuBIDS

cubids/cli.py

@@ -121,6 +121,7 @@ def _parse_validate():
         allow_abbrev=False,
     )
     PathExists = partial(_path_exists, parser=parser)
+    IsFile = partial(_is_file, parser=parser)
 
     parser.add_argument(
         "bids_dir",
@@ -177,6 +178,17 @@ def _parse_validate():
         help="Lets user run a locally installed BIDS validator. Default is set to False ",
         required=False,
     )
+    parser.add_argument(
+        "--schema",
+        type=IsFile,
+        action="store",
+        default=None,
+        help=(
+            "Path to a BIDS schema JSON file. "
+            "Default is None, which uses the latest schema available to the validator."
+        ),
+        required=False,
+    )
     return parser
 
 
@@ -243,6 +255,7 @@ def _parse_bids_version():
         allow_abbrev=False,
     )
     PathExists = partial(_path_exists, parser=parser)
+    IsFile = partial(_is_file, parser=parser)
 
     parser.add_argument(
         "bids_dir",
@@ -263,6 +276,17 @@ def _parse_bids_version():
             "By default, `cubids bids-version /bids/path` prints to the terminal."
         ),
     )
+    parser.add_argument(
+        "--schema",
+        type=IsFile,
+        action="store",
+        default=None,
+        help=(
+            "Path to a BIDS schema JSON file. "
+            "Default is None, which uses the latest schema available to the validator."
+        ),
+        required=False,
+    )
     return parser
 
 
@@ -412,6 +436,7 @@ def _parse_group():
         allow_abbrev=False,
     )
     PathExists = partial(_path_exists, parser=parser)
+    IsFile = partial(_is_file, parser=parser)
 
     parser.add_argument(
         "bids_dir",
@@ -446,13 +471,24 @@ def _parse_group():
     parser.add_argument(
         "--config",
         action="store",
-        type=PathExists,
+        type=IsFile,
         default=None,
         help=(
             "Path to a config file for grouping. "
             "If not provided, then the default config file from CuBIDS will be used."
         ),
     )
+    parser.add_argument(
+        "--schema",
+        type=IsFile,
+        action="store",
+        default=None,
+        help=(
+            "Path to a BIDS schema JSON file. "
+            "Default is None, which uses the latest schema available to the validator."
+        ),
+        required=False,
+    )
     return parser
 
 
@@ -601,6 +637,17 @@ def _parse_apply():
             "If not provided, then the default config file from CuBIDS will be used."
         ),
     )
+    parser.add_argument(
+        "--schema",
+        type=IsFile,
+        action="store",
+        default=None,
+        help=(
+            "Path to a BIDS schema JSON file. "
+            "Default is None, which uses the latest schema available to the validator."
+        ),
+        required=False,
+    )
 
     return parser
 

cubids/config.py

@@ -26,3 +26,32 @@ def load_config(config_file):
         config = yaml.safe_load(f)
 
     return config
+
+
+def load_schema(schema_file):
+    """Load a JSON file containing the BIDS schema.
+
+    Parameters
+    ----------
+    schema_file : str or pathlib.Path, optional
+        The path to the schema file. If None, the default schema file is used.
+
+    Returns
+    -------
+    dict
+        The schema loaded from the YAML file.
+    """
+    import json
+
+    if schema_file is None:
+        schema_file = Path(importlib.resources.files("cubids") / "data/schema.json")
+
+    with schema_file.open() as f:
+        schema = json.load(f)
+
+    print(
+        f"Loading BIDS schema version: {schema['schema_version']}. "
+        f"BIDS version: {schema['bids_version']}"
+    )
+
+    return schema