codeocean 0.15.0__tar.gz → 0.16.0__tar.gz

{codeocean-0.15.0 → codeocean-0.16.0}/CHANGELOG.md

@@ -1,6 +1,10 @@
 CHANGELOG
 =========
 
+## 0.16.0 (2026-06-08)
+- [#71](https://github.com/codeocean/codeocean-sdk-python/pull/71) feat: add Git sync support for capsules and pipelines
+- **Minimum Code Ocean platform version updated to `4.6.0`.**
+
 ## 0.15.0 (2026-04-10)
 - [#69](https://github.com/codeocean/codeocean-sdk-python/pull/69) feat: Code Ocean version 4.3 functionality
 - [#68](https://github.com/codeocean/codeocean-sdk-python/pull/68) feat: add get_permissions method for capsules, pipelines, data assets

{codeocean-0.15.0 → codeocean-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeocean
-Version: 0.15.0
+Version: 0.16.0
 Summary: Code Ocean Python SDK
 Project-URL: Homepage, https://github.com/codeocean/codeocean-sdk-python
 Project-URL: Issues, https://github.com/codeocean/codeocean-sdk-python/issues

{codeocean-0.15.0 → codeocean-0.16.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codeocean"
-version = "0.15.0"
+version = "0.16.0"
 authors = [
   { name="Code Ocean", email="dev@codeocean.com" },
 ]

{codeocean-0.15.0 → codeocean-0.16.0}/src/codeocean/capsule.py

@@ -9,6 +9,7 @@ from codeocean.models.capsule import (
     CapsuleSearchParams,
     CapsuleSearchResults,
     AppPanel,
+    GitSyncResults,
 )
 # Re-exports for backward compatibility
 from codeocean.models.capsule import (  # noqa: F401
@@ -91,6 +92,12 @@ class Capsules:
             json=data_assets,
         )
 
+    def sync_capsule(self, capsule_id: str) -> GitSyncResults:
+        """Sync a capsule with its linked external Git repository."""
+        res = self.client.post(f"{self._route}/{capsule_id}/sync")
+
+        return GitSyncResults.from_dict(res.json())
+
     def archive_capsule(self, capsule_id: str, archive: bool):
         """Archive or unarchive a capsule to control its visibility and accessibility."""
         self.client.patch(

{codeocean-0.15.0 → codeocean-0.16.0}/src/codeocean/client.py

@@ -38,7 +38,7 @@ class CodeOcean:
     agent_id: Optional[str] = None
 
     # Minimum server version required by this SDK
-    MIN_SERVER_VERSION = "4.3.0"
+    MIN_SERVER_VERSION = "4.6.0"
 
     def __post_init__(self):
         self.session = BaseUrlSession(base_url=f"{self.domain}/api/v1/")

{codeocean-0.15.0 → codeocean-0.16.0}/src/codeocean/models/capsule.py

@@ -159,6 +159,25 @@ class Capsule:
     )
 
 
+@dataclass_json
+@dataclass(frozen=True)
+class GitSyncResults:
+    """Results of syncing a capsule or pipeline with its external Git remote."""
+
+    pushed: int = dataclass_field(
+        default=0,
+        metadata={"description": "Number of commits pushed to the external Git remote"},
+    )
+    pulled: int = dataclass_field(
+        default=0,
+        metadata={"description": "Number of commits pulled from the external Git remote"},
+    )
+    new_branch: bool = dataclass_field(
+        default=False,
+        metadata={"description": "Whether the current branch was newly created on the external remote by this sync"},
+    )
+
+
 @dataclass_json
 @dataclass(frozen=True)
 class CapsuleSearchParams:

{codeocean-0.15.0 → codeocean-0.16.0}/src/codeocean/pipeline.py

@@ -10,6 +10,7 @@ from codeocean.models.capsule import (
     CapsuleSearchParams,
     CapsuleSearchResults,
     AppPanel,
+    GitSyncResults,
 )
 from codeocean.models.components import Permissions
 from codeocean.models.computation import Computation
@@ -62,6 +63,10 @@ class Pipelines:
         """Detach one or more data assets from a pipeline by their IDs."""
         return self._capsules.detach_data_assets(pipeline_id, data_assets)
 
+    def sync_pipeline(self, pipeline_id: str) -> GitSyncResults:
+        """Sync a pipeline with its linked external Git repository."""
+        return self._capsules.sync_capsule(pipeline_id)
+
     def archive_pipeline(self, pipeline_id: str, archive: bool):
         """Archive or unarchive a pipeline to control its visibility and accessibility."""
         return self._capsules.archive_capsule(pipeline_id, archive)

codeocean-0.16.0/tests/test_git_sync.py

@@ -0,0 +1,46 @@
+import unittest
+from unittest.mock import MagicMock
+
+from codeocean.capsule import Capsules, GitSyncResults
+from codeocean.pipeline import Pipelines
+
+
+class TestGitSync(unittest.TestCase):
+    """Test cases for capsule and pipeline Git sync."""
+
+    def _mock_session(self, body):
+        """Build a mock session whose post() returns a response with the given JSON body."""
+        session = MagicMock()
+        response = MagicMock()
+        response.json.return_value = body
+        session.post.return_value = response
+        return session
+
+    def test_sync_capsule_returns_results(self):
+        """sync_capsule posts to the capsule sync route and parses the results."""
+        session = self._mock_session({"pushed": 2, "pulled": 1, "new_branch": True})
+        capsules = Capsules(client=session)
+
+        result = capsules.sync_capsule("cap-123")
+
+        session.post.assert_called_once_with("capsules/cap-123/sync")
+        self.assertEqual(result, GitSyncResults(pushed=2, pulled=1, new_branch=True))
+
+    def test_sync_capsule_empty_body_defaults(self):
+        """An empty body (all fields omitempty on the server) deserializes to zero defaults."""
+        session = self._mock_session({})
+        capsules = Capsules(client=session)
+
+        result = capsules.sync_capsule("cap-123")
+
+        self.assertEqual(result, GitSyncResults(pushed=0, pulled=0, new_branch=False))
+
+    def test_sync_pipeline_returns_results(self):
+        """sync_pipeline posts to the pipeline sync route and parses the results."""
+        session = self._mock_session({"pushed": 0, "pulled": 3, "new_branch": False})
+        pipelines = Pipelines(client=session)
+
+        result = pipelines.sync_pipeline("pipe-456")
+
+        session.post.assert_called_once_with("pipelines/pipe-456/sync")
+        self.assertEqual(result, GitSyncResults(pushed=0, pulled=3, new_branch=False))