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

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

@@ -1,16 +1,16 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.17
+Version: 1.2.19
 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
-Project-URL: changelog, https://gitcode-api.readthedocs.io/en/latest/changelog.html
-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://hugohuang.com/gitcode-api
-Project-URL: author, https://hugohuang.com
+Project-URL: Changelog, https://gitcode-api.readthedocs.io/en/latest/changelog.html
+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://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: Programming Language :: Python
@@ -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=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)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=a97d86566eb14d5e96f3f90dafdd0beb)](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=a97d86566eb14d5e96f3f90dafdd0beb)](https://pepy.tech/projects/gitcode-api) [![CodeFactor](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api/badge)](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api)
 [![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?logoColor=white)](https://cursor.com/en/install-mcp?name=GitCode%20API&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXRjb2RlLWFwaVttY3BdIiwiZ2l0Y29kZS1hcGkiLCJzZXJ2ZSJdLCJlbnYiOnsiR0lUQ09ERV9BQ0NFU1NfVE9LRU4iOiIke2lucHV0OmdpdGNvZGVfYWNjZXNzX3Rva2VufSJ9LCJpbnB1dHMiOlt7ImlkIjoiZ2l0Y29kZV9hY2Nlc3NfdG9rZW4iLCJ0eXBlIjoicHJvbXB0U3RyaW5nIiwiZGVzY3JpcHRpb24iOiJFbnRlciBHSVRDT0RFX0FDQ0VTU19UT0tFTiIsInBhc3N3b3JkIjp0cnVlfV19) [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=GitCode%20API&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22gitcode-api%5Bmcp%5D%22%2C%22gitcode-api%22%2C%22serve%22%5D%2C%22env%22%3A%7B%22GITCODE_ACCESS_TOKEN%22%3A%22%24%7Binput%3Agitcode_access_token%7D%22%7D%2C%22inputs%22%3A%5B%7B%22id%22%3A%22gitcode_access_token%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22Enter%20GITCODE_ACCESS_TOKEN%22%2C%22password%22%3Atrue%7D%5D%7D)
 [![GitHub Badge](https://img.shields.io/badge/github-repo-blue?logo=github&link=https%3A%2F%2Fgithub.com%2FTrenza1ore%2FGitCode-API)](https://github.com/Trenza1ore/GitCode-API) [![GitCode Badge](https://img.shields.io/badge/gitcode-repo-brown?logo=gitcode&link=https%3A%2F%2Fgitcode.com%2FSushiNinja%2FGitCode-API)](https://gitcode.com/SushiNinja/GitCode-API)
 

{gitcode_api-1.2.17 → gitcode_api-1.2.19}/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=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)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=a97d86566eb14d5e96f3f90dafdd0beb)](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=a97d86566eb14d5e96f3f90dafdd0beb)](https://pepy.tech/projects/gitcode-api) [![CodeFactor](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api/badge)](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api)
 [![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?logoColor=white)](https://cursor.com/en/install-mcp?name=GitCode%20API&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXRjb2RlLWFwaVttY3BdIiwiZ2l0Y29kZS1hcGkiLCJzZXJ2ZSJdLCJlbnYiOnsiR0lUQ09ERV9BQ0NFU1NfVE9LRU4iOiIke2lucHV0OmdpdGNvZGVfYWNjZXNzX3Rva2VufSJ9LCJpbnB1dHMiOlt7ImlkIjoiZ2l0Y29kZV9hY2Nlc3NfdG9rZW4iLCJ0eXBlIjoicHJvbXB0U3RyaW5nIiwiZGVzY3JpcHRpb24iOiJFbnRlciBHSVRDT0RFX0FDQ0VTU19UT0tFTiIsInBhc3N3b3JkIjp0cnVlfV19) [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=GitCode%20API&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22gitcode-api%5Bmcp%5D%22%2C%22gitcode-api%22%2C%22serve%22%5D%2C%22env%22%3A%7B%22GITCODE_ACCESS_TOKEN%22%3A%22%24%7Binput%3Agitcode_access_token%7D%22%7D%2C%22inputs%22%3A%5B%7B%22id%22%3A%22gitcode_access_token%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22Enter%20GITCODE_ACCESS_TOKEN%22%2C%22password%22%3Atrue%7D%5D%7D)
 [![GitHub Badge](https://img.shields.io/badge/github-repo-blue?logo=github&link=https%3A%2F%2Fgithub.com%2FTrenza1ore%2FGitCode-API)](https://github.com/Trenza1ore/GitCode-API) [![GitCode Badge](https://img.shields.io/badge/gitcode-repo-brown?logo=gitcode&link=https%3A%2F%2Fgitcode.com%2FSushiNinja%2FGitCode-API)](https://gitcode.com/SushiNinja/GitCode-API)
 

gitcode_api-1.2.19/gitcode_api/__init__.py

@@ -0,0 +1,55 @@
+"""Public package exports for the GitCode SDK."""
+
+import re
+from importlib.metadata import PackageNotFoundError, metadata, version
+from typing import cast
+
+from . import constants
+from ._client import AsyncGitCode, GitCode
+from ._exceptions import (
+    GitCodeAPIError,
+    GitCodeConfigurationError,
+    GitCodeError,
+    GitCodeHTTPStatusError,
+)
+from .utils import as_dict
+
+_README_UUIDS = []
+_VERSION_STR = "unknown"
+
+try:
+    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)
+    _VERSION_STR = version("gitcode_api")
+except PackageNotFoundError:
+    from pathlib import Path
+
+    import tomllib
+
+    pyproject_toml = Path(__file__).parent.parent / "pyproject.toml"
+    if pyproject_toml.exists():
+        _VERSION_STR = tomllib.loads(pyproject_toml.read_text(encoding="utf-8")).get("project", {}).get("version", "")
+    else:
+        version_file = Path(__file__).with_name("version.txt")
+        if version_file.exists():
+            _VERSION_STR = version_file.read_text(encoding="utf-8").strip()
+    read_me_file = pyproject_toml.with_name("README.md")
+    if read_me_file.exists():
+        _README_UUIDS = re.findall(r"\&uuid=(\w+)", read_me_file.read_text(encoding="utf-8").strip(), flags=re.ASCII)
+
+__build_hash__ = _README_UUIDS[0] if _README_UUIDS else "unknown"
+__version__ = _VERSION_STR.strip()
+
+__all__ = [
+    "constants",
+    "__version__",
+    "__build_hash__",
+    "AsyncGitCode",
+    "GitCode",
+    "GitCodeAPIError",
+    "GitCodeConfigurationError",
+    "GitCodeError",
+    "GitCodeHTTPStatusError",
+    "as_dict",
+]

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

@@ -20,6 +20,11 @@ def _drop_none_values(mapping: Dict[str, Any]) -> Dict[str, Any]:
     return {key: value for key, value in mapping.items() if value is not None}
 
 
+def _default_decrypt(value: Any) -> str:
+    """Dummy decryption function, basically a no-op."""
+    return value
+
+
 class BaseGitCodeClient:
     """Base configuration shared by synchronous and asynchronous clients.
 
@@ -42,19 +47,24 @@ class BaseGitCodeClient:
         decrypt: Optional[Callable] = None,
     ) -> None:
         """Store client configuration and resolve authentication."""
-        self.api_key = self._resolve_api_key(api_key, decrypt)
+        self.decrypt = decrypt or _default_decrypt
+        self.api_key = self._resolve_api_key(api_key)
         self.owner = owner
         self.repo = repo
         self.base_url = base_url.rstrip("/")
         self.timeout = timeout if timeout is not None else DEFAULT_TIMEOUT
 
-    def _resolve_api_key(self, api_key: Optional[str], decrypt: Optional[Callable] = None) -> str:
+    def _resolve_api_key(self, api_key: Optional[str]) -> str:
         """Resolve the access token from an argument or environment variable."""
         token = api_key or os.getenv(DEFAULT_TOKEN_ENV)
-        if callable(decrypt):
-            token = decrypt(token)
         if not token:
             raise GitCodeConfigurationError("No API key provided. Pass api_key=... or set GITCODE_ACCESS_TOKEN.")
+        try:
+            token_decrypt = self.decrypt(str(token))
+            if not isinstance(token_decrypt, str):
+                raise TypeError(f"Decrypted token has type={type(token_decrypt)} instead of str: {token_decrypt}")
+        except Exception as e:
+            raise GitCodeConfigurationError("Invalid decrypt function, check its correctness.") from e
         return str(token)
 
     def _resolve_repo_context(
@@ -75,7 +85,7 @@ class BaseGitCodeClient:
         """Build request headers for authenticated JSON API calls."""
         headers = {
             "Accept": "application/json",
-            "Authorization": f"Bearer {self.api_key}",
+            "Authorization": f"Bearer {self.decrypt(self.api_key)}",
         }
         if extra_headers:
             headers.update(extra_headers)

gitcode_api-1.2.19/gitcode_api/constants.py

@@ -0,0 +1,25 @@
+"""Shared constant values for the GitCode SDK."""
+
+import re
+
+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"
+GITCODE_ISSUE_TEMPLATE_PATH_RE: re.Pattern[str] = re.compile(
+    r"\.git(code|hub)/ISSUE_TEMPLATE.*\.(md|markdown|ya?ml)$", re.IGNORECASE
+)
+GITCODE_PULL_REQUEST_TEMPLATE_PATH_RE: re.Pattern[str] = re.compile(
+    r"\.git(code|hub)/PULL_REQUEST_TEMPLATE.*\.(md|markdown|ya?ml)$", re.IGNORECASE
+)
+GITCODE_TEMPLATE_REPO = ".gitcode"
+
+__all__ = [
+    "DEFAULT_BASE_URL",
+    "DEFAULT_TIMEOUT",
+    "DEFAULT_TOKEN_ENV",
+    "DEFAULT_CA_ENV",
+    "GITCODE_ISSUE_TEMPLATE_PATH_RE",
+    "GITCODE_PULL_REQUEST_TEMPLATE_PATH_RE",
+    "GITCODE_TEMPLATE_REPO",
+]

{gitcode_api-1.2.17 → gitcode_api-1.2.19}/gitcode_api/resources/_shared.py

@@ -1,19 +1,12 @@
 """Shared resource base classes for the GitCode SDK."""
 
-import re
 from typing import Any, Dict, List, Optional, Pattern, Tuple, Union
 
 from .._base_client import AsyncAPIClient, SyncAPIClient
 from .._base_resource import BaseResource
 from .._exceptions import GitCodeHTTPStatusError
 from .._models import APIObject, ModelT, as_model, as_model_list
-
-GITCODE_ISSUE_TEMPLATE_PATH_RE: Pattern[str] = re.compile(
-    r"\.gitcode/ISSUE_TEMPLATE.*\.(md|markdown|ya?ml)$", re.IGNORECASE
-)
-GITCODE_PULL_REQUEST_TEMPLATE_PATH_RE: Pattern[str] = re.compile(
-    r"\.gitcode/PULL_REQUEST_TEMPLATE.*\.(md|markdown|ya?ml)$", re.IGNORECASE
-)
+from ..constants import GITCODE_TEMPLATE_REPO
 
 
 def _parse_parent_owner_repo(repo_obj: Any) -> Optional[Tuple[str, str]]:
@@ -50,7 +43,7 @@ def _resolution_sources_sync(client: SyncAPIClient, owner: str, repo: str) -> Li
             sources.append(pair)
 
     add((owner, repo))
-    add((owner, ".gitcode"))
+    add((owner, GITCODE_TEMPLATE_REPO))
 
     max_candidates = 64
     index = 0
@@ -68,7 +61,7 @@ def _resolution_sources_sync(client: SyncAPIClient, owner: str, repo: str) -> Li
             continue
         po, pr = parsed
         add((po, pr))
-        add((po, ".gitcode"))
+        add((po, GITCODE_TEMPLATE_REPO))
 
     return sources
 
@@ -86,7 +79,7 @@ async def _resolution_sources_async(client: AsyncAPIClient, owner: str, repo: st
             sources.append(pair)
 
     add((owner, repo))
-    add((owner, ".gitcode"))
+    add((owner, GITCODE_TEMPLATE_REPO))
 
     max_candidates = 64
     index = 0
@@ -104,7 +97,7 @@ async def _resolution_sources_async(client: AsyncAPIClient, owner: str, repo: st
             continue
         po, pr = parsed
         add((po, pr))
-        add((po, ".gitcode"))
+        add((po, GITCODE_TEMPLATE_REPO))
 
     return sources
 
@@ -210,6 +203,8 @@ def list_gitcode_template_rows_sync(
         acc: List[Tuple[str, str, str, str]] = []
         try:
             _walk_dot_gitcode_contents_sync(client, so, sr, ".gitcode", acc)
+            if sr != GITCODE_TEMPLATE_REPO:
+                _walk_dot_gitcode_contents_sync(client, so, sr, ".github", acc)
         except GitCodeHTTPStatusError:
             continue
         rows = [(t_o, t_r, p, s) for t_o, t_r, p, s in acc if path_pattern.match(p)]
@@ -228,6 +223,8 @@ async def list_gitcode_template_rows_async(
         acc: List[Tuple[str, str, str, str]] = []
         try:
             await _walk_dot_gitcode_contents_async(client, so, sr, ".gitcode", acc)
+            if sr != GITCODE_TEMPLATE_REPO:
+                await _walk_dot_gitcode_contents_async(client, so, sr, ".github", acc)
         except GitCodeHTTPStatusError:
             continue
         rows = [(t_o, t_r, p, s) for t_o, t_r, p, s in acc if path_pattern.match(p)]

{gitcode_api-1.2.17 → gitcode_api-1.2.19}/gitcode_api/resources/collaboration.py

@@ -25,9 +25,8 @@ from .._models import (
     UserSummary,
     as_model,
 )
+from ..constants import GITCODE_ISSUE_TEMPLATE_PATH_RE, GITCODE_PULL_REQUEST_TEMPLATE_PATH_RE
 from ._shared import (
-    GITCODE_ISSUE_TEMPLATE_PATH_RE,
-    GITCODE_PULL_REQUEST_TEMPLATE_PATH_RE,
     AsyncResource,
     SyncResource,
     get_gitcode_template_body_async,
@@ -420,6 +419,8 @@ class IssuesResource(SyncResource):
         are appended, deduplicated, and visited in order). The first source with matching
         templates wins.
 
+        Version 1.2.19: Now also supporting GitHub-mirrored repos with a ``.github/`` folder.
+
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository name. Uses the client default when omitted.
         :returns: Template metadata entries (paths and SHAs); empty when none match.
@@ -1067,6 +1068,8 @@ class PullsResource(SyncResource):
         are appended, deduplicated, and visited in order). The first source with matching
         templates wins.
 
+        Version 1.2.19: Now also supporting GitHub-mirrored repos with a ``.github/`` folder.
+
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository path. Uses the client default when omitted.
         :returns: Template metadata entries (paths and SHAs); empty when none match.
@@ -1734,6 +1737,8 @@ class AsyncIssuesResource(AsyncResource):
         are appended, deduplicated, and visited in order). The first source with matching
         templates wins.
 
+        Version 1.2.19: Now also supporting GitHub-mirrored repos with a ``.github/`` folder.
+
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository name. Uses the client default when omitted.
         :returns: Template metadata entries (paths and SHAs); empty when none match.
@@ -2328,6 +2333,8 @@ class AsyncPullsResource(AsyncResource):
         are appended, deduplicated, and visited in order). The first source with matching
         templates wins.
 
+        Version 1.2.19: Now also supporting GitHub-mirrored repos with a ``.github/`` folder.
+
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository path. Uses the client default when omitted.
         :returns: Template metadata entries (paths and SHAs); empty when none match.

gitcode_api-1.2.19/gitcode_api/version.txt

@@ -0,0 +1 @@
+1.2.19

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

@@ -1,16 +1,16 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.17
+Version: 1.2.19
 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
-Project-URL: changelog, https://gitcode-api.readthedocs.io/en/latest/changelog.html
-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://hugohuang.com/gitcode-api
-Project-URL: author, https://hugohuang.com
+Project-URL: Changelog, https://gitcode-api.readthedocs.io/en/latest/changelog.html
+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://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: Programming Language :: Python
@@ -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=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)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=a97d86566eb14d5e96f3f90dafdd0beb)](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=a97d86566eb14d5e96f3f90dafdd0beb)](https://pepy.tech/projects/gitcode-api) [![CodeFactor](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api/badge)](https://www.codefactor.io/repository/github/trenza1ore/gitcode-api)
 [![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?logoColor=white)](https://cursor.com/en/install-mcp?name=GitCode%20API&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXRjb2RlLWFwaVttY3BdIiwiZ2l0Y29kZS1hcGkiLCJzZXJ2ZSJdLCJlbnYiOnsiR0lUQ09ERV9BQ0NFU1NfVE9LRU4iOiIke2lucHV0OmdpdGNvZGVfYWNjZXNzX3Rva2VufSJ9LCJpbnB1dHMiOlt7ImlkIjoiZ2l0Y29kZV9hY2Nlc3NfdG9rZW4iLCJ0eXBlIjoicHJvbXB0U3RyaW5nIiwiZGVzY3JpcHRpb24iOiJFbnRlciBHSVRDT0RFX0FDQ0VTU19UT0tFTiIsInBhc3N3b3JkIjp0cnVlfV19) [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=GitCode%20API&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22gitcode-api%5Bmcp%5D%22%2C%22gitcode-api%22%2C%22serve%22%5D%2C%22env%22%3A%7B%22GITCODE_ACCESS_TOKEN%22%3A%22%24%7Binput%3Agitcode_access_token%7D%22%7D%2C%22inputs%22%3A%5B%7B%22id%22%3A%22gitcode_access_token%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22Enter%20GITCODE_ACCESS_TOKEN%22%2C%22password%22%3Atrue%7D%5D%7D)
 [![GitHub Badge](https://img.shields.io/badge/github-repo-blue?logo=github&link=https%3A%2F%2Fgithub.com%2FTrenza1ore%2FGitCode-API)](https://github.com/Trenza1ore/GitCode-API) [![GitCode Badge](https://img.shields.io/badge/gitcode-repo-brown?logo=gitcode&link=https%3A%2F%2Fgitcode.com%2FSushiNinja%2FGitCode-API)](https://gitcode.com/SushiNinja/GitCode-API)
 

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

@@ -1,6 +1,6 @@
 [project]
 name = "gitcode-api"
-version = "1.2.17"
+version = "1.2.19"
 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",
@@ -79,13 +79,13 @@ dev = [
 ]
 
 [project.urls]
-changelog = "https://gitcode-api.readthedocs.io/en/latest/changelog.html"
-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://hugohuang.com/gitcode-api"
-author = "https://hugohuang.com"
+Changelog = "https://gitcode-api.readthedocs.io/en/latest/changelog.html"
+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://hugohuang.com/gitcode-api"
+Author = "https://hugohuang.com"
 
 [project.scripts]
 gitcode-api = "gitcode_api.cli:main"
@@ -94,7 +94,7 @@ gitcode-api = "gitcode_api.cli:main"
 default-groups = ['dev']
 
 [tool.setuptools.package-data]
-gitcode_api = ["**/version.txt", "**/py.typed"]
+gitcode_api = ["version.txt", "py.typed"]
 
 [tool.coverage.run]
 omit = ["tests/*"]

{gitcode_api-1.2.17 → gitcode_api-1.2.19}/tests/test_build_manifest.py

@@ -4,8 +4,6 @@ import importlib.util
 import json
 from pathlib import Path
 
-import pytest
-
 ROOT = Path(__file__).resolve().parents[1]
 _BUILD_MANIFEST_PATH = ROOT / "scripts" / "build_manifest.py"
 _spec = importlib.util.spec_from_file_location("build_manifest", _BUILD_MANIFEST_PATH)
@@ -24,11 +22,11 @@ license = "MIT"
 authors = [{ name = "Alice Example", email = "alice@example.com" }]
 
 [project.urls]
-homepage = "https://example.com/home"
-documentation = "https://example.com/docs"
-github = "https://github.com/org/demo"
-author = "https://example.com/~alice"
-issues = "https://github.com/org/demo/issues"
+Homepage = "https://example.com/home"
+Documentation = "https://example.com/docs"
+Github = "https://github.com/org/demo"
+Author = "https://example.com/~alice"
+Issues = "https://github.com/org/demo/issues"
 """
 
 MINIMAL_TEMPLATE = {
@@ -75,20 +73,3 @@ def test_write_manifest_ensure_ascii_utf8(tmp_path: Path) -> None:
     text = out.read_text(encoding="utf-8")
     assert "café" in text
     assert text.endswith("\n")
-
-
-def test_missing_github_raises(tmp_path: Path) -> None:
-    bad = b"""\
-[project]
-name = "x"
-version = "1"
-description = "d"
-authors = [{ name = "A", email = "a@b.c" }]
-"""
-    pyproject_path = tmp_path / "pyproject.toml"
-    pyproject_path.write_bytes(bad)
-    template_path = tmp_path / "manifest.in.json"
-    template_path.write_text(json.dumps(MINIMAL_TEMPLATE), encoding="utf-8")
-
-    with pytest.raises(ValueError, match="github"):
-        _build_manifest.build_manifest_dict(pyproject_path, template_path)

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

@@ -1,4 +1,4 @@
-"""Tests for issue/PR ``.gitcode`` template resolution helpers."""
+"""Tests for issue/PR ``.gitcode`` and ``.github`` template resolution helpers."""
 
 from typing import Optional
 
@@ -6,6 +6,10 @@ import httpx
 import pytest
 
 from gitcode_api._exceptions import GitCodeHTTPStatusError
+from gitcode_api.constants import (
+    GITCODE_ISSUE_TEMPLATE_PATH_RE,
+    GITCODE_PULL_REQUEST_TEMPLATE_PATH_RE,
+)
 
 # ``_resolution_sources_*`` probes ``GET /repos/{owner}/{repo}`` for every candidate; stub these.
 _REPO_METADATA_NONFORK_PATHS = frozenset(
@@ -29,12 +33,22 @@ def _repo_metadata_nonfork_stub(request: httpx.Request, path: str) -> Optional[h
     return None
 
 
+def _empty_github_contents_stub(request: httpx.Request, path: str) -> Optional[httpx.Response]:
+    """Stub ``GET .../contents/.github`` from mirrored-repo template walks."""
+    if request.method == "GET" and path.endswith("/contents/.github"):
+        return httpx.Response(404, json={"message": "missing"})
+    return None
+
+
 def test_list_templates_fallback_to_dot_gitcode_repo(sync_client_factory):
     def handler(request: httpx.Request) -> httpx.Response:
         p = request.url.path
         stub = _repo_metadata_nonfork_stub(request, p)
         if stub is not None:
             return stub
+        gh = _empty_github_contents_stub(request, p)
+        if gh is not None:
+            return gh
         if p == "/api/v5/repos/acme/proj" and request.method == "GET":
             return httpx.Response(200, json={"fork": False, "id": 1})
         if p == "/api/v5/repos/acme/proj/contents/.gitcode":
@@ -68,6 +82,9 @@ def test_list_templates_fork_parent_source(sync_client_factory):
         stub = _repo_metadata_nonfork_stub(request, p)
         if stub is not None:
             return stub
+        gh = _empty_github_contents_stub(request, p)
+        if gh is not None:
+            return gh
         if p == "/api/v5/repos/acme/proj" and request.method == "GET":
             return httpx.Response(
                 200,
@@ -111,6 +128,9 @@ def test_list_templates_fork_parent_dot_gitcode_repo(sync_client_factory):
         stub = _repo_metadata_nonfork_stub(request, p)
         if stub is not None:
             return stub
+        gh = _empty_github_contents_stub(request, p)
+        if gh is not None:
+            return gh
         if p == "/api/v5/repos/acme/proj" and request.method == "GET":
             return httpx.Response(
                 200,
@@ -153,6 +173,9 @@ def test_list_templates_includes_yaml_issue_forms(sync_client_factory):
         stub = _repo_metadata_nonfork_stub(request, p)
         if stub is not None:
             return stub
+        gh = _empty_github_contents_stub(request, p)
+        if gh is not None:
+            return gh
         if p == "/api/v5/repos/acme/proj" and request.method == "GET":
             return httpx.Response(200, json={"fork": False})
         if p == "/api/v5/repos/acme/proj/contents/.gitcode":
@@ -224,6 +247,9 @@ def test_pulls_list_and_get_template(sync_client_factory):
         stub = _repo_metadata_nonfork_stub(request, p)
         if stub is not None:
             return stub
+        gh = _empty_github_contents_stub(request, p)
+        if gh is not None:
+            return gh
         if p == "/api/v5/repos/o/r" and request.method == "GET" and "contents" not in p and "raw" not in p:
             return httpx.Response(200, json={"fork": False})
         if p == "/api/v5/repos/o/r/contents/.gitcode":
@@ -257,6 +283,9 @@ async def test_async_issues_list_templates(async_client_factory):
         stub = _repo_metadata_nonfork_stub(request, p)
         if stub is not None:
             return stub
+        gh = _empty_github_contents_stub(request, p)
+        if gh is not None:
+            return gh
         if p == "/api/v5/repos/acme/proj" and request.method == "GET":
             return httpx.Response(200, json={"fork": False})
         if p == "/api/v5/repos/acme/proj/contents/.gitcode":
@@ -280,3 +309,63 @@ async def test_async_issues_list_templates(async_client_factory):
     await http.aclose()
     assert len(items) == 1
     assert items[0].sha == "asyncsha"
+
+
+def test_template_path_patterns_accept_github_paths():
+    assert GITCODE_ISSUE_TEMPLATE_PATH_RE.match(".github/ISSUE_TEMPLATE/bug.md")
+    assert GITCODE_ISSUE_TEMPLATE_PATH_RE.match(".gitcode/ISSUE_TEMPLATE_bug.yml")
+    assert not GITCODE_ISSUE_TEMPLATE_PATH_RE.match(".github/README.md")
+    assert GITCODE_PULL_REQUEST_TEMPLATE_PATH_RE.match(".github/PULL_REQUEST_TEMPLATE.md")
+
+
+def test_list_templates_from_dot_github(sync_client_factory):
+    def handler(request: httpx.Request) -> httpx.Response:
+        p = request.url.path
+        stub = _repo_metadata_nonfork_stub(request, p)
+        if stub is not None:
+            return stub
+        if p == "/api/v5/repos/acme/proj" and request.method == "GET":
+            return httpx.Response(200, json={"fork": False})
+        if p == "/api/v5/repos/acme/proj/contents/.gitcode":
+            return httpx.Response(404, json={"message": "missing"})
+        if p == "/api/v5/repos/acme/proj/contents/.github":
+            return httpx.Response(
+                200,
+                json=[
+                    {
+                        "type": "file",
+                        "path": ".github/ISSUE_TEMPLATE/bug_report.md",
+                        "sha": "ghsha",
+                    }
+                ],
+            )
+        if p == "/api/v5/repos/acme/.gitcode/contents/.gitcode":
+            return httpx.Response(404, json={"message": "missing"})
+        raise AssertionError(f"unexpected {request.method} {p}")
+
+    client, _ = sync_client_factory(handler, owner="acme", repo="proj")
+    items = client.issues.list_templates()
+    assert len(items) == 1
+    assert items[0].path == ".github/ISSUE_TEMPLATE/bug_report.md"
+    assert items[0].sha == "ghsha"
+    assert items[0].template_owner == "acme"
+    assert items[0].template_repo == "proj"
+
+
+def test_get_template_from_dot_github_path(sync_client_factory):
+    path = ".github/PULL_REQUEST_TEMPLATE/default.md"
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        p = request.url.path
+        stub = _repo_metadata_nonfork_stub(request, p)
+        if stub is not None:
+            return stub
+        if p == "/api/v5/repos/acme/proj" and request.method == "GET" and "contents" not in p and "raw" not in p:
+            return httpx.Response(200, json={"fork": False})
+        if p == f"/api/v5/repos/acme/proj/raw/{path}":
+            return httpx.Response(200, content=b"github pr body")
+        raise AssertionError(f"unexpected {request.method} {p}")
+
+    client, _ = sync_client_factory(handler, owner="acme", repo="proj")
+    text = client.pulls.get_template(path=path)
+    assert text == "github pr body"

{gitcode_api-1.2.17 → gitcode_api-1.2.19}/tests/test_resources_misc.py

@@ -71,7 +71,7 @@ def test_releases_create_posts_documented_payload_and_models_assets(sync_client_
     client, http_client = sync_client_factory(handler, owner="SushiNinja", repo="GitCode-API")
     try:
         release = client.releases.create(
-            tag_name="v1.0.0",
+            tag="v1.0.0",
             name="v1.0.0",
             body="Release notes",
             target_commitish="main",

gitcode_api-1.2.17/gitcode_api/__init__.py

@@ -1,34 +0,0 @@
-"""Public package exports for the GitCode SDK."""
-
-import re
-from importlib.metadata import metadata
-from typing import cast
-
-from . import constants
-from ._client import AsyncGitCode, GitCode
-from ._exceptions import (
-    GitCodeAPIError,
-    GitCodeConfigurationError,
-    GitCodeError,
-    GitCodeHTTPStatusError,
-)
-from .utils import as_dict
-
-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",
-    "GitCodeConfigurationError",
-    "GitCodeError",
-    "GitCodeHTTPStatusError",
-    "as_dict",
-]

gitcode_api-1.2.17/gitcode_api/constants.py

@@ -1,8 +0,0 @@
-"""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/py.typed

@@ -1 +0,0 @@
-partial

gitcode_api-1.2.17/gitcode_api/version.txt

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