codeocean 0.14.0__tar.gz → 0.16.0__tar.gz

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

@@ -1,6 +1,15 @@
 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
+- **Minimum Code Ocean platform version updated to `4.3.0`.**  
+
 ## 0.14.0 (2026-01-29)
 - [#66](https://github.com/codeocean/codeocean-sdk-python/pull/66) feat: Code Ocean version 4.2 functionality
 - **Minimum Code Ocean platform version updated to `4.2.0`.**  

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeocean
-Version: 0.14.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.14.0 → codeocean-0.16.0}/pyproject.toml

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

{codeocean-0.14.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
@@ -58,6 +59,12 @@ class Capsules:
 
         return [Computation.from_dict(c) for c in res.json()]
 
+    def get_permissions(self, capsule_id: str) -> Permissions:
+        """Get permissions for a specific capsule."""
+        res = self.client.get(f"{self._route}/{capsule_id}/permissions")
+
+        return Permissions.from_dict(res.json())
+
     def update_permissions(self, capsule_id: str, permissions: Permissions):
         """Update permissions for a capsule."""
         self.client.post(
@@ -85,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.14.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.2.0"
+    MIN_SERVER_VERSION = "4.6.0"
 
     def __post_init__(self):
         self.session = BaseUrlSession(base_url=f"{self.domain}/api/v1/")

{codeocean-0.14.0 → codeocean-0.16.0}/src/codeocean/data_asset.py

@@ -183,6 +183,12 @@ class DataAssets:
 
             params["next_token"] = response.next_token
 
+    def get_permissions(self, data_asset_id: str) -> Permissions:
+        """Get permissions for a specific data asset."""
+        res = self.client.get(f"data_assets/{data_asset_id}/permissions")
+
+        return Permissions.from_dict(res.json())
+
     def list_data_asset_files(self, data_asset_id: str, path: str = "") -> Folder:
         """
         List files and folders within an internal data asset at the specified path.

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

@@ -101,6 +101,10 @@ class Capsule:
     slug: str = dataclass_field(
         metadata={"description": "Alternate capsule ID (URL-friendly identifier)"},
     )
+    owner_email: Optional[str] = dataclass_field(
+        default=None,
+        metadata={"description": "Capsule owner's email address"},
+    )
     last_accessed: Optional[int] = dataclass_field(
         default=None,
         metadata={"description": "Capsule last accessed time (int64 timestamp)"},
@@ -155,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.14.0 → codeocean-0.16.0}/src/codeocean/models/computation.py

@@ -97,6 +97,9 @@ class Computation:
     name: str = field(
         metadata={"description": "Display name of the computation"},
     )
+    owner: str = field(
+        metadata={"description": "Computation owner's ID"},
+    )
     run_time: int = field(
         metadata={"description": "Total run time in seconds"},
     )
@@ -105,6 +108,10 @@ class Computation:
             "description": "Current state of the computation (initializing, running, finalizing, completed, failed)",
         },
     )
+    owner_email: Optional[str] = field(
+        default=None,
+        metadata={"description": "Computation owner's email address"},
+    )
     cloud_workstation: Optional[bool] = field(
         default=None,
         metadata={

{codeocean-0.14.0 → codeocean-0.16.0}/src/codeocean/models/data_asset.py

@@ -173,6 +173,14 @@ class DataAsset:
     mount: str = field(
         metadata={"description": "The default mount folder of the data asset"},
     )
+    last_used: int = field(
+        metadata={
+            "description": "Time data asset was last used in seconds from unix epoch",
+        },
+    )
+    owner: str = field(
+        metadata={"description": "Data asset owner's ID"},
+    )
     state: DataAssetState = field(
         metadata={"description": "Data asset creation state (draft, ready, failed)"},
     )
@@ -181,11 +189,6 @@ class DataAsset:
             "description": "Type of the data asset (dataset, result, combined, model)",
         },
     )
-    last_used: int = field(
-        metadata={
-            "description": "Time data asset was last used in seconds from unix epoch",
-        },
-    )
     files: Optional[int] = field(
         default=None,
         metadata={"description": "Number of files in the data asset"},
@@ -198,6 +201,10 @@ class DataAsset:
         default=None,
         metadata={"description": "Data asset description"},
     )
+    owner_email: Optional[str] = field(
+        default=None,
+        metadata={"description": "Data asset owner's email address"},
+    )
     tags: Optional[list[str]] = field(
         default=None,
         metadata={"description": "Keywords for searching the data asset"},

{codeocean-0.14.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
@@ -42,6 +43,10 @@ class Pipelines:
         """Get all computations associated with a specific pipeline."""
         return self._capsules.list_computations(pipeline_id)
 
+    def get_permissions(self, pipeline_id: str) -> Permissions:
+        """Get permissions for a specific pipeline."""
+        return self._capsules.get_permissions(pipeline_id)
+
     def update_permissions(self, pipeline_id: str, permissions: Permissions):
         """Update permissions for a pipeline."""
         return self._capsules.update_permissions(pipeline_id, permissions)
@@ -58,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))