bidsval 0.0.1__tar.gz

bidsval-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bidsval contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bidsval-0.0.1/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: bidsval
+Version: 0.0.1
+Summary: A schema-driven, pydantic-typed, in-process BIDS validator.
+Author: bidsval contributors
+License: MIT
+Project-URL: Homepage, https://github.com/karellopez/bidsval
+Project-URL: Repository, https://github.com/karellopez/bidsval
+Project-URL: Issues, https://github.com/karellopez/bidsval/issues
+Keywords: BIDS,validation,neuroimaging,schema,pydantic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bidsschematools<=1.2.2,>=1.0
+Requires-Dist: pydantic<=2.13.4,>=2
+Requires-Dist: nibabel<=5.4.2,>=5.0
+Requires-Dist: pandas<3.0,>=2.0
+Requires-Dist: mne<=1.12.1,>=1.6
+Requires-Dist: pyyaml<=6.0.3,>=5.4
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Dynamic: license-file
+
+# bidsval
+
+Validate [BIDS](https://bids.neuroimaging.io) datasets in pure Python.
+
+`bidsval` reads the official BIDS schema and checks datasets against the rules it
+contains. It runs in-process with no external runtime, returns typed (pydantic)
+results, and validates a whole dataset, a single subject, a single file, or a
+single expression. Every published BIDS schema version ships inside the package,
+so it works offline and you choose the version with one argument.
+
+Because the schema drives everything, `bidsval` covers all of BIDS - anatomical,
+functional, diffusion, fieldmaps, perfusion, EEG, MEG, iEEG, behavioural, PET,
+microscopy, motion, NIRS, MRS - not a fixed set of modalities. Point it at a
+newer schema and the newer rules apply with no code change.
+
+> Working and tested against real MRI, EEG, MEG, and PET datasets and the
+> official `bids-examples` corpus, with zero false positives versus the reference
+> validator. It checks file structure, sidecar fields (presence and value type),
+> associated files (events, bval/bvec, channels, ASL, ...), and tabular columns.
+> Full coverage parity with the reference is still in progress; see "Roadmap".
+
+## Install
+
+```shell
+pip install -e .                 # bidsval and all required readers (nibabel, pandas, mne)
+pip install -e ".[dev]"          # also the test and lint tooling
+```
+
+## Validate a dataset
+
+From Python:
+
+```python
+import bidsval
+
+report = bidsval.validate("/path/to/dataset")
+report.is_valid            # False if there are any errors
+report.counts              # {'error': 3, 'warning': 27, 'ignore': 0}
+for verdict in report.files:
+    for issue in verdict.issues:
+        print(issue.severity.value, issue.code, verdict.path, issue.message)
+
+# Narrower granularity:
+bidsval.validate_subject("/path/to/dataset", "sub-01")
+bidsval.validate_file("/path/to/dataset", "sub-01/anat/sub-01_T1w.nii.gz")
+```
+
+From the command line:
+
+```shell
+# Text summary to the terminal (exits non-zero on errors, so it drops into CI):
+bidsval validate /path/to/dataset
+
+# Validate one subject; also check NIfTI headers:
+bidsval validate /path/to/dataset --subject sub-01 --headers
+
+# Pick the output type (independent of where it goes):
+bidsval validate /path/to/dataset --output-type json     # JSON to stdout
+bidsval validate /path/to/dataset --output-type sarif    # SARIF to stdout (CI / IDE code scanning)
+
+# Write report files: --out-dir holds report.<ext> for each selected type:
+bidsval validate /path/to/dataset --output-type html --out-dir reports/   # reports/report.html
+bidsval validate /path/to/dataset --output-type all  --out-dir reports/   # report.txt/.json/.sarif/.html
+
+# Show only the severities you care about (does not change pass/fail):
+bidsval validate /path/to/dataset --show error           # errors only
+```
+
+Flags: `--schema <version|url|path>`, `--subject sub-01`, `--headers`
+(also check NIfTI headers, needs nibabel), `--output-type text|json|sarif|html|all`
+(default `text`; one type prints to stdout, several need `--out-dir`),
+`--out-dir DIR` (write `report.<ext>` per type), `--show error,warning,ignore,all`
+(filter displayed findings; default `error,warning`).
+
+## Choose a schema version
+
+Every published BIDS schema is bundled, and any other version or a URL is fetched
+and cached. One argument selects the schema; everything downstream is unchanged:
+
+```python
+bidsval.validate("/data", schema="1.10.0")               # a bundled version
+bidsval.validate("/data", schema="latest")               # the development tip (fetched)
+bidsval.validate("/data", schema="https://.../schema.json")  # any URL (fetched + cached)
+bidsval.validate("/data", schema="/path/to/schema.json") # a local dereferenced schema.json
+bidsval.validate("/data", schema="/path/to/src/schema")  # a YAML schema source directory
+bidsval.available_versions()                             # bundled: ['1.8.0', ... '1.11.1']
+```
+
+```shell
+bidsval validate /data --schema 1.9.0
+bidsval validate /data --schema latest
+bidsval validate /data --schema https://bids-specification.readthedocs.io/en/v1.10.0/schema.json
+bidsval schema --schema 1.10.0      # show the versions a selector resolves to
+```
+
+## Evaluate a single expression
+
+The expression engine is usable on its own - handy for understanding a rule or
+checking one condition:
+
+```python
+from bidsval import evaluate_string
+
+evaluate_string("suffix == 'T1w'", {"suffix": "T1w"})                       # True
+evaluate_string("nifti_header.dim[0] == 3", {"nifti_header": {"dim": [4]}}) # False
+```
+
+```shell
+bidsval eval "suffix == 'T1w'" --context '{"suffix": "T1w"}'
+```
+
+## How it works
+
+- The schema is the engine. The BIDS schema expresses validation logic as
+  expressions: selectors that decide when a rule applies (`suffix == 'T1w'`) and
+  checks that must hold (`nifti_header.dim[0] == 3`). `bidsval` reads the schema's
+  vocabulary (datatypes, entities, suffixes, extensions) and rules, builds a
+  context for each file, and evaluates the rules against it. No BIDS terms are
+  hardcoded.
+- Parsing comes from `bidsschematools`; `bidsval` adds the evaluator that walks
+  the syntax tree (no `eval`/`exec`), the file/context layers, and the rule loop.
+- A finding is reported only when a rule produces a determinate failure. When the
+  context cannot determine a rule (for example a check that needs a content layer
+  not yet built), the rule is skipped rather than guessed, so the validator does
+  not emit false errors.
+- Results are pydantic models, ready to serialise to JSON or bind to a GUI.
+
+## Layout
+
+| Module | Responsibility |
+|---|---|
+| `bidsval.schema` | Resolve a selector to one schema object; read BIDS vocabulary from it. The only version-aware code. |
+| `bidsval.files` | Index a dataset's files (`FileTree`). |
+| `bidsval.context` | Build the per-file context: entities, datatype, inheritance-merged sidecar, associated files, loaded content. |
+| `bidsval.expr` | Evaluate BIDS schema expressions against a context. |
+| `bidsval.rules` | Apply the schema's checks, sidecar fields (presence + value type), and tabular-column rules; plus bespoke checks. |
+| `bidsval.validate` | `validate` / `validate_subject` / `validate_file`. |
+| `bidsval.render` | Render a report as text / JSON / SARIF / HTML. |
+| `bidsval.issues` / `bidsval.report` | Typed findings and results. |
+| `bidsval.cli` | The `bidsval` command. |
+
+Done: schema engine; file/context/rule layers; dataset/subject/file validation;
+JSON sidecar field presence and value-type checks; the associations layer
+(events, bval/bvec, channels, ASL, coordsystem, ...); tabular-column checks;
+empty-file / unreadable-NIfTI checks; bundled + URL + `latest` schema selection;
+text / JSON / SARIF / HTML outputs.
+
+## Roadmap
+
+Filename/path legality, file integrity, the cross-file and tabular checks (including
+full value-type checking and type redefinition), inheritance checks, CITATION.cff,
+derivatives recursion, and the coordsystems/atlas-description aggregates are all in
+(see [comparison vs the Deno reference validator](docs/comparison-vs-deno.md) for full
+coverage). Remaining:
+
+1. Deferred reference checks: HED (needs a HED validator dependency) and symlink checks
+   (the annex-symlink tension). Only the gzip/ome/tiff content-header aggregates are
+   still unbuilt.
+2. The ahead-of-market features: requirement-level completeness per subject, reasoned
+   waivers, explain mode, and one-click fixes (provenance and fix hints are already on
+   every finding).
+
+## Documentation
+
+See [`docs/`](docs/index.md):
+
+- [usage](docs/usage.md) - install, the CLI, the Python API.
+- [CLI reference](docs/cli-reference.md) - every command and option, with examples and exit codes.
+- [schema selection](docs/schema-selection.md) - the single `--schema` selector.
+- [output formats](docs/output-formats.md) - `--output-type`, `--out-dir`, `--show`.
+- [how it works](docs/internals.md) - the complete technical reference: design, dependencies, every layer, flowcharts, and a glossary.
+- [comparison vs the Deno reference validator](docs/comparison-vs-deno.md) - coverage, results, and the no-false-positives evidence.
+
+## Develop
+
+```shell
+pytest                                  # unit suite, incl. the schema expression oracle
+BIDSVAL_REAL_DATA=1 pytest tests/test_real_data.py   # real-data validation (if datasets present)
+ruff check src tests
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

bidsval-0.0.1/README.md

@@ -0,0 +1,184 @@
+# bidsval
+
+Validate [BIDS](https://bids.neuroimaging.io) datasets in pure Python.
+
+`bidsval` reads the official BIDS schema and checks datasets against the rules it
+contains. It runs in-process with no external runtime, returns typed (pydantic)
+results, and validates a whole dataset, a single subject, a single file, or a
+single expression. Every published BIDS schema version ships inside the package,
+so it works offline and you choose the version with one argument.
+
+Because the schema drives everything, `bidsval` covers all of BIDS - anatomical,
+functional, diffusion, fieldmaps, perfusion, EEG, MEG, iEEG, behavioural, PET,
+microscopy, motion, NIRS, MRS - not a fixed set of modalities. Point it at a
+newer schema and the newer rules apply with no code change.
+
+> Working and tested against real MRI, EEG, MEG, and PET datasets and the
+> official `bids-examples` corpus, with zero false positives versus the reference
+> validator. It checks file structure, sidecar fields (presence and value type),
+> associated files (events, bval/bvec, channels, ASL, ...), and tabular columns.
+> Full coverage parity with the reference is still in progress; see "Roadmap".
+
+## Install
+
+```shell
+pip install -e .                 # bidsval and all required readers (nibabel, pandas, mne)
+pip install -e ".[dev]"          # also the test and lint tooling
+```
+
+## Validate a dataset
+
+From Python:
+
+```python
+import bidsval
+
+report = bidsval.validate("/path/to/dataset")
+report.is_valid            # False if there are any errors
+report.counts              # {'error': 3, 'warning': 27, 'ignore': 0}
+for verdict in report.files:
+    for issue in verdict.issues:
+        print(issue.severity.value, issue.code, verdict.path, issue.message)
+
+# Narrower granularity:
+bidsval.validate_subject("/path/to/dataset", "sub-01")
+bidsval.validate_file("/path/to/dataset", "sub-01/anat/sub-01_T1w.nii.gz")
+```
+
+From the command line:
+
+```shell
+# Text summary to the terminal (exits non-zero on errors, so it drops into CI):
+bidsval validate /path/to/dataset
+
+# Validate one subject; also check NIfTI headers:
+bidsval validate /path/to/dataset --subject sub-01 --headers
+
+# Pick the output type (independent of where it goes):
+bidsval validate /path/to/dataset --output-type json     # JSON to stdout
+bidsval validate /path/to/dataset --output-type sarif    # SARIF to stdout (CI / IDE code scanning)
+
+# Write report files: --out-dir holds report.<ext> for each selected type:
+bidsval validate /path/to/dataset --output-type html --out-dir reports/   # reports/report.html
+bidsval validate /path/to/dataset --output-type all  --out-dir reports/   # report.txt/.json/.sarif/.html
+
+# Show only the severities you care about (does not change pass/fail):
+bidsval validate /path/to/dataset --show error           # errors only
+```
+
+Flags: `--schema <version|url|path>`, `--subject sub-01`, `--headers`
+(also check NIfTI headers, needs nibabel), `--output-type text|json|sarif|html|all`
+(default `text`; one type prints to stdout, several need `--out-dir`),
+`--out-dir DIR` (write `report.<ext>` per type), `--show error,warning,ignore,all`
+(filter displayed findings; default `error,warning`).
+
+## Choose a schema version
+
+Every published BIDS schema is bundled, and any other version or a URL is fetched
+and cached. One argument selects the schema; everything downstream is unchanged:
+
+```python
+bidsval.validate("/data", schema="1.10.0")               # a bundled version
+bidsval.validate("/data", schema="latest")               # the development tip (fetched)
+bidsval.validate("/data", schema="https://.../schema.json")  # any URL (fetched + cached)
+bidsval.validate("/data", schema="/path/to/schema.json") # a local dereferenced schema.json
+bidsval.validate("/data", schema="/path/to/src/schema")  # a YAML schema source directory
+bidsval.available_versions()                             # bundled: ['1.8.0', ... '1.11.1']
+```
+
+```shell
+bidsval validate /data --schema 1.9.0
+bidsval validate /data --schema latest
+bidsval validate /data --schema https://bids-specification.readthedocs.io/en/v1.10.0/schema.json
+bidsval schema --schema 1.10.0      # show the versions a selector resolves to
+```
+
+## Evaluate a single expression
+
+The expression engine is usable on its own - handy for understanding a rule or
+checking one condition:
+
+```python
+from bidsval import evaluate_string
+
+evaluate_string("suffix == 'T1w'", {"suffix": "T1w"})                       # True
+evaluate_string("nifti_header.dim[0] == 3", {"nifti_header": {"dim": [4]}}) # False
+```
+
+```shell
+bidsval eval "suffix == 'T1w'" --context '{"suffix": "T1w"}'
+```
+
+## How it works
+
+- The schema is the engine. The BIDS schema expresses validation logic as
+  expressions: selectors that decide when a rule applies (`suffix == 'T1w'`) and
+  checks that must hold (`nifti_header.dim[0] == 3`). `bidsval` reads the schema's
+  vocabulary (datatypes, entities, suffixes, extensions) and rules, builds a
+  context for each file, and evaluates the rules against it. No BIDS terms are
+  hardcoded.
+- Parsing comes from `bidsschematools`; `bidsval` adds the evaluator that walks
+  the syntax tree (no `eval`/`exec`), the file/context layers, and the rule loop.
+- A finding is reported only when a rule produces a determinate failure. When the
+  context cannot determine a rule (for example a check that needs a content layer
+  not yet built), the rule is skipped rather than guessed, so the validator does
+  not emit false errors.
+- Results are pydantic models, ready to serialise to JSON or bind to a GUI.
+
+## Layout
+
+| Module | Responsibility |
+|---|---|
+| `bidsval.schema` | Resolve a selector to one schema object; read BIDS vocabulary from it. The only version-aware code. |
+| `bidsval.files` | Index a dataset's files (`FileTree`). |
+| `bidsval.context` | Build the per-file context: entities, datatype, inheritance-merged sidecar, associated files, loaded content. |
+| `bidsval.expr` | Evaluate BIDS schema expressions against a context. |
+| `bidsval.rules` | Apply the schema's checks, sidecar fields (presence + value type), and tabular-column rules; plus bespoke checks. |
+| `bidsval.validate` | `validate` / `validate_subject` / `validate_file`. |
+| `bidsval.render` | Render a report as text / JSON / SARIF / HTML. |
+| `bidsval.issues` / `bidsval.report` | Typed findings and results. |
+| `bidsval.cli` | The `bidsval` command. |
+
+Done: schema engine; file/context/rule layers; dataset/subject/file validation;
+JSON sidecar field presence and value-type checks; the associations layer
+(events, bval/bvec, channels, ASL, coordsystem, ...); tabular-column checks;
+empty-file / unreadable-NIfTI checks; bundled + URL + `latest` schema selection;
+text / JSON / SARIF / HTML outputs.
+
+## Roadmap
+
+Filename/path legality, file integrity, the cross-file and tabular checks (including
+full value-type checking and type redefinition), inheritance checks, CITATION.cff,
+derivatives recursion, and the coordsystems/atlas-description aggregates are all in
+(see [comparison vs the Deno reference validator](docs/comparison-vs-deno.md) for full
+coverage). Remaining:
+
+1. Deferred reference checks: HED (needs a HED validator dependency) and symlink checks
+   (the annex-symlink tension). Only the gzip/ome/tiff content-header aggregates are
+   still unbuilt.
+2. The ahead-of-market features: requirement-level completeness per subject, reasoned
+   waivers, explain mode, and one-click fixes (provenance and fix hints are already on
+   every finding).
+
+## Documentation
+
+See [`docs/`](docs/index.md):
+
+- [usage](docs/usage.md) - install, the CLI, the Python API.
+- [CLI reference](docs/cli-reference.md) - every command and option, with examples and exit codes.
+- [schema selection](docs/schema-selection.md) - the single `--schema` selector.
+- [output formats](docs/output-formats.md) - `--output-type`, `--out-dir`, `--show`.
+- [how it works](docs/internals.md) - the complete technical reference: design, dependencies, every layer, flowcharts, and a glossary.
+- [comparison vs the Deno reference validator](docs/comparison-vs-deno.md) - coverage, results, and the no-false-positives evidence.
+
+## Develop
+
+```shell
+pytest                                  # unit suite, incl. the schema expression oracle
+BIDSVAL_REAL_DATA=1 pytest tests/test_real_data.py   # real-data validation (if datasets present)
+ruff check src tests
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

bidsval-0.0.1/pyproject.toml

@@ -0,0 +1,87 @@
+[build-system]
+requires = ["setuptools>=64"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bidsval"
+version = "0.0.1"
+description = "A schema-driven, pydantic-typed, in-process BIDS validator."
+readme = "README.md"
+requires-python = ">=3.10,<3.15"
+license = { text = "MIT" }
+authors = [{ name = "bidsval contributors" }]
+keywords = ["BIDS", "validation", "neuroimaging", "schema", "pydantic"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering",
+]
+
+# Dependencies.
+# Bounds strategy (same as BIDS-Manager):
+#   lower bound = oldest version that works with any supported Python (3.10+).
+#   upper bound = latest version tested in the reference env. On older Pythons
+#                 pip picks the newest release that fits both the version range
+#                 AND that Python's compatibility.
+# The content readers (nibabel, pandas, mne) are REQUIRED, not optional, so a
+# default install validates file contents out of the box. The loaders still
+# degrade safely (return empty/None) if a reader is ever missing or a file is
+# malformed, so a rule that needs that content simply does not fire.
+dependencies = [
+    # Schema engine: the BIDS schema and its expression-language parser. The
+    # keystone of the architecture; all BIDS knowledge enters through here.
+    "bidsschematools>=1.0,<=1.2.2",
+
+    # Strongly-typed, serialisable result model (Issue / ValidationReport).
+    "pydantic>=2,<=2.13.4",
+
+    # Content readers.
+    "nibabel>=5.0,<=5.4.2",   # NIfTI headers (read by default)
+    "pandas>=2.0,<3.0",       # TSV columns (pandas 3 changes string dtype: cap < 3.0)
+    "mne>=1.6,<=1.12.1",      # EEG / MEG / iEEG readers (for forthcoming content checks)
+    "pyyaml>=5.4,<=6.0.3",    # CITATION.cff parsing
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "ruff>=0.1"]
+
+[project.scripts]
+bidsval = "bidsval.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/karellopez/bidsval"
+Repository = "https://github.com/karellopez/bidsval"
+Issues = "https://github.com/karellopez/bidsval/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+# Ship the bundled schema(s) so the default schema is pinned to a known BIDS
+# version and works fully offline, independent of the installed bidsschematools.
+bidsval = ["schema/bundled/*.json"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+# A pragmatic, widely-used set: pycodestyle errors, pyflakes, isort, pyupgrade,
+# and a few bugbear checks. Kept intentionally modest so the rules help rather
+# than nag.
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.ruff.lint.per-file-ignores]
+# The HTML renderer embeds a CSS/HTML template; long template lines are fine.
+"src/bidsval/render/html.py" = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

bidsval-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

bidsval-0.0.1/src/bidsval/__init__.py

@@ -0,0 +1,45 @@
+"""bidsval - a schema-driven, pydantic-typed, in-process BIDS validator.
+
+The public surface grows as the validator does. Today it exposes the two pieces
+that the rest of the engine is built on:
+
+* the schema resolver (:func:`bidsval.schema.resolve`), the single place that
+  turns a schema selector into one in-memory schema object, and
+* the expression evaluator (:func:`bidsval.expr.evaluate_string`), which runs a
+  BIDS schema expression against a context.
+
+Result types (:class:`~bidsval.issues.Issue`, :class:`~bidsval.report.ValidationReport`)
+are re-exported here so consumers can ``from bidsval import Issue, ValidationReport``.
+"""
+
+from __future__ import annotations
+
+from .expr import evaluate_string
+from .issues import DatasetIssues, Issue, Severity
+from .report import FileVerdict, ValidationReport
+from .schema import available_versions, bids_version, resolve, schema_version
+from .validate import validate, validate_file, validate_subject
+
+try:  # populated from package metadata once installed
+    from importlib.metadata import version
+
+    __version__ = version("bidsval")
+except Exception:  # pragma: no cover - source checkout without metadata
+    __version__ = "0.0.0"
+
+__all__ = [
+    "Severity",
+    "Issue",
+    "DatasetIssues",
+    "FileVerdict",
+    "ValidationReport",
+    "resolve",
+    "available_versions",
+    "schema_version",
+    "bids_version",
+    "evaluate_string",
+    "validate",
+    "validate_subject",
+    "validate_file",
+    "__version__",
+]