feat: deprecates field access by attribute.

Removes all @Property annotated methods used for direct field access on
concrete resources. A new __getattr__ implementation is added to
Resource to maintain backwards compatiblity. This implementation calls
__getitem__ when the key exists in self. A noisy deprecation warning is
issued to alert users that this functionality will be removed in v1.0.0.

Author: tdstein

src/posit/connect/bundles.py

@@ -9,139 +9,19 @@
 
 
 class BundleMetadata(resources.Resource):
-    """Bundle metadata resource.
-
-    Attributes
-    ----------
-    source : str | None
-        Source of the bundle.
-    source_repo : str | None
-        Source repository of the bundle.
-    source_branch : str | None
-        Source branch of the bundle.
-    source_commit : str | None
-        Source commit of the bundle.
-    archive_md5 : str | None
-        MD5 checksum of the bundle archive.
-    archive_sha1 : str | None
-        SHA-1 checksum of the bundle archive.
-    """
-
-    @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")
+    pass
 
 
 class Bundle(resources.Resource):
-    """Bundle resource.
-
-    Attributes
-    ----------
-    id : str
-        Identifier of the bundle.
-    content_guid : str
-        Content GUID of the bundle.
-    created_time : str
-        Creation time of the bundle.
-    cluster_name : str | None
-        Cluster name associated with the bundle.
-    image_name : str | None
-        Image name of the bundle.
-    r_version : str | None
-        R version used in the bundle.
-    r_environment_management : bool | None
-        Indicates if R environment management is enabled.
-    py_version : str | None
-        Python version used in the bundle.
-    py_environment_management : bool | None
-        Indicates if Python environment management is enabled.
-    quarto_version : str | None
-        Quarto version used in the bundle.
-    active : bool | None
-        Indicates if the bundle is active.
-    size : int | None
-        Size of the bundle.
-    metadata : BundleMetadata
-        Metadata of the bundle.
-    """
-
-    @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.params, **self.get("metadata", {}))
 
     def delete(self) -> None:
         """Delete the bundle."""
         path = f"v1/content/{self.content_guid}/bundles/{self.id}"
-        url = self.url + path
-        self.session.delete(url)
+        url = self.params.url + path
+        self.params.session.delete(url)
 
     def deploy(self) -> tasks.Task:
         """Deploy the bundle.
@@ -160,8 +40,8 @@ def deploy(self) -> tasks.Task:
         None
         """
         path = f"v1/content/{self.content_guid}/deploy"
-        url = self.url + path
-        response = self.session.post(url, json={"bundle_id": self.id})
+        url = self.params.url + path
+        response = self.params.session.post(url, json={"bundle_id": self.id})
         result = response.json()
         ts = tasks.Tasks(self.params)
         return ts.get(result["task_id"])
@@ -198,8 +78,8 @@ def download(self, output: io.BufferedWriter | str) -> None:
             )
 
         path = f"v1/content/{self.content_guid}/bundles/{self.id}/download"
-        url = self.url + path
-        response = self.session.get(url, stream=True)
+        url = self.params.url + path
+        response = self.params.session.get(url, stream=True)
         if isinstance(output, io.BufferedWriter):
             for chunk in response.iter_content():
                 output.write(chunk)
@@ -284,8 +164,8 @@ def create(self, archive: io.BufferedReader | bytes | str) -> Bundle:
             )
 
         path = f"v1/content/{self.content_guid}/bundles"
-        url = self.url + path
-        response = self.session.post(url, data=data)
+        url = self.params.url + path
+        response = self.params.session.post(url, data=data)
         result = response.json()
         return Bundle(self.params, **result)
 
@@ -298,8 +178,8 @@ def find(self) -> List[Bundle]:
             List of all found bundles.
         """
         path = f"v1/content/{self.content_guid}/bundles"
-        url = self.url + path
-        response = self.session.get(url)
+        url = self.params.url + path
+        response = self.params.session.get(url)
         results = response.json()
         return [Bundle(self.params, **result) for result in results]
 
@@ -328,7 +208,7 @@ def get(self, uid: str) -> Bundle:
             The bundle with the specified ID.
         """
         path = f"v1/content/{self.content_guid}/bundles/{uid}"
-        url = self.url + path
-        response = self.session.get(url)
+        url = self.params.url + path
+        response = self.params.session.get(url)
         result = response.json()
         return Bundle(self.params, **result)