linkml-redcap 0.1.0__tar.gz

linkml_redcap-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 P2GX
+
+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.

linkml_redcap-0.1.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.1
+Name: linkml-redcap
+Version: 0.1.0
+Summary: LinkML schemas modelling REDCap structures — the data dictionary and the record-data envelope
+Home-page: https://github.com/linkml/linkml-redcap
+License: MIT
+Keywords: linkml,redcap,data-dictionary,ontology,fair,rare-disease,phenopackets
+Author: Adam SL Graefe
+Author-email: adam.graefe@charite.de
+Requires-Python: >=3.10,<3.13
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Healthcare Industry
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
+Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
+Requires-Dist: linkml-runtime (>=1.9.4)
+Project-URL: Documentation, https://linkml.github.io/linkml-redcap
+Project-URL: Repository, https://github.com/linkml/linkml-redcap
+Description-Content-Type: text/markdown
+
+# linkml-redcap
+
+[![CI](https://github.com/linkml/linkml-redcap/actions/workflows/ci.yaml/badge.svg)](https://github.com/linkml/linkml-redcap/actions/workflows/ci.yaml)
+[![PyPI version](https://badge.fury.io/py/linkml-redcap.svg)](https://badge.fury.io/py/linkml-redcap)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Docs](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://linkml.github.io/linkml-redcap)
+
+LinkML schemas modelling **REDCap structures**. This package is the canonical,
+vendor-neutral source of the REDCap primitives that downstream projects build
+on — what a valid data dictionary looks like, and what record data looks like in
+both its flat and structured shapes. You can find more information in the [documentation](https://linkml.github.io/linkml-redcap).
+
+It is an umbrella with two submodules:
+
+- **`data_dictionary`** — the meta-schema that formalises a REDCap *data
+  dictionary*: the 18-column CSV structure, field-naming rules, field/validation
+  types, and matrix groups.
+- **`record`** — a reusable envelope for REDCap *record data*: the structural
+  fields REDCap adds to every export (`record_id`, `redcap_event_name`,
+  `redcap_repeat_instrument`, `redcap_repeat_instance`, ...), the universal
+  `*_complete` / yes-no / true-false / checkbox value spaces, the REDCap
+  date/time string types, and the `RepeatedElement` wrapper — plus the generic
+  flat ⇄ structured grouping step.
+
+It contains **no project-specific or RareLink-specific rules**. Those conventions
+(variable naming, instrument naming, annotation profile) live in
+[RareLink](https://github.com/BIH-CEI/rarelink) and are layered on top of these
+primitives. Contributions and collaboration are welcome.
+
+## Install
+
+```bash
+pip install linkml-redcap
+```
+
+## Usage
+
+```python
+# --- the data dictionary meta-schema ---
+from linkml_redcap.data_dictionary import schema_view as dd_view
+sv = dd_view()
+assert "Field" in sv.all_classes()
+assert "FieldType" in sv.all_enums()
+
+# --- the record-data envelope ---
+from linkml_redcap.record import schema_view as record_view, group_flat_records
+rv = record_view()
+assert "FlatRecord" in rv.all_classes()
+assert "StructuredRecord" in rv.all_classes()
+assert "FormCompleteStatus" in rv.all_enums()
+
+# group a flat REDCap export into per-record objects (generic structural step)
+grouped = group_flat_records(flat_rows, drop_empty=True)
+```
+
+Each submodule exposes the same loader API — `schema_path() -> Path` (for LinkML
+CLI tools) and `schema_view() -> SchemaView` (for introspection). Schemas load
+via `importlib.resources`, so they work from any install location — regular
+installs, zipped wheels, or air-gapped environments.
+
+## What's in it
+
+### `linkml_redcap.data_dictionary`
+
+A LinkML meta-schema for the REDCap data dictionary CSV:
+
+- **`DataDictionary`** — tree root, a complete DD
+- **`Field`** — one CSV row, all 18 REDCap columns as typed/constrained slots
+- **`Choice`** — structured representation of one permissible value
+- **`Instrument`** — logical grouping of contiguous fields sharing a `form_name`
+
+Enums cover REDCap's native value spaces (`FieldType`, `TextValidationType`
+incl. the European comma-decimal variants, `CustomAlignment`, `IdentifierStatus`,
+`MatrixRanking`).
+
+> This schema is **vendor-neutral REDCap only**. RareLink ontology conventions —
+> variable-name prefixes (`snomedct_…`), the structured `field_annotation`
+> grammar, and BioPortal/ontology curation — are **not** defined here; they live
+> in [rarelink](https://github.com/BIH-CEI/rarelink).
+
+### `linkml_redcap.record`
+
+The single source of truth for the **REDCap record representation** — the actual
+shape of REDCap record data, in the two serializations the data uses:
+
+- **`FlatRecord`** (abstract) — one flat-export row; a project specialises it via
+  `is_a: FlatRecord` and adds one typed slot per field variable.
+- **`StructuredRecord`** (abstract) — the lossless record-grouped serialization:
+  one object per `record_id` with its repeating-instrument instances nested. A
+  project specialises it (`is_a`), marks itself `tree_root`, and adds its typed
+  non-repeating instrument slots.
+- **`RepeatedElement`** — the `(redcap_repeat_instrument, redcap_repeat_instance)`
+  wrapper for one repeating-instrument instance. The canonical version of the
+  class rarelink and cieinr currently redeclare per repo — import this one.
+- Structural slots: `record_id`, `redcap_event_name`, `redcap_repeat_instrument`,
+  `redcap_repeat_instance`, `redcap_data_access_group`,
+  `redcap_survey_identifier`, `repeated_elements`.
+- Enums **`FormCompleteStatus`** (0/1/2), **`YesNo`**, **`TrueFalse`**,
+  **`CheckboxState`** — REDCap's universal value spaces.
+- Types **`redcap_date`** / **`redcap_datetime`** / **`redcap_time`** /
+  **`redcap_integer`** / **`redcap_number`** / **`redcap_email`** — one typed
+  primitive per REDCap value space, so a project can give every field a defined
+  range (never a bare `string` where REDCap constrains the value, never `Any`).
+- `grouping.group_flat_records` / `ungroup_records` — the lossless flat ⇄
+  structured conversion (the cardinality change `linkml-map` can't express),
+  depending only on REDCap-native fields.
+
+> The structured envelope here is deliberately **generic, abstract and
+> convention-free** — REDCap's own record-and-repeats model, serialized
+> hierarchically. It defines **no** typed instrument classes, variable-naming
+> rules, or ontology/Phenopacket mappings: that *semantic* layer is the
+> consuming project's (the instrument classes that specialise these) and
+> [rarelink](https://github.com/BIH-CEI/rarelink)'s (the conventions and the
+> Phenopacket/FHIR engine). Nothing RareLink-specific is defined here.
+
+See [`instructions/MAPPING_WORKFLOW.md`](instructions/MAPPING_WORKFLOW.md) for the
+full flat → grouped → structured pipeline and how it feeds Phenopacket/FHIR export.
+
+## Why this exists
+
+REDCap data dictionaries are unstructured CSVs governed by implicit rules, and
+REDCap record exports are flat and wide. Making both machine-readable lets
+downstream tools **validate** any DD or export, **generate** DDs from higher-level
+specs, and **transform** flat exports into structured models with `linkml-map`
+instead of hand-written, per-instrument Python — the same envelope serving
+RareLink-CDM, the MII KDS-SE editions, CIEINR, and any other RareLink-based model.
+
+## Backwards compatibility
+
+This package is an import dependency, so its schema `id`s and public
+class/slot/enum/type names are treated as a stable API: additive minor releases
+only, deprecate-don't-remove, breaking changes ⇒ major bump. The policy is in
+[`instructions/COMPATIBILITY.md`](instructions/COMPATIBILITY.md) and enforced by
+`tests/test_public_surface.py`, which fails CI if any public name disappears.
+
+## Ecosystem
+
+- [**RareLink**](https://github.com/BIH-CEI/rarelink) — the REDCap-based rare
+  disease interoperability framework that defines the rules built on these
+  primitives
+- [**rd-cdm**](https://pypi.org/project/rd-cdm/) — ontology code systems & versions
+
+## Development
+
+```bash
+git clone https://github.com/linkml/linkml-redcap
+cd linkml-redcap
+poetry install --with dev
+
+# Validate the schemas
+poetry run linkml-lint src/linkml_redcap/data_dictionary/schema/redcap_data_dictionary.yaml
+poetry run linkml-lint src/linkml_redcap/record/schema/redcap_record.yaml
+
+# Run tests
+poetry run pytest
+```
+
+Releases are tag-triggered: push a `vX.Y.Z` tag matching the version in
+`pyproject.toml` and GitHub Actions builds and publishes to PyPI via OIDC
+trusted publishing.
+
+## License
+
+MIT
+

linkml_redcap-0.1.0/README.md

@@ -0,0 +1,164 @@
+# linkml-redcap
+
+[![CI](https://github.com/linkml/linkml-redcap/actions/workflows/ci.yaml/badge.svg)](https://github.com/linkml/linkml-redcap/actions/workflows/ci.yaml)
+[![PyPI version](https://badge.fury.io/py/linkml-redcap.svg)](https://badge.fury.io/py/linkml-redcap)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Docs](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://linkml.github.io/linkml-redcap)
+
+LinkML schemas modelling **REDCap structures**. This package is the canonical,
+vendor-neutral source of the REDCap primitives that downstream projects build
+on — what a valid data dictionary looks like, and what record data looks like in
+both its flat and structured shapes. You can find more information in the [documentation](https://linkml.github.io/linkml-redcap).
+
+It is an umbrella with two submodules:
+
+- **`data_dictionary`** — the meta-schema that formalises a REDCap *data
+  dictionary*: the 18-column CSV structure, field-naming rules, field/validation
+  types, and matrix groups.
+- **`record`** — a reusable envelope for REDCap *record data*: the structural
+  fields REDCap adds to every export (`record_id`, `redcap_event_name`,
+  `redcap_repeat_instrument`, `redcap_repeat_instance`, ...), the universal
+  `*_complete` / yes-no / true-false / checkbox value spaces, the REDCap
+  date/time string types, and the `RepeatedElement` wrapper — plus the generic
+  flat ⇄ structured grouping step.
+
+It contains **no project-specific or RareLink-specific rules**. Those conventions
+(variable naming, instrument naming, annotation profile) live in
+[RareLink](https://github.com/BIH-CEI/rarelink) and are layered on top of these
+primitives. Contributions and collaboration are welcome.
+
+## Install
+
+```bash
+pip install linkml-redcap
+```
+
+## Usage
+
+```python
+# --- the data dictionary meta-schema ---
+from linkml_redcap.data_dictionary import schema_view as dd_view
+sv = dd_view()
+assert "Field" in sv.all_classes()
+assert "FieldType" in sv.all_enums()
+
+# --- the record-data envelope ---
+from linkml_redcap.record import schema_view as record_view, group_flat_records
+rv = record_view()
+assert "FlatRecord" in rv.all_classes()
+assert "StructuredRecord" in rv.all_classes()
+assert "FormCompleteStatus" in rv.all_enums()
+
+# group a flat REDCap export into per-record objects (generic structural step)
+grouped = group_flat_records(flat_rows, drop_empty=True)
+```
+
+Each submodule exposes the same loader API — `schema_path() -> Path` (for LinkML
+CLI tools) and `schema_view() -> SchemaView` (for introspection). Schemas load
+via `importlib.resources`, so they work from any install location — regular
+installs, zipped wheels, or air-gapped environments.
+
+## What's in it
+
+### `linkml_redcap.data_dictionary`
+
+A LinkML meta-schema for the REDCap data dictionary CSV:
+
+- **`DataDictionary`** — tree root, a complete DD
+- **`Field`** — one CSV row, all 18 REDCap columns as typed/constrained slots
+- **`Choice`** — structured representation of one permissible value
+- **`Instrument`** — logical grouping of contiguous fields sharing a `form_name`
+
+Enums cover REDCap's native value spaces (`FieldType`, `TextValidationType`
+incl. the European comma-decimal variants, `CustomAlignment`, `IdentifierStatus`,
+`MatrixRanking`).
+
+> This schema is **vendor-neutral REDCap only**. RareLink ontology conventions —
+> variable-name prefixes (`snomedct_…`), the structured `field_annotation`
+> grammar, and BioPortal/ontology curation — are **not** defined here; they live
+> in [rarelink](https://github.com/BIH-CEI/rarelink).
+
+### `linkml_redcap.record`
+
+The single source of truth for the **REDCap record representation** — the actual
+shape of REDCap record data, in the two serializations the data uses:
+
+- **`FlatRecord`** (abstract) — one flat-export row; a project specialises it via
+  `is_a: FlatRecord` and adds one typed slot per field variable.
+- **`StructuredRecord`** (abstract) — the lossless record-grouped serialization:
+  one object per `record_id` with its repeating-instrument instances nested. A
+  project specialises it (`is_a`), marks itself `tree_root`, and adds its typed
+  non-repeating instrument slots.
+- **`RepeatedElement`** — the `(redcap_repeat_instrument, redcap_repeat_instance)`
+  wrapper for one repeating-instrument instance. The canonical version of the
+  class rarelink and cieinr currently redeclare per repo — import this one.
+- Structural slots: `record_id`, `redcap_event_name`, `redcap_repeat_instrument`,
+  `redcap_repeat_instance`, `redcap_data_access_group`,
+  `redcap_survey_identifier`, `repeated_elements`.
+- Enums **`FormCompleteStatus`** (0/1/2), **`YesNo`**, **`TrueFalse`**,
+  **`CheckboxState`** — REDCap's universal value spaces.
+- Types **`redcap_date`** / **`redcap_datetime`** / **`redcap_time`** /
+  **`redcap_integer`** / **`redcap_number`** / **`redcap_email`** — one typed
+  primitive per REDCap value space, so a project can give every field a defined
+  range (never a bare `string` where REDCap constrains the value, never `Any`).
+- `grouping.group_flat_records` / `ungroup_records` — the lossless flat ⇄
+  structured conversion (the cardinality change `linkml-map` can't express),
+  depending only on REDCap-native fields.
+
+> The structured envelope here is deliberately **generic, abstract and
+> convention-free** — REDCap's own record-and-repeats model, serialized
+> hierarchically. It defines **no** typed instrument classes, variable-naming
+> rules, or ontology/Phenopacket mappings: that *semantic* layer is the
+> consuming project's (the instrument classes that specialise these) and
+> [rarelink](https://github.com/BIH-CEI/rarelink)'s (the conventions and the
+> Phenopacket/FHIR engine). Nothing RareLink-specific is defined here.
+
+See [`instructions/MAPPING_WORKFLOW.md`](instructions/MAPPING_WORKFLOW.md) for the
+full flat → grouped → structured pipeline and how it feeds Phenopacket/FHIR export.
+
+## Why this exists
+
+REDCap data dictionaries are unstructured CSVs governed by implicit rules, and
+REDCap record exports are flat and wide. Making both machine-readable lets
+downstream tools **validate** any DD or export, **generate** DDs from higher-level
+specs, and **transform** flat exports into structured models with `linkml-map`
+instead of hand-written, per-instrument Python — the same envelope serving
+RareLink-CDM, the MII KDS-SE editions, CIEINR, and any other RareLink-based model.
+
+## Backwards compatibility
+
+This package is an import dependency, so its schema `id`s and public
+class/slot/enum/type names are treated as a stable API: additive minor releases
+only, deprecate-don't-remove, breaking changes ⇒ major bump. The policy is in
+[`instructions/COMPATIBILITY.md`](instructions/COMPATIBILITY.md) and enforced by
+`tests/test_public_surface.py`, which fails CI if any public name disappears.
+
+## Ecosystem
+
+- [**RareLink**](https://github.com/BIH-CEI/rarelink) — the REDCap-based rare
+  disease interoperability framework that defines the rules built on these
+  primitives
+- [**rd-cdm**](https://pypi.org/project/rd-cdm/) — ontology code systems & versions
+
+## Development
+
+```bash
+git clone https://github.com/linkml/linkml-redcap
+cd linkml-redcap
+poetry install --with dev
+
+# Validate the schemas
+poetry run linkml-lint src/linkml_redcap/data_dictionary/schema/redcap_data_dictionary.yaml
+poetry run linkml-lint src/linkml_redcap/record/schema/redcap_record.yaml
+
+# Run tests
+poetry run pytest
+```
+
+Releases are tag-triggered: push a `vX.Y.Z` tag matching the version in
+`pyproject.toml` and GitHub Actions builds and publishes to PyPI via OIDC
+trusted publishing.
+
+## License
+
+MIT

linkml_redcap-0.1.0/pyproject.toml

@@ -0,0 +1,76 @@
+[tool.poetry]
+name = "linkml-redcap"
+version = "0.1.0"
+description = "LinkML schemas modelling REDCap structures — the data dictionary and the record-data envelope"
+authors = [
+    "Adam SL Graefe <adam.graefe@charite.de>",
+    "Corey Cox <corey@tislab.org>"
+]
+license = "MIT"
+readme = "README.md"
+homepage = "https://github.com/linkml/linkml-redcap"
+repository = "https://github.com/linkml/linkml-redcap"
+documentation = "https://linkml.github.io/linkml-redcap"
+keywords = [
+    "linkml",
+    "redcap",
+    "data-dictionary",
+    "ontology",
+    "fair",
+    "rare-disease",
+    "phenopackets",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Healthcare Industry",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Bio-Informatics",
+    "Topic :: Scientific/Engineering :: Medical Science Apps.",
+]
+packages = [{ include = "linkml_redcap", from = "src" }]
+
+# Ship schema YAMLs and the py.typed marker inside the wheel.
+include = [
+    { path = "src/linkml_redcap/**/schema/*.yaml", format = ["sdist", "wheel"] },
+    { path = "src/linkml_redcap/py.typed", format = ["sdist", "wheel"] },
+]
+
+[tool.poetry.dependencies]
+python = ">=3.10,<3.13"
+linkml-runtime = ">=1.9.4"
+
+[tool.poetry.group.dev.dependencies]
+linkml = ">=1.8.0"       # for gen-pydantic, gen-doc, linkml-lint, linkml-validate
+pytest = ">=8.0"
+pytest-cov = ">=5.0"
+ruff = ">=0.5"
+pre-commit = ">=3.5"
+
+[tool.poetry.group.docs.dependencies]
+mkdocs = ">=1.6"
+mkdocs-material = ">=9.5"
+mkdocs-mermaid2-plugin = ">=1.1"
+mkdocs-include-markdown-plugin = ">=6.0"  # render instructions/*.md as doc pages
+
+[build-system]
+requires = ["poetry-core>=1.5.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "UP", "B", "SIM"]
+ignore = ["E501"]  # line length handled by formatter
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra --strict-markers"

linkml_redcap-0.1.0/src/linkml_redcap/__init__.py

@@ -0,0 +1,22 @@
+"""linkml-redcap: LinkML schemas for REDCap structures.
+
+Two submodules are available:
+
+* :mod:`linkml_redcap.data_dictionary` — the meta-schema describing a valid
+  REDCap *data dictionary* (the 18-column CSV).
+* :mod:`linkml_redcap.record` — the reusable envelope for REDCap *record data*,
+  in both its flat-export and structured/nested shapes, plus structural
+  grouping helpers for flat ⇄ structured conversion.
+"""
+
+from linkml_redcap import data_dictionary, record
+from linkml_redcap._version import __version__
+from linkml_redcap.data_dictionary import schema_path, schema_view
+
+__all__ = [
+    "data_dictionary",
+    "record",
+    "schema_path",
+    "schema_view",
+    "__version__",
+]

linkml_redcap-0.1.0/src/linkml_redcap/_resources.py

@@ -0,0 +1,29 @@
+"""Resolve bundled schema files to stable filesystem paths.
+
+``importlib.resources.as_file`` only guarantees a real path *within* its context
+manager: for a zip-imported package it extracts the resource to a temporary file
+that is removed as soon as the context exits. Returning such a path from a public
+``schema_path()`` would hand callers (and ``SchemaView``) a path that may already
+be gone.
+
+We therefore enter the ``as_file`` context under a single process-lifetime
+``ExitStack`` that is closed at interpreter shutdown, so the path stays valid for
+the whole session. For a normally installed (unzipped) wheel this is a no-op that
+simply returns the real file on disk.
+"""
+
+from __future__ import annotations
+
+import atexit
+from contextlib import ExitStack
+from importlib.resources import as_file, files
+from pathlib import Path
+
+_file_manager = ExitStack()
+atexit.register(_file_manager.close)
+
+
+def resolve_schema(package: str, filename: str) -> Path:
+    """Return a stable filesystem path to ``<package>/schema/<filename>``."""
+    resource = files(package).joinpath("schema").joinpath(filename)
+    return Path(_file_manager.enter_context(as_file(resource)))

linkml_redcap-0.1.0/src/linkml_redcap/_version.py

@@ -0,0 +1,8 @@
+"""Resolved package version (falls back when running from a source tree)."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("linkml-redcap")
+except PackageNotFoundError:  # not installed (e.g. running from a checkout)
+    __version__ = "0.1.0"

linkml_redcap-0.1.0/src/linkml_redcap/data_dictionary/__init__.py

@@ -0,0 +1,25 @@
+"""LinkML meta-schema for REDCap data dictionaries."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from linkml_redcap._resources import resolve_schema
+
+if TYPE_CHECKING:
+    from linkml_runtime.utils.schemaview import SchemaView
+
+SCHEMA_FILENAME = "redcap_data_dictionary.yaml"
+
+
+def schema_path() -> Path:
+    """Return the filesystem path to the bundled meta-schema YAML."""
+    return resolve_schema(__name__, SCHEMA_FILENAME)
+
+
+def schema_view() -> SchemaView:
+    """Return a SchemaView instance ready for introspection."""
+    from linkml_runtime.utils.schemaview import SchemaView
+
+    return SchemaView(str(schema_path()))

linkml_redcap-0.1.0/src/linkml_redcap/data_dictionary/schema/README.md

@@ -0,0 +1,3 @@
+# Schema Directory
+
+This folder contains the LinkML schema yaml files.