feat: initial implementation of oauth API session / integration resources (#267)

Refactors our oauth-centric API resources into a common `oauth`
meta-resource. Provides initial CRUD implementations for `sessions` and
`integrations`.

Author: zackverham

CONTRIBUTING.md

@@ -27,7 +27,7 @@ Before contributing to the `posit-sdk`, ensure that the following prerequisites
 
 ## Tooling
 
-Use the default make target to execute the full build pipeline. For details on specific targets, refer to the [Makefile](./Makefile).
+Use the default make target to execute the full build pipeline. For details on specific targets, run `make help`, or review the [Makefile](./Makefile) itself.
 
 ## Style Guide
 

integration/tests/posit/connect/oauth/__init__.py

@@ -0,0 +1,97 @@
+import pytest
+from packaging import version
+
+from posit import connect
+
+from .. import CONNECT_VERSION
+
+
+@pytest.mark.skipif(
+    CONNECT_VERSION <= version.parse("2024.06.0"),
+    reason="OAuth Integrations not supported.",
+)
+class TestIntegrations:
+    @classmethod
+    def setup_class(cls):
+        cls.client = connect.Client()
+        cls.integration = cls.client.oauth.integrations.create(
+            name="example integration",
+            description="integration description",
+            template="custom",
+            config={
+                "auth_mode": "Confidential",
+                "authorization_uri": "https://example.com/__tenand_id__/oauth2/v2.0/authorize",
+                "client_id": "client_id",
+                "client_secret": "client_secret",
+                "scopes": "a b c",
+                "token_endpoint_auth_method": "client_secret_post",
+                "token_uri": "https://example.com/__tenant_id__/oauth2/v2.0/token",
+            },
+        )
+
+        cls.another_integration = cls.client.oauth.integrations.create(
+            name="another example integration",
+            description="another integration description",
+            template="custom",
+            config={
+                "auth_mode": "Confidential",
+                "authorization_uri": "https://example.com/__tenand_id__/oauth2/v2.0/authorize",
+                "client_id": "client_id",
+                "client_secret": "client_secret",
+                "scopes": "a b c",
+                "token_endpoint_auth_method": "client_secret_post",
+                "token_uri": "https://example.com/__tenant_id__/oauth2/v2.0/token",
+            },
+        )
+
+    @classmethod
+    def teardown_class(cls):
+        cls.integration.delete()
+        cls.another_integration.delete()
+        assert len(cls.client.oauth.integrations.find()) == 0
+
+    def test_get(self):
+        result = self.client.oauth.integrations.get(self.integration.guid)
+        assert result == self.integration
+
+    def test_find(self):
+        results = self.client.oauth.integrations.find()
+        assert len(results) == 2
+        assert results[0] == self.integration
+        assert results[1] == self.another_integration
+
+    def test_create_update_delete(self):
+        # create a new integration
+
+        integration = self.client.oauth.integrations.create(
+            name="new integration",
+            description="new integration description",
+            template="custom",
+            config={
+                "auth_mode": "Confidential",
+                "authorization_uri": "https://example.com/__tenand_id__/oauth2/v2.0/authorize",
+                "client_id": "client_id",
+                "client_secret": "client_secret",
+                "scopes": "a b c",
+                "token_endpoint_auth_method": "client_secret_post",
+                "token_uri": "https://example.com/__tenant_id__/oauth2/v2.0/token",
+            },
+        )
+
+        created = self.client.oauth.integrations.get(integration.guid)
+        assert created == integration
+
+        all_integrations = self.client.oauth.integrations.find()
+        assert len(all_integrations) == 3
+
+        # update the new integration
+
+        created.update(name="updated integration name")
+        updated = self.client.oauth.integrations.get(integration.guid)
+        assert updated.name == "updated integration name"
+
+        # delete the new integration
+
+        created.delete()
+        all_integrations_after_delete = self.client.oauth.integrations.find()
+        assert len(all_integrations_after_delete) == 2

integration/tests/posit/connect/oauth/test_integrations.py

@@ -14,7 +14,7 @@
 from .content import Content
 from .groups import Groups
 from .metrics import Metrics
-from .oauth import OAuthIntegration
+from .oauth import OAuth
 from .tasks import Tasks
 from .users import User, Users
 
@@ -41,6 +41,8 @@ class Client:
         Connect user resource.
     metrics: Metrics
         Metrics resource.
+    oauth: OAuth
+        OAuth resource.
     tasks: Tasks
         Tasks resource.
     users: Users
@@ -184,18 +186,6 @@ def me(self) -> User:
         """
         return me.get(self.resource_params)
 
-    @property
-    def oauth(self) -> OAuthIntegration:
-        """
-        An OAuthIntegration.
-
-        Returns
-        -------
-        OAuthIntegration
-            The OAuth integration instance.
-        """
-        return OAuthIntegration(self.cfg, self.session)
-
     @property
     def groups(self) -> Groups:
         """The groups resource interface.
@@ -271,6 +261,18 @@ def metrics(self) -> Metrics:
         """
         return Metrics(self.resource_params)
 
+    @property
+    def oauth(self) -> OAuth:
+        """
+        The OAuth API interface.
+
+        Returns
+        -------
+        OAuth
+            The oauth API instance.
+        """
+        return OAuth(self.resource_params, self.cfg.api_key)
+
     def __del__(self):
         """Close the session when the Client instance is deleted."""
         if hasattr(self, "session") and self.session is not None:

src/posit/connect/client.py

@@ -0,0 +1 @@
+from .oauth import OAuth as OAuth