feat: adds permission delete

src/posit/connect/permissions.py

@@ -31,9 +31,15 @@ def principal_type(self) -> str:
     def role(self) -> str:
         return self.get("role")  # type: ignore
 
+    def delete(self) -> None:
+        """Delete the permission."""
+        path = f"v1/content/{self.content_guid}/permissions/{self.id}"
+        url = urls.append_path(self.config.url, path)
+        self.session.delete(url)
+
     @overload
     def update(self, role: str) -> None:
-        """Update a permission.
+        """Update the permission.
 
         Parameters
         ----------
@@ -44,11 +50,11 @@ def update(self, role: str) -> None:
 
     @overload
     def update(self, *args, **kwargs) -> None:
-        """Update a permission."""
+        """Update the permission."""
         ...
 
     def update(self, *args, **kwargs) -> None:
-        """Update a permission."""
+        """Update the permission."""
         body = dict(*args, **kwargs)
         path = f"v1/content/{self.content_guid}/permissions/{self.id}"
         url = urls.append_path(self.config.url, path)

tests/posit/connect/test_permissions.py

@@ -14,6 +14,31 @@
 from .api import load_mock  # type: ignore
 
 
+class TestPermissionDelete:
+    @responses.activate
+    def test(self):
+        # data
+        id = "94"
+        content_guid = "f2f37341-e21d-3d80-c698-a935ad614066"
+
+        # behavior
+        mock_delete = responses.delete(
+            f"https://connect.example/__api__/v1/content/{content_guid}/permissions/{id}"
+        )
+
+        # setup
+        config = Config(api_key="12345", url="https://connect.example/")
+        session = requests.Session()
+        fake_permission = load_mock(f"v1/content/{content_guid}/permissions/{id}.json")
+        permission = Permission(config, session, **fake_permission)
+
+        # invoke
+        permission.delete()
+
+        # assert
+        assert mock_delete.call_count == 1
+
+
 class TestPermissionUpdate:
     @responses.activate
     def test_request_shape(self):