feat: add more info to validation errors

Author: gadomski

CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Added
 
 - More permissive schema_uri matching to allow future versions of extension schemas ([#1231](https://github.com/stac-utils/pystac/pull/1231))
+- Better error messages from jsonschema validation ([#1233](https://github.com/stac-utils/pystac/pull/1233))
 
 ## [v1.8.4] - 2023-09-22
 

pystac/validation/stac_validator.py

@@ -210,6 +210,8 @@ def _validate_from_uri(
             msg += f"against schema at {schema_uri}"
 
             best = jsonschema.exceptions.best_match(errors)
+            if best:
+                msg += "\n" + str(best)
             raise STACValidationError(msg, source=errors) from best
 
     def validate_core(

tests/test_item.py

@@ -13,7 +13,7 @@
 
 import pystac
 import pystac.serialization.common_properties
-from pystac import Asset, Catalog, Collection, Item, Link
+from pystac import Asset, Catalog, Collection, Item, Link, STACValidationError
 from pystac.utils import (
     datetime_to_str,
     get_opt,
@@ -630,3 +630,10 @@ def test_non_hierarchical_relative_link() -> None:
     assert a.target_in_hierarchy(b)
     assert root.target_in_hierarchy(next(b.get_items()))
     assert root.target_in_hierarchy(root)
+
+
+def test_invalid_error_message(item: Item) -> None:
+    item.extra_fields["collection"] = "can't have a collection"
+    with pytest.raises(STACValidationError) as error:
+        item.validate()
+    assert "can't have a collection" in str(error.value)