gitcode-api 1.2.15__tar.gz → 1.2.17__tar.gz

{gitcode_api-1.2.15 → gitcode_api-1.2.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.15
+Version: 1.2.17
 Summary: Easy to use Python SDK for the GitCode REST API. Providing builtin CLI tool, and optional LLM integration (MCP, OpenAI tool, and openJiuwen tool) for agents. Community-maintained.
 Author-email: Hugo Huang <hugo@hugohuang.com>
 License-Expression: MIT
@@ -37,7 +37,7 @@ Dynamic: license-file
 
 # GitCode-API
 
-[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=1d56ca66edb448b88c30fbfd677b8542)](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=03b2f61f19894ce49501bb9e856b434a)](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=0c863acb12c7438c96f44568f4d808ce)](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=161cdcabfd404203848318e830b96b41)](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)
 
@@ -427,6 +427,8 @@ with GitCode(
     pulls = client.pulls.list(state="open", per_page=5)
 ```
 
+> Default CA bundle / `verify` behavior for the built-in `httpx` client is documented under **TLS and certificate verification** in [`docs/sdk/quickstart.rst`](docs/sdk/quickstart.rst) and summarized at the top of [`docs/sdk/client_api.rst`](docs/sdk/client_api.rst).
+
 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.

{gitcode_api-1.2.15 → gitcode_api-1.2.17}/README.md

@@ -1,6 +1,6 @@
 # GitCode-API
 
-[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=1d56ca66edb448b88c30fbfd677b8542)](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=03b2f61f19894ce49501bb9e856b434a)](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=0c863acb12c7438c96f44568f4d808ce)](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=161cdcabfd404203848318e830b96b41)](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)
 
@@ -390,6 +390,8 @@ with GitCode(
     pulls = client.pulls.list(state="open", per_page=5)
 ```
 
+> Default CA bundle / `verify` behavior for the built-in `httpx` client is documented under **TLS and certificate verification** in [`docs/sdk/quickstart.rst`](docs/sdk/quickstart.rst) and summarized at the top of [`docs/sdk/client_api.rst`](docs/sdk/client_api.rst).
+
 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.

{gitcode_api-1.2.15 → gitcode_api-1.2.17}/gitcode_api/__init__.py

@@ -1,7 +1,10 @@
 """Public package exports for the GitCode SDK."""
 
-from pathlib import Path
+import re
+from importlib.metadata import metadata
+from typing import cast
 
+from . import constants
 from ._client import AsyncGitCode, GitCode
 from ._exceptions import (
     GitCodeAPIError,
@@ -11,10 +14,16 @@ from ._exceptions import (
 )
 from .utils import as_dict
 
-__version__ = (Path(__file__).parent / "version.txt").read_text().strip()
+package_meta = metadata("gitcode_api")
+package_desc = cast(str, package_meta.get("Description"))
+readme_uuids = re.findall(r"\&uuid=(\w+)", package_desc, flags=re.ASCII)
+__build_hash__ = readme_uuids[0] if readme_uuids else "unknown"
+__version__ = cast(str, package_meta.get("Version")).strip()
 
 __all__ = [
+    "constants",
     "__version__",
+    "__build_hash__",
     "AsyncGitCode",
     "GitCode",
     "GitCodeAPIError",

{gitcode_api-1.2.15 → gitcode_api-1.2.17}/gitcode_api/_base_client.py

@@ -12,10 +12,7 @@ import httpx
 
 from ._base_resource import BaseResource
 from ._exceptions import GitCodeConfigurationError, GitCodeHTTPStatusError
-
-DEFAULT_BASE_URL = "https://api.gitcode.com/api/v5"
-DEFAULT_TIMEOUT = 30.0
-DEFAULT_TOKEN_ENV = "GITCODE_ACCESS_TOKEN"
+from .constants import DEFAULT_BASE_URL, DEFAULT_CA_ENV, DEFAULT_TIMEOUT, DEFAULT_TOKEN_ENV
 
 
 def _drop_none_values(mapping: Dict[str, Any]) -> Dict[str, Any]:
@@ -215,7 +212,8 @@ class SyncAPIClient(BaseGitCodeClient):
     ) -> None:
         """Create or reuse an ``httpx.Client`` for synchronous requests."""
         super().__init__(api_key=api_key, owner=owner, repo=repo, base_url=base_url, timeout=timeout, decrypt=decrypt)
-        self._client = http_client or httpx.Client(timeout=self.timeout)
+        verify = os.environ.get(DEFAULT_CA_ENV, "").strip() or os.environ.get("REQUESTS_CA_BUNDLE", "").strip() or True
+        self._client = http_client or httpx.Client(timeout=self.timeout, verify=verify)
 
     def request(
         self,
@@ -289,7 +287,8 @@ class AsyncAPIClient(BaseGitCodeClient):
     ) -> None:
         """Create or reuse an ``httpx.AsyncClient`` for asynchronous requests."""
         super().__init__(api_key=api_key, owner=owner, repo=repo, base_url=base_url, timeout=timeout, decrypt=decrypt)
-        self._client = http_client or httpx.AsyncClient(timeout=self.timeout)
+        verify = os.environ.get(DEFAULT_CA_ENV, "").strip() or os.environ.get("REQUESTS_CA_BUNDLE", "").strip() or True
+        self._client = http_client or httpx.AsyncClient(timeout=self.timeout, verify=verify)
 
     async def request(
         self,

{gitcode_api-1.2.15 → gitcode_api-1.2.17}/gitcode_api/_cli_banner.py

@@ -2,6 +2,8 @@
 
 import sys
 from functools import lru_cache
+from importlib.metadata import metadata
+from typing import List, cast
 
 # ANSI Colour Codes
 CREDBG = "\033[41m"
@@ -24,8 +26,18 @@ BANNER = r"""
 
 
 @lru_cache(maxsize=1)
-def format_default_welcome(version: str) -> str:
+def format_default_welcome(version: str, build: str) -> str:
     """Colored banner and version line for the no-arguments launcher (plain if not a TTY)."""
+    homepage = "https://gitcode-api.readthedocs.io"
+    docspage = "https://gitcode-api.readthedocs.io"
+    banner = BANNER
+    version = f"Ver. {version} (build {build})"
+    for project_url in cast(List[str], metadata("gitcode_api").get_all("Project-URL")):
+        if project_url.casefold().startswith("homepage"):
+            homepage = project_url.split(", ")[1]
     if sys.stdout.isatty():
-        return f"{CRED}{BANNER}{CEND}\n{CBLU}  Ver. {version}{CEND}\n\n"
-    return f"{BANNER}\n  Ver. {version}\n\n"
+        homepage = f"{CBLU}{homepage}{CEND}"
+        docspage = f"{CBLU}{docspage}{CEND}"
+        banner = f"{CRED}{BANNER}{CEND}"
+        version = f"{CREDBG}{version}{CEND}"
+    return f"{banner}\n  {version}\n  Home Page: {homepage}\n  Docs Page: {docspage}\n\n"

{gitcode_api-1.2.15 → gitcode_api-1.2.17}/gitcode_api/cli.py

@@ -13,7 +13,7 @@ from typing import Any, Dict, List, Optional, Union, get_args, get_origin
 
 import httpx
 
-from . import GitCode, __version__
+from . import GitCode, __build_hash__, __version__
 from ._base_client import DEFAULT_BASE_URL, DEFAULT_TOKEN_ENV
 from ._cli_banner import format_default_welcome
 from ._exceptions import GitCodeError
@@ -295,7 +295,7 @@ Each method -h opens with resource.method_signature("<name>") from the Python SD
         epilog=epilog,
         formatter_class=_CLIHelpFormatter,
     )
-    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__} (build {__build_hash__})")
 
     client = _probe_gitcode()
     try:
@@ -457,7 +457,7 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
     parser = build_parser()
     effective = list(sys.argv[1:] if argv is None else argv)
     if not effective:
-        print(format_default_welcome(__version__), end="")
+        print(format_default_welcome(__version__, __build_hash__), end="")
         saved_epilog = parser.epilog
         parser.epilog = None
         try:

gitcode_api-1.2.17/gitcode_api/constants.py

@@ -0,0 +1,8 @@
+"""Shared constant values for the GitCode SDK."""
+
+DEFAULT_BASE_URL = "https://api.gitcode.com/api/v5"
+DEFAULT_TIMEOUT = 30.0
+DEFAULT_TOKEN_ENV = "GITCODE_ACCESS_TOKEN"
+DEFAULT_CA_ENV = "GITCODE_CA_BUNDLE"
+
+__all__ = ["DEFAULT_BASE_URL", "DEFAULT_TIMEOUT", "DEFAULT_TOKEN_ENV", "DEFAULT_CA_ENV"]

gitcode_api-1.2.17/gitcode_api/version.txt

@@ -0,0 +1 @@
+1.2.17

{gitcode_api-1.2.15 → gitcode_api-1.2.17}/gitcode_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.15
+Version: 1.2.17
 Summary: Easy to use Python SDK for the GitCode REST API. Providing builtin CLI tool, and optional LLM integration (MCP, OpenAI tool, and openJiuwen tool) for agents. Community-maintained.
 Author-email: Hugo Huang <hugo@hugohuang.com>
 License-Expression: MIT
@@ -37,7 +37,7 @@ Dynamic: license-file
 
 # GitCode-API
 
-[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=1d56ca66edb448b88c30fbfd677b8542)](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=03b2f61f19894ce49501bb9e856b434a)](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=0c863acb12c7438c96f44568f4d808ce)](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=161cdcabfd404203848318e830b96b41)](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)
 
@@ -427,6 +427,8 @@ with GitCode(
     pulls = client.pulls.list(state="open", per_page=5)
 ```
 
+> Default CA bundle / `verify` behavior for the built-in `httpx` client is documented under **TLS and certificate verification** in [`docs/sdk/quickstart.rst`](docs/sdk/quickstart.rst) and summarized at the top of [`docs/sdk/client_api.rst`](docs/sdk/client_api.rst).
+
 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.

{gitcode_api-1.2.15 → gitcode_api-1.2.17}/gitcode_api.egg-info/SOURCES.txt

@@ -10,6 +10,7 @@ gitcode_api/_client.py
 gitcode_api/_exceptions.py
 gitcode_api/_models.py
 gitcode_api/cli.py
+gitcode_api/constants.py
 gitcode_api/py.typed
 gitcode_api/run_mcp.py
 gitcode_api/utils.py

{gitcode_api-1.2.15 → gitcode_api-1.2.17}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gitcode-api"
-version = "1.2.15"
+version = "1.2.17"
 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",
@@ -94,7 +94,7 @@ gitcode-api = "gitcode_api.cli:main"
 default-groups = ['dev']
 
 [tool.setuptools.package-data]
-gitcode_api = ["**/version.txt"]
+gitcode_api = ["**/version.txt", "**/py.typed"]
 
 [tool.coverage.run]
 omit = ["tests/*"]

{gitcode_api-1.2.15 → gitcode_api-1.2.17}/tests/test_collaboration_templates.py

@@ -1,10 +1,10 @@
 """Tests for issue/PR ``.gitcode`` template resolution helpers."""
 
+from typing import Optional
+
 import httpx
 import pytest
-from typing import Optional
 
-from gitcode_api import AsyncGitCode
 from gitcode_api._exceptions import GitCodeHTTPStatusError
 
 # ``_resolution_sources_*`` probes ``GET /repos/{owner}/{repo}`` for every candidate; stub these.

gitcode_api-1.2.15/gitcode_api/version.txt

@@ -1 +0,0 @@
-1.2.15