tests

Signed-off-by: Clemens Vasters <clemens@vasters.com>

Author: clemensv

.github/workflows/python-samples-pcv.yml

@@ -0,0 +1,31 @@
+name: Validate Python Samples
+
+on:
+    push:
+        branches:
+            - main
+    pull_request:
+        branches:
+            - main
+
+jobs:
+    validate-samples:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v4
+
+            - name: Set up Python
+              uses: actions/setup-python@v5
+              with:
+                python-version: '3.11.x'
+
+            - name: Install dependencies
+              run: |
+                 python -m pip install --upgrade pip
+                 pip install pytest
+
+            - name: Run tests
+              run: |
+                cd samples/py
+                pytest

README.md

@@ -0,0 +1,36 @@
+# JSON Structure Primer and Samples
+
+This repository contains a primer and sample implementations for the JSON
+Structure specification. The content in this repository is not part of the
+official JSON Structure specification, but is provided as a reference for
+implementers and users of the specification.
+
+## Primer
+
+The primer provides an introduction to the JSON Structure specification and why
+it has been created in the first place. The primer is a good place to start if
+you are new to JSON Structure and illustrates many of the concepts using
+examples.
+
+[Read the primer](./json-structure-primer.md)
+
+## Presentation
+
+The introductory presentation gives a high-level overview of the JSON
+Structure specification and its goals. It is a good starting point for
+understanding the motivation behind JSON Structure and its key features.
+
+[View the presentation](./presentations/JSON%20Structure.pdf) (PDF)
+[Borrow the presentation content](./presentations/JSON%20Structure.pptx) (PPTX)
+
+## Samples
+
+The samples folder contains sample implementations and associated test suites
+targeting the JSON Structure Core specification. 
+
+### Python
+
+The [samples/py](./samples/py) folder contains sample Python implementations for
+validation of JSON Structure schema documents and JSON documents against JSON
+Structure schemas. The Python samples include a command-line tool for schema
+validation and a validator for JSON document instances.

json-structure-primer.md

@@ -707,11 +707,11 @@ the `$uses` attribute to activate the companion specification for the schema
 document.
 
 The feature identifiers for the companion specifications are:
-- `Altnames`: Alternate names and descriptions for properties and types.
-- `Units`: Symbols, scientific units, and currencies for numeric properties.
-- `Conditionals`: Conditional composition and validation rules.
-- `Imports`: Importing types from other schema documents.
-- `Validation`: Validation rules for JSON data.
+- `JSONStructureAlternateNames`: Alternate names and descriptions for properties and types.
+- `JSONStructureUnits`: Symbols, scientific units, and currencies for numeric properties.
+- `JSONStructureImports`: Importing types from other schema documents.
+- `JSONStructureValidation`: Validation rules for JSON data.
+- `JSONStructureConditionalComposition`: Conditional composition and validation rules.
 
 ### 5.1. Example: Using the `altnames` Keyword
 
@@ -725,7 +725,7 @@ Here is an example of how to use the `altnames` keyword:
 ```json
 {
     "$schema": "https://json-structure.github.io/meta/extended/v0/#",
-    "$uses": ["Altnames"],
+    "$uses": ["JSONStructureAlternateNames"],
     "Person": {
         "type": "object",
         "altnames": {
@@ -780,7 +780,7 @@ Here is an example of how to use the `altenums` keyword:
 ```json
 {
     "$schema": "https://json-structure.github.io/meta/extended/v0/#",
-    "$uses": ["Altnames"],
+    "$uses": ["JSONStructureAlternateNames"],
     "type": "object",
     "name": "Color",
     "properties": {
@@ -823,7 +823,7 @@ Here is an example of how to use the `unit` keyword:
 ```json
 {
     "$schema": "https://json-structure.github.io/meta/extended/v0/#",
-    "$uses": ["Units"],
+    "$uses": ["JSONStructureUnits"],
     "type": "object",
     "name": "Pressure",
     "properties": {
@@ -849,7 +849,7 @@ Here is an example of how to use the `currency` keyword:
 ```json
 {
     "$schema": "https://json-structure.github.io/meta/extended/v0/#",
-    "$uses": ["Units"],
+    "$uses": ["JSONStructureUnits"],
     "type": "object",
     "name": "Price",
     "properties": {

presentations/JSON Structure.pdf

@@ -0,0 +1,40 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+
+# Virtual environments
+venv/
+env/
+.env/
+.venv/
+
+# IDE specific files
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+coverage.xml
+*.cover
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Local development settings
+.env
+.env.local
+
+# Logs
+*.log

presentations/JSON Structure.pptx

@@ -0,0 +1,52 @@
+# JSON Structure Python Samples & Tools
+
+This folder contains sample Python implementations and associated pytest-based
+test suites targeting the JSON Structure Core specification.
+
+## Contents
+
+- **json_structure_schema_validator.py**  
+  A command-line tool that validates JSON schemas according to the JSON
+  Structure specification. It supports all extension specifications when enabled and also allows validating extension metadata schemas that introduce new `$`-prefixed keywords in property names (when enabled via `--metaschema`).
+
+- **json_structure_instance_validator.py**  
+  A validator for JSON document instances against JSON Structure schemas.  
+  It supports all core constructs including abstract types, `$extends`,
+  `$offers/$uses`, conditional composition, and additional validation addins.
+
+## Test Suites
+
+- **test_json_schema_validator_core.py**  
+  Test cases ensuring full code coverage of the schema validator, verifying
+  valid and invalid schema cases.
+
+- **test_json_validator_core.py**  
+  Test cases for the instance validator across a variety of JSON types, compound
+  types, conditional rules, and addin constraints.
+
+- **test_import.py**  
+  A dedicated test for JSON Structure Import support, using temporary files and
+  an import map to simulate external schema resolution.
+
+## Usage
+
+1. **Schema Validation:**  
+   Run the schema validator via the command line:
+   ```
+   python json_structure_schema_validator.py [--metaschema] [--allowimport] [--importmap URI=filename ...] <path_to_json_file>
+   ```
+   - Use `--metaschema` to allow `$` in property names.
+   - Use `--allowimport` and `--importmap` to enable external imports.
+
+2. **Instance Validation:**  
+   Validate an instance file against a schema by running:
+   ```
+   python json_structure_instance_validator.py <schema_file> <instance_file>
+   ```
+
+3. **Running Tests:**  
+   Use pytest to run all tests:
+   ```
+   pytest
+   ```
+