Add description support for Python transforms in repository integrator

Thread the optional `description` field through the Python transform
pipeline: get_python_transforms → create/compare/update methods.
This achieves parity with Jinja2 transform description handling.

The SDK-side change (InfrahubPythonTransformConfig.description) is in
opsmill/infrahub-sdk-python#887.

Closes #6382

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: minitriga

backend/infrahub/git/integrator.py

@@ -135,6 +135,9 @@ class TransformPythonInformation(BaseModel):
         ..., description="Indicate if the transform should convert the query response to InfrahubNode objects"
     )
 
+    description: str | None = None
+    """Description of the Transform"""
+
 
 class InfrahubRepositoryIntegrator(InfrahubRepositoryBase):
     """
@@ -1001,6 +1004,7 @@ async def get_python_transforms(
                     query=str(graphql_query.id),
                     timeout=transform_class.timeout,
                     convert_query_response=transform.convert_query_response,
+                    description=transform.description,
                 )
             )
 
@@ -1133,6 +1137,7 @@ async def create_python_transform(
         schema = await self.sdk.schema.get(kind=InfrahubKind.TRANSFORMPYTHON, branch=branch_name)
         data = {
             "name": transform.name,
+            "description": transform.description,
             "repository": transform.repository,
             "query": transform.query,
             "file_path": transform.file_path,
@@ -1153,6 +1158,9 @@ async def create_python_transform(
     async def update_python_transform(
         self, existing_transform: CoreTransformPython, local_transform: TransformPythonInformation
     ) -> None:
+        if existing_transform.description.value != local_transform.description:
+            existing_transform.description.value = local_transform.description
+
         if existing_transform.query.id != local_transform.query:
             existing_transform.query = {"id": local_transform.query, "source": str(self.id), "is_protected": True}
 
@@ -1172,7 +1180,8 @@ async def compare_python_transform(
         cls, existing_transform: CoreTransformPython, local_transform: TransformPythonInformation
     ) -> bool:
         if (
-            existing_transform.query.id != local_transform.query
+            existing_transform.description.value != local_transform.description
+            or existing_transform.query.id != local_transform.query
             or existing_transform.file_path.value != local_transform.file_path
             or existing_transform.timeout.value != local_transform.timeout
             or existing_transform.convert_query_response.value != local_transform.convert_query_response

backend/tests/fixtures/repos/car-dealership/initial__main/.infrahub.yml

@@ -24,6 +24,7 @@ jinja2_transforms:
 
 python_transforms:
   - name: PersonWithCarsTransform
+    description: "Transform to generate a JSON report of a person and the cars they own"
     class_name: PersonWithCarsTransform
     file_path: "transforms/person_with_cars_transform.py"
   - name: ConvertedPersonWithCarsTransform

backend/tests/unit/git/__init__.py

@@ -0,0 +1,92 @@
+from unittest.mock import MagicMock
+
+import pytest
+
+from infrahub.git.integrator import InfrahubRepositoryIntegrator, TransformPythonInformation
+
+
+class TestTransformPythonInformation:
+    def test_description_field_default(self) -> None:
+        info = TransformPythonInformation(
+            name="test",
+            repository="repo-id",
+            file_path="transforms/test.py",
+            query="query-id",
+            class_name="TestTransform",
+            transform_class=MagicMock(),
+            timeout=10,
+            convert_query_response=False,
+        )
+        assert info.description is None
+
+    def test_description_field_with_value(self) -> None:
+        info = TransformPythonInformation(
+            name="test",
+            repository="repo-id",
+            file_path="transforms/test.py",
+            query="query-id",
+            class_name="TestTransform",
+            transform_class=MagicMock(),
+            timeout=10,
+            convert_query_response=False,
+            description="A useful transform",
+        )
+        assert info.description == "A useful transform"
+
+
+def _make_mock_transform(
+    query_id: str = "query-id",
+    file_path: str = "transforms/test.py",
+    timeout: int = 10,
+    convert_query_response: bool = False,
+    description: str | None = None,
+) -> MagicMock:
+    mock = MagicMock()
+    mock.query.id = query_id
+    mock.file_path.value = file_path
+    mock.timeout.value = timeout
+    mock.convert_query_response.value = convert_query_response
+    mock.description.value = description
+    return mock
+
+
+def _make_local_transform(**kwargs: object) -> TransformPythonInformation:
+    defaults: dict[str, object] = {
+        "name": "test",
+        "repository": "repo-id",
+        "file_path": "transforms/test.py",
+        "query": "query-id",
+        "class_name": "TestTransform",
+        "transform_class": MagicMock(),
+        "timeout": 10,
+        "convert_query_response": False,
+        "description": None,
+    }
+    defaults.update(kwargs)
+    return TransformPythonInformation(**defaults)  # type: ignore[arg-type]
+
+
+class TestComparePythonTransform:
+    @pytest.mark.anyio
+    async def test_identical_returns_true(self) -> None:
+        existing = _make_mock_transform()
+        local = _make_local_transform()
+        assert await InfrahubRepositoryIntegrator.compare_python_transform(existing, local) is True
+
+    @pytest.mark.anyio
+    async def test_description_changed_returns_false(self) -> None:
+        existing = _make_mock_transform(description=None)
+        local = _make_local_transform(description="New description")
+        assert await InfrahubRepositoryIntegrator.compare_python_transform(existing, local) is False
+
+    @pytest.mark.anyio
+    async def test_description_removed_returns_false(self) -> None:
+        existing = _make_mock_transform(description="Old description")
+        local = _make_local_transform(description=None)
+        assert await InfrahubRepositoryIntegrator.compare_python_transform(existing, local) is False
+
+    @pytest.mark.anyio
+    async def test_description_same_returns_true(self) -> None:
+        existing = _make_mock_transform(description="Same")
+        local = _make_local_transform(description="Same")
+        assert await InfrahubRepositoryIntegrator.compare_python_transform(existing, local) is True