gitcode-api 1.2.11__py3-none-any.whl → 1.2.13__py3-none-any.whl

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/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/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/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/version.txt

@@ -1 +1 @@
-1.2.11
+1.2.13

{gitcode_api-1.2.11.dist-info → gitcode_api-1.2.13.dist-info}/METADATA

@@ -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.dist-info → gitcode_api-1.2.13.dist-info}/RECORD

@@ -5,11 +5,11 @@ gitcode_api/_base_resource.py,sha256=mlKe1b_1AKcqxhptaCpP-AOjKkLNzCbYG-Pkp1HYWrA
 gitcode_api/_cli_banner.py,sha256=3DsoJ2qZ-mWWB4yD-cnxDN_osXzrUKabrA5tbV6752M,978
 gitcode_api/_client.py,sha256=bmZxBHdfshM5Kv_EurHUVu8rsEj0k3Up3ATSIPaFrvc,8258
 gitcode_api/_exceptions.py,sha256=T5N8gBGmPSktDkLP5P_hxbzOHw3W378TzxN1xja40pA,1140
-gitcode_api/_models.py,sha256=v-GZzCGAb3_frY6wFiQww9m271U5MigivpEHDHnoDcI,109030
-gitcode_api/cli.py,sha256=7LLDRCKJg7avaLgIwckZZC5LewSpMPWNQFFDRhAQkEs,16616
+gitcode_api/_models.py,sha256=7MqQJSEZiXkqcBAKdaKUQN_I61QjkHRIJYIR70tYMWU,110559
+gitcode_api/cli.py,sha256=Z-X5gK8iI2wCEXqT-igVKpVzO4ZhaRYaxmTbqMbIUx8,18735
 gitcode_api/py.typed,sha256=mDShSrm8qg9qjacQc2F-rI8ATllqP6EdgHuEYxuCXZ0,7
-gitcode_api/run_mcp.py,sha256=a7zNrcAooGovzokJwTHQGj6iT4g7iltaUoD_E1KLvMg,130
-gitcode_api/version.txt,sha256=NzEMfzSBZRIsy59KhUwpSFOVuzrwZZulp3vgZsFRFnk,7
+gitcode_api/run_mcp.py,sha256=3_JOrjg9_yL-0M-H-F8mPgxdVKh7K2ggipu7UHeNCg0,147
+gitcode_api/version.txt,sha256=whaYM0seIwi4VWrB0QQCNCuNPoN_ZfocQx6yM5KCSx0,7
 gitcode_api/llm/__init__.py,sha256=rU75ZlJvTWNVxBLc3QzdfWmSjqVc9z6hfQ8z6jVVKOk,1693
 gitcode_api/llm/_tool.py,sha256=b65iUiHo1H29uA6mFM3WlD0zZlISsENx1tpEqlkiUoA,16239
 gitcode_api/llm/jiuwen.py,sha256=axwAcoG86XkPkN37PTh47Cdzwh3yACUpe4bTjlaAFDc,4244
@@ -19,11 +19,11 @@ gitcode_api/resources/__init__.py,sha256=nsCKW0bFDZ5ombJZxLThmO82sOuF7o4OKUMRkAm
 gitcode_api/resources/_shared.py,sha256=7bCym8bIfs818SiYYrBGI7-ZtiYlxECSDG3RduInu10,5387
 gitcode_api/resources/account.py,sha256=mnc2p7wI-nBnHFNdWPNiHfmZpT6d3RDQC777gewtm4M,38801
 gitcode_api/resources/collaboration.py,sha256=8lyk78GTjVXddiE9fieutsMGovRjteGfTJcAhwLoR0M,101607
-gitcode_api/resources/misc.py,sha256=guDwh4cxbTVsSa7EivaYM3bKMJ8_Op4KucGbKEoayKE,22412
+gitcode_api/resources/misc.py,sha256=w7bq8rmgKr2ScBKeWZ3EZJmAdylDdPtSPrhi3AQre7w,34747
 gitcode_api/resources/repositories.py,sha256=EAK2znZhEsgVUu-NDEQslSEEYJzvb-kHuh4mW57y6sc,78178
-gitcode_api-1.2.11.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
-gitcode_api-1.2.11.dist-info/METADATA,sha256=3VOsMVB8v0K7pMtOetkpLGH4UJjeF9R_QsEmF9GbZrs,22054
-gitcode_api-1.2.11.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gitcode_api-1.2.11.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
-gitcode_api-1.2.11.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
-gitcode_api-1.2.11.dist-info/RECORD,,
+gitcode_api-1.2.13.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
+gitcode_api-1.2.13.dist-info/METADATA,sha256=sqYMb5Au9bBv9TpDu8d6sK29DzIzl2XwsP3Mrllwfng,22335
+gitcode_api-1.2.13.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gitcode_api-1.2.13.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
+gitcode_api-1.2.13.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
+gitcode_api-1.2.13.dist-info/RECORD,,