Schema config file (#253)

- Added `--schema-config` option to specify a YAML or JSON configuration file that maps remote schema URLs to local file paths, making it easier to validate against multiple local schemas, allowing offline validation and improved performance

Author: jonhealy1

CHANGELOG.md

@@ -6,6 +6,12 @@ The format is (loosely) based on [Keep a Changelog](http://keepachangelog.com/)
 
 ## [Unreleased]
 
+## [v3.8.0] - 2025-06-03
+
+### Added
+
+- Added `--schema-config` option to specify a YAML or JSON configuration file that maps remote schema URLs to local file paths, making it easier to validate against multiple local schemas, allowing offline validation and improved performance [#253](https://github.com/stac-utils/stac-validator/pull/253)
+
 ## [v3.7.0] - 2025-05-30
 
 ### Added
@@ -62,7 +68,7 @@ The format is (loosely) based on [Keep a Changelog](http://keepachangelog.com/)
 
 - Development dependencies removed from runtime dependency list
   ([#228](https://github.com/stac-utils/stac-check/pull/109))
-- Remove jsonschema RefResolver ([#228](https://github.com/stac-utils/stac-check/pull/109))
+- Remove jsonschema RefResolver ([#228](https://github.com/stac-utils/stac-check/pull/109)
 
 ## [v3.3.1] - 2022-12-16
 
@@ -245,7 +251,8 @@ The format is (loosely) based on [Keep a Changelog](http://keepachangelog.com/)
 - With the newest version - 1.0.0-beta.2 - items will run through jsonchema validation before the PySTAC validation. The reason for this is that jsonschema will give more informative error messages. This should be addressed better in the future. This is not the case with the --recursive option as time can be a concern here with larger collections.
 - Logging. Various additions were made here depending on the options selected. This was done to help assist people to update their STAC collections.
 
-[Unreleased]: https://github.com/sparkgeo/stac-validator/compare/v3.7.0..main
+[Unreleased]: https://github.com/sparkgeo/stac-validator/compare/v3.8.0..main
+[v3.8.0]: https://github.com/sparkgeo/stac-validator/compare/v3.7.0..v3.8.0
 [v3.7.0]: https://github.com/sparkgeo/stac-validator/compare/v3.6.0..v3.7.0
 [v3.6.0]: https://github.com/sparkgeo/stac-validator/compare/v3.5.0..v3.6.0
 [v3.5.0]: https://github.com/sparkgeo/stac-validator/compare/v3.4.0..v3.5.0

README.md

@@ -31,6 +31,7 @@
   - [Item Collection Validation](#--item-collection)
   - [Using Headers](#--header)
   - [Schema Mapping](#--schema-map)
+  - [Schema Config](#--schema-config)
   - [Pydantic Validation](#--pydantic)
 - [Deployment](#deployment)
   - [Docker](#docker)
@@ -177,6 +178,7 @@ Options:
                                   (local filepath).
   --pydantic                      Validate using stac-pydantic models for enhanced
                                   type checking and validation.
+  --schema-config TEXT            Path to a YAML or JSON schema config file.
   --help                          Show this message and exit.
 ```
 
@@ -461,6 +463,25 @@ $ stac-validator tests/test_data/v100/extended-item-local.json --custom tests/te
 ]
 ```
 
+### --schema-config
+
+The `--schema-config` option allows you to specify a YAML or JSON configuration file that maps remote schema URLs to local file paths. This is useful when you need to validate against multiple local schemas and want to avoid using multiple `--schema-map` arguments.
+
+Example schema config file (YAML):
+```yaml
+schemas:
+  "https://schemas.stacspec.org/v1.0.0/collection-spec/json-schema/collection.json": "local_schemas/v1.0.0/collection.json"
+  "https://schemas.stacspec.org/v1.0.0/item-spec/json-schema/item.json": "local_schemas/v1.0.0/item.json"
+  "https://stac-extensions.github.io/eo/v1.0.0/schema.json": "local_schemas/v1.0.0/eo.json"
+```
+
+Usage:
+```bash
+$ stac-validator https://raw.githubusercontent.com/radiantearth/stac-spec/v1.0.0/examples/extended-item.json --schema-config path/to/schema_config.yaml
+```
+
+The paths in the config file can be absolute or relative to the config file's location.
+
 ### --pydantic
 
 The `--pydantic` option provides enhanced validation using stac-pydantic models, which offer stronger type checking and more detailed error messages. To use this feature, you need to install the optional dependency:

local_schemas/v1.0.0/catalog.json

@@ -0,0 +1,94 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "https://schemas.stacspec.org/v1.0.0/catalog-spec/json-schema/catalog.json#",
+    "title": "STAC Catalog Specification",
+    "description": "This object represents Catalogs in a SpatioTemporal Asset Catalog.",
+    "allOf": [
+      {
+        "$ref": "#/definitions/catalog"
+      }
+    ],
+    "definitions": {
+      "catalog": {
+        "title": "STAC Catalog",
+        "type": "object",
+        "required": [
+          "stac_version",
+          "type",
+          "id",
+          "description",
+          "links"
+        ],
+        "properties": {
+          "stac_version": {
+            "title": "STAC version",
+            "type": "string",
+            "const": "1.0.0"
+          },
+          "stac_extensions": {
+            "title": "STAC extensions",
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "title": "Reference to a JSON Schema",
+              "type": "string",
+              "format": "iri"
+            }
+          },
+          "type": {
+            "title": "Type of STAC entity",
+            "const": "Catalog"
+          },
+          "id": {
+            "title": "Identifier",
+            "type": "string",
+            "minLength": 1
+          },
+          "title": {
+            "title": "Title",
+            "type": "string"
+          },
+          "description": {
+            "title": "Description",
+            "type": "string",
+            "minLength": 1
+          },
+          "links": {
+            "title": "Links",
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/link"
+            }
+          }
+        }
+      },
+      "link": {
+        "type": "object",
+        "required": [
+          "rel",
+          "href"
+        ],
+        "properties": {
+          "href": {
+            "title": "Link reference",
+            "type": "string",
+            "format": "iri-reference",
+            "minLength": 1
+          },
+          "rel": {
+            "title": "Link relation type",
+            "type": "string",
+            "minLength": 1
+          },
+          "type": {
+            "title": "Link type",
+            "type": "string"
+          },
+          "title": {
+            "title": "Link title",
+            "type": "string"
+          }
+        }
+      }
+    }
+  }