Merge pull request #1299 from genematx/fix-properties-backcompat

FIX: backcompatibility issue with extra field

Author: genematx

CHANGELOG.md

@@ -10,6 +10,9 @@ Write the date in place of the "Unreleased" in the case a new version is release
 
 - Raise an error with a suitable message when trying to create an API key
   on a server that does not support it.
+- Backwards compatibility with older servers that do not support the `properties`
+  field in `DataSource` objects. The client will now omit this field when
+  communicating with servers older than v0.2.4.
 
 ## v0.2.6 (2026-02-24)
 

tiled/client/container.py

@@ -13,6 +13,7 @@
 import entrypoints
 import httpx
 import orjson
+from packaging.version import Version
 
 from ..iterviews import ItemsView, KeysView, ValuesView
 from ..queries import KeyLookup
@@ -699,13 +700,24 @@ def new(
         metadata = metadata or {}
         access_blob = {"tags": access_tags} if access_tags is not None else {}
 
+        # Backompatibility: if the server is older than 0.2.4,
+        # it can not accept the "properties" field in the data source.
+        # This can be removed in later releases.
+        if Version(self.context.server_info.library_version) < Version("0.2.4"):
+            data_sources_as_dicts = [
+                {k: v for k, v in asdict(ds).items() if k != "properties"}
+                for ds in data_sources
+            ]
+        else:
+            data_sources_as_dicts = [asdict(ds) for ds in data_sources]
+
         item = {
             "attributes": {
                 "ancestors": self.path_parts,
                 "metadata": metadata,
                 "structure_family": StructureFamily(structure_family),
                 "specs": normalize_specs(specs or []),
-                "data_sources": [asdict(data_source) for data_source in data_sources],
+                "data_sources": data_sources_as_dicts,
                 "access_blob": access_blob,
             }
         }