feat: add create local user support (#305)

Adds create user support for local authentication providers (e.g.,
'ldap', 'oauth2', 'pam', 'password', 'proxy', or 'saml').

Closes #113
Closes #225

Author: tdstein

integration/tests/posit/connect/test_users.py

@@ -1,29 +1,79 @@
 from posit import connect
 
 
-class TestAttributeContent:
+class TestUser:
+    @classmethod
+    def setup_class(cls):
+        cls.client = client = connect.Client()
+        cls.aron = client.users.create(
+            username="aron", email="[email protected]", password="s3cur3p@ssword"
+        )
+        cls.bill = client.users.create(
+            username="bill", email="[email protected]", password="s3cur3p@ssword"
+        )
+        cls.cole = client.users.create(
+            username="cole", email="[email protected]", password="s3cur3p@ssword"
+        )
+
+    def test_lock(self):
+        for user in (self.aron, self.bill, self.cole):
+            user.lock()
+            assert len(self.client.users.find(account_status="locked")) == 1
+            user.unlock()
+        assert len(self.client.users.find(account_status="locked")) == 0
+
+    def test_count(self):
+        # aron, bill, cole, and me
+        assert self.client.users.count() == 4
+
+    def test_find(self):
+        assert self.client.users.find(prefix="aron") == [self.aron]
+        assert self.client.users.find(prefix="bill") == [self.bill]
+        assert self.client.users.find(prefix="cole") == [self.cole]
+
+    def test_find_one(self):
+        assert self.client.users.find_one(prefix="aron") == self.aron
+        assert self.client.users.find_one(prefix="bill") == self.bill
+        assert self.client.users.find_one(prefix="cole") == self.cole
+
+    def test_get(self):
+        assert self.client.users.get(self.aron["guid"]) == self.aron
+        assert self.client.users.get(self.bill["guid"]) == self.bill
+        assert self.client.users.get(self.cole["guid"]) == self.cole
+
+
+class TestUserContent:
     """Checks behavior of the content attribute."""
 
     @classmethod
     def setup_class(cls):
-        cls.client = connect.Client()
-        cls.user = cls.client.me
-        cls.user.content.create(
+        cls.client = client = connect.Client()
+        cls.me = me = client.me
+        cls.content = me.content.create(
             name="Sample",
             description="Simple sample content for testing",
             access_type="acl",
         )
 
     @classmethod
     def teardown_class(cls):
-        assert cls.user.content.find_one().delete() is None
-        assert cls.user.content.count() == 0
+        assert cls.content.delete() is None
+        assert cls.me.content.count() == 0
 
     def test_count(self):
-        assert self.user.content.count() == 1
+        assert self.me.content.count() == 1
 
     def test_find(self):
-        assert self.user.content.find()
+        assert self.me.content.find()
 
     def test_find_one(self):
-        assert self.user.content.find_one()
+        assert self.me.content.find_one()
+
+    def test_multiple_users(self):
+        user = self.client.users.create(
+            username="example", email="[email protected]", password="s3cur3p@ssword"
+        )
+        # assert filtering limits to the provided user.
+        assert self.me.content.find_one() == self.content
+        assert user.content.find_one() is None
+        user.lock()

pyproject.toml

@@ -21,7 +21,8 @@ classifiers = [
 dynamic = ["version"]
 dependencies = [
     "requests>=2.31.0,<3",
-    "packaging"
+    "packaging",
+    "typing-extensions"
 ]
 
 [project.urls]

requirements.txt

@@ -1,2 +1,3 @@
 requests==2.32.2
 packaging==24.1
+typing-extensions==4.12.2

src/posit/connect/content.py

@@ -367,7 +367,7 @@ def create(
             Content title. Default is None.
         description : str, optional
             Content description. Default is None.
-        access_type : Literal['all', 'acl', 'logged_in', optional
+        access_type : Literal['all', 'acl', 'logged_in'], optional
             How content manages viewers. Default is 'acl'. Options: 'all', 'logged_in', 'acl'.
         connection_timeout : int, optional
             Max seconds without data exchange. Default is None. Falls back to server setting 'Scheduler.ConnectionTimeout'.

src/posit/connect/paginator.py

@@ -38,7 +38,7 @@ class Paginator:
         url (str): The URL of the paginated API endpoint.
     """
 
-    def __init__(self, session: requests.Session, url: str, params: dict = {}) -> None:
+    def __init__(self, session: requests.Session, url: str, params = {}) -> None:
         self.session = session
         self.url = url
         self.params = params