gitcode-api 1.2.18__tar.gz → 1.2.20__tar.gz

{gitcode_api-1.2.18 → gitcode_api-1.2.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.18
+Version: 1.2.20
 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=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)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=07b9a0e809feb403999bf97670a5d29f)](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=07b9a0e809feb403999bf97670a5d29f)](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.18 → gitcode_api-1.2.20}/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=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)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F&uuid=07b9a0e809feb403999bf97670a5d29f)](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=07b9a0e809feb403999bf97670a5d29f)](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.18 → gitcode_api-1.2.20}/gitcode_api/_base_client.py

@@ -21,7 +21,7 @@ def _drop_none_values(mapping: Dict[str, Any]) -> Dict[str, Any]:
 
 
 def _default_decrypt(value: Any) -> str:
-    """Dummy decryption function, basically a no-op."""
+    """Just a dummy decryption function, basically a no-op."""
     return value
 
 

gitcode_api-1.2.20/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.18 → gitcode_api-1.2.20}/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)]
@@ -224,10 +219,13 @@ async def list_gitcode_template_rows_async(
     repo: str,
     path_pattern: Pattern[str],
 ) -> List[Tuple[str, str, str, str]]:
+    """Return ``(template_owner, template_repo, path, sha)`` from the first resolution source with matches."""
     for so, sr in await _resolution_sources_async(client, owner, repo):
         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)]
@@ -242,6 +240,8 @@ def get_gitcode_template_body_sync(
     path_pattern: Pattern[str],
     owner: str,
     repo: str,
+    encoding: str = "utf-8",
+    **decoding_kwargs,
 ) -> str:
     """Fetch raw template text from the first resolution source that serves ``path``."""
     if not path_pattern.match(path):
@@ -262,7 +262,7 @@ def get_gitcode_template_body_sync(
             last_error = exc
             continue
         if isinstance(raw, bytes):
-            return raw.decode("utf-8")
+            return raw.decode(encoding=encoding, **decoding_kwargs)
         if isinstance(raw, str):
             return raw
         return str(raw)
@@ -281,7 +281,10 @@ async def get_gitcode_template_body_async(
     path_pattern: Pattern[str],
     owner: str,
     repo: str,
+    encoding: str = "utf-8",
+    **decoding_kwargs,
 ) -> str:
+    """Fetch raw template text from the first resolution source that serves ``path``."""
     if not path_pattern.match(path):
         raise GitCodeHTTPStatusError(
             "Path does not match the expected GitCode template pattern for this resource.",
@@ -300,7 +303,7 @@ async def get_gitcode_template_body_async(
             last_error = exc
             continue
         if isinstance(raw, bytes):
-            return raw.decode("utf-8")
+            return raw.decode(encoding=encoding, **decoding_kwargs)
         if isinstance(raw, str):
             return raw
         return str(raw)

{gitcode_api-1.2.18 → gitcode_api-1.2.20}/gitcode_api/resources/account.py

@@ -909,37 +909,106 @@ class AsyncSearchResource(AsyncResource):
     see ``docs/rest_api/search`` and the synchronous methods for field meanings.
     """
 
-    async def users(self, *, q: str, **params) -> List[SearchUser]:
+    async def users(
+        self,
+        *,
+        q: str,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        sort: Optional[str] = None,
+        order: Optional[str] = None,
+    ) -> List[SearchUser]:
         """Search users.
 
-        :param q: Search keywords (required).
-        :param params: Optional query parameters merged into the request, such as ``page``,
-            ``per_page``, ``sort``, and ``order`` (same meanings as :meth:`SearchResource.users`).
+        :param q: Search keywords.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param sort: Optional sort field such as ``joined_at``.
+        :param order: Sort order, usually ``asc`` or ``desc``.
         :returns: Matching user search results.
         """
-        return await self._models("GET", self._client._path("search", "users"), SearchUser, params={"q": q, **params})
+        return await self._models(
+            "GET",
+            self._client._path("search", "users"),
+            SearchUser,
+            params={"q": q, "page": page, "per_page": per_page, "sort": sort, "order": order},
+        )
 
-    async def issues(self, *, q: str, **params) -> List[SearchIssue]:
+    async def issues(
+        self,
+        *,
+        q: str,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        sort: Optional[str] = None,
+        order: Optional[str] = None,
+        repo: Optional[str] = None,
+        state: Optional[str] = None,
+    ) -> List[SearchIssue]:
         """Search issues.
 
-        :param q: Search keywords (required).
-        :param params: Optional query parameters merged into the request, such as ``page``,
-            ``per_page``, ``sort``, ``order``, ``repo``, and ``state`` (see :meth:`SearchResource.issues`).
+        :param q: Search keywords.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param sort: Optional sort field.
+        :param order: Sort order, usually ``asc`` or ``desc``.
+        :param repo: Optional repository path filter.
+        :param state: Optional issue state filter.
         :returns: Matching issue search results.
         """
-        return await self._models("GET", self._client._path("search", "issues"), SearchIssue, params={"q": q, **params})
+        return await self._models(
+            "GET",
+            self._client._path("search", "issues"),
+            SearchIssue,
+            params={
+                "q": q,
+                "page": page,
+                "per_page": per_page,
+                "sort": sort,
+                "order": order,
+                "repo": repo,
+                "state": state,
+            },
+        )
 
-    async def repositories(self, *, q: str, **params) -> List[SearchRepository]:
+    async def repositories(
+        self,
+        *,
+        q: str,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        sort: Optional[str] = None,
+        order: Optional[str] = None,
+        owner: Optional[str] = None,
+        fork: Optional[str] = None,
+        language: Optional[str] = None,
+    ) -> List[SearchRepository]:
         """Search repositories.
 
-        :param q: Search keywords (required).
-        :param params: Optional query parameters merged into the request, such as ``page``,
-            ``per_page``, ``sort``, ``order``, ``owner``, ``fork``, and ``language``
-            (see :meth:`SearchResource.repositories`).
+        :param q: Search keywords.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param sort: Optional sort field such as ``stars_count``.
+        :param order: Sort order, usually ``asc`` or ``desc``.
+        :param owner: Optional owner path filter.
+        :param fork: Optional fork visibility filter.
+        :param language: Optional programming language filter.
         :returns: Matching repository search results.
         """
         return await self._models(
-            "GET", self._client._path("search", "repositories"), SearchRepository, params={"q": q, **params}
+            "GET",
+            self._client._path("search", "repositories"),
+            SearchRepository,
+            params={
+                "q": q,
+                "page": page,
+                "per_page": per_page,
+                "sort": sort,
+                "order": order,
+                "owner": owner,
+                "fork": fork,
+                "language": language,
+            },
         )