gitcode-api 1.2.17__py3-none-any.whl → 1.2.19__py3-none-any.whl

gitcode_api/__init__.py

@@ -1,7 +1,7 @@
 """Public package exports for the GitCode SDK."""
 
 import re
-from importlib.metadata import metadata
+from importlib.metadata import PackageNotFoundError, metadata, version
 from typing import cast
 
 from . import constants
@@ -14,11 +14,32 @@ from ._exceptions import (
 )
 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()
+_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",

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/constants.py

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

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

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

@@ -1 +1 @@
-1.2.17
+1.2.19

{gitcode_api-1.2.17.dist-info → gitcode_api-1.2.19.dist-info}/METADATA

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

@@ -1,31 +1,31 @@
-gitcode_api/__init__.py,sha256=c3FpiH2ISh_5FIUEHVALVBsv9rrUl501V0pbmu44z-g,872
+gitcode_api/__init__.py,sha256=94gg5E1bAWozIR6PBYIPdZMfj-VyBFJp_rQQda2Qagk,1672
 gitcode_api/__main__.py,sha256=Yd8P4MSNcWFqUTKnUaNibbWX4Vd-MVVNmhPFaohzqcA,137
-gitcode_api/_base_client.py,sha256=zc2WMxgMA4KdxrhS5Ptmlmf3UIsl09pUoXaOVOGpUms,13523
+gitcode_api/_base_client.py,sha256=qG-d6wlMwjvbK4bi4m4dwHNZR9wP2tSS9qiWFTIIsFA,13960
 gitcode_api/_base_resource.py,sha256=mlKe1b_1AKcqxhptaCpP-AOjKkLNzCbYG-Pkp1HYWrA,2238
 gitcode_api/_cli_banner.py,sha256=S6i8dnzCXrxytrboxNh_gz-x95u6w9E-Yz6IkTz2PJk,1576
 gitcode_api/_client.py,sha256=bmZxBHdfshM5Kv_EurHUVu8rsEj0k3Up3ATSIPaFrvc,8258
 gitcode_api/_exceptions.py,sha256=T5N8gBGmPSktDkLP5P_hxbzOHw3W378TzxN1xja40pA,1140
 gitcode_api/_models.py,sha256=ip0xgdWao8Z3ATfSaPn3KzG81OXd25RVB1ansOaJaUM,110586
 gitcode_api/cli.py,sha256=7ZrpWIh5zZdftMhbMjldiuvijig8qKLFiQbof93Cy6k,18792
-gitcode_api/constants.py,sha256=UYfSkmoRc71kIkgFYS5NFUoFhdbcXvnGV-EiJnvbELI,296
-gitcode_api/py.typed,sha256=mDShSrm8qg9qjacQc2F-rI8ATllqP6EdgHuEYxuCXZ0,7
+gitcode_api/constants.py,sha256=uzcI7dVq4Qx_toYtnIphUh1IGepv9NuOdJ4DCswiYgo,769
+gitcode_api/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gitcode_api/run_mcp.py,sha256=3_JOrjg9_yL-0M-H-F8mPgxdVKh7K2ggipu7UHeNCg0,147
 gitcode_api/utils.py,sha256=51QmPTQPeNsPSGf2IzhwmiEO1H2GkJrp2A7vkzhOOag,1351
-gitcode_api/version.txt,sha256=3vZfbhJrgomRbGajbYUy_iaIl-F0UxtE4rP7GwAihls,7
+gitcode_api/version.txt,sha256=Kt-wv6L2q7wzBPEfl6iGyfGBmEs0ik7CR57DsILDjYU,7
 gitcode_api/llm/__init__.py,sha256=rU75ZlJvTWNVxBLc3QzdfWmSjqVc9z6hfQ8z6jVVKOk,1693
 gitcode_api/llm/_tool.py,sha256=b65iUiHo1H29uA6mFM3WlD0zZlISsENx1tpEqlkiUoA,16239
 gitcode_api/llm/jiuwen.py,sha256=qca2y4544xoRYFOCMbkjiUZZLpJGMcBkK4w5bqs60-4,4276
 gitcode_api/llm/mcp.py,sha256=eeAuEETZ4THw31wbcnQaTlZQJ-9ZolvsejQY630OqHs,5702
 gitcode_api/llm/openai.py,sha256=FSPA0Jv-k4n1Ud92TDfP1TWRlW4FB7smaLwY331nagk,3257
 gitcode_api/resources/__init__.py,sha256=nsCKW0bFDZ5ombJZxLThmO82sOuF7o4OKUMRkAmwbwk,1725
-gitcode_api/resources/_shared.py,sha256=07f4Zk_bk6JKjEwubZ6iSd1Lq1rGi7CyWjvcMNMcYpo,15402
+gitcode_api/resources/_shared.py,sha256=My0DuLyd8q_SPByGcbmizUdN5r3yMbBJ1rUhsXF4LZw,15458
 gitcode_api/resources/account.py,sha256=mnc2p7wI-nBnHFNdWPNiHfmZpT6d3RDQC777gewtm4M,38801
-gitcode_api/resources/collaboration.py,sha256=TK0QXG_ymE4vbtHyP3Y-M39oG9zQE44UU5-UnPhF2WM,112388
+gitcode_api/resources/collaboration.py,sha256=je3ykQOTS_n9bSUr0gDYRkXVxhNtf1NJXWPWcuv5nSs,112783
 gitcode_api/resources/misc.py,sha256=w7bq8rmgKr2ScBKeWZ3EZJmAdylDdPtSPrhi3AQre7w,34747
 gitcode_api/resources/repositories.py,sha256=EAK2znZhEsgVUu-NDEQslSEEYJzvb-kHuh4mW57y6sc,78178
-gitcode_api-1.2.17.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
-gitcode_api-1.2.17.dist-info/METADATA,sha256=x3U0ebx62mxesdGHb3QFkXgVZMBTVP2DP75lLptx3IA,23592
-gitcode_api-1.2.17.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gitcode_api-1.2.17.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
-gitcode_api-1.2.17.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
-gitcode_api-1.2.17.dist-info/RECORD,,
+gitcode_api-1.2.19.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
+gitcode_api-1.2.19.dist-info/METADATA,sha256=lkda5yPPW5Nz2RTNiRmtIgptKm7RG-cdy8EVnWPQfk0,23592
+gitcode_api-1.2.19.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gitcode_api-1.2.19.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
+gitcode_api-1.2.19.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
+gitcode_api-1.2.19.dist-info/RECORD,,