feat: Content repository resource (#300)

Author: zackverham

.gitignore

@@ -169,3 +169,4 @@ cython_debug/
 .ruff_cache/
 
 /.luarc.json
+_dev/

Makefile

@@ -65,8 +65,8 @@ it: $(UV_LOCK)
 	$(MAKE) -C ./integration
 
 lint: dev
-	$(UV) run pyright
 	$(UV) run ruff check
+	$(UV) run pyright
 
 test: dev
 	$(UV) run coverage run --source=src -m pytest tests

integration/tests/posit/connect/__init__.py

@@ -3,4 +3,6 @@
 from posit import connect
 
 client = connect.Client()
-CONNECT_VERSION = version.parse(client.version)
+client_version = client.version
+assert client_version is not None
+CONNECT_VERSION = version.parse(client_version)

integration/tests/posit/connect/test_content.py

@@ -29,7 +29,7 @@ def test_find(self):
         assert self.client.content.find()
 
     def test_find_by(self):
-        assert self.client.content.find_by(guid=self.content["guid"]) == self.content
+        assert self.client.content.find_by(name=self.content["name"]) == self.content
 
     def test_find_one(self):
         assert self.client.content.find_one()

integration/tests/posit/connect/test_content_item_repository.py

@@ -0,0 +1,88 @@
+import pytest
+from packaging import version
+
+from posit import connect
+from posit.connect.content import ContentItem, ContentItemRepository
+
+from . import CONNECT_VERSION
+
+
+class TestContentItemRepository:
+    content: ContentItem
+
+    @classmethod
+    def setup_class(cls):
+        cls.client = connect.Client()
+        cls.content = cls.client.content.create(name="example")
+
+    @classmethod
+    def teardown_class(cls):
+        cls.content.delete()
+        assert cls.client.content.count() == 0
+
+    @property
+    def repo_repository(self):
+        return "https://github.com/posit-dev/posit-sdk-py"
+
+    @property
+    def repo_branch(self):
+        return "1dacc4dd"
+
+    @property
+    def repo_directory(self):
+        return "integration/resources/connect/bundles/example-quarto-minimal"
+
+    @property
+    def repo_polling(self):
+        return False
+
+    @property
+    def default_repository(self):
+        return {
+            "repository": self.repo_repository,
+            "branch": self.repo_branch,
+            "directory": self.repo_directory,
+            "polling": self.repo_polling,
+        }
+
+    @pytest.mark.skipif(
+        # Added to the v2022.12.0 milestone
+        # https://github.com/rstudio/connect/issues/22242#event-7859377097
+        CONNECT_VERSION < version.parse("2022.12.0"),
+        reason="Repository routes not implemented",
+    )
+    def test_create_get_update_delete(self):
+        content = self.content
+
+        # None by default
+        assert content.repository is None
+
+        # Create
+        new_repo = content.create_repository(**self.default_repository)
+
+        # Get
+        content_repo = content.repository
+        assert content_repo is not None
+
+        def assert_repo(r: ContentItemRepository):
+            assert isinstance(content_repo, ContentItemRepository)
+            assert r["repository"] == self.repo_repository
+            assert r["branch"] == self.repo_branch
+            assert r["directory"] == self.repo_directory
+            assert r["polling"] is self.repo_polling
+
+        assert_repo(new_repo)
+        assert_repo(content_repo)
+
+        # Update
+        ex_branch = "main"
+        updated_repo = content_repo.update(branch=ex_branch)
+        assert updated_repo["branch"] == ex_branch
+
+        assert updated_repo["repository"] == self.repo_repository
+        assert updated_repo["directory"] == self.repo_directory
+        assert updated_repo["polling"] is self.repo_polling
+
+        # Delete
+        content_repo.destroy()
+        assert content.repository is None

pyproject.toml

@@ -26,7 +26,7 @@ Source = "https://github.com/posit-dev/posit-sdk-py"
 Issues = "https://github.com/posit-dev/posit-sdk-py/issues"
 
 [tool.pyright]
-include = ["src"]
+include = ["src", "tests", "integration/tests"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
@@ -70,6 +70,7 @@ extend-select = [
     # Check docstring formatting. Many of these rules are intentionally ignored below.
     "D",
 
+    "ARG",    # ARG; flake8-argparse: https://docs.astral.sh/ruff/rules/#flake8-unused-arguments-arg
     "E",      # E; pycodestyle: https://docs.astral.sh/ruff/rules/#pycodestyle-e-w
     "F",      # F; Pyflakes: https://docs.astral.sh/ruff/rules/#pyflakes-f
     "I",      # I; isort: https://docs.astral.sh/ruff/rules/#isort-i
@@ -111,8 +112,8 @@ ignore = [
 ]
 
 [tool.ruff.lint.per-file-ignores]
-"examples/*" = ["D"]
-"tests/*" = ["D"]
+"examples/connect*" = ["D", "ARG"]
+"tests/posit/connect/*" = ["D", "ARG"]
 
 
 [tool.ruff.lint.pydocstyle]
@@ -130,7 +131,7 @@ exclude = ".*"
 [dependency-groups]
 build = ["build"]
 coverage = ["coverage"]
-examples = ["rsconnect-python", "pandas"]
+examples = ["rsconnect-python", "pandas", "databricks", "shiny"]
 git = ["pre-commit"]
 lint = ["ruff", "pyright"]
 test = ["rsconnect-python", "responses", "pytest", "pyjson5"]