feat: adds bundles

src/posit/connect/bundles.py

@@ -0,0 +1,129 @@
+from __future__ import annotations
+
+from typing import List
+
+from requests.sessions import Session as Session
+
+from posit.connect.config import Config
+
+from . import urls
+
+from .resources import Resources, Resource
+
+
+class BundleMetadata(Resource):
+    @property
+    def source(self) -> str | None:
+        return self.get("source")
+
+    @property
+    def source_repo(self) -> str | None:
+        return self.get("source_repo")
+
+    @property
+    def source_branch(self) -> str | None:
+        return self.get("source_branch")
+
+    @property
+    def source_commit(self) -> str | None:
+        return self.get("source_commit")
+
+    @property
+    def archive_md5(self) -> str | None:
+        return self.get("archive_md5")
+
+    @property
+    def archive_sha1(self) -> str | None:
+        return self.get("archive_sha1")
+
+
+class Bundle(Resource):
+    @property
+    def id(self) -> str:
+        return self["id"]
+
+    @property
+    def content_guid(self) -> str:
+        return self["content_guid"]
+
+    @property
+    def created_time(self) -> str:
+        return self["created_time"]
+
+    @property
+    def cluster_name(self) -> str | None:
+        return self.get("cluster_name")
+
+    @property
+    def image_name(self) -> str | None:
+        return self.get("image_name")
+
+    @property
+    def r_version(self) -> str | None:
+        return self.get("r_version")
+
+    @property
+    def r_environment_management(self) -> bool | None:
+        return self.get("r_environment_management")
+
+    @property
+    def py_version(self) -> str | None:
+        return self.get("py_version")
+
+    @property
+    def py_environment_management(self) -> bool | None:
+        return self.get("py_environment_management")
+
+    @property
+    def quarto_version(self) -> str | None:
+        return self.get("quarto_version")
+
+    @property
+    def active(self) -> bool | None:
+        return self["active"]
+
+    @property
+    def size(self) -> int | None:
+        return self["size"]
+
+    @property
+    def metadata(self) -> BundleMetadata:
+        return BundleMetadata(self.config, self.session, **self.get("metadata", {}))
+
+    # Accessor Methods
+
+    def delete(self) -> None:
+        path = f"v1/content/{self.content_guid}/bundles/{self.id}"
+        url = urls.append_path(self.config.url, path)
+        self.session.delete(url)
+
+
+class Bundles(Resources):
+    def __init__(self, config: Config, session: Session, content_guid: str) -> None:
+        super().__init__(config, session)
+        self.content_guid = content_guid
+
+    def find(self) -> List[Bundle]:
+        path = f"v1/content/{self.content_guid}/bundles"
+        url = urls.append_path(self.config.url, path)
+        response = self.session.get(url)
+        results = response.json()
+        return [
+            Bundle(
+                self.config,
+                self.session,
+                **result,
+            )
+            for result in results
+        ]
+
+    def find_one(self) -> Bundle | None:
+        bundles = self.find()
+        return next(iter(bundles), None)
+
+    def get(self, id: str) -> Bundle:
+        path = f"v1/content/{self.content_guid}/bundles/{id}"
+        url = urls.append_path(self.config.url, path)
+        response = self.session.get(url)
+        result = response.json()
+        return Bundle(self.config, self.session, **result)

src/posit/connect/content.py

@@ -10,13 +10,26 @@
 from . import urls
 
 from .config import Config
+from .bundles import Bundles
 from .permissions import Permissions
 from .resources import Resources, Resource
 
 
 class ContentItem(Resource):
     """A piece of content."""
 
+    # Relationships
+
+    @property
+    def bundles(self) -> Bundles:
+        return Bundles(self.config, self.session, self.guid)
+
+    @property
+    def permissions(self) -> Permissions:
+        return Permissions(self.config, self.session, self.guid)
+
+    # Properties
+
     @property
     def id(self) -> str:
         return self.get("id")  # type: ignore
@@ -189,9 +202,7 @@ def dashboard_url(self) -> str:
     def app_role(self) -> str:
         return self.get("app_role")  # type: ignore
 
-    @property
-    def permissions(self) -> Permissions:
-        return Permissions(self.config, self.session, content_guid=self.guid)
+    # Accessor Methods
 
     def delete(self) -> None:
         """Delete the content item."""

src/posit/connect/permissions.py

@@ -71,7 +71,7 @@ def update(self, *args, **kwargs) -> None:
 
 
 class Permissions(Resources):
-    def __init__(self, config: Config, session: Session, *, content_guid: str) -> None:
+    def __init__(self, config: Config, session: Session, content_guid: str) -> None:
         super().__init__(config, session)
         self.content_guid = content_guid
 

tests/posit/connect/__api__/v1/content/f2f37341-e21d-3d80-c698-a935ad614066/bundles.json

@@ -0,0 +1,24 @@
+[
+    {
+        "id": "101",
+        "content_guid": "f2f37341-e21d-3d80-c698-a935ad614066",
+        "created_time": "2006-01-02T15:04:05Z07:00",
+        "cluster_name": "Local",
+        "image_name": "Local",
+        "r_version": "3.5.1",
+        "r_environment_management": true,
+        "py_version": "3.8.2",
+        "py_environment_management": true,
+        "quarto_version": "0.2.22",
+        "active": false,
+        "size": 1000000,
+        "metadata": {
+            "source": "string",
+            "source_repo": "string",
+            "source_branch": "string",
+            "source_commit": "string",
+            "archive_md5": "37324238a80595c453c706b22adb83d3",
+            "archive_sha1": "a2f7d13d87657df599aeeabdb70194d508cfa92f"
+        }
+    }
+]

tests/posit/connect/__api__/v1/content/f2f37341-e21d-3d80-c698-a935ad614066/bundles/101.json

@@ -0,0 +1,22 @@
+{
+    "id": "101",
+    "content_guid": "f2f37341-e21d-3d80-c698-a935ad614066",
+    "created_time": "2006-01-02T15:04:05Z07:00",
+    "cluster_name": "Local",
+    "image_name": "Local",
+    "r_version": "3.5.1",
+    "r_environment_management": true,
+    "py_version": "3.8.2",
+    "py_environment_management": true,
+    "quarto_version": "0.2.22",
+    "active": false,
+    "size": 1000000,
+    "metadata": {
+        "source": "string",
+        "source_repo": "string",
+        "source_branch": "string",
+        "source_commit": "string",
+        "archive_md5": "37324238a80595c453c706b22adb83d3",
+        "archive_sha1": "a2f7d13d87657df599aeeabdb70194d508cfa92f"
+    }
+}