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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.10
+Version: 1.2.12
 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=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)
 [![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
@@ -231,7 +233,7 @@ Every resource group inherits a cached `methods` property from the shared resour
 
 ## LLM tools, MCP, and openJiuwen
 
-The `gitcode_api.llm` module exposes a single logical tool, **`gitcode_api_tool`**, that routes calls to sync or async SDK resources. Model-facing parameters match the JSON schema used by OpenAI-style function tools:
+The `gitcode_api.llm` module exposes a single unified tool, **`gitcode_api_tool`**, that routes calls to respective sync or async SDK resource groups. Model-facing parameters match the JSON schema used by OpenAI-style function tools:
 
 | Parameter | Role |
 | --- | --- |

{gitcode_api-1.2.10 → gitcode_api-1.2.12}/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=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)
 [![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
@@ -194,7 +196,7 @@ Every resource group inherits a cached `methods` property from the shared resour
 
 ## LLM tools, MCP, and openJiuwen
 
-The `gitcode_api.llm` module exposes a single logical tool, **`gitcode_api_tool`**, that routes calls to sync or async SDK resources. Model-facing parameters match the JSON schema used by OpenAI-style function tools:
+The `gitcode_api.llm` module exposes a single unified tool, **`gitcode_api_tool`**, that routes calls to respective sync or async SDK resource groups. Model-facing parameters match the JSON schema used by OpenAI-style function tools:
 
 | Parameter | Role |
 | --- | --- |

{gitcode_api-1.2.10 → gitcode_api-1.2.12}/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.10 → gitcode_api-1.2.12}/gitcode_api/llm/__init__.py

@@ -3,6 +3,8 @@
 from importlib import import_module
 from typing import TYPE_CHECKING, Any, Dict
 
+from ._tool import GitCodeLLMTool
+
 if TYPE_CHECKING:
     from .jiuwen import create_openjiuwen_gitcode_api_tool
     from .mcp import (
@@ -25,7 +27,7 @@ _IMPORT_MAP = {
     "create_openjiuwen_gitcode_api_tool": ".jiuwen",
 }
 
-_IMPORT_CACHE: Dict[str, Any] = {}
+_IMPORT_CACHE: Dict[str, Any] = {"GitCodeLLMTool": GitCodeLLMTool}
 
 
 def __getattr__(name: str) -> object:
@@ -50,6 +52,7 @@ def __dir__() -> list[str]:
 
 
 __all__ = [
+    "GitCodeLLMTool",
     "GitCodeOpenAITool",
     "GitCodeMCP",
     "create_mcp_gitcode_api_tool",

{gitcode_api-1.2.10 → gitcode_api-1.2.12}/gitcode_api/llm/jiuwen.py

@@ -30,8 +30,30 @@ def _openjiuwen_tool_decorator() -> Callable[..., Any]:
 class _GitCodeJiuwenTool(GitCodeLLMTool):
     """Build an openJiuwen ``LocalFunction`` bound to :class:`GitCodeLLMTool` (async invoke only)."""
 
-    def __init__(self, *, name: Optional[str] = None, description: Optional[str] = None, **kwargs) -> None:
-        super().__init__(**kwargs)
+    def __init__(
+        self,
+        *,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        client: Optional[GitCode] = None,
+        async_client: Optional[AsyncGitCode] = None,
+        api_key: Optional[str] = None,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: Optional[float] = None,
+        decrypt: Optional[Callable[..., Any]] = None,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+    ) -> None:
+        super().__init__(
+            client=client,
+            async_client=async_client,
+            api_key=api_key,
+            owner=owner,
+            repo=repo,
+            base_url=base_url,
+            timeout=timeout,
+            decrypt=decrypt,
+        )
         tool_name = name if name is not None else TOOL_NAME
         tool_description = description if description is not None else TOOL_DESCRIPTION
         oj_tool = _openjiuwen_tool_decorator()
@@ -60,11 +82,11 @@ def create_openjiuwen_gitcode_api_tool(
     client: Optional[GitCode] = None,
     async_client: Optional[AsyncGitCode] = None,
     api_key: Optional[str] = None,
-    owner: Optional[str] = None,
-    repo: Optional[str] = None,
     base_url: str = DEFAULT_BASE_URL,
     timeout: Optional[float] = None,
     decrypt: Optional[Callable[..., Any]] = None,
+    owner: Optional[str] = None,
+    repo: Optional[str] = None,
 ) -> "LocalFunction":
     """Create an openJiuwen ``LocalFunction`` for the GitCode API tool.
 
@@ -73,11 +95,11 @@ def create_openjiuwen_gitcode_api_tool(
     :param client: Optional synchronous GitCode client.
     :param async_client: Optional asynchronous GitCode client.
     :param api_key: Personal access token when clients are not supplied.
-    :param owner: Default repository owner for generated clients.
-    :param repo: Default repository name for generated clients.
     :param base_url: Base URL for generated clients.
     :param timeout: Request timeout for generated clients.
     :param decrypt: Optional decryption function for encrypted access tokens.
+    :param owner: Default repository owner for generated clients.
+    :param repo: Default repository name for generated clients.
     :returns: openJiuwen ``LocalFunction`` with the standard parameter schema.
     """
     adapter = _GitCodeJiuwenTool(

{gitcode_api-1.2.10 → gitcode_api-1.2.12}/gitcode_api/llm/openai.py

@@ -2,7 +2,10 @@
 
 import json
 from functools import cached_property
-from typing import Any, Coroutine, Dict, Union
+from typing import Any, Callable, Coroutine, Dict, Optional, Union
+
+from gitcode_api import AsyncGitCode, GitCode
+from gitcode_api._base_client import DEFAULT_BASE_URL
 
 from ._tool import TOOL_DESCRIPTION, TOOL_NAME, TOOL_PARAMETERS, GitCodeLLMTool
 
@@ -13,19 +16,47 @@ class GitCodeOpenAITool(GitCodeLLMTool):
     :param async_mode: When true, calling the instance returns the async tool coroutine.
     :param indent: ``indent`` argument passed to :func:`json.dumps` when serializing
         invocation results (default ``2``).
-    :param kwargs: Passed to :class:`gitcode_api.llm.GitCodeLLMTool` ---
-        ``client``, ``async_client``, ``api_key``, ``owner``, ``repo``, ``base_url``, ``timeout``, ``decrypt``.
+    :param client: Optional synchronous GitCode client.
+    :param async_client: Optional asynchronous GitCode client.
+    :param api_key: Personal access token used when clients are not supplied.
+    :param base_url: Base URL for generated clients.
+    :param timeout: Request timeout for generated clients.
+    :param decrypt: Optional decryption function for encrypted access tokens.
+    :param owner: Default repository owner for generated clients.
+    :param repo: Default repository name for generated clients.
     """
 
     name = TOOL_NAME
     description = TOOL_DESCRIPTION
     parameters = TOOL_PARAMETERS
 
-    def __init__(self, async_mode: bool = False, indent: int = 2, **kwargs) -> None:
+    def __init__(
+        self,
+        async_mode: bool = False,
+        indent: int = 2,
+        *,
+        client: Optional[GitCode] = None,
+        async_client: Optional[AsyncGitCode] = None,
+        api_key: Optional[str] = None,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: Optional[float] = None,
+        decrypt: Optional[Callable] = None,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+    ) -> None:
         """Create an OpenAI tool wrapper."""
         self.indent = indent
         self.async_mode = bool(async_mode)
-        super().__init__(**kwargs)
+        super().__init__(
+            client=client,
+            async_client=async_client,
+            api_key=api_key,
+            owner=owner,
+            repo=repo,
+            base_url=base_url,
+            timeout=timeout,
+            decrypt=decrypt,
+        )
 
     @cached_property
     def tool(self) -> Dict[str, Any]:

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

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

{gitcode_api-1.2.10 → gitcode_api-1.2.12}/gitcode_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.10
+Version: 1.2.12
 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=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)
 [![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
@@ -231,7 +233,7 @@ Every resource group inherits a cached `methods` property from the shared resour
 
 ## LLM tools, MCP, and openJiuwen
 
-The `gitcode_api.llm` module exposes a single logical tool, **`gitcode_api_tool`**, that routes calls to sync or async SDK resources. Model-facing parameters match the JSON schema used by OpenAI-style function tools:
+The `gitcode_api.llm` module exposes a single unified tool, **`gitcode_api_tool`**, that routes calls to respective sync or async SDK resource groups. Model-facing parameters match the JSON schema used by OpenAI-style function tools:
 
 | Parameter | Role |
 | --- | --- |

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

@@ -1,6 +1,6 @@
 [project]
 name = "gitcode-api"
-version = "1.2.10"
+version = "1.2.12"
 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",
@@ -76,7 +76,7 @@ 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-1.2.10 → gitcode_api-1.2.12}/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.10/gitcode_api/version.txt

@@ -1 +0,0 @@
-1.2.10

{gitcode_api-1.2.10 → gitcode_api-1.2.12}/gitcode_api/llm/_tool.py

@@ -227,11 +227,11 @@ class GitCodeLLMTool:
     :param client: Optional synchronous GitCode client.
     :param async_client: Optional asynchronous GitCode client.
     :param api_key: Personal access token used when clients are not supplied.
-    :param owner: Default repository owner for generated clients.
-    :param repo: Default repository name for generated clients.
     :param base_url: Base URL for generated clients.
     :param timeout: Request timeout for generated clients.
     :param decrypt: Optional decryption function for encrypted access tokens.
+    :param owner: Default repository owner for generated clients.
+    :param repo: Default repository name for generated clients.
     """
 
     def __init__(
@@ -240,11 +240,11 @@ class GitCodeLLMTool:
         client: Optional[GitCode] = None,
         async_client: Optional[AsyncGitCode] = None,
         api_key: Optional[str] = None,
-        owner: Optional[str] = None,
-        repo: Optional[str] = None,
         base_url: str = DEFAULT_BASE_URL,
         timeout: Optional[float] = None,
         decrypt: Optional[Callable] = None,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
     ) -> None:
         """Create a reusable tool with lazy sync and async clients."""
         self._client = client