python-gitea 0.12.0__py3-none-any.whl → 0.12.2__py3-none-any.whl

gitea/cli/issue/label/common.py

@@ -7,9 +7,13 @@ and one that does not rejects the whole request. Resolving first also means an
 unknown name is an error before anything is written, rather than a label silently
 not applied, and before the first of several issues has been changed.
 
-A value made only of ASCII digits is taken to be an ID and is sent as it is,
-without being looked up. That is what lets a label defined on the organization,
-which the repository's listing does not include, be applied at all.
+A value made only of ASCII digits is taken to be an ID. An ID is checked too,
+against the repository's labels and then, for one not among them, against the
+labels of the organization owning the repository, which the repository's listing
+does not include. An ID found in neither is an error before anything is written:
+Gitea drops an ID it cannot apply without saying so, so an ID copied from another
+repository would otherwise be a silent no-op for `add`, and for `set` would leave
+the issue with no labels at all.
 
 Every command takes one `--issue-id` or several. With one, `data` is that issue's
 labels, as `gitea-cli issue label list` emits them. With several, `data` holds one
@@ -25,6 +29,8 @@ import re
 from collections.abc import Callable
 from typing import TYPE_CHECKING, Any
 
+from requests import HTTPError
+
 from gitea.cli.utils.errors import CommandError
 from gitea.utils.pagination import PAGE_SIZE, collect_all_pages
 
@@ -37,6 +43,7 @@ ISSUE_IDS_HELP = "Issue number shown in the web UI. Repeat the option to act on
 LABEL_HELP = "Label name or numeric ID. Repeat the option for several labels."
 
 _NUMERIC_ID = re.compile(r"[0-9]+")
+_NOT_FOUND = 404
 
 
 def require_issue_ids(issue_ids: list[int] | None, *, command: str) -> list[int]:
@@ -79,14 +86,41 @@ def require_labels(labels: list[str] | None, *, command: str, hint: str = "") ->
     return labels
 
 
+def _organization_label_ids(client: Gitea, owner: str) -> set[int]:
+    """Read the IDs of the labels defined on the organization owning a repository.
+
+    Args:
+        client: The client to list the labels with.
+        owner: The owner of the repository.
+
+    Returns:
+        The IDs, or none when the owner is a user rather than an organization,
+        which Gitea answers with a 404.
+
+    Raises:
+        HTTPError: If the listing failed for any other reason.
+
+    """
+    try:
+        defined, _ = collect_all_pages(
+            lambda page: client.label.list_organization_labels(organization=owner, page=page, limit=PAGE_SIZE)
+        )
+    except HTTPError as e:
+        response = getattr(e, "response", None)
+        if response is None or response.status_code != _NOT_FOUND:
+            raise
+        return set()
+    return {label["id"] for label in defined}
+
+
 def resolve_label_ids(client: Gitea, owner: str, repository: str, labels: list[str], *, command: str) -> list[int]:
-    """Resolve the labels given on the command line to their IDs.
+    """Resolve the labels given on the command line to their IDs, and check that each exists.
 
-    The repository's labels are listed only when a name has to be resolved, and
-    then only once for all of them.
+    The repository's labels are listed once for all of them. The organization's
+    are listed only when an ID is not among the repository's.
 
     Args:
-        client: The client to list the repository's labels with.
+        client: The client to list the labels with.
         owner: The owner of the repository.
         repository: The name of the repository.
         labels: The labels, each a name or a numeric ID.
@@ -96,18 +130,19 @@ def resolve_label_ids(client: Gitea, owner: str, repository: str, labels: list[s
         The label IDs, in the order given, each once.
 
     Raises:
-        CommandError: If a name matches no label of the repository, or more than one.
+        CommandError: If a name matches no label of the repository, or more than
+            one, or an ID is neither a label of the repository nor of the
+            organization owning it.
 
     """
-    names = [label for label in labels if not _NUMERIC_ID.fullmatch(label)]
+    defined, _ = collect_all_pages(
+        lambda page: client.label.list_labels(owner=owner, repository=repository, page=page, limit=PAGE_SIZE)
+    )
     by_name: dict[str, list[int]] = {}
-    if names:
-        defined, _ = collect_all_pages(
-            lambda page: client.label.list_labels(owner=owner, repository=repository, page=page, limit=PAGE_SIZE)
-        )
-        for label in defined:
-            by_name.setdefault(label["name"], []).append(label["id"])
+    for label in defined:
+        by_name.setdefault(label["name"], []).append(label["id"])
 
+    names = [label for label in labels if not _NUMERIC_ID.fullmatch(label)]
     unknown = [name for name in names if name not in by_name]
     if unknown:
         raise CommandError(
@@ -122,8 +157,23 @@ def resolve_label_ids(client: Gitea, owner: str, repository: str, labels: list[s
             f"in {owner}/{repository}. Pass the numeric ID of the one you mean."
         )
 
-    ids = [int(label) if _NUMERIC_ID.fullmatch(label) else by_name[label][0] for label in labels]
-    return list(dict.fromkeys(ids))
+    repository_ids = {label["id"] for label in defined}
+    ids = [int(label) for label in labels if _NUMERIC_ID.fullmatch(label)]
+    elsewhere = [label_id for label_id in dict.fromkeys(ids) if label_id not in repository_ids]
+    if elsewhere:
+        organization_ids = _organization_label_ids(client, owner)
+        missing = [label_id for label_id in elsewhere if label_id not in organization_ids]
+        if missing:
+            raise CommandError(
+                f"'{command}': no label with ID {', '.join(str(label_id) for label_id in missing)} "
+                f"in {owner}/{repository} or on its owner {owner}. "
+                f"A label's ID belongs to the repository or organization defining it, so an ID read from "
+                f"another repository names a different label there, or none; nothing was changed. "
+                f"Pass the label's name instead; 'gitea-cli label list' shows the repository's labels."
+            )
+
+    resolved = [int(label) if _NUMERIC_ID.fullmatch(label) else by_name[label][0] for label in labels]
+    return list(dict.fromkeys(resolved))
 
 
 def for_each_issue(

gitea/label/async_label.py

@@ -74,6 +74,63 @@ class AsyncLabel(BaseLabel, AsyncResource):
         data, status_code = await process_async_response(response, default=[])
         return cast(list[dict[str, Any]], data), {"status_code": status_code}
 
+    async def _list_organization_labels(
+        self,
+        organization: str,
+        page: int | None = None,
+        limit: int | None = None,
+        **kwargs: Any,
+    ) -> ClientResponse:
+        """List the labels defined on an organization.
+
+        Args:
+            organization: The name of the organization.
+            page: The page number for pagination.
+            limit: The number of labels per page.
+            **kwargs: Additional arguments for the request.
+
+        Returns:
+            The HTTP response object.
+
+        """
+        endpoint, params = self._list_organization_labels_helper(
+            organization=organization,
+            page=page,
+            limit=limit,
+        )
+        return await self._get(endpoint=endpoint, params=params, **kwargs)
+
+    async def list_organization_labels(
+        self,
+        organization: str,
+        page: int | None = None,
+        limit: int | None = None,
+        **kwargs: Any,
+    ) -> tuple[list[dict[str, Any]], dict[str, Any]]:
+        """List the labels defined on an organization.
+
+        These are the labels every repository of the organization can use, and
+        which the listing of a repository's own labels does not include.
+
+        Args:
+            organization: The name of the organization.
+            page: The page number for pagination.
+            limit: The number of labels per page.
+            **kwargs: Additional arguments for the request.
+
+        Returns:
+            A tuple containing a list of labels as dictionaries and a dictionary with metadata.
+
+        """
+        response = await self._list_organization_labels(
+            organization=organization,
+            page=page,
+            limit=limit,
+            **kwargs,
+        )
+        data, status_code = await process_async_response(response, default=[])
+        return cast(list[dict[str, Any]], data), {"status_code": status_code}
+
     async def _create_label(
         self,
         owner: str,

gitea/label/base.py

@@ -50,6 +50,45 @@ class BaseLabel:
 
         return endpoint, params
 
+    def _list_organization_labels_endpoint(self, organization: str) -> str:
+        """Construct the endpoint URL for listing the labels defined on an organization.
+
+        Args:
+            organization: The name of the organization.
+
+        Returns:
+            The endpoint URL for listing the organization's labels.
+
+        """
+        return f"/orgs/{organization}/labels"
+
+    def _list_organization_labels_helper(
+        self,
+        organization: str,
+        page: int | None = None,
+        limit: int | None = None,
+    ) -> tuple[str, dict[str, Any]]:
+        """Get the endpoint and parameters for listing the labels defined on an organization.
+
+        Args:
+            organization: The name of the organization.
+            page: The page number for pagination.
+            limit: The number of labels per page.
+
+        Returns:
+            A tuple containing the endpoint and the request arguments.
+
+        """
+        endpoint = self._list_organization_labels_endpoint(organization=organization)
+
+        params = {}
+        if page is not None:
+            params["page"] = page
+        if limit is not None:
+            params["limit"] = limit
+
+        return endpoint, params
+
     def _create_label_endpoint(self, owner: str, repository: str) -> str:
         """Construct the endpoint URL for creating a label in a repository.
 

gitea/label/label.py

@@ -74,6 +74,63 @@ class Label(BaseLabel, Resource):
         data, status_code = process_response(response, default=[])
         return cast(list[dict[str, Any]], data), {"status_code": status_code}
 
+    def _list_organization_labels(
+        self,
+        organization: str,
+        page: int | None = None,
+        limit: int | None = None,
+        **kwargs: Any,
+    ) -> Response:
+        """List the labels defined on an organization.
+
+        Args:
+            organization: The name of the organization.
+            page: The page number for pagination.
+            limit: The number of labels per page.
+            **kwargs: Additional arguments for the request.
+
+        Returns:
+            The HTTP response object.
+
+        """
+        endpoint, params = self._list_organization_labels_helper(
+            organization=organization,
+            page=page,
+            limit=limit,
+        )
+        return self._get(endpoint=endpoint, params=params, **kwargs)
+
+    def list_organization_labels(
+        self,
+        organization: str,
+        page: int | None = None,
+        limit: int | None = None,
+        **kwargs: Any,
+    ) -> tuple[list[dict[str, Any]], dict[str, Any]]:
+        """List the labels defined on an organization.
+
+        These are the labels every repository of the organization can use, and
+        which the listing of a repository's own labels does not include.
+
+        Args:
+            organization: The name of the organization.
+            page: The page number for pagination.
+            limit: The number of labels per page.
+            **kwargs: Additional arguments for the request.
+
+        Returns:
+            A tuple containing a list of labels as dictionaries and a dictionary with metadata.
+
+        """
+        response = self._list_organization_labels(
+            organization=organization,
+            page=page,
+            limit=limit,
+            **kwargs,
+        )
+        data, status_code = process_response(response, default=[])
+        return cast(list[dict[str, Any]], data), {"status_code": status_code}
+
     def _create_label(
         self,
         owner: str,

{python_gitea-0.12.0.dist-info → python_gitea-0.12.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-gitea
-Version: 0.12.0
+Version: 0.12.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
@@ -18,7 +18,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.12
 Requires-Dist: aiohttp>=3.13.3
-Requires-Dist: platformdirs>=4.3.6
+Requires-Dist: platformdirs>=4.4.0
 Requires-Dist: pydantic>=2.12.5
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: requests>=2.33.0

{python_gitea-0.12.0.dist-info → python_gitea-0.12.2.dist-info}/RECORD

@@ -89,7 +89,7 @@ gitea/cli/issue/dependency/remove.py,sha256=1Adml7ATeO7RoOOYb6ZR9K1qBpbqgVXfW1F0
 gitea/cli/issue/label/__init__.py,sha256=og5McB5fVl_BTSBBNGnYad_NAiy_M6-Djg2LtyUYzxo,54
 gitea/cli/issue/label/add.py,sha256=N75TrExobdWf_LdPQdyoiyc_jcQjBjvg3OL2YSelP2Q,3652
 gitea/cli/issue/label/clear.py,sha256=dGPlT4neZt454XlnzdIZOzJgs8IckaqlpaRT0uhM8g0,3500
-gitea/cli/issue/label/common.py,sha256=oSFasD7xvyLYV5pjS10GI1QuchePQFacbygzgJK_f-A,8951
+gitea/cli/issue/label/common.py,sha256=Q9LC0MhYF0AIm2ddKVCloLfEE-JjOz5RfayxnDPwSps,11237
 gitea/cli/issue/label/list.py,sha256=GqSkZjRXn7-wAWVa65cajV3uLxh63IT00R2VFM2nQR4,3127
 gitea/cli/issue/label/main.py,sha256=vLSjxNpP8ymLwIEUxrOPnYciUOmdwb8Jo1o_PersxLc,1179
 gitea/cli/issue/label/remove.py,sha256=AIW1_Rzz444An-iuMM7bPH2kI6SFmLy_JkEY3F7Y8ds,3644
@@ -167,9 +167,9 @@ gitea/issue/base.py,sha256=Q13QLwxKGozvmd7oPiex9Kw5unsdvCKF-GCvdg0-zJQ,15298
 gitea/issue/issue.py,sha256=wpXoGH9JQps3ypbGyzOkqKacGGnDxXxwFWrPEtORXfw,28894
 gitea/issue/project_column.py,sha256=7TpnQcq9-hqc9eEciluplHQmSLiEBkRBr-lH7y6L9s8,15005
 gitea/label/__init__.py,sha256=cHdpsWsPWOX-q6k1JRzPOFSRafJUj907lmndLntjZjQ,690
-gitea/label/async_label.py,sha256=RtjH8ySiZraJKe_pYjn_xEAndgGlwsDt1tUoienWiI4,8133
-gitea/label/base.py,sha256=wlgx_TcA9P8Hj31tELi9MgC48fVlZk1sRmWd7UHsfBU,5277
-gitea/label/label.py,sha256=7q54hFUe1lSUZOKUziLsToFhA_rTwxPVBt0osDzU9qw,7907
+gitea/label/async_label.py,sha256=11UPD9T15Z3_Z2f63a9oxnwy__qDXTrIECZ03S0ecgE,10049
+gitea/label/base.py,sha256=8zD3r7n6iC4d4bnnDgTB8yfuu0GuZQFoNTC6T7xUcQ4,6483
+gitea/label/label.py,sha256=sIA4f08R1jN30jIMH3h92nq7953rdh2da3TeHJQB2_o,9781
 gitea/milestone/__init__.py,sha256=N5IclwSWdsJXJLK0vDtVIajk-TWstEsfom5FMN4AB50,750
 gitea/milestone/async_milestone.py,sha256=2ofOOtfYp3nyOxEu021mEUsbsclflCr8C4oZVjAj2Ck,5197
 gitea/milestone/base.py,sha256=ZWCP6UungakNkfdezfbMpDDgXr_5Fu7K5ceXgNF3s0g,3437
@@ -210,8 +210,8 @@ gitea/utils/response.py,sha256=dDk-joN6TA3blefFGTxWTs41dHOUapQs3OxoOqiMg6o,5945
 gitea/watch/__init__.py,sha256=xeLLpoldkTAJda4WPOVa6NvE1i_X2VcUcgiMFoK9ImU,1422
 gitea/watch/changes.py,sha256=lSeq3-V8IjvcoZFp5teciiezOlQa89vhaWju80JEHO4,14418
 gitea/watch/state.py,sha256=ZmwPnTRavdyIJuXIY0QllVCh56O_p9oPdVzS-pt0oCs,17856
-python_gitea-0.12.0.dist-info/METADATA,sha256=DLS01Nx4zpg4tFhSaI57H2x0WVGeboy69aXAADfYJiQ,7634
-python_gitea-0.12.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-python_gitea-0.12.0.dist-info/entry_points.txt,sha256=m5yt-1RMRZRFMj_M-Un5E4eOkM113S9EppAHp0aCzEY,49
-python_gitea-0.12.0.dist-info/licenses/LICENSE,sha256=4dW9zcCxiQKAu4CyNKJTRmvzdJCCHDxbPGuQ-YALpsY,1137
-python_gitea-0.12.0.dist-info/RECORD,,
+python_gitea-0.12.2.dist-info/METADATA,sha256=PgXEdpd3tfl6AKhOdc6MqZ-XrpRqAkb0wluhPpmf9Go,7634
+python_gitea-0.12.2.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+python_gitea-0.12.2.dist-info/entry_points.txt,sha256=m5yt-1RMRZRFMj_M-Un5E4eOkM113S9EppAHp0aCzEY,49
+python_gitea-0.12.2.dist-info/licenses/LICENSE,sha256=4dW9zcCxiQKAu4CyNKJTRmvzdJCCHDxbPGuQ-YALpsY,1137
+python_gitea-0.12.2.dist-info/RECORD,,