python-gitea 0.11.0__tar.gz → 0.11.2__tar.gz

{python_gitea-0.11.0 → python_gitea-0.11.2}/.github/workflows/codeql.yml

@@ -22,13 +22,13 @@ jobs:
               uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
 
             - name: Initialize CodeQL
-              uses: github/codeql-action/init@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4
+              uses: github/codeql-action/init@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4
               with:
                   languages: python
                   queries: security-and-quality
 
             - name: Autobuild
-              uses: github/codeql-action/autobuild@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4
+              uses: github/codeql-action/autobuild@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4
 
             - name: Perform CodeQL Analysis
-              uses: github/codeql-action/analyze@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4
+              uses: github/codeql-action/analyze@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4

{python_gitea-0.11.0 → python_gitea-0.11.2}/.github/workflows/support_floor_update.yml

@@ -22,7 +22,7 @@ jobs:
 
             - name: Apply support policy (spec0, from pyproject tool table)
               id: policy
-              uses: isaac-cf-wong/dependency-support-policy-action@c00466ca1b1d902260e56e087c072cbb41ac038b # v0.2.5
+              uses: isaac-cf-wong/dependency-support-policy-action@0555ece55dc2e9ac071a9f0f66345ef3d3594620 # v0.2.6
               with:
                   mode: update
 

{python_gitea-0.11.0 → python_gitea-0.11.2}/.pre-commit-config.yaml

@@ -16,7 +16,7 @@ repos:
           - id: check-json
 
     - repo: https://github.com/astral-sh/ruff-pre-commit
-      rev: v0.16.4
+      rev: v0.16.5
       hooks:
           - id: ruff
             args: [--fix, --config=pyproject.toml]
@@ -28,7 +28,7 @@ repos:
           - id: taplo-format
 
     - repo: https://github.com/crate-ci/typos
-      rev: v1.49.0
+      rev: v1.50.0
       hooks:
           - id: typos
             args: []
@@ -52,7 +52,7 @@ repos:
           - id: actionlint
 
     - repo: https://github.com/astral-sh/uv-pre-commit
-      rev: 0.12.5
+      rev: 0.12.7
       hooks:
           # Update the uv lockfile
           - id: uv-lock

{python_gitea-0.11.0 → python_gitea-0.11.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-gitea
-Version: 0.11.0
+Version: 0.11.2
 Summary: A Python package for interacting with the Gitea API, offering a simple interface to access repositories, users, organizations, issues, and more for automation and data management.
 Project-URL: Documentation, https://isaac-cf-wong.github.io/python-gitea
 Project-URL: Source, https://github.com/isaac-cf-wong/python-gitea

{python_gitea-0.11.0 → python_gitea-0.11.2}/docs/dev/architecture.md

@@ -90,17 +90,17 @@ Each client exposes one attribute per resource:
 
 ```python
 with Gitea(token="...", base_url="...") as client:
-    client.actions        # Actions
-    client.issue          # Issue
-    client.pull_request   # PullRequest
-    client.repository     # Repository
-    client.user           # User
-    client.comment        # Comment
-    client.label          # Label
-    client.milestone      # Milestone
-    client.notification   # Notification
-    client.project        # Project
-    client.organization   # Organization
+    client.actions  # Actions
+    client.issue  # Issue
+    client.pull_request  # PullRequest
+    client.repository  # Repository
+    client.user  # User
+    client.comment  # Comment
+    client.label  # Label
+    client.milestone  # Milestone
+    client.notification  # Notification
+    client.project  # Project
+    client.organization  # Organization
 ```
 
 ## Resource Layer

{python_gitea-0.11.0 → python_gitea-0.11.2}/docs/user-guide/python-api.md

@@ -202,9 +202,7 @@ variable listings are the exception: those two really do answer with a bare
 array, so they hand back a list and fall back to the empty one.
 
 ```python
-runs, _ = client.actions.list_workflow_runs(
-    owner="my-org", repository="my-repo", status="failure", limit=10
-)
+runs, _ = client.actions.list_workflow_runs(owner="my-org", repository="my-repo", status="failure", limit=10)
 print(runs["total_count"])
 for run in runs["workflow_runs"]:
     print(run["run_number"], run["status"], run["conclusion"])
@@ -337,11 +335,11 @@ downstream can come to depend on a name the API does not use.
 
 ```python
 column = columns[0]
-column["name"]        # 'Working' - reads the title
-column.get("name")    # 'Working'
-"name" in column      # True
-list(column)          # ['id', 'title', 'default', 'sorting', ...] - no 'name'
-json.dumps(column)    # {"id": 117, "title": "Working", ...} - no 'name'
+column["name"]  # 'Working' - reads the title
+column.get("name")  # 'Working'
+"name" in column  # True
+list(column)  # ['id', 'title', 'default', 'sorting', ...] - no 'name'
+json.dumps(column)  # {"id": 117, "title": "Working", ...} - no 'name'
 ```
 
 Only reading is widened. `column["name"] = x` writes a field called `name`, as

{python_gitea-0.11.0 → python_gitea-0.11.2}/pyproject.toml

@@ -29,13 +29,13 @@ dependencies = [
 
 [dependency-groups]
 dev = [
-  "ruff>=0.16.3",
+  "ruff>=0.16.5",
   # The mutation runner, in the environment `uv run` resolves, so that
   # `uv run mutmut run` reaches the same interpreter as `uv run pytest` and finds
   # the pytest plugins the suite's own options need. Run from a tool environment
   # of its own it cannot read `--cov`, and the run dies at collection.
   "mutmut>=3.7.0",
-  "prek>=0.4.14",
+  "prek>=0.5.0",
   "pytest-github-actions-annotate-failures>=0.4.2",
   "pytest-cov>=7.1.0",
   "pytest-mock>=3.15.1",

{python_gitea-0.11.0 → python_gitea-0.11.2}/src/gitea/resource/async_resource.py

@@ -7,13 +7,13 @@ from typing import TYPE_CHECKING, Any
 from aiohttp import ClientResponse
 
 if TYPE_CHECKING:
-    from gitea.client.async_gitea import AsyncGitea
+    from gitea.resource.protocol import AsyncClientProtocol
 
 
 class AsyncResource:
     """Base class for asynchronous Gitea API resources."""
 
-    def __init__(self, client: AsyncGitea) -> None:
+    def __init__(self, client: AsyncClientProtocol) -> None:
         """Initialize the Resource with a AsyncGitea client.
 
         Args:

python_gitea-0.11.2/src/gitea/resource/protocol.py

@@ -0,0 +1,62 @@
+"""What a resource needs of the client that owns it.
+
+`Resource` and `AsyncResource` reach for exactly one thing on their client:
+`_request`. Naming that as a protocol here, rather than importing the concrete
+`Gitea` and `AsyncGitea`, is what keeps the dependency running one way. The
+clients build the resources, so a resource that imported its client back -
+even under `TYPE_CHECKING` - would close a cycle across most of the package.
+
+Neither protocol is `runtime_checkable`, and nothing here is meant to be
+subclassed: `Gitea` and `AsyncGitea` satisfy these structurally, by having the
+method, and a test double satisfies them the same way.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Protocol
+
+if TYPE_CHECKING:
+    from aiohttp import ClientResponse
+    from requests import Response
+
+
+class ClientProtocol(Protocol):
+    """The part of a synchronous client that a `Resource` uses."""
+
+    def _request(
+        self, method: str, endpoint: str, headers: dict | None = None, timeout: int = 30, **kwargs: Any
+    ) -> Response:
+        """Make an HTTP request to the Gitea API.
+
+        Args:
+            method: The HTTP method (GET, POST, etc.).
+            endpoint: The API endpoint.
+            headers: Additional headers for the request.
+            timeout: Timeout for the request in seconds.
+            **kwargs: Additional arguments for the request.
+
+        Returns:
+            The HTTP response object.
+
+        """
+
+
+class AsyncClientProtocol(Protocol):
+    """The part of an asynchronous client that an `AsyncResource` uses."""
+
+    async def _request(
+        self, method: str, endpoint: str, headers: dict | None = None, timeout: int = 30, **kwargs: Any
+    ) -> ClientResponse:
+        """Make an asynchronous HTTP request to the Gitea API.
+
+        Args:
+            method: The HTTP method (GET, POST, etc.).
+            endpoint: The API endpoint.
+            headers: Optional headers to include in the request.
+            timeout: Request timeout in seconds.
+            **kwargs: Additional arguments for the request.
+
+        Returns:
+            The aiohttp ClientResponse object.
+
+        """

{python_gitea-0.11.0 → python_gitea-0.11.2}/src/gitea/resource/resource.py

@@ -7,13 +7,13 @@ from typing import TYPE_CHECKING, Any
 from requests import Response
 
 if TYPE_CHECKING:
-    from gitea.client.gitea import Gitea
+    from gitea.resource.protocol import ClientProtocol
 
 
 class Resource:
     """Base class for Gitea API resources."""
 
-    def __init__(self, client: Gitea) -> None:
+    def __init__(self, client: ClientProtocol) -> None:
         """Initialize the Resource with a Gitea client.
 
         Args:

{python_gitea-0.11.0 → python_gitea-0.11.2}/tests/cli/utils/test_cli_utils_options.py

@@ -10,6 +10,24 @@ from gitea.cli.utils.errors import CommandError
 from gitea.cli.utils.options import reporting_scope_errors, require_repository, resolve_issue_id
 
 
+def _raise(error: BaseException) -> None:
+    """Raise `error` from inside a `with` block.
+
+    Raising through a call rather than a bare `raise` statement keeps the
+    statements after the block reachable - to a reader and to static analysis
+    alike, which otherwise reads a block ending in `raise` as one control never
+    leaves, and the assertions after it as dead code.
+
+    Args:
+        error: The exception the block under test should meet.
+
+    Raises:
+        BaseException: Always; whatever it was handed.
+
+    """
+    raise error
+
+
 class TestRequireRepository:
     """Test cases for `require_repository`."""
 
@@ -132,7 +150,7 @@ class TestReportingScopeErrors:
         part in it.
         """
         with pytest.raises(CommandError) as excinfo, reporting_scope_errors("gitea-cli actions secret list"):
-            raise ValueError("Gitea has no Actions endpoint here for the authenticated account.")
+            _raise(ValueError("Gitea has no Actions endpoint here for the authenticated account."))
 
         message = str(excinfo.value)
         assert "gitea-cli actions secret list" in message
@@ -144,7 +162,7 @@ class TestReportingScopeErrors:
             pytest.raises(CommandError, match="offered for a repository or an organization"),
             reporting_scope_errors("gitea-cli actions secret list"),
         ):
-            raise ValueError("this one is offered for a repository or an organization")
+            _raise(ValueError("this one is offered for a repository or an organization"))
 
     def test_other_failures_are_left_to_be_reported_as_failures(self):
         """Only a `ValueError` is converted; a real fault should still raise as itself.
@@ -154,13 +172,13 @@ class TestReportingScopeErrors:
         wanted.
         """
         with pytest.raises(RuntimeError), reporting_scope_errors("gitea-cli actions secret list"):
-            raise RuntimeError("something is actually broken")
+            _raise(RuntimeError("something is actually broken"))
 
     def test_the_refusal_keeps_its_cause(self):
         """The original error should be chained, so a debugger can still reach it."""
         original = ValueError("no such scope")
 
         with pytest.raises(CommandError) as excinfo, reporting_scope_errors("gitea-cli actions runner list"):
-            raise original
+            _raise(original)
 
         assert excinfo.value.__cause__ is original