fix: migrate by default (#1509)

* fix: migrate by default

* chore: update changelog

Author: gadomski

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+### Changed
+
+- `migrate=True` is now the default in `from_dict` ([#1509](https://github.com/stac-utils/pystac/pull/1509))
+
 ### Fixed
 
 - Fall back to `epsg` when `code` is not present in the Projection extension ([#1505](https://github.com/stac-utils/pystac/pull/1505), [#1510](https://github.com/stac-utils/pystac/pull/1510))

pystac/catalog.py

@@ -1224,7 +1224,7 @@ def from_dict(
         d: dict[str, Any],
         href: str | None = None,
         root: Catalog | None = None,
-        migrate: bool = False,
+        migrate: bool = True,
         preserve_dict: bool = True,
     ) -> C:
         if migrate:

pystac/collection.py

@@ -632,7 +632,7 @@ def from_dict(
         d: dict[str, Any],
         href: str | None = None,
         root: Catalog | None = None,
-        migrate: bool = False,
+        migrate: bool = True,
         preserve_dict: bool = True,
     ) -> C:
         from pystac.extensions.version import CollectionVersionExtension

pystac/item.py

@@ -416,7 +416,7 @@ def from_dict(
         d: dict[str, Any],
         href: str | None = None,
         root: Catalog | None = None,
-        migrate: bool = False,
+        migrate: bool = True,
         preserve_dict: bool = True,
     ) -> T:
         from pystac.extensions.version import ItemVersionExtension

pystac/stac_io.py

@@ -169,19 +169,19 @@ def stac_object_from_dict(
 
         if info.object_type == pystac.STACObjectType.CATALOG:
             result = pystac.Catalog.from_dict(
-                d, href=href_str, root=root, migrate=False, preserve_dict=preserve_dict
+                d, href=href_str, root=root, migrate=True, preserve_dict=preserve_dict
             )
             result._stac_io = self
             return result
 
         if info.object_type == pystac.STACObjectType.COLLECTION:
             return pystac.Collection.from_dict(
-                d, href=href_str, root=root, migrate=False, preserve_dict=preserve_dict
+                d, href=href_str, root=root, migrate=True, preserve_dict=preserve_dict
             )
 
         if info.object_type == pystac.STACObjectType.ITEM:
             return pystac.Item.from_dict(
-                d, href=href_str, root=root, migrate=False, preserve_dict=preserve_dict
+                d, href=href_str, root=root, migrate=True, preserve_dict=preserve_dict
             )
 
         raise ValueError(f"Unknown STAC object type {info.object_type}")

pystac/stac_object.py

@@ -647,7 +647,7 @@ def from_dict(
         d: dict[str, Any],
         href: str | None = None,
         root: Catalog | None = None,
-        migrate: bool = False,
+        migrate: bool = True,
         preserve_dict: bool = True,
     ) -> S:
         """Parses this STACObject from the passed in dictionary.
@@ -659,8 +659,9 @@ def from_dict(
             root : Optional root catalog for this object.
                 If provided, the root of the returned STACObject will be set
                 to this parameter.
-            migrate: Use True if this dict represents JSON from an older STAC object,
-                so that migrations are run against it.
+            migrate: By default, STAC objects and extensions are migrated to
+                their latest supported version. Set this to False to disable
+                this behavior.
             preserve_dict: If False, the dict parameter ``d`` may be modified
                 during this method call. Otherwise the dict is not mutated.
                 Defaults to True, which results results in a deepcopy of the

tests/extensions/test_classification.py

@@ -260,7 +260,7 @@ def _parse_times(a_dict: dict[str, Any]) -> None:
                         a_dict[k] = a_dict[k].replace(microsecond=0)
 
     d1 = deepcopy(item_dict)
-    d2 = Item.from_dict(item_dict).to_dict()
+    d2 = Item.from_dict(item_dict, migrate=False).to_dict()
     _parse_times(d1)
     _parse_times(d2)
     assert d1 == d2, f"Mismatch between dictionaries: \n{d1}\n{d2}"
@@ -343,7 +343,7 @@ def test_older_extension_version(landsat_item: Item) -> None:
     stac_extensions.add(old)
     item_as_dict = landsat_item.to_dict(include_self_link=False, transform_hrefs=False)
     item_as_dict["stac_extensions"] = list(stac_extensions)
-    item = Item.from_dict(item_as_dict)
+    item = Item.from_dict(item_as_dict, migrate=False)
     assert ClassificationExtension.has_extension(item)
     assert old in item.stac_extensions
 

tests/extensions/test_eo.py

@@ -439,7 +439,7 @@ def test_older_extension_version(ext_item: Item) -> None:
     stac_extensions.add(old)
     item_as_dict = ext_item.to_dict(include_self_link=False, transform_hrefs=False)
     item_as_dict["stac_extensions"] = list(stac_extensions)
-    item = Item.from_dict(item_as_dict)
+    item = Item.from_dict(item_as_dict, migrate=False)
     assert EOExtension.has_extension(item)
     assert old in item.stac_extensions
 

tests/extensions/test_grid.py

@@ -160,7 +160,7 @@ def test_older_extension_version(ext_item: pystac.Item) -> None:
     stac_extensions.add(old)
     item_as_dict = ext_item.to_dict(include_self_link=False, transform_hrefs=False)
     item_as_dict["stac_extensions"] = list(stac_extensions)
-    item = pystac.Item.from_dict(item_as_dict)
+    item = pystac.Item.from_dict(item_as_dict, migrate=False)
     assert GridExtension.has_extension(item)
     assert old in item.stac_extensions
 

tests/extensions/test_projection.py

@@ -602,7 +602,7 @@ def test_older_extension_version(projection_landsat8_item: Item) -> None:
         include_self_link=False, transform_hrefs=False
     )
     item_as_dict["stac_extensions"] = list(stac_extensions)
-    item = Item.from_dict(item_as_dict)
+    item = Item.from_dict(item_as_dict, migrate=False)
     assert ProjectionExtension.has_extension(item)
     assert old in item.stac_extensions