gitcode-api 1.2.11__tar.gz → 1.2.13__tar.gz

{gitcode_api-1.2.11 → gitcode_api-1.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.11
+Version: 1.2.13
 Summary: Easy to use Python SDK for the GitCode REST API. Providing builtin CLI tool, and optional LLM integration (MCP, OpenAI tool, and openJiuwen tool) for agents. Community-maintained.
 Author-email: Hugo Huang <hugo@hugohuang.com>
 License-Expression: MIT
@@ -9,7 +9,7 @@ Project-URL: issues, https://github.com/Trenza1ore/GitCode-API/issues
 Project-URL: documentation, https://gitcode-api.readthedocs.io
 Project-URL: gitcode, https://gitcode.com/SushiNinja/GitCode-API
 Project-URL: github, https://github.com/Trenza1ore/GitCode-API
-Project-URL: homepage, https://linktr.ee/Hugoooo
+Project-URL: homepage, https://hugohuang.com/gitcode-api
 Project-URL: author, https://hugohuang.com
 Keywords: gitcode,git,devops,api,sdk,python,httpx,client,mcp,agent,fastmcp,llm,openjiuwen,mcp client,mcp server,model context protocol
 Classifier: Development Status :: 4 - Beta
@@ -37,7 +37,7 @@ Dynamic: license-file
 
 # GitCode-API
 
-[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F)](https://pypi.org/project/gitcode-api) [![PyPI Downloads](https://static.pepy.tech/personalized-badge/gitcode-api?period=total&units=INTERNATIONAL_SYSTEM&left_color=GRAY&right_color=RED&left_text=downloads)](https://pepy.tech/projects/gitcode-api) [![CodeFactor](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api/badge)](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=d15040ff268342bca07ad60f812924a7)](https://pypi.org/project/gitcode-api) [![PyPI Downloads](https://static.pepy.tech/personalized-badge/gitcode-api?period=total&units=INTERNATIONAL_SYSTEM&left_color=GRAY&right_color=RED&left_text=downloads&uuid=b7f4a02b5f3e4776bd62a22cc539074b)](https://pepy.tech/projects/gitcode-api) [![CodeFactor](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api/badge)](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api)
 [![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?logoColor=white)](https://cursor.com/en/install-mcp?name=GitCode%20API&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXRjb2RlLWFwaVttY3BdIiwiZ2l0Y29kZS1hcGkiLCJzZXJ2ZSJdLCJlbnYiOnsiR0lUQ09ERV9BQ0NFU1NfVE9LRU4iOiIke2lucHV0OmdpdGNvZGVfYWNjZXNzX3Rva2VufSJ9LCJpbnB1dHMiOlt7ImlkIjoiZ2l0Y29kZV9hY2Nlc3NfdG9rZW4iLCJ0eXBlIjoicHJvbXB0U3RyaW5nIiwiZGVzY3JpcHRpb24iOiJFbnRlciBHSVRDT0RFX0FDQ0VTU19UT0tFTiIsInBhc3N3b3JkIjp0cnVlfV19) [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=GitCode%20API&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22gitcode-api%5Bmcp%5D%22%2C%22gitcode-api%22%2C%22serve%22%5D%2C%22env%22%3A%7B%22GITCODE_ACCESS_TOKEN%22%3A%22%24%7Binput%3Agitcode_access_token%7D%22%7D%2C%22inputs%22%3A%5B%7B%22id%22%3A%22gitcode_access_token%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22Enter%20GITCODE_ACCESS_TOKEN%22%2C%22password%22%3Atrue%7D%5D%7D)
 [![GitHub Badge](https://img.shields.io/badge/github-repo-blue?logo=github&link=https%3A%2F%2Fgithub.com%2FTrenza1ore%2FGitCode-API)](https://github.com/Trenza1ore/GitCode-API) [![GitCode Badge](https://img.shields.io/badge/gitcode-repo-brown?logo=gitcode&link=https%3A%2F%2Fgitcode.com%2FSushiNinja%2FGitCode-API)](https://gitcode.com/SushiNinja/GitCode-API)
 
@@ -111,12 +111,14 @@ With `gitcode-api[mcp]` installed (Python 3.10+), you can start the bundled Fast
 gitcode-api serve --api-key "$GITCODE_ACCESS_TOKEN"
 ```
 
-Use `gitcode-api serve -h` for defaults such as `--owner`, `--repo`, and `--transport`.
+Use `gitcode-api serve -h` for defaults such as `--owner`, `--repo`, `--transport` (`stdio`, `http`, or `sse`), and other options.
 
 Commands mirror the synchronous resource methods on `GitCode`, using the pattern
 `gitcode-api <resource> <method> ...`. For methods that accept extra `**params`
 or `**payload`, pass repeated `--set key=value` flags or `--set-json '{"key": "value"}'`.
 
+When using string arguments with escape sequence (such as line break `\n`), pass `-e` / `--escape` with the sequences to un-escape, such as `-e '\n\t'`.
+
 ## Quick Start
 
 ### Sync client

{gitcode_api-1.2.11 → gitcode_api-1.2.13}/README.md

@@ -1,6 +1,6 @@
 # GitCode-API
 
-[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F)](https://pypi.org/project/gitcode-api) [![PyPI Downloads](https://static.pepy.tech/personalized-badge/gitcode-api?period=total&units=INTERNATIONAL_SYSTEM&left_color=GRAY&right_color=RED&left_text=downloads)](https://pepy.tech/projects/gitcode-api) [![CodeFactor](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api/badge)](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=d15040ff268342bca07ad60f812924a7)](https://pypi.org/project/gitcode-api) [![PyPI Downloads](https://static.pepy.tech/personalized-badge/gitcode-api?period=total&units=INTERNATIONAL_SYSTEM&left_color=GRAY&right_color=RED&left_text=downloads&uuid=b7f4a02b5f3e4776bd62a22cc539074b)](https://pepy.tech/projects/gitcode-api) [![CodeFactor](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api/badge)](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api)
 [![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?logoColor=white)](https://cursor.com/en/install-mcp?name=GitCode%20API&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXRjb2RlLWFwaVttY3BdIiwiZ2l0Y29kZS1hcGkiLCJzZXJ2ZSJdLCJlbnYiOnsiR0lUQ09ERV9BQ0NFU1NfVE9LRU4iOiIke2lucHV0OmdpdGNvZGVfYWNjZXNzX3Rva2VufSJ9LCJpbnB1dHMiOlt7ImlkIjoiZ2l0Y29kZV9hY2Nlc3NfdG9rZW4iLCJ0eXBlIjoicHJvbXB0U3RyaW5nIiwiZGVzY3JpcHRpb24iOiJFbnRlciBHSVRDT0RFX0FDQ0VTU19UT0tFTiIsInBhc3N3b3JkIjp0cnVlfV19) [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=GitCode%20API&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22gitcode-api%5Bmcp%5D%22%2C%22gitcode-api%22%2C%22serve%22%5D%2C%22env%22%3A%7B%22GITCODE_ACCESS_TOKEN%22%3A%22%24%7Binput%3Agitcode_access_token%7D%22%7D%2C%22inputs%22%3A%5B%7B%22id%22%3A%22gitcode_access_token%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22Enter%20GITCODE_ACCESS_TOKEN%22%2C%22password%22%3Atrue%7D%5D%7D)
 [![GitHub Badge](https://img.shields.io/badge/github-repo-blue?logo=github&link=https%3A%2F%2Fgithub.com%2FTrenza1ore%2FGitCode-API)](https://github.com/Trenza1ore/GitCode-API) [![GitCode Badge](https://img.shields.io/badge/gitcode-repo-brown?logo=gitcode&link=https%3A%2F%2Fgitcode.com%2FSushiNinja%2FGitCode-API)](https://gitcode.com/SushiNinja/GitCode-API)
 
@@ -74,12 +74,14 @@ With `gitcode-api[mcp]` installed (Python 3.10+), you can start the bundled Fast
 gitcode-api serve --api-key "$GITCODE_ACCESS_TOKEN"
 ```
 
-Use `gitcode-api serve -h` for defaults such as `--owner`, `--repo`, and `--transport`.
+Use `gitcode-api serve -h` for defaults such as `--owner`, `--repo`, `--transport` (`stdio`, `http`, or `sse`), and other options.
 
 Commands mirror the synchronous resource methods on `GitCode`, using the pattern
 `gitcode-api <resource> <method> ...`. For methods that accept extra `**params`
 or `**payload`, pass repeated `--set key=value` flags or `--set-json '{"key": "value"}'`.
 
+When using string arguments with escape sequence (such as line break `\n`), pass `-e` / `--escape` with the sequences to un-escape, such as `-e '\n\t'`.
+
 ## Quick Start
 
 ### Sync client

{gitcode_api-1.2.11 → gitcode_api-1.2.13}/gitcode_api/_models.py

@@ -2171,6 +2171,23 @@ class RepoMemberPermission(APIObject):
     permission: Optional[str] = None
 
 
+@dataclass(init=False)
+class ReleaseAsset(APIObject):
+    """Asset metadata embedded in release payloads.
+
+    :ivar browser_download_url: Browser download URL for this asset.
+    :vartype browser_download_url: Optional[str]
+    :ivar name: Asset file name.
+    :vartype name: Optional[str]
+    :ivar type: Asset media type.
+    :vartype type: Optional[str]
+    """
+
+    browser_download_url: Optional[str] = None
+    name: Optional[str] = None
+    type: Optional[str] = None
+
+
 @dataclass(init=False)
 class Release(APIObject):
     """Release payload.
@@ -2179,6 +2196,10 @@ class Release(APIObject):
     :vartype id: Optional[Union[int, str]]
     :ivar tag_name: Tag name.
     :vartype tag_name: Optional[str]
+    :ivar target_commitish: Branch or commit SHA targeted by the release tag.
+    :vartype target_commitish: Optional[str]
+    :ivar prerelease: Whether this release is a pre-release.
+    :vartype prerelease: Optional[bool]
     :ivar name: Display name.
     :vartype name: Optional[str]
     :ivar body: Body text of the object.
@@ -2191,16 +2212,38 @@ class Release(APIObject):
     :vartype published_at: Optional[str]
     :ivar html_url: Web URL for this object.
     :vartype html_url: Optional[str]
+    :ivar assets: Release source packages and uploaded attachments.
+    :vartype assets: Optional[List[ReleaseAsset]]
+    :ivar release_status: Release status, for example ``pre`` or ``latest``.
+    :vartype release_status: Optional[str]
     """
 
     id: Optional[Union[int, str]] = None
     tag_name: Optional[str] = None
+    target_commitish: Optional[str] = None
+    prerelease: Optional[bool] = None
     name: Optional[str] = None
     body: Optional[str] = None
     author: Optional[UserRef] = None
     created_at: Optional[str] = None
     published_at: Optional[str] = None
     html_url: Optional[str] = None
+    assets: Optional[List[ReleaseAsset]] = None
+    release_status: Optional[str] = None
+
+
+@dataclass(init=False)
+class ReleaseUploadURL(APIObject):
+    """Pre-signed release attachment upload target.
+
+    :ivar url: Pre-signed object storage URL for uploading with ``PUT``.
+    :vartype url: Optional[str]
+    :ivar headers: Headers to send unchanged with the upload request.
+    :vartype headers: Optional[Dict[str, str]]
+    """
+
+    url: Optional[str] = None
+    headers: Optional[Dict[str, str]] = None
 
 
 @dataclass(init=False)

{gitcode_api-1.2.11 → gitcode_api-1.2.13}/gitcode_api/cli.py

@@ -1,6 +1,7 @@
 """Command-line interface for the GitCode SDK."""
 
 import argparse
+import codecs
 import inspect
 import json
 import re
@@ -8,7 +9,7 @@ import sys
 import textwrap
 from collections.abc import Mapping, Sequence
 from pathlib import Path
-from typing import Any, List, Optional, Union, get_args, get_origin
+from typing import Any, Dict, List, Optional, Union, get_args, get_origin
 
 import httpx
 
@@ -36,6 +37,40 @@ def _plain_cli_inline(text: str) -> str:
     return t
 
 
+_ESCAPE_PATTERN = re.compile(r"\\\w+")
+
+
+def _unescape_input(value: str, replacements: Dict[str, str]) -> str:
+    """Unescape CLI input with provided escape sequences."""
+    for token, decoded in replacements.items():
+        value = value.replace(token, decoded)
+    return value
+
+
+def _unescape_namespace(args: argparse.Namespace) -> None:
+    mapping = ((token, codecs.decode(token, "unicode-escape")) for token in _ESCAPE_PATTERN.findall(str(args.escape)))
+    replacements = {token: decoded for token, decoded in mapping if token and (token != decoded)}
+    if not replacements:
+        raise argparse.ArgumentTypeError("No valid escape sequence provided!")
+    for key, value in vars(args).items():
+        if key in {"escape", "base_url", "resource", "method", "api_key"}:
+            continue
+        if isinstance(value, str):
+            setattr(args, key, _unescape_input(value, replacements=replacements))
+            continue
+        if isinstance(value, list):
+            updated = []
+            changed = False
+            for item in value:
+                if isinstance(item, str):
+                    updated.append(_unescape_input(item, replacements=replacements))
+                    changed = True
+                else:
+                    updated.append(item)
+            if changed:
+                setattr(args, key, updated)
+
+
 def _unwrap_optional(annotation: Any) -> Any:
     origin = get_origin(annotation)
     if origin is Union:
@@ -179,12 +214,17 @@ def _invocation_parent_parser() -> argparse.ArgumentParser:
     """Parser with flags for real API calls (attached only to leaf METHOD parsers, not top-level usage)."""
     parser = argparse.ArgumentParser(add_help=False)
     parser.add_argument("--api-key", help=f"GitCode access token. Defaults to {DEFAULT_TOKEN_ENV}.")
-    parser.add_argument("--owner", help="Default repository owner.")
-    parser.add_argument("--repo", help="Default repository name.")
     parser.add_argument("--base-url", default=DEFAULT_BASE_URL, help="Base URL for the REST API.")
     parser.add_argument("--timeout", type=float, default=None, help="Request timeout in seconds.")
     parser.add_argument("--output-file", help="Write the response to a file instead of stdout.")
     parser.add_argument("--compact", action="store_true", help="Print JSON without indentation.")
+    parser.add_argument(
+        "-e",
+        "--escape",
+        default="",
+        metavar="SEQUENCES",
+        help='Unescape certain escape sequences (e.g. -e "\\n\\t") in arguments.',
+    )
     return parser
 
 
@@ -192,6 +232,15 @@ def _root_banner() -> str:
     return "Connection and defaults are documented on each method's help: %(prog)s RESOURCE METHOD -h."
 
 
+def _parse_true_false(raw: str) -> bool:
+    value = raw.strip().lower()
+    if value == "true":
+        return True
+    if value == "false":
+        return False
+    raise argparse.ArgumentTypeError("Expected 'true' or 'false'.")
+
+
 def _serve_parser() -> argparse.ArgumentParser:
     """Parser with options for starting the bundled MCP server."""
     parser = argparse.ArgumentParser(add_help=False)
@@ -201,10 +250,25 @@ def _serve_parser() -> argparse.ArgumentParser:
     parser.add_argument("--repo", help="Default repository name.")
     parser.add_argument("--base-url", default=DEFAULT_BASE_URL, help="Base URL for the REST API.")
     parser.add_argument("--timeout", type=float, default=None, help="Request timeout in seconds.")
-    parser.add_argument("--transport", default="stdio", help="FastMCP transport to run, such as stdio or http.")
+    parser.add_argument(
+        "--transport",
+        default="stdio",
+        choices=("stdio", "http", "sse"),
+        metavar="{stdio,http,sse}",
+        help="FastMCP transport to run, such as stdio or http.",
+    )
     parser.add_argument("--host", default=None, help="Host for HTTP-based transports.")
     parser.add_argument("--port", type=int, default=None, help="Port for HTTP-based transports.")
     parser.add_argument("--path", default=None, help="Path for HTTP-based transports.")
+    parser.add_argument(
+        "-b",
+        "--show-banner",
+        type=_parse_true_false,
+        choices=(True, False),
+        default=None,
+        metavar="{true,false}",
+        help="Show the FastMCP startup banner.",
+    )
     return parser
 
 
@@ -356,7 +420,7 @@ def _run_mcp_server(args: argparse.Namespace) -> int:
         if value is not None:
             run_kwargs[key] = value
 
-    server.run(**run_kwargs)
+    server.run(show_banner=args.show_banner, **run_kwargs)
     return 0
 
 
@@ -402,6 +466,9 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
             parser.epilog = saved_epilog
         return 0
     args = parser.parse_args(effective)
+    escape_seq = getattr(args, "escape", None)
+    if escape_seq and isinstance(escape_seq, str):
+        _unescape_namespace(args)
 
     try:
         if getattr(args, "command", None) == "serve":
@@ -409,8 +476,6 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
 
         with GitCode(
             api_key=args.api_key,
-            owner=args.owner,
-            repo=args.repo,
             base_url=args.base_url,
             timeout=args.timeout,
         ) as client:

{gitcode_api-1.2.11 → gitcode_api-1.2.13}/gitcode_api/resources/misc.py

@@ -1,39 +1,128 @@
 """Release, tag, and webhook resource groups."""
 
+from pathlib import Path
 from typing import List, Optional, Union
 
-from .._models import ProtectedTag, Release, Tag, Webhook
+from .._models import ProtectedTag, Release, ReleaseUploadURL, Tag, Webhook
 from ._shared import AsyncResource, SyncResource
 
 
 class ReleasesResource(SyncResource):
     """Synchronous release endpoints."""
 
+    def create(
+        self,
+        *,
+        tag: str,
+        name: str,
+        body: str,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        target_commitish: Optional[str] = None,
+        release_status: Optional[str] = None,
+    ) -> Release:
+        """Create a repository release.
+
+        :param tag: Tag name for the release.
+        :param name: Release title.
+        :param body: Release description.
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :param target_commitish: Branch name or commit SHA for creating a missing tag.
+        :param release_status: Release status, such as ``pre`` or ``latest``.
+        :returns: Created release payload.
+        """
+        return self._model(
+            "POST",
+            self._client._repo_path("releases", owner=owner, repo=repo),
+            Release,
+            json={
+                "tag_name": tag,
+                "name": name,
+                "body": body,
+                "target_commitish": target_commitish,
+                "release_status": release_status,
+            },
+        )
+
     def update(
         self,
         *,
-        release_id: Union[int, str],
-        tag_name: str,
+        tag: str,
         name: str,
         body: str,
         owner: Optional[str] = None,
         repo: Optional[str] = None,
+        release_status: Optional[str] = None,
     ) -> Release:
         """Update a repository release.
 
-        :param release_id: Release identifier.
-        :param tag_name: Tag name for the release.
+        :param tag: Tag name in the release URL path.
         :param name: Release name.
         :param body: Release description.
         :param owner: Repository owner path. Uses the client default when omitted.
-        :param repo: Repository name. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :param release_status: Release status, such as ``pre`` or ``latest``.
         :returns: Updated release payload.
         """
         return self._model(
             "PATCH",
-            self._client._repo_path("releases", release_id, owner=owner, repo=repo),
+            self._client._repo_path("releases", tag, owner=owner, repo=repo),
             Release,
-            json={"tag_name": tag_name, "name": name, "body": body},
+            json={"name": name, "body": body, "release_status": release_status},
+        )
+
+    def get_upload_url(
+        self, *, tag: str, file_name: str, owner: Optional[str] = None, repo: Optional[str] = None
+    ) -> ReleaseUploadURL:
+        """Get a pre-signed URL for uploading a release attachment.
+
+        :param tag: Tag name in the release URL path.
+        :param file_name: Attachment file name to upload.
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :returns: Upload URL and required headers.
+        """
+        return self._model(
+            "GET",
+            self._client._repo_path("releases", tag, "upload_url", owner=owner, repo=repo),
+            ReleaseUploadURL,
+            params={"file_name": file_name},
+        )
+
+    def upload(
+        self,
+        *,
+        tag: str,
+        file_name: str,
+        content: Union[bytes, str],
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        upload_timeout: Optional[float] = 300.0,
+    ) -> None:
+        """Upload a release attachment through the pre-signed upload URL.
+
+        :param tag: Tag name in the release URL path.
+        :param file_name: Attachment file name to upload.
+        :param content: Attachment bytes, or a local file path to read as bytes.
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :param upload_timeout: Timeout for upload operation. Default to 300 (5 minutes).
+        """
+        upload_content = Path(content).read_bytes() if isinstance(content, str) else content
+        if not isinstance(upload_content, bytes):
+            raise TypeError("content must be bytes or a file path string.")
+
+        upload_url = self.get_upload_url(tag=tag, file_name=file_name, owner=owner, repo=repo)
+        if not upload_url.url:
+            raise ValueError("Release upload URL response did not include a URL.")
+
+        self._client._client.request(
+            "PUT",
+            upload_url.url,
+            content=upload_content,
+            headers=upload_url.headers or {},
+            timeout=upload_timeout,
         )
 
     def get_by_tag(self, *, tag: str, owner: Optional[str] = None, repo: Optional[str] = None) -> Release:
@@ -50,14 +139,87 @@ class ReleasesResource(SyncResource):
             Release,
         )
 
-    def list(self, *, owner: Optional[str] = None, repo: Optional[str] = None) -> List[Release]:
+    def list(
+        self,
+        *,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+    ) -> List[Release]:
         """List releases for a repository.
 
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository path. Uses the client default when omitted.
+        :param direction: Sort direction, for example ``asc`` or ``desc``.
+        :param page: Page number.
+        :param per_page: Page size, up to 100.
         :returns: Releases ordered as returned by the API.
         """
-        return self._models("GET", self._client._repo_path("releases", owner=owner, repo=repo), Release)
+        return self._models(
+            "GET",
+            self._client._repo_path("releases", owner=owner, repo=repo),
+            Release,
+            params={"direction": direction, "page": page, "per_page": per_page},
+        )
+
+    def get_latest(
+        self, *, owner: Optional[str] = None, repo: Optional[str] = None, type: Optional[str] = None
+    ) -> Release:
+        """Get the latest repository release.
+
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :param type: Selection type, either ``updated`` or ``latest``.
+        :returns: Latest release metadata.
+        """
+        return self._model(
+            "GET",
+            self._client._repo_path("releases", "latest", owner=owner, repo=repo),
+            Release,
+            params={"type": type},
+        )
+
+    def get(
+        self,
+        *,
+        tag: str,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        temp_download_url: Optional[Union[bool, str]] = None,
+    ) -> Release:
+        """Get a repository release by tag path.
+
+        :param tag: Tag name in the release URL path.
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :param temp_download_url: Whether to return temporary source package and attachment URLs.
+        :returns: Release metadata.
+        """
+        return self._model(
+            "GET",
+            self._client._repo_path("releases", tag, owner=owner, repo=repo),
+            Release,
+            params={"temp_download_url": temp_download_url},
+        )
+
+    def download_attachment(
+        self, *, tag: str, file_name: str, owner: Optional[str] = None, repo: Optional[str] = None
+    ) -> bytes:
+        """Download a release attachment as bytes.
+
+        :param tag: Tag name in the release URL path.
+        :param file_name: Attachment file name.
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :returns: Attachment bytes.
+        """
+        return self._request(
+            "GET",
+            self._client._repo_path("releases", tag, "attach_files", file_name, "download", owner=owner, repo=repo),
+            raw=True,
+        )
 
 
 class TagsResource(SyncResource):
@@ -288,31 +450,119 @@ class AsyncReleasesResource(AsyncResource):
     Mirrors :class:`ReleasesResource`; see that class for parameters (Release API in ``docs/rest_api``).
     """
 
+    async def create(
+        self,
+        *,
+        tag: str,
+        name: str,
+        body: str,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        target_commitish: Optional[str] = None,
+        release_status: Optional[str] = None,
+    ) -> Release:
+        """Create a repository release.
+
+        :param tag: Tag name for the release.
+        :param name: Release title.
+        :param body: Release description.
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :param target_commitish: Branch name or commit SHA for creating a missing tag.
+        :param release_status: Release status, such as ``pre`` or ``latest``.
+        :returns: Created release payload.
+        """
+        return await self._model(
+            "POST",
+            self._client._repo_path("releases", owner=owner, repo=repo),
+            Release,
+            json={
+                "tag_name": tag,
+                "name": name,
+                "body": body,
+                "target_commitish": target_commitish,
+                "release_status": release_status,
+            },
+        )
+
     async def update(
         self,
         *,
-        release_id: Union[int, str],
-        tag_name: str,
+        tag: str,
         name: str,
         body: str,
         owner: Optional[str] = None,
         repo: Optional[str] = None,
+        release_status: Optional[str] = None,
     ) -> Release:
         """Update a repository release.
 
-        :param release_id: Release identifier.
-        :param tag_name: Tag name for the release.
+        :param tag: Tag name in the release URL path.
         :param name: Release name.
         :param body: Release description.
         :param owner: Repository owner path. Uses the client default when omitted.
-        :param repo: Repository name. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :param release_status: Release status, such as ``pre`` or ``latest``.
         :returns: Updated release payload.
         """
         return await self._model(
             "PATCH",
-            self._client._repo_path("releases", release_id, owner=owner, repo=repo),
+            self._client._repo_path("releases", tag, owner=owner, repo=repo),
             Release,
-            json={"tag_name": tag_name, "name": name, "body": body},
+            json={"name": name, "body": body, "release_status": release_status},
+        )
+
+    async def get_upload_url(
+        self, *, tag: str, file_name: str, owner: Optional[str] = None, repo: Optional[str] = None
+    ) -> ReleaseUploadURL:
+        """Get a pre-signed URL for uploading a release attachment.
+
+        :param tag: Tag name in the release URL path.
+        :param file_name: Attachment file name to upload.
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :returns: Upload URL and required headers.
+        """
+        return await self._model(
+            "GET",
+            self._client._repo_path("releases", tag, "upload_url", owner=owner, repo=repo),
+            ReleaseUploadURL,
+            params={"file_name": file_name},
+        )
+
+    async def upload(
+        self,
+        *,
+        tag: str,
+        file_name: str,
+        content: Union[bytes, str],
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        upload_timeout: Optional[float] = 300.0,
+    ) -> None:
+        """Upload a release attachment through the pre-signed upload URL.
+
+        :param tag: Tag name in the release URL path.
+        :param file_name: Attachment file name to upload.
+        :param content: Attachment bytes, or a local file path to read as bytes.
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :param upload_timeout: Timeout for upload operation. Default to 300 (5 minutes).
+        """
+        upload_content = Path(content).read_bytes() if isinstance(content, str) else content
+        if not isinstance(upload_content, bytes):
+            raise TypeError("content must be bytes or a file path string.")
+
+        upload_url = await self.get_upload_url(tag=tag, file_name=file_name, owner=owner, repo=repo)
+        if not upload_url.url:
+            raise ValueError("Release upload URL response did not include a URL.")
+
+        await self._client._client.request(
+            "PUT",
+            upload_url.url,
+            content=upload_content,
+            headers=upload_url.headers or {},
+            timeout=upload_timeout,
         )
 
     async def get_by_tag(self, *, tag: str, owner: Optional[str] = None, repo: Optional[str] = None) -> Release:
@@ -327,14 +577,87 @@ class AsyncReleasesResource(AsyncResource):
             "GET", self._client._repo_path("releases", "tags", tag, owner=owner, repo=repo), Release
         )
 
-    async def list(self, *, owner: Optional[str] = None, repo: Optional[str] = None) -> List[Release]:
+    async def list(
+        self,
+        *,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+    ) -> List[Release]:
         """List releases for a repository.
 
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository path. Uses the client default when omitted.
+        :param direction: Sort direction, for example ``asc`` or ``desc``.
+        :param page: Page number.
+        :param per_page: Page size, up to 100.
         :returns: Releases ordered as returned by the API.
         """
-        return await self._models("GET", self._client._repo_path("releases", owner=owner, repo=repo), Release)
+        return await self._models(
+            "GET",
+            self._client._repo_path("releases", owner=owner, repo=repo),
+            Release,
+            params={"direction": direction, "page": page, "per_page": per_page},
+        )
+
+    async def get_latest(
+        self, *, owner: Optional[str] = None, repo: Optional[str] = None, type: Optional[str] = None
+    ) -> Release:
+        """Get the latest repository release.
+
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :param type: Selection type, either ``updated`` or ``latest``.
+        :returns: Latest release metadata.
+        """
+        return await self._model(
+            "GET",
+            self._client._repo_path("releases", "latest", owner=owner, repo=repo),
+            Release,
+            params={"type": type},
+        )
+
+    async def get(
+        self,
+        *,
+        tag: str,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        temp_download_url: Optional[Union[bool, str]] = None,
+    ) -> Release:
+        """Get a repository release by tag path.
+
+        :param tag: Tag name in the release URL path.
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :param temp_download_url: Whether to return temporary source package and attachment URLs.
+        :returns: Release metadata.
+        """
+        return await self._model(
+            "GET",
+            self._client._repo_path("releases", tag, owner=owner, repo=repo),
+            Release,
+            params={"temp_download_url": temp_download_url},
+        )
+
+    async def download_attachment(
+        self, *, tag: str, file_name: str, owner: Optional[str] = None, repo: Optional[str] = None
+    ) -> bytes:
+        """Download a release attachment as bytes.
+
+        :param tag: Tag name in the release URL path.
+        :param file_name: Attachment file name.
+        :param owner: Repository owner path. Uses the client default when omitted.
+        :param repo: Repository path. Uses the client default when omitted.
+        :returns: Attachment bytes.
+        """
+        return await self._request(
+            "GET",
+            self._client._repo_path("releases", tag, "attach_files", file_name, "download", owner=owner, repo=repo),
+            raw=True,
+        )
 
 
 class AsyncTagsResource(AsyncResource):

{gitcode_api-1.2.11 → gitcode_api-1.2.13}/gitcode_api/run_mcp.py

@@ -3,4 +3,4 @@
 from gitcode_api.llm.mcp import GitCodeMCP
 
 if __name__ == "__main__":
-    GitCodeMCP().mcp.run()
+    GitCodeMCP().mcp.run(show_banner=False)

gitcode_api-1.2.13/gitcode_api/version.txt

@@ -0,0 +1 @@
+1.2.13

{gitcode_api-1.2.11 → gitcode_api-1.2.13}/gitcode_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.11
+Version: 1.2.13
 Summary: Easy to use Python SDK for the GitCode REST API. Providing builtin CLI tool, and optional LLM integration (MCP, OpenAI tool, and openJiuwen tool) for agents. Community-maintained.
 Author-email: Hugo Huang <hugo@hugohuang.com>
 License-Expression: MIT
@@ -9,7 +9,7 @@ Project-URL: issues, https://github.com/Trenza1ore/GitCode-API/issues
 Project-URL: documentation, https://gitcode-api.readthedocs.io
 Project-URL: gitcode, https://gitcode.com/SushiNinja/GitCode-API
 Project-URL: github, https://github.com/Trenza1ore/GitCode-API
-Project-URL: homepage, https://linktr.ee/Hugoooo
+Project-URL: homepage, https://hugohuang.com/gitcode-api
 Project-URL: author, https://hugohuang.com
 Keywords: gitcode,git,devops,api,sdk,python,httpx,client,mcp,agent,fastmcp,llm,openjiuwen,mcp client,mcp server,model context protocol
 Classifier: Development Status :: 4 - Beta
@@ -37,7 +37,7 @@ Dynamic: license-file
 
 # GitCode-API
 
-[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F)](https://pypi.org/project/gitcode-api) [![PyPI Downloads](https://static.pepy.tech/personalized-badge/gitcode-api?period=total&units=INTERNATIONAL_SYSTEM&left_color=GRAY&right_color=RED&left_text=downloads)](https://pepy.tech/projects/gitcode-api) [![CodeFactor](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api/badge)](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=d15040ff268342bca07ad60f812924a7)](https://pypi.org/project/gitcode-api) [![PyPI Downloads](https://static.pepy.tech/personalized-badge/gitcode-api?period=total&units=INTERNATIONAL_SYSTEM&left_color=GRAY&right_color=RED&left_text=downloads&uuid=b7f4a02b5f3e4776bd62a22cc539074b)](https://pepy.tech/projects/gitcode-api) [![CodeFactor](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api/badge)](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api)
 [![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?logoColor=white)](https://cursor.com/en/install-mcp?name=GitCode%20API&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXRjb2RlLWFwaVttY3BdIiwiZ2l0Y29kZS1hcGkiLCJzZXJ2ZSJdLCJlbnYiOnsiR0lUQ09ERV9BQ0NFU1NfVE9LRU4iOiIke2lucHV0OmdpdGNvZGVfYWNjZXNzX3Rva2VufSJ9LCJpbnB1dHMiOlt7ImlkIjoiZ2l0Y29kZV9hY2Nlc3NfdG9rZW4iLCJ0eXBlIjoicHJvbXB0U3RyaW5nIiwiZGVzY3JpcHRpb24iOiJFbnRlciBHSVRDT0RFX0FDQ0VTU19UT0tFTiIsInBhc3N3b3JkIjp0cnVlfV19) [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=GitCode%20API&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22gitcode-api%5Bmcp%5D%22%2C%22gitcode-api%22%2C%22serve%22%5D%2C%22env%22%3A%7B%22GITCODE_ACCESS_TOKEN%22%3A%22%24%7Binput%3Agitcode_access_token%7D%22%7D%2C%22inputs%22%3A%5B%7B%22id%22%3A%22gitcode_access_token%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22Enter%20GITCODE_ACCESS_TOKEN%22%2C%22password%22%3Atrue%7D%5D%7D)
 [![GitHub Badge](https://img.shields.io/badge/github-repo-blue?logo=github&link=https%3A%2F%2Fgithub.com%2FTrenza1ore%2FGitCode-API)](https://github.com/Trenza1ore/GitCode-API) [![GitCode Badge](https://img.shields.io/badge/gitcode-repo-brown?logo=gitcode&link=https%3A%2F%2Fgitcode.com%2FSushiNinja%2FGitCode-API)](https://gitcode.com/SushiNinja/GitCode-API)
 
@@ -111,12 +111,14 @@ With `gitcode-api[mcp]` installed (Python 3.10+), you can start the bundled Fast
 gitcode-api serve --api-key "$GITCODE_ACCESS_TOKEN"
 ```
 
-Use `gitcode-api serve -h` for defaults such as `--owner`, `--repo`, and `--transport`.
+Use `gitcode-api serve -h` for defaults such as `--owner`, `--repo`, `--transport` (`stdio`, `http`, or `sse`), and other options.
 
 Commands mirror the synchronous resource methods on `GitCode`, using the pattern
 `gitcode-api <resource> <method> ...`. For methods that accept extra `**params`
 or `**payload`, pass repeated `--set key=value` flags or `--set-json '{"key": "value"}'`.
 
+When using string arguments with escape sequence (such as line break `\n`), pass `-e` / `--escape` with the sequences to un-escape, such as `-e '\n\t'`.
+
 ## Quick Start
 
 ### Sync client

{gitcode_api-1.2.11 → gitcode_api-1.2.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gitcode-api"
-version = "1.2.11"
+version = "1.2.13"
 description = "Easy to use Python SDK for the GitCode REST API. Providing builtin CLI tool, and optional LLM integration (MCP, OpenAI tool, and openJiuwen tool) for agents. Community-maintained."
 keywords = [
     "gitcode", "git", "devops", "api", "sdk", "python", "httpx", "client",
@@ -64,11 +64,19 @@ binary = [
     "pyinstaller>=6.0,<7",
 ]
 
+# FastMCP
 mcp = [
     "fastmcp; python_version >= '3.10'",
 ]
 
-dev = [{ include-group = "test" }, { include-group = "format" }, { include-group = "docs" }]
+dev = [
+    { include-group = "test" },
+    { include-group = "format" },
+    { include-group = "docs" },
+    "githubkit>=0.15.4",
+    "openai",
+    "setuptools",
+]
 
 [project.urls]
 changelog = "https://gitcode-api.readthedocs.io/en/latest/changelog.html"
@@ -76,14 +84,14 @@ issues = "https://github.com/Trenza1ore/GitCode-API/issues"
 documentation = "https://gitcode-api.readthedocs.io"
 gitcode = "https://gitcode.com/SushiNinja/GitCode-API"
 github = "https://github.com/Trenza1ore/GitCode-API"
-homepage = "https://linktr.ee/Hugoooo"
+homepage = "https://hugohuang.com/gitcode-api"
 author = "https://hugohuang.com"
 
 [project.scripts]
 gitcode-api = "gitcode_api.cli:main"
 
 [tool.uv]
-default-groups = ['test']
+default-groups = ['dev']
 
 [tool.setuptools.package-data]
 gitcode_api = ["**/version.txt"]

{gitcode_api-1.2.11 → gitcode_api-1.2.13}/tests/test_cli.py

@@ -161,12 +161,14 @@ def test_run_mcp_server_passes_fastmcp_options(monkeypatch: Any) -> None:
         host="127.0.0.1",
         port=8000,
         path="/mcp",
+        show_banner=None,
     )
 
     assert _run_mcp_server(args) == 0
     assert captured["server_kwargs"]["name"] == "GitCode API"
     assert captured["server_kwargs"]["tool"]._client_kwargs["api_key"] == "test-token"
     assert captured["run_kwargs"] == {
+        "show_banner": None,
         "transport": "http",
         "host": "127.0.0.1",
         "port": 8000,

gitcode_api-1.2.13/tests/test_resources_misc.py

@@ -0,0 +1,280 @@
+import json
+from typing import Optional
+
+import httpx
+import pytest
+
+from gitcode_api._models import ReleaseAsset, ReleaseUploadURL
+
+RELEASE_PAYLOAD = {
+    "tag_name": "v1.0.0",
+    "target_commitish": "main",
+    "prerelease": False,
+    "name": "v1.0.0",
+    "body": "Release notes",
+    "author": {"id": "1", "login": "octo", "name": "Octo", "avatar_url": "https://example.com/a.png"},
+    "created_at": "2026-05-12T10:00:00+08:00",
+    "assets": [
+        {"browser_download_url": "https://example.com/checksums.txt", "name": "checksums.txt", "type": "text/plain"}
+    ],
+    "release_status": "latest",
+}
+
+
+def test_labels_list_enterprise_v8_uses_absolute_versioned_url(sync_client_factory) -> None:
+    seen_url: Optional[str] = None
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        nonlocal seen_url
+        seen_url = str(request.url)
+        return httpx.Response(200, json=[{"name": "bug", "color": "#f00"}])
+
+    client, http_client = sync_client_factory(handler, base_url="https://api.gitcode.com/api/v5")
+    try:
+        labels = client.labels.list_enterprise(enterprise="SushiNinja", api_version="v8", search="bug")
+        assert labels[0].name == "bug"
+        assert seen_url == "https://api.gitcode.com/api/v8/enterprises/SushiNinja/labels?search=bug"
+    finally:
+        client.close()
+        http_client.close()
+
+
+@pytest.mark.asyncio
+async def test_async_webhooks_test_hits_expected_endpoint(async_client_factory) -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        assert request.method == "POST"
+        assert request.url.path == "/api/v5/repos/SushiNinja/GitCode-API/hooks/44/tests"
+        return httpx.Response(204)
+
+    client, http_client = async_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
+    try:
+        result = await client.webhooks.test(hook_id=44)
+        assert result is None
+    finally:
+        await client.close()
+        await http_client.aclose()
+
+
+def test_releases_create_posts_documented_payload_and_models_assets(sync_client_factory) -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        assert request.method == "POST"
+        assert request.url.path == "/api/v5/repos/SushiNinja/GitCode-API/releases"
+        assert json.loads(request.content) == {
+            "tag_name": "v1.0.0",
+            "name": "v1.0.0",
+            "body": "Release notes",
+            "target_commitish": "main",
+            "release_status": "latest",
+        }
+        return httpx.Response(200, json=RELEASE_PAYLOAD, request=request)
+
+    client, http_client = sync_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
+    try:
+        release = client.releases.create(
+            tag_name="v1.0.0",
+            name="v1.0.0",
+            body="Release notes",
+            target_commitish="main",
+            release_status="latest",
+        )
+    finally:
+        client.close()
+        http_client.close()
+
+    assert release.target_commitish == "main"
+    assert release.prerelease is False
+    assert release.release_status == "latest"
+    assert release.assets is not None
+    assert isinstance(release.assets[0], ReleaseAsset)
+    assert release.assets[0].browser_download_url == "https://example.com/checksums.txt"
+
+
+def test_releases_update_uses_tag_path_and_documented_payload(sync_client_factory) -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        assert request.method == "PATCH"
+        assert request.url.path == "/api/v5/repos/SushiNinja/GitCode-API/releases/v1.0.0"
+        assert json.loads(request.content) == {
+            "name": "v1.0.0",
+            "body": "Updated notes",
+            "release_status": "pre",
+        }
+        return httpx.Response(200, json={**RELEASE_PAYLOAD, "body": "Updated notes", "release_status": "pre"})
+
+    client, http_client = sync_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
+    try:
+        release = client.releases.update(tag="v1.0.0", name="v1.0.0", body="Updated notes", release_status="pre")
+    finally:
+        client.close()
+        http_client.close()
+
+    assert release.body == "Updated notes"
+    assert release.release_status == "pre"
+
+
+def test_releases_list_sends_documented_query_params(sync_client_factory) -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        assert request.method == "GET"
+        assert request.url.path == "/api/v5/repos/SushiNinja/GitCode-API/releases"
+        assert request.url.params["direction"] == "desc"
+        assert request.url.params["page"] == "2"
+        assert request.url.params["per_page"] == "50"
+        return httpx.Response(200, json=[RELEASE_PAYLOAD], request=request)
+
+    client, http_client = sync_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
+    try:
+        releases = client.releases.list(direction="desc", page=2, per_page=50)
+    finally:
+        client.close()
+        http_client.close()
+
+    assert releases[0].tag_name == "v1.0.0"
+
+
+def test_releases_get_upload_url_returns_model(sync_client_factory) -> None:
+    payload = {
+        "url": "https://obs.example.com/upload",
+        "headers": {"x-obs-acl": "public-read", "Content-Type": "application/pdf"},
+    }
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        assert request.method == "GET"
+        assert request.url.path == "/api/v5/repos/SushiNinja/GitCode-API/releases/v1.0.0/upload_url"
+        assert request.url.params["file_name"] == "notes.pdf"
+        return httpx.Response(200, json=payload, request=request)
+
+    client, http_client = sync_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
+    try:
+        upload_url = client.releases.get_upload_url(tag="v1.0.0", file_name="notes.pdf")
+    finally:
+        client.close()
+        http_client.close()
+
+    assert isinstance(upload_url, ReleaseUploadURL)
+    assert upload_url.url == "https://obs.example.com/upload"
+    assert upload_url.headers == payload["headers"]
+
+
+def test_releases_upload_puts_file_content_to_presigned_url(sync_client_factory, tmp_path) -> None:
+    upload_path = tmp_path / "notes.pdf"
+    upload_path.write_bytes(b"pdf-bytes")
+    seen_upload = False
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        nonlocal seen_upload
+        if request.method == "GET":
+            assert request.url.path == "/api/v5/repos/SushiNinja/GitCode-API/releases/v1.0.0/upload_url"
+            assert request.url.params["file_name"] == "notes.pdf"
+            upload_path.write_bytes(b"mutated-after-upload-url-request")
+            return httpx.Response(
+                200,
+                json={
+                    "url": "https://obs.example.com/upload",
+                    "headers": {"x-obs-acl": "public-read", "Content-Type": "application/pdf"},
+                },
+                request=request,
+            )
+
+        assert request.method == "PUT"
+        assert str(request.url) == "https://obs.example.com/upload"
+        assert "authorization" not in request.headers
+        assert request.headers["x-obs-acl"] == "public-read"
+        assert request.headers["content-type"] == "application/pdf"
+        assert request.content == b"pdf-bytes"
+        seen_upload = True
+        return httpx.Response(200, request=request)
+
+    client, http_client = sync_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
+    try:
+        result = client.releases.upload(tag="v1.0.0", file_name="notes.pdf", content=str(upload_path))
+    finally:
+        client.close()
+        http_client.close()
+
+    assert result is None
+    assert seen_upload is True
+
+
+def test_releases_upload_rejects_non_bytes_content_before_request(sync_client_factory) -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        raise AssertionError(f"Unexpected request: {request.method} {request.url}")
+
+    client, http_client = sync_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
+    try:
+        with pytest.raises(TypeError, match="content must be bytes or a file path string"):
+            client.releases.upload(tag="v1.0.0", file_name="notes.pdf", content=object())  # type: ignore[arg-type]
+    finally:
+        client.close()
+        http_client.close()
+
+
+def test_releases_download_attachment_returns_raw_bytes(sync_client_factory) -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        assert request.method == "GET"
+        assert request.url.path == (
+            "/api/v5/repos/SushiNinja/GitCode-API/releases/v1.0.0/attach_files/checksums.txt/download"
+        )
+        return httpx.Response(200, content=b"checksum-bytes", request=request)
+
+    client, http_client = sync_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
+    try:
+        content = client.releases.download_attachment(tag="v1.0.0", file_name="checksums.txt")
+    finally:
+        client.close()
+        http_client.close()
+
+    assert content == b"checksum-bytes"
+
+
+@pytest.mark.asyncio
+async def test_async_releases_get_upload_and_download_attachment(async_client_factory, tmp_path) -> None:
+    upload_path = tmp_path / "async-notes.pdf"
+    upload_path.write_bytes(b"async-pdf-bytes")
+    seen_upload = False
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        nonlocal seen_upload
+        if request.url.path.endswith("/download"):
+            assert request.method == "GET"
+            assert request.url.path == (
+                "/api/v5/repos/SushiNinja/GitCode-API/releases/v1.0.0/attach_files/checksums.txt/download"
+            )
+            return httpx.Response(200, content=b"async-checksum-bytes", request=request)
+
+        if request.method == "PUT":
+            assert str(request.url) == "https://obs.example.com/async-upload"
+            assert "authorization" not in request.headers
+            assert request.headers["x-obs-acl"] == "public-read"
+            assert request.content == b"async-pdf-bytes"
+            seen_upload = True
+            return httpx.Response(204, request=request)
+
+        if request.url.path.endswith("/upload_url"):
+            assert request.method == "GET"
+            upload_path.write_bytes(b"mutated-async-pdf-bytes")
+            return httpx.Response(
+                200,
+                json={
+                    "url": "https://obs.example.com/async-upload",
+                    "headers": {"x-obs-acl": "public-read", "Content-Type": "application/pdf"},
+                },
+                request=request,
+            )
+
+        assert request.method == "GET"
+        assert request.url.path == "/api/v5/repos/SushiNinja/GitCode-API/releases/v1.0.0"
+        assert request.url.params["temp_download_url"] == "true"
+        return httpx.Response(200, json=RELEASE_PAYLOAD, request=request)
+
+    client, http_client = async_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
+    try:
+        release = await client.releases.get(tag="v1.0.0", temp_download_url="true")
+        result = await client.releases.upload(tag="v1.0.0", file_name="notes.pdf", content=str(upload_path))
+        content = await client.releases.download_attachment(tag="v1.0.0", file_name="checksums.txt")
+    finally:
+        await client.close()
+        await http_client.aclose()
+
+    assert release.tag_name == "v1.0.0"
+    assert result is None
+    assert seen_upload is True
+    assert content == b"async-checksum-bytes"

gitcode_api-1.2.11/gitcode_api/version.txt

@@ -1 +0,0 @@
-1.2.11

gitcode_api-1.2.11/tests/test_resources_misc.py

@@ -1,38 +0,0 @@
-from typing import Optional
-
-import httpx
-import pytest
-
-
-def test_labels_list_enterprise_v8_uses_absolute_versioned_url(sync_client_factory) -> None:
-    seen_url: Optional[str] = None
-
-    def handler(request: httpx.Request) -> httpx.Response:
-        nonlocal seen_url
-        seen_url = str(request.url)
-        return httpx.Response(200, json=[{"name": "bug", "color": "#f00"}])
-
-    client, http_client = sync_client_factory(handler, base_url="https://api.gitcode.com/api/v5")
-    try:
-        labels = client.labels.list_enterprise(enterprise="SushiNinja", api_version="v8", search="bug")
-        assert labels[0].name == "bug"
-        assert seen_url == "https://api.gitcode.com/api/v8/enterprises/SushiNinja/labels?search=bug"
-    finally:
-        client.close()
-        http_client.close()
-
-
-@pytest.mark.asyncio
-async def test_async_webhooks_test_hits_expected_endpoint(async_client_factory) -> None:
-    def handler(request: httpx.Request) -> httpx.Response:
-        assert request.method == "POST"
-        assert request.url.path == "/api/v5/repos/SushiNinja/GitCode-API/hooks/44/tests"
-        return httpx.Response(204)
-
-    client, http_client = async_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
-    try:
-        result = await client.webhooks.test(hook_id=44)
-        assert result is None
-    finally:
-        await client.close()
-        await http_client.aclose()