Merge pull request #150 from jonhealy1/add-fast-mode

Add --fast mode via fastjsonschema

Author: jonhealy1

CHANGELOG.md

@@ -6,6 +6,12 @@ The format is (loosely) based on [Keep a Changelog](http://keepachangelog.com/)
 
 ## Unreleased
 
+## [v1.13.0] - 2026-04-29
+
+### Added
+
+- Support for FastJSONSchema validation method with --fast flag to validate items, item collections ([#150](https://github.com/stac-utils/stac-check/pull/150))
+
 ### Updated
 
 - Updated publish script to use pyproject.toml instead of setup.py ([#149](https://github.com/stac-utils/stac-check/pull/149))
@@ -322,7 +328,8 @@ The format is (loosely) based on [Keep a Changelog](http://keepachangelog.com/)
 - Validation from stac-validator 2.3.0
 - Links and assets validation checks
 
-[Unreleased]: https://github.com/stac-utils/stac-check/compare/v1.12.0...main
+[Unreleased]: https://github.com/stac-utils/stac-check/compare/v1.13.0...main
+[v1.13.0]: https://github.com/stac-utils/stac-check/compare/v1.12.0...v1.13.0
 [v1.12.0]: https://github.com/stac-utils/stac-check/compare/v1.11.1...v1.12.0
 [v1.11.1]: https://github.com/stac-utils/stac-check/compare/v1.11.0...v1.11.1
 [v1.11.0]: https://github.com/stac-utils/stac-check/compare/v1.10.1...v1.11.0

README.md

@@ -35,6 +35,7 @@ The intent of this project is to provide a validation tool that also follows the
   - [Link and Asset Validation](#link-and-asset-validation)
   - [Invalid STAC](#invalid-stac)
   - [Using HTTP Headers](#using-http-headers)
+  - [Fast Validation](#fast-validation)
   - [STAC API Validation](#stac-api-validation)
 - [Development](#development)
   - [Building Documentation](#building-documentation)
@@ -94,6 +95,8 @@ Options:
   --pydantic               Use stac-pydantic for enhanced validation with Pydantic models.
   --verbose                Show verbose error messages.
   -o, --output FILE        Save output to the specified file.
+  --fast                   Use FastJSONSchema for high-speed validation. Skips best
+                           practices and geometry checks for maximum performance.
   --item-collection        Validate item collection response. Can be combined with
                            --pages. Defaults to one page.
   --collections            Validate collections endpoint response. Can be combined with
@@ -421,6 +424,64 @@ No ASSET format errors!
 This object has 4 links
 </pre>
 
+### Fast Validation
+
+For large STAC collections or when you need maximum validation speed, use the `--fast` flag to enable FastJSONSchema validation. This mode skips best practices and geometry checks, focusing only on STAC spec compliance.
+
+**Fast Validation of a Large Item Collection:**
+
+```bash
+stac-check large_collection.json --fast
+```
+
+<pre><b>stac-check: STAC spec validation and linting tool</b>
+
+Validator: stac-valid 4.2.1
+
+Validation method: FastJSONSchema
+
+ Validation Summary
+
+✅ Passed: 998/1000
+❌ Failed: 2/1000
+
+⚡ Timing Information:
+  Total Validation Time: 245.67 ms
+  Average per Object: 0.246 ms
+
+Schemas checked:
+    https://schemas.stacspec.org/v1.0.0/item-spec/json-schema/item.json
+    https://stac-extensions.github.io/eo/v1.0.0/schema.json
+    https://stac-extensions.github.io/projection/v1.0.0/schema.json
+
+ Validation Errors
+
+❌ STAC Spec Violation: Missing {'rel': 'collection'} in links array.
+   Affected Items: 2 | Examples: item_1, item_2
+</pre>
+
+**Fast Validation with Verbose Output:**
+
+You can combine `--fast` with `--verbose` to see detailed validation output for each item:
+
+```bash
+stac-check large_collection.json --fast --verbose
+```
+
+This will show detailed validation information for each item while still maintaining the speed benefits of FastJSONSchema.
+
+**Performance Comparison:**
+
+- **`--fast` mode**: ~0.25ms per item (skips best practices and geometry)
+- **Regular mode**: ~1-2ms per item (includes all checks)
+- **Speedup**: 4-8x faster for large collections
+
+Use `--fast` when:
+- Validating large collections (100+ items)
+- You only need STAC spec compliance
+- You want to skip best practices checks
+- Performance is critical
+
 ### STAC API Validation
 
 stac-check can validate STAC API endpoints, including item collections and collections endpoints. It supports pagination and can validate multiple pages of results.

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stac_check"
-version = "1.12.0"
+version = "1.13.0"
 description = "Linting and validation tool for STAC assets"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -16,7 +16,7 @@ dependencies = [
     "requests>=2.32.4",
     "jsonschema>=4.25.0",
     "click>=8.1.8",
-    "stac-valid~=4.2.0",
+    "stac-valid~=4.2.2",
     "PyYAML",
     "python-dotenv",
 ]
@@ -26,7 +26,7 @@ dev = [
     "pytest",
     "requests-mock",
     "types-setuptools",
-    "stac-valid[pydantic]~=4.2.0",
+    "stac-valid[pydantic]~=4.2.2",
 ]
 docs = [
     "sphinx>=8.2.3",
@@ -35,7 +35,7 @@ docs = [
     "myst-parser>=4.0.1",
     "sphinx-autodoc-typehints>=3.2.0",
 ]
-pydantic = ["stac-valid[pydantic]~=4.2.0"]
+pydantic = ["stac-valid[pydantic]~=4.2.2"]
 
 [project.urls]
 Homepage = "https://github.com/stac-utils/stac-check"

sample_files/1.1.0/extended-item.json

@@ -7,7 +7,6 @@
       "https://stac-extensions.github.io/view/v1.0.0/schema.json",
       "https://stac-extensions.github.io/remote-data/v1.0.0/schema.json"
     ],
-    "type": "Feature",
     "id": "20201211_223832_CS2",
     "bbox": [
       172.91173669923782,