gitcode-api 1.2.16__py3-none-any.whl → 1.2.18__py3-none-any.whl

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 PackageNotFoundError, metadata, version
+from typing import cast
 
+from . import constants
 from ._client import AsyncGitCode, GitCode
 from ._exceptions import (
     GitCodeAPIError,
@@ -11,10 +14,37 @@ from ._exceptions import (
 )
 from .utils import as_dict
 
-__version__ = (Path(__file__).parent / "version.txt").read_text().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",
     "__version__",
+    "__build_hash__",
     "AsyncGitCode",
     "GitCode",
     "GitCodeAPIError",

gitcode_api/_base_client.py

@@ -12,11 +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"
-DEFAULT_CA_ENV = "GITCODE_CA_BUNDLE"
+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]:
@@ -24,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.
 
@@ -46,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(
@@ -79,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/_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/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/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/py.typed

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

gitcode_api/version.txt

@@ -1 +1 @@
-1.2.16
+1.2.18

{gitcode_api-1.2.16.dist-info → gitcode_api-1.2.18.dist-info}/METADATA

@@ -1,16 +1,16 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.16
+Version: 1.2.18
 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=da2880de93fd4f4e9d40eeb7df479829)](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=d8567ce466b142c6acc4b21bdec35cbd)](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=f049bfb2e9a847dfb667888d9e54d163)](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=3d4c578403ac4d8aab1c59a48425e14b)](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.16.dist-info → gitcode_api-1.2.18.dist-info}/RECORD

@@ -1,16 +1,17 @@
-gitcode_api/__init__.py,sha256=vqRBOTuk4UygSh2y4wZSTiK2FNY8DSqjcSGjC3W0ifg,539
+gitcode_api/__init__.py,sha256=94gg5E1bAWozIR6PBYIPdZMfj-VyBFJp_rQQda2Qagk,1672
 gitcode_api/__main__.py,sha256=Yd8P4MSNcWFqUTKnUaNibbWX4Vd-MVVNmhPFaohzqcA,137
-gitcode_api/_base_client.py,sha256=knOWB3ppW2AEEFuSjC89F7AYVEhcRE4KMVtEqlT8Jzk,13587
+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=3DsoJ2qZ-mWWB4yD-cnxDN_osXzrUKabrA5tbV6752M,978
+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=Z-X5gK8iI2wCEXqT-igVKpVzO4ZhaRYaxmTbqMbIUx8,18735
-gitcode_api/py.typed,sha256=mDShSrm8qg9qjacQc2F-rI8ATllqP6EdgHuEYxuCXZ0,7
+gitcode_api/cli.py,sha256=7ZrpWIh5zZdftMhbMjldiuvijig8qKLFiQbof93Cy6k,18792
+gitcode_api/constants.py,sha256=UYfSkmoRc71kIkgFYS5NFUoFhdbcXvnGV-EiJnvbELI,296
+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=4VkQEA8HJ0Uo1YxpYgTG7ZV380aDnxGbtKY9rf37tsU,7
+gitcode_api/version.txt,sha256=EEaCKUK2jb-KMegeJfWHxBHsQs-nsTSYst95cj6LJIo,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
@@ -22,9 +23,9 @@ gitcode_api/resources/account.py,sha256=mnc2p7wI-nBnHFNdWPNiHfmZpT6d3RDQC777gewt
 gitcode_api/resources/collaboration.py,sha256=TK0QXG_ymE4vbtHyP3Y-M39oG9zQE44UU5-UnPhF2WM,112388
 gitcode_api/resources/misc.py,sha256=w7bq8rmgKr2ScBKeWZ3EZJmAdylDdPtSPrhi3AQre7w,34747
 gitcode_api/resources/repositories.py,sha256=EAK2znZhEsgVUu-NDEQslSEEYJzvb-kHuh4mW57y6sc,78178
-gitcode_api-1.2.16.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
-gitcode_api-1.2.16.dist-info/METADATA,sha256=KKD1GlaXWDlszyfUX3Ar7vd6DA9PDNBAsSj_0-4fwYg,23592
-gitcode_api-1.2.16.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gitcode_api-1.2.16.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
-gitcode_api-1.2.16.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
-gitcode_api-1.2.16.dist-info/RECORD,,
+gitcode_api-1.2.18.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
+gitcode_api-1.2.18.dist-info/METADATA,sha256=QsYuYvwW_j8YWO2FV6YnK6HBOCu9BDLjfIjUaYL_8SI,23592
+gitcode_api-1.2.18.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gitcode_api-1.2.18.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
+gitcode_api-1.2.18.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
+gitcode_api-1.2.18.dist-info/RECORD,,