gitcode-api 1.2.21__tar.gz → 1.3.1__tar.gz

{gitcode_api-1.2.21 → gitcode_api-1.3.1}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.21
+Version: 1.3.1
 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>
+Author-email: "Hugo (Jin Huang)" <hugo@hugohuang.com>
 License-Expression: MIT
 Project-URL: Changelog, https://gitcode-api.readthedocs.io/en/latest/changelog.html
 Project-URL: Issues, https://github.com/Trenza1ore/GitCode-API/issues
@@ -12,7 +12,7 @@ Project-URL: Github, https://github.com/Trenza1ore/GitCode-API
 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
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: 3
@@ -35,15 +35,12 @@ Provides-Extra: mcp
 Requires-Dist: fastmcp; python_version >= "3.10" and extra == "mcp"
 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=c9611358e1474a759d09ac0b861d8d22)](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=c9611358e1474a759d09ac0b861d8d22)](https://pepy.tech/projects/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) [![CI Badge](https://github.com/Trenza1ore/GitCode-API/actions/workflows/check-code.yml/badge.svg?uuid=c9611358e1474a759d09ac0b861d8d22)](https://github.com/Trenza1ore/GitCode-API/actions/workflows/check-code.yml/)
+# GitCode-API [![GitCode Badge](https://img.shields.io/badge/gitcode-brown?logo=gitcode&link=https%3A%2F%2Fgitcode.com%2FSushiNinja%2FGitCode-API)](https://gitcode.com/SushiNinja/GitCode-API) [![GitHub Badge](https://img.shields.io/badge/github-black?logo=github&link=https%3A%2F%2Fgithub.com%2FTrenza1ore%2FGitCode-API)](https://github.com/Trenza1ore/GitCode-API)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?color=blue&uuid=96abf98469db4ee7bc12ded4646e76d9)](https://pypi.org/project/gitcode-api) [![PyPI - Downloads](https://img.shields.io/pypi/dm/gitcode-api?color=blue&logo=pypi&logoColor=white&label=PyPI%20%E2%86%93&uuid=96abf98469db4ee7bc12ded4646e76d9)](https://pepy.tech/projects/gitcode-api) ![MCP Bundle Downloads](https://img.shields.io/github/downloads/Trenza1ore/GitCode-API/total?color=blue&logo=modelcontextprotocol&label=MCPB%20%E2%86%93&uuid=96abf98469db4ee7bc12ded4646e76d9)
 
 [![Docs](https://img.shields.io/badge/%E6%96%87%E6%A1%A3-Docs-cyan?style=for-the-badge&logo=readthedocs&link=https%3A%2F%2Fgitcode-api.readthedocs.io%2Fen%2Flatest%2Findex.html)](https://gitcode-api.readthedocs.io) [![中文README](https://img.shields.io/badge/%E4%B8%AD%E6%96%87-README-brown?style=for-the-badge&logo=googledocs&link=README.zh.md)](README.zh.md)
 
-`gitcode-api` is a community-maintained Python SDK for the GitCode REST API. It provides easy-to-use synchronous and asynchronous clients, repository-scoped helpers, and lightweight response models so you can work with GitCode from Python without hand-writing raw HTTP requests. The `gitcode_api.llm` module adds an OpenAI-style function tool, an MCP service, and an [openJiuwen](https://openjiuwen.com) tool integration so agents can reuse the same resource-oriented API.
+`gitcode-api` is a community-maintained Python SDK for the GitCode REST API. It provides easy-to-use synchronous and asynchronous clients, helpers methods grouped by resource groups, and type-hinted response models so you can work with GitCode from Python without hand-writing raw HTTP requests. The `gitcode_api.llm` module adds an OpenAI-style function tool, an MCP service, and an [openJiuwen](https://openjiuwen.com) tool integration so agents can reuse the same resource-oriented API.
 
 ## Why This Project
 
@@ -51,7 +48,7 @@ Dynamic: license-file
 - Sync and async clients with a consistent API surface.
 - Convenient methods not offered by REST API directly: such as fetching Issue and PR templates.
 - Resource groups such as `client.repos`, `client.pulls`, and `client.users`.
-- Repository defaults via `owner=` and `repo=` on the client.
+- Repository defaults via `owner` and `repo` on the client.
 - Sphinx docs plus a mirrored GitCode REST API reference in `docs/`.
 - Provides MCP server, OpenAI tool, and [openJiuwen](https://openjiuwen.com) tool for LLM agent usage.
 - Provide MCP service that directly installs to your IDE of choice, such as Cursor and VS Code!
@@ -77,14 +74,14 @@ For detailed setup (including installing to services like Claude Code / Codex):
 
 ## Authentication
 
-Pass `api_key=` directly, or set `GITCODE_ACCESS_TOKEN` in your environment:
+Pass `api_key` directly, or set `GITCODE_ACCESS_TOKEN` in your environment:
 
 ```bash
 export GITCODE_ACCESS_TOKEN="your-token"
 ```
 
-If your token is stored in encrypted form, pass `decrypt=` to decode either an
-encrypted `api_key=` value or an encrypted `GITCODE_ACCESS_TOKEN` value before
+If your token is stored in encrypted form, pass `decrypt` to decode either an
+encrypted `api_key` value or an encrypted `GITCODE_ACCESS_TOKEN` value before
 the client uses it.
 
 ```python
@@ -171,7 +168,7 @@ meta = as_dict(repo)  # dict
 
 ### Context managers
 
-`GitCode` and `AsyncGitCode` (and the lower-level `SyncAPIClient` / `AsyncAPIClient`) support `with` / `async with`. Leaving the block calls `close()` / `await close()` on the underlying client automatically, including a custom `http_client=` you passed in. `close()` also clears the LRU cache used by each resource group's `method_signature(...)` helper (see the [Available Resources](#available-resources) section).
+`GitCode` and `AsyncGitCode` (and the lower-level `SyncAPIClient` / `AsyncAPIClient`) support `with` / `async with`. Leaving the block calls `close()` / `await close()` on the underlying client automatically, including a custom `http_client` you passed in. `close()` also clears the LRU cache used by each resource group's `method_signature(...)` helper (see the [Available Resources](#available-resources) section).
 
 ```python
 from gitcode_api import GitCode
@@ -328,7 +325,7 @@ while True:
 pip install 'gitcode-api[mcp]'
 ```
 
-- **`create_mcp_server`** — builds a `FastMCP` instance with `gitcode_api_tool` already registered; optional `name=`, `tool=`, and extra keyword arguments are forwarded to `FastMCP(...)`.
+- **`create_mcp_server`** — builds a `FastMCP` instance with `gitcode_api_tool` already registered; optional `name`, `tool`, and extra keyword arguments are forwarded to `FastMCP(...)`.
 - **`GitCodeMCP`** — thin wrapper that constructs that server and registers the tool; unknown attributes are delegated to the underlying `FastMCP` object (for example transport helpers exposed by your FastMCP version).
 - **`create_mcp_gitcode_api_tool`** — returns the standalone async callable used as the tool body (for custom wiring).
 - **`register_mcp_gitcode_api_tool`** — attaches that callable to an existing FastMCP-compatible object (`mcp.tool(...)` or `mcp.add_tool(...)`).
@@ -342,7 +339,7 @@ mcp = create_mcp_server(name="GitCode API", owner="SushiNinja", repo="GitCode-AP
 
 The same server is available from the CLI as `gitcode-api serve` (see the [CLI](#cli) section).
 
-To share auth or clients across tools, build `GitCodeLLMTool` once (`from gitcode_api.llm._tool import GitCodeLLMTool`) and pass it as `tool=` into `GitCodeMCP`, `create_mcp_server`, `register_mcp_gitcode_api_tool`, or `create_mcp_gitcode_api_tool`.
+To share auth or clients across tools, build `GitCodeLLMTool` once (`from gitcode_api.llm._tool import GitCodeLLMTool`) and pass it as `tool` into `GitCodeMCP`, `create_mcp_server`, `register_mcp_gitcode_api_tool`, or `create_mcp_gitcode_api_tool`.
 
 ### openJiuwen (`LocalFunction`)
 
@@ -360,7 +357,7 @@ jiuwen_tool = create_openjiuwen_gitcode_api_tool(owner="SushiNinja", repo="GitCo
 # await jiuwen_tool.invoke({"op_type": "repos", "action": "get", "params": {}})
 ```
 
-Optional `name=` and `description=` override the default tool card. Constructor options otherwise mirror `GitCode` / `AsyncGitCode` (`client=`, `async_client=`, `api_key=`, `owner=`, `repo=`, `base_url=`, `timeout=`, `decrypt=`).
+Optional `name` and `description` override the default tool card. Constructor options otherwise mirror `GitCode` / `AsyncGitCode` (`client`, `async_client`, `api_key`, `owner`, `repo`, `base_url`, `timeout`, `decrypt`).
 
 **Claude Desktop (MCPB):** published GitHub Releases include a `gitcode-<version>.mcpb` bundle for one-click installation as a Claude Desktop extension; see Anthropic’s guide, [Build a desktop extension with MCPB](https://claude.com/docs/connectors/building/mcpb). From a checkout you can run `make mcpb` (requires the [`@anthropic-ai/mcpb`](https://www.npmjs.com/package/@anthropic-ai/mcpb) CLI on your `PATH`).
 
@@ -431,7 +428,7 @@ with GitCode(
 
 Use `httpx.AsyncClient(verify=...)` with `AsyncGitCode` for async code.
 
-The OpenAI tool (`GitCodeOpenAITool`), MCP helpers, and `create_openjiuwen_gitcode_api_tool` accept the same `client=` / `async_client=` arguments (OpenAI and MCP also accept a shared `GitCodeLLMTool` via `tool=`). Build `GitCode` / `AsyncGitCode` with your custom `http_client` once and pass it through so LLM tool calls reuse the same TLS settings.
+The OpenAI tool (`GitCodeOpenAITool`), MCP helpers, and `create_openjiuwen_gitcode_api_tool` accept the same `client` / `async_client` arguments (OpenAI and MCP also accept a shared `GitCodeLLMTool` via `tool`). Build `GitCode` / `AsyncGitCode` with your custom `http_client` once and pass it through so LLM tool calls reuse the same TLS settings.
 
 ## Project Status
 

{gitcode_api-1.2.21 → gitcode_api-1.3.1}/README.md

@@ -1,12 +1,9 @@
-# GitCode-API
-
-[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=c9611358e1474a759d09ac0b861d8d22)](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=c9611358e1474a759d09ac0b861d8d22)](https://pepy.tech/projects/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) [![CI Badge](https://github.com/Trenza1ore/GitCode-API/actions/workflows/check-code.yml/badge.svg?uuid=c9611358e1474a759d09ac0b861d8d22)](https://github.com/Trenza1ore/GitCode-API/actions/workflows/check-code.yml/)
+# GitCode-API [![GitCode Badge](https://img.shields.io/badge/gitcode-brown?logo=gitcode&link=https%3A%2F%2Fgitcode.com%2FSushiNinja%2FGitCode-API)](https://gitcode.com/SushiNinja/GitCode-API) [![GitHub Badge](https://img.shields.io/badge/github-black?logo=github&link=https%3A%2F%2Fgithub.com%2FTrenza1ore%2FGitCode-API)](https://github.com/Trenza1ore/GitCode-API)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?color=blue&uuid=96abf98469db4ee7bc12ded4646e76d9)](https://pypi.org/project/gitcode-api) [![PyPI - Downloads](https://img.shields.io/pypi/dm/gitcode-api?color=blue&logo=pypi&logoColor=white&label=PyPI%20%E2%86%93&uuid=96abf98469db4ee7bc12ded4646e76d9)](https://pepy.tech/projects/gitcode-api) ![MCP Bundle Downloads](https://img.shields.io/github/downloads/Trenza1ore/GitCode-API/total?color=blue&logo=modelcontextprotocol&label=MCPB%20%E2%86%93&uuid=96abf98469db4ee7bc12ded4646e76d9)
 
 [![Docs](https://img.shields.io/badge/%E6%96%87%E6%A1%A3-Docs-cyan?style=for-the-badge&logo=readthedocs&link=https%3A%2F%2Fgitcode-api.readthedocs.io%2Fen%2Flatest%2Findex.html)](https://gitcode-api.readthedocs.io) [![中文README](https://img.shields.io/badge/%E4%B8%AD%E6%96%87-README-brown?style=for-the-badge&logo=googledocs&link=README.zh.md)](README.zh.md)
 
-`gitcode-api` is a community-maintained Python SDK for the GitCode REST API. It provides easy-to-use synchronous and asynchronous clients, repository-scoped helpers, and lightweight response models so you can work with GitCode from Python without hand-writing raw HTTP requests. The `gitcode_api.llm` module adds an OpenAI-style function tool, an MCP service, and an [openJiuwen](https://openjiuwen.com) tool integration so agents can reuse the same resource-oriented API.
+`gitcode-api` is a community-maintained Python SDK for the GitCode REST API. It provides easy-to-use synchronous and asynchronous clients, helpers methods grouped by resource groups, and type-hinted response models so you can work with GitCode from Python without hand-writing raw HTTP requests. The `gitcode_api.llm` module adds an OpenAI-style function tool, an MCP service, and an [openJiuwen](https://openjiuwen.com) tool integration so agents can reuse the same resource-oriented API.
 
 ## Why This Project
 
@@ -14,7 +11,7 @@
 - Sync and async clients with a consistent API surface.
 - Convenient methods not offered by REST API directly: such as fetching Issue and PR templates.
 - Resource groups such as `client.repos`, `client.pulls`, and `client.users`.
-- Repository defaults via `owner=` and `repo=` on the client.
+- Repository defaults via `owner` and `repo` on the client.
 - Sphinx docs plus a mirrored GitCode REST API reference in `docs/`.
 - Provides MCP server, OpenAI tool, and [openJiuwen](https://openjiuwen.com) tool for LLM agent usage.
 - Provide MCP service that directly installs to your IDE of choice, such as Cursor and VS Code!
@@ -40,14 +37,14 @@ For detailed setup (including installing to services like Claude Code / Codex):
 
 ## Authentication
 
-Pass `api_key=` directly, or set `GITCODE_ACCESS_TOKEN` in your environment:
+Pass `api_key` directly, or set `GITCODE_ACCESS_TOKEN` in your environment:
 
 ```bash
 export GITCODE_ACCESS_TOKEN="your-token"
 ```
 
-If your token is stored in encrypted form, pass `decrypt=` to decode either an
-encrypted `api_key=` value or an encrypted `GITCODE_ACCESS_TOKEN` value before
+If your token is stored in encrypted form, pass `decrypt` to decode either an
+encrypted `api_key` value or an encrypted `GITCODE_ACCESS_TOKEN` value before
 the client uses it.
 
 ```python
@@ -134,7 +131,7 @@ meta = as_dict(repo)  # dict
 
 ### Context managers
 
-`GitCode` and `AsyncGitCode` (and the lower-level `SyncAPIClient` / `AsyncAPIClient`) support `with` / `async with`. Leaving the block calls `close()` / `await close()` on the underlying client automatically, including a custom `http_client=` you passed in. `close()` also clears the LRU cache used by each resource group's `method_signature(...)` helper (see the [Available Resources](#available-resources) section).
+`GitCode` and `AsyncGitCode` (and the lower-level `SyncAPIClient` / `AsyncAPIClient`) support `with` / `async with`. Leaving the block calls `close()` / `await close()` on the underlying client automatically, including a custom `http_client` you passed in. `close()` also clears the LRU cache used by each resource group's `method_signature(...)` helper (see the [Available Resources](#available-resources) section).
 
 ```python
 from gitcode_api import GitCode
@@ -291,7 +288,7 @@ while True:
 pip install 'gitcode-api[mcp]'
 ```
 
-- **`create_mcp_server`** — builds a `FastMCP` instance with `gitcode_api_tool` already registered; optional `name=`, `tool=`, and extra keyword arguments are forwarded to `FastMCP(...)`.
+- **`create_mcp_server`** — builds a `FastMCP` instance with `gitcode_api_tool` already registered; optional `name`, `tool`, and extra keyword arguments are forwarded to `FastMCP(...)`.
 - **`GitCodeMCP`** — thin wrapper that constructs that server and registers the tool; unknown attributes are delegated to the underlying `FastMCP` object (for example transport helpers exposed by your FastMCP version).
 - **`create_mcp_gitcode_api_tool`** — returns the standalone async callable used as the tool body (for custom wiring).
 - **`register_mcp_gitcode_api_tool`** — attaches that callable to an existing FastMCP-compatible object (`mcp.tool(...)` or `mcp.add_tool(...)`).
@@ -305,7 +302,7 @@ mcp = create_mcp_server(name="GitCode API", owner="SushiNinja", repo="GitCode-AP
 
 The same server is available from the CLI as `gitcode-api serve` (see the [CLI](#cli) section).
 
-To share auth or clients across tools, build `GitCodeLLMTool` once (`from gitcode_api.llm._tool import GitCodeLLMTool`) and pass it as `tool=` into `GitCodeMCP`, `create_mcp_server`, `register_mcp_gitcode_api_tool`, or `create_mcp_gitcode_api_tool`.
+To share auth or clients across tools, build `GitCodeLLMTool` once (`from gitcode_api.llm._tool import GitCodeLLMTool`) and pass it as `tool` into `GitCodeMCP`, `create_mcp_server`, `register_mcp_gitcode_api_tool`, or `create_mcp_gitcode_api_tool`.
 
 ### openJiuwen (`LocalFunction`)
 
@@ -323,7 +320,7 @@ jiuwen_tool = create_openjiuwen_gitcode_api_tool(owner="SushiNinja", repo="GitCo
 # await jiuwen_tool.invoke({"op_type": "repos", "action": "get", "params": {}})
 ```
 
-Optional `name=` and `description=` override the default tool card. Constructor options otherwise mirror `GitCode` / `AsyncGitCode` (`client=`, `async_client=`, `api_key=`, `owner=`, `repo=`, `base_url=`, `timeout=`, `decrypt=`).
+Optional `name` and `description` override the default tool card. Constructor options otherwise mirror `GitCode` / `AsyncGitCode` (`client`, `async_client`, `api_key`, `owner`, `repo`, `base_url`, `timeout`, `decrypt`).
 
 **Claude Desktop (MCPB):** published GitHub Releases include a `gitcode-<version>.mcpb` bundle for one-click installation as a Claude Desktop extension; see Anthropic’s guide, [Build a desktop extension with MCPB](https://claude.com/docs/connectors/building/mcpb). From a checkout you can run `make mcpb` (requires the [`@anthropic-ai/mcpb`](https://www.npmjs.com/package/@anthropic-ai/mcpb) CLI on your `PATH`).
 
@@ -394,7 +391,7 @@ with GitCode(
 
 Use `httpx.AsyncClient(verify=...)` with `AsyncGitCode` for async code.
 
-The OpenAI tool (`GitCodeOpenAITool`), MCP helpers, and `create_openjiuwen_gitcode_api_tool` accept the same `client=` / `async_client=` arguments (OpenAI and MCP also accept a shared `GitCodeLLMTool` via `tool=`). Build `GitCode` / `AsyncGitCode` with your custom `http_client` once and pass it through so LLM tool calls reuse the same TLS settings.
+The OpenAI tool (`GitCodeOpenAITool`), MCP helpers, and `create_openjiuwen_gitcode_api_tool` accept the same `client` / `async_client` arguments (OpenAI and MCP also accept a shared `GitCodeLLMTool` via `tool`). Build `GitCode` / `AsyncGitCode` with your custom `http_client` once and pass it through so LLM tool calls reuse the same TLS settings.
 
 ## Project Status
 

{gitcode_api-1.2.21 → gitcode_api-1.3.1}/gitcode_api/__init__.py

@@ -1,16 +1,18 @@
-"""Public package exports for the GitCode SDK."""
+"""GitCode API — Python clients for interactions with GitCode REST API."""
 
 import re
 from importlib.metadata import PackageNotFoundError, metadata, version
 from typing import cast
 
-from . import constants
+from . import constants, exceptions, models
 from ._client import AsyncGitCode, GitCode
 from ._exceptions import (
     GitCodeAPIError,
     GitCodeConfigurationError,
     GitCodeError,
     GitCodeHTTPStatusError,
+    GitCodeTokenError,
+    GitCodeUnauthorizedError,
 )
 from .utils import as_dict
 
@@ -43,6 +45,8 @@ __version__ = _VERSION_STR.strip()
 
 __all__ = [
     "constants",
+    "exceptions",
+    "models",
     "__version__",
     "__build_hash__",
     "AsyncGitCode",
@@ -51,5 +55,7 @@ __all__ = [
     "GitCodeConfigurationError",
     "GitCodeError",
     "GitCodeHTTPStatusError",
+    "GitCodeTokenError",
+    "GitCodeUnauthorizedError",
     "as_dict",
 ]

{gitcode_api-1.2.21 → gitcode_api-1.3.1}/gitcode_api/_exceptions.py

@@ -38,8 +38,10 @@ class GitCodeAPIError(GitCodeError):
 class GitCodeHTTPStatusError(GitCodeAPIError):
     """Raised for non-success HTTP responses from the GitCode API."""
 
+
 class GitCodeUnauthorizedError(GitCodeHTTPStatusError):
     """Raised for 401 unauthorized HTTP responses from the GitCode API."""
 
+
 class GitCodeTokenError(GitCodeUnauthorizedError):
     """Raised for invalid token from the GitCode API."""

gitcode_api-1.3.1/gitcode_api/exceptions.py

@@ -0,0 +1,19 @@
+"""Exception classes for the GitCode SDK."""
+
+from gitcode_api._exceptions import (
+    GitCodeAPIError,
+    GitCodeConfigurationError,
+    GitCodeError,
+    GitCodeHTTPStatusError,
+    GitCodeTokenError,
+    GitCodeUnauthorizedError,
+)
+
+__all__ = [
+    "GitCodeAPIError",
+    "GitCodeConfigurationError",
+    "GitCodeError",
+    "GitCodeHTTPStatusError",
+    "GitCodeTokenError",
+    "GitCodeUnauthorizedError",
+]

{gitcode_api-1.2.21 → gitcode_api-1.3.1}/gitcode_api/llm/mcp.py

@@ -1,6 +1,6 @@
 """FastMCP integration for the GitCode LLM tool."""
 
-from typing import TYPE_CHECKING, Any, Callable, Optional, Union
+from typing import TYPE_CHECKING, Any, Callable, Optional, Union, cast
 
 from ._tool import (
     MCP_SERVER_INSTRUCTIONS,
@@ -25,8 +25,8 @@ def _missing_fastmcp_error() -> ImportError:
 
 def _load_fastmcp() -> tuple["type[FastMCP]", Callable[..., "Tool"]]:
     try:
-        from fastmcp import FastMCP
-        from fastmcp.tools import tool as fastmcp_tool
+        from fastmcp import FastMCP  # pylint: disable=import-outside-toplevel
+        from fastmcp.tools import tool as fastmcp_tool  # pylint: disable=import-outside-toplevel
     except ImportError as exc:
         raise _missing_fastmcp_error() from exc
     return FastMCP, fastmcp_tool  # type: ignore[return-value]
@@ -61,9 +61,9 @@ def register_mcp_gitcode_api_tool(mcp: Union["FastMCP", Any], tool: Optional[Git
     callable_tool = create_mcp_gitcode_api_tool(tool)
     if hasattr(mcp, "tool"):
         try:
-            return mcp.tool(name=TOOL_NAME, description=TOOL_DESCRIPTION)(callable_tool)
+            return cast("Tool", mcp.tool(name=TOOL_NAME, description=TOOL_DESCRIPTION)(callable_tool))
         except TypeError:
-            return mcp.tool()(callable_tool)
+            return cast("Tool", mcp.tool()(callable_tool))
     if hasattr(mcp, "add_tool"):
         _, fastmcp_tool = _load_fastmcp()
         mcp_tool = fastmcp_tool(callable_tool, name=TOOL_NAME, description=TOOL_DESCRIPTION)
@@ -136,7 +136,7 @@ def create_mcp_server(name: str = "GitCode API", tool: Optional[GitCodeLLMTool]
     :param name: MCP server display name.
     :param tool: Optional preconfigured :class:`~gitcode_api.llm._tool.GitCodeLLMTool`.
     :param kwargs: Forwarded to :class:`GitCodeMCP` and then to ``fastmcp.FastMCP`` (for example
-        ``instructions=`` to override the default server instructions).
+        ``instructions`` to override the default server instructions).
     :returns: Configured ``FastMCP`` instance with ``gitcode_api_tool`` registered.
     """
     return GitCodeMCP(name=name, tool=tool, **kwargs).mcp

gitcode_api-1.3.1/gitcode_api/models.py

@@ -0,0 +1,205 @@
+"""Response models for the GitCode SDK."""
+
+from gitcode_api._models import (
+    APIObject,
+    ApiStatusResponse,
+    Blob,
+    Branch,
+    BranchDetail,
+    BranchDetailCommit,
+    BranchListCommit,
+    Commit,
+    CommitAuthorSummary,
+    CommitComment,
+    CommitComparison,
+    CommitFile,
+    CommitIdentity,
+    CommitParent,
+    CommitPayload,
+    CommitResult,
+    CommitStats,
+    CommitSummary,
+    CommitTreeRef,
+    ContentLinks,
+    ContentObject,
+    ContentWriteCommit,
+    Contributor,
+    ContributorStatistics,
+    ContributorStatisticsEntry,
+    ContributorStatisticsOverview,
+    Email,
+    EmptyResponse,
+    EnterpriseMember,
+    EnterpriseRef,
+    Issue,
+    IssueComment,
+    IssueOperationLog,
+    Label,
+    MergeResult,
+    MergeStatus,
+    Milestone,
+    Namespace,
+    NamespaceDetails,
+    OAuthToken,
+    Organization,
+    OrganizationMembership,
+    OrganizationSummary,
+    ProtectedBranch,
+    ProtectedTag,
+    PublicKey,
+    PullRequest,
+    PullRequestApprover,
+    PullRequestAssigneeCount,
+    PullRequestBranch,
+    PullRequestComment,
+    PullRequestCount,
+    PullRequestDiffRefs,
+    PullRequestFile,
+    PullRequestOperationLog,
+    PullRequestReview,
+    PullRequestSettingDetail,
+    PullRequestSettings,
+    PullRequestTest,
+    PullRequestTimeStats,
+    Release,
+    ReleaseAsset,
+    ReleaseUploadURL,
+    RepoCollaborator,
+    RepoMember,
+    RepoMemberPermission,
+    RepoMemberPermissions,
+    Repository,
+    RepositoryCollaboratorCheck,
+    RepositoryCustomizedRole,
+    RepositoryDownloadStatistics,
+    RepositoryDownloadStatisticsDetail,
+    RepositoryGitCodeTemplate,
+    RepositoryPermission,
+    RepositoryPermissionMode,
+    RepositoryPushConfig,
+    RepositoryReviewerSettingsUpdate,
+    RepositorySettings,
+    RepositorySummary,
+    RepositoryTransferResult,
+    RepositoryUploadResult,
+    SearchIssue,
+    SearchRepository,
+    SearchResult,
+    SearchUser,
+    Tag,
+    TagCommit,
+    Tagger,
+    Tree,
+    TreeEntry,
+    User,
+    UserEvent,
+    UserEventLinks,
+    UserEventProject,
+    UserEventPushData,
+    UserEventsResponse,
+    UserRef,
+    UserSummary,
+    Webhook,
+)
+
+__all__ = [
+    "APIObject",
+    "ApiStatusResponse",
+    "Blob",
+    "Branch",
+    "BranchDetail",
+    "BranchDetailCommit",
+    "BranchListCommit",
+    "Commit",
+    "CommitAuthorSummary",
+    "CommitComment",
+    "CommitComparison",
+    "CommitFile",
+    "CommitIdentity",
+    "CommitParent",
+    "CommitPayload",
+    "CommitResult",
+    "CommitStats",
+    "CommitSummary",
+    "CommitTreeRef",
+    "ContentLinks",
+    "ContentObject",
+    "ContentWriteCommit",
+    "Contributor",
+    "ContributorStatistics",
+    "ContributorStatisticsEntry",
+    "ContributorStatisticsOverview",
+    "Email",
+    "EmptyResponse",
+    "EnterpriseMember",
+    "EnterpriseRef",
+    "Issue",
+    "IssueComment",
+    "IssueOperationLog",
+    "Label",
+    "MergeResult",
+    "MergeStatus",
+    "Milestone",
+    "Namespace",
+    "NamespaceDetails",
+    "OAuthToken",
+    "Organization",
+    "OrganizationMembership",
+    "OrganizationSummary",
+    "ProtectedBranch",
+    "ProtectedTag",
+    "PublicKey",
+    "PullRequest",
+    "PullRequestApprover",
+    "PullRequestAssigneeCount",
+    "PullRequestBranch",
+    "PullRequestComment",
+    "PullRequestCount",
+    "PullRequestDiffRefs",
+    "PullRequestFile",
+    "PullRequestOperationLog",
+    "PullRequestReview",
+    "PullRequestSettingDetail",
+    "PullRequestSettings",
+    "PullRequestTest",
+    "PullRequestTimeStats",
+    "Release",
+    "ReleaseAsset",
+    "ReleaseUploadURL",
+    "RepoCollaborator",
+    "RepoMember",
+    "RepoMemberPermission",
+    "RepoMemberPermissions",
+    "Repository",
+    "RepositoryCollaboratorCheck",
+    "RepositoryCustomizedRole",
+    "RepositoryDownloadStatistics",
+    "RepositoryDownloadStatisticsDetail",
+    "RepositoryGitCodeTemplate",
+    "RepositoryPermission",
+    "RepositoryPermissionMode",
+    "RepositoryPushConfig",
+    "RepositoryReviewerSettingsUpdate",
+    "RepositorySettings",
+    "RepositorySummary",
+    "RepositoryTransferResult",
+    "RepositoryUploadResult",
+    "SearchIssue",
+    "SearchRepository",
+    "SearchResult",
+    "SearchUser",
+    "Tag",
+    "TagCommit",
+    "Tagger",
+    "Tree",
+    "TreeEntry",
+    "User",
+    "UserEvent",
+    "UserEventLinks",
+    "UserEventProject",
+    "UserEventPushData",
+    "UserEventsResponse",
+    "UserRef",
+    "UserSummary",
+    "Webhook",
+]

{gitcode_api-1.2.21 → gitcode_api-1.3.1}/gitcode_api/resources/__init__.py

@@ -1,4 +1,4 @@
-"""Public resource group exports for the GitCode SDK."""
+"""Sync and async resource group classes for all API endpoint families."""
 
 from .account import (
     AsyncOAuthResource,

gitcode_api-1.3.1/gitcode_api/resources/_shared/__init__.py

@@ -0,0 +1,18 @@
+"""Shared resource base classes and template helpers."""
+
+from .base import AsyncResource, SyncResource
+from .fetch_template import (
+    get_gitcode_template_body_async,
+    get_gitcode_template_body_sync,
+    list_gitcode_template_rows_async,
+    list_gitcode_template_rows_sync,
+)
+
+__all__ = [
+    "AsyncResource",
+    "SyncResource",
+    "get_gitcode_template_body_sync",
+    "get_gitcode_template_body_async",
+    "list_gitcode_template_rows_sync",
+    "list_gitcode_template_rows_async",
+]