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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.12
+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
@@ -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&uuid=d541c73026c34c2a825a2dbefb55ce2c)](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=28b7f87502c04ba39f9cdbcff8d5d25d)](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)
 

{gitcode_api-1.2.12 → 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&uuid=d541c73026c34c2a825a2dbefb55ce2c)](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=28b7f87502c04ba39f9cdbcff8d5d25d)](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)
 

{gitcode_api-1.2.12 → 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.12 → 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.13/gitcode_api/version.txt

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

{gitcode_api-1.2.12 → 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.12
+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
@@ -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&uuid=d541c73026c34c2a825a2dbefb55ce2c)](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=28b7f87502c04ba39f9cdbcff8d5d25d)](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)
 

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

@@ -1,6 +1,6 @@
 [project]
 name = "gitcode-api"
-version = "1.2.12"
+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"
@@ -83,7 +91,7 @@ author = "https://hugohuang.com"
 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.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.12/gitcode_api/version.txt

@@ -1 +0,0 @@
-1.2.12

gitcode_api-1.2.12/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()