gitcode-api 1.3.0__py3-none-any.whl → 1.3.2__py3-none-any.whl

gitcode_api/resources/collaboration/pulls_resource_group.py

@@ -48,12 +48,26 @@ class AbstractPullsResource(ABC):
         direction: Optional[str] = None,
         page: Optional[int] = None,
         per_page: Optional[int] = None,
-        **params,
+        base: Optional[str] = None,
+        since: Optional[str] = None,
+        milestone_number: Optional[int] = None,
+        labels: Optional[str] = None,
+        author: Optional[str] = None,
+        assignee: Optional[str] = None,
+        reviewer: Optional[str] = None,
+        merged_after: Optional[str] = None,
+        merged_before: Optional[str] = None,
+        only_count: Optional[bool] = None,
+        created_after: Optional[str] = None,
+        created_before: Optional[str] = None,
+        updated_before: Optional[str] = None,
+        updated_after: Optional[str] = None,
+        **kwargs,
     ) -> Union[List[PullRequest], PullRequestCount]:
         """List pull requests for a repository.
 
-        When ``only_count`` is true in ``params`` (or passed via ``**params``), the API returns a
-        JSON object with counts per state instead of an array (see Pull Request API).
+        When ``only_count`` is true, the API returns a JSON object with counts per state
+        instead of an array (see Pull Request API).
 
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository path (name). Uses the client default when omitted.
@@ -62,10 +76,21 @@ class AbstractPullsResource(ABC):
         :param direction: ``asc`` or ``desc`` (API default is usually ``desc``).
         :param page: Current page number.
         :param per_page: Page size (max 100 per API documentation).
-        :param params: Extra query parameters from the Pull Request API, for example ``base``,
-            ``since``, ``author``, ``assignee``, ``reviewer``, ``milestone_number``, ``labels`` (comma-separated),
-            ``merged_after``, ``merged_before``, ``created_after``, ``created_before``, ``updated_after``,
-            ``updated_before``, ``only_count`` (boolean), and ISO 8601 timestamps (URL-encoded when sent).
+        :param base: Base branch filter.
+        :param since: Return PRs updated since this ISO 8601 timestamp.
+        :param milestone_number: Milestone number filter.
+        :param labels: Comma-separated label names.
+        :param author: Username of the PR creator.
+        :param assignee: Username of the PR assignee.
+        :param reviewer: Username of the PR reviewer.
+        :param merged_after: Return PRs merged after this ISO 8601 timestamp.
+        :param merged_before: Return PRs merged before this ISO 8601 timestamp.
+        :param only_count: If true, only return the count of merge requests.
+        :param created_after: Return PRs created after this ISO 8601 timestamp.
+        :param created_before: Return PRs created before this ISO 8601 timestamp.
+        :param updated_before: Return PRs updated before this ISO 8601 timestamp.
+        :param updated_after: Return PRs updated after this ISO 8601 timestamp.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: A list of pull requests, or an :class:`~gitcode_api._models.APIObject` for count-only responses.
         """
 
@@ -366,14 +391,25 @@ class AbstractPullsResource(ABC):
 
     @abstractmethod
     def list_operation_logs(
-        self, *, number: Union[int, str], owner: Optional[str] = None, repo: Optional[str] = None, **params
+        self,
+        *,
+        number: Union[int, str],
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        sort: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
     ) -> List[PullRequestOperationLog]:
         """List operation logs for a pull request.
 
         :param number: Pull request number.
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository path. Uses the client default when omitted.
-        :param params: Additional query parameters accepted by the operate_logs endpoint.
+        :param sort: Sort direction: ``desc`` (default) or ``asc``.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Log entries as generic API objects.
         """
 
@@ -467,20 +503,56 @@ class AbstractPullsResource(ABC):
         """
 
     @abstractmethod
-    def list_enterprise(self, *, enterprise: str, **params) -> List[PullRequest]:
+    def list_enterprise(
+        self,
+        *,
+        enterprise: str,
+        repo: Optional[str] = None,
+        state: Optional[str] = None,
+        issue_number: Optional[int] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[PullRequest]:
         """List enterprise pull requests.
 
         :param enterprise: Enterprise path or login.
-        :param params: Query parameters for the enterprise pull_requests listing.
+        :param repo: Repository path filter (query parameter).
+        :param state: Pull request state filter.
+        :param issue_number: Issue global id filter.
+        :param sort: Sort field. Default: sorted by creation time.
+        :param direction: ``asc`` or ``desc``.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Pull requests in the enterprise scope.
         """
 
     @abstractmethod
-    def list_org(self, *, org: str, **params) -> List[PullRequest]:
+    def list_org(
+        self,
+        *,
+        org: str,
+        state: Optional[str] = None,
+        issue_number: Optional[int] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[PullRequest]:
         """List pull requests for an organization scope.
 
         :param org: Organization path (``GET .../org/{org}/pull_requests``).
-        :param params: Query parameters accepted by that listing.
+        :param state: Pull request state filter.
+        :param issue_number: Global issue id filter.
+        :param sort: Sort field. Default: sorted by creation time.
+        :param direction: ``asc`` or ``desc``.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Organization-scoped pull requests.
         """
 
@@ -553,7 +625,21 @@ class PullsResource(SyncResource, AbstractPullsResource):
         direction: Optional[str] = None,
         page: Optional[int] = None,
         per_page: Optional[int] = None,
-        **params,
+        base: Optional[str] = None,
+        since: Optional[str] = None,
+        milestone_number: Optional[int] = None,
+        labels: Optional[str] = None,
+        author: Optional[str] = None,
+        assignee: Optional[str] = None,
+        reviewer: Optional[str] = None,
+        merged_after: Optional[str] = None,
+        merged_before: Optional[str] = None,
+        only_count: Optional[bool] = None,
+        created_after: Optional[str] = None,
+        created_before: Optional[str] = None,
+        updated_before: Optional[str] = None,
+        updated_after: Optional[str] = None,
+        **kwargs,
     ) -> Union[List[PullRequest], PullRequestCount]:
         path = self._client._repo_path("pulls", owner=owner, repo=repo)
         response = self._request(
@@ -565,7 +651,21 @@ class PullsResource(SyncResource, AbstractPullsResource):
                 "direction": direction,
                 "page": page,
                 "per_page": per_page,
-                **params,
+                "base": base,
+                "since": since,
+                "milestone_number": milestone_number,
+                "labels": labels,
+                "author": author,
+                "assignee": assignee,
+                "reviewer": reviewer,
+                "merged_after": merged_after,
+                "merged_before": merged_before,
+                "only_count": only_count,
+                "created_after": created_after,
+                "created_before": created_before,
+                "updated_before": updated_before,
+                "updated_after": updated_after,
+                **kwargs,
             },
         )
         if isinstance(response, dict):
@@ -801,12 +901,20 @@ class PullsResource(SyncResource, AbstractPullsResource):
         )
 
     def list_operation_logs(
-        self, *, number: Union[int, str], owner: Optional[str] = None, repo: Optional[str] = None, **params
+        self,
+        *,
+        number: Union[int, str],
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        sort: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
     ) -> List[PullRequestOperationLog]:
         data = self._request(
             "GET",
             self._client._repo_path("pulls", number, "operate_logs", owner=owner, repo=repo),
-            params=params,
+            params={"sort": sort, "page": page, "per_page": per_page, **kwargs},
         )
         return [as_model(item, PullRequestOperationLog) for item in data]
 
@@ -871,13 +979,61 @@ class PullsResource(SyncResource, AbstractPullsResource):
     ) -> List[Issue]:
         return self._models("GET", self._client._repo_path("pulls", number, "issues", owner=owner, repo=repo), Issue)
 
-    def list_enterprise(self, *, enterprise: str, **params) -> List[PullRequest]:
+    def list_enterprise(
+        self,
+        *,
+        enterprise: str,
+        repo: Optional[str] = None,
+        state: Optional[str] = None,
+        issue_number: Optional[int] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[PullRequest]:
         return self._models(
-            "GET", self._client._path("enterprises", enterprise, "pull_requests"), PullRequest, params=params
+            "GET",
+            self._client._path("enterprises", enterprise, "pull_requests"),
+            PullRequest,
+            params={
+                "repo": repo,
+                "state": state,
+                "issue_number": issue_number,
+                "sort": sort,
+                "direction": direction,
+                "page": page,
+                "per_page": per_page,
+                **kwargs,
+            },
         )
 
-    def list_org(self, *, org: str, **params) -> List[PullRequest]:
-        return self._models("GET", self._client._path("org", org, "pull_requests"), PullRequest, params=params)
+    def list_org(
+        self,
+        *,
+        org: str,
+        state: Optional[str] = None,
+        issue_number: Optional[int] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[PullRequest]:
+        return self._models(
+            "GET",
+            self._client._path("org", org, "pull_requests"),
+            PullRequest,
+            params={
+                "state": state,
+                "issue_number": issue_number,
+                "sort": sort,
+                "direction": direction,
+                "page": page,
+                "per_page": per_page,
+                **kwargs,
+            },
+        )
 
     def list_issue_pull_requests(self, *, enterprise: str, number: Union[int, str]) -> List[PullRequest]:
         return self._models(
@@ -947,7 +1103,21 @@ class AsyncPullsResource(AsyncResource, AbstractPullsResource):
         direction: Optional[str] = None,
         page: Optional[int] = None,
         per_page: Optional[int] = None,
-        **params,
+        base: Optional[str] = None,
+        since: Optional[str] = None,
+        milestone_number: Optional[int] = None,
+        labels: Optional[str] = None,
+        author: Optional[str] = None,
+        assignee: Optional[str] = None,
+        reviewer: Optional[str] = None,
+        merged_after: Optional[str] = None,
+        merged_before: Optional[str] = None,
+        only_count: Optional[bool] = None,
+        created_after: Optional[str] = None,
+        created_before: Optional[str] = None,
+        updated_before: Optional[str] = None,
+        updated_after: Optional[str] = None,
+        **kwargs,
     ) -> Union[List[PullRequest], PullRequestCount]:
         response = await self._request(
             "GET",
@@ -958,7 +1128,21 @@ class AsyncPullsResource(AsyncResource, AbstractPullsResource):
                 "direction": direction,
                 "page": page,
                 "per_page": per_page,
-                **params,
+                "base": base,
+                "since": since,
+                "milestone_number": milestone_number,
+                "labels": labels,
+                "author": author,
+                "assignee": assignee,
+                "reviewer": reviewer,
+                "merged_after": merged_after,
+                "merged_before": merged_before,
+                "only_count": only_count,
+                "created_after": created_after,
+                "created_before": created_before,
+                "updated_before": updated_before,
+                "updated_after": updated_after,
+                **kwargs,
             },
         )
         if isinstance(response, dict):
@@ -1173,10 +1357,20 @@ class AsyncPullsResource(AsyncResource, AbstractPullsResource):
         )
 
     async def list_operation_logs(
-        self, *, number: Union[int, str], owner: Optional[str] = None, repo: Optional[str] = None, **params
+        self,
+        *,
+        number: Union[int, str],
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        sort: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
     ) -> List[PullRequestOperationLog]:
         data = await self._request(
-            "GET", self._client._repo_path("pulls", number, "operate_logs", owner=owner, repo=repo), params=params
+            "GET",
+            self._client._repo_path("pulls", number, "operate_logs", owner=owner, repo=repo),
+            params={"sort": sort, "page": page, "per_page": per_page, **kwargs},
         )
         return [as_model(item, PullRequestOperationLog) for item in data]
 
@@ -1243,13 +1437,61 @@ class AsyncPullsResource(AsyncResource, AbstractPullsResource):
             "GET", self._client._repo_path("pulls", number, "issues", owner=owner, repo=repo), Issue
         )
 
-    async def list_enterprise(self, *, enterprise: str, **params) -> List[PullRequest]:
+    async def list_enterprise(
+        self,
+        *,
+        enterprise: str,
+        repo: Optional[str] = None,
+        state: Optional[str] = None,
+        issue_number: Optional[int] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[PullRequest]:
         return await self._models(
-            "GET", self._client._path("enterprises", enterprise, "pull_requests"), PullRequest, params=params
+            "GET",
+            self._client._path("enterprises", enterprise, "pull_requests"),
+            PullRequest,
+            params={
+                "repo": repo,
+                "state": state,
+                "issue_number": issue_number,
+                "sort": sort,
+                "direction": direction,
+                "page": page,
+                "per_page": per_page,
+                **kwargs,
+            },
         )
 
-    async def list_org(self, *, org: str, **params) -> List[PullRequest]:
-        return await self._models("GET", self._client._path("org", org, "pull_requests"), PullRequest, params=params)
+    async def list_org(
+        self,
+        *,
+        org: str,
+        state: Optional[str] = None,
+        issue_number: Optional[int] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[PullRequest]:
+        return await self._models(
+            "GET",
+            self._client._path("org", org, "pull_requests"),
+            PullRequest,
+            params={
+                "state": state,
+                "issue_number": issue_number,
+                "sort": sort,
+                "direction": direction,
+                "page": page,
+                "per_page": per_page,
+                **kwargs,
+            },
+        )
 
     async def list_issue_pull_requests(self, *, enterprise: str, number: Union[int, str]) -> List[PullRequest]:
         return await self._models(

gitcode_api/resources/repositories/repos_resource_group.py

@@ -474,13 +474,23 @@ class AbstractReposResource(ABC):
 
     @abstractmethod
     def get_download_statistics(
-        self, *, owner: Optional[str] = None, repo: Optional[str] = None, **params
+        self,
+        *,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+        direction: Optional[str] = None,
+        **kwargs,
     ) -> RepositoryDownloadStatistics:
         """Get download statistics for a repository.
 
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository name. Uses the client default when omitted.
-        :param params: Query parameters accepted by the statistics endpoint.
+        :param start_date: Start date filter (e.g. ``2024-01-06``).
+        :param end_date: End date filter (e.g. ``2024-12-06``).
+        :param direction: Sort direction: ``asc`` or ``desc``. Default: ``desc``.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Download statistics payload.
         """
 
@@ -856,13 +866,20 @@ class ReposResource(SyncResource, AbstractReposResource):
         return [as_model(item, RepositoryCustomizedRole) for item in data]
 
     def get_download_statistics(
-        self, *, owner: Optional[str] = None, repo: Optional[str] = None, **params
+        self,
+        *,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+        direction: Optional[str] = None,
+        **kwargs,
     ) -> RepositoryDownloadStatistics:
         return self._model(
             "GET",
             self._client._repo_path("download_statistics", owner=owner, repo=repo),
             RepositoryDownloadStatistics,
-            params=params,
+            params={"start_date": start_date, "end_date": end_date, "direction": direction, **kwargs},
         )
 
     def get_contributor_statistics(
@@ -1245,13 +1262,20 @@ class AsyncReposResource(AsyncResource, AbstractReposResource):
         return [as_model(item, RepositoryCustomizedRole) for item in data]
 
     async def get_download_statistics(
-        self, *, owner: Optional[str] = None, repo: Optional[str] = None, **params
+        self,
+        *,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+        direction: Optional[str] = None,
+        **kwargs,
     ) -> RepositoryDownloadStatistics:
         return await self._model(
             "GET",
             self._client._repo_path("download_statistics", owner=owner, repo=repo),
             RepositoryDownloadStatistics,
-            params=params,
+            params={"start_date": start_date, "end_date": end_date, "direction": direction, **kwargs},
         )
 
     async def get_contributor_statistics(

gitcode_api/version.txt

@@ -1 +1 @@
-1.3.0
+1.3.2

{gitcode_api-1.3.0.dist-info → gitcode_api-1.3.2.dist-info}/METADATA

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.3.0
+Version: 1.3.2
 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>
+Author-email: "Hugo (Jin 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
@@ -12,7 +12,7 @@ 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: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: 3
@@ -35,15 +35,12 @@ Provides-Extra: mcp
 Requires-Dist: fastmcp; python_version >= "3.10" and extra == "mcp"
 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=96abf98469db4ee7bc12ded4646e76d9)](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=96abf98469db4ee7bc12ded4646e76d9)](https://pepy.tech/projects/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) [![CI Badge](https://github.com/Trenza1ore/GitCode-API/actions/workflows/check-code.yml/badge.svg?uuid=96abf98469db4ee7bc12ded4646e76d9)](https://github.com/Trenza1ore/GitCode-API/actions/workflows/check-code.yml/)
+# GitCode-API [![GitCode Badge](https://img.shields.io/badge/gitcode-brown?logo=gitcode&link=https%3A%2F%2Fgitcode.com%2FSushiNinja%2FGitCode-API)](https://gitcode.com/SushiNinja/GitCode-API) [![GitHub Badge](https://img.shields.io/badge/github-black?logo=github&link=https%3A%2F%2Fgithub.com%2FTrenza1ore%2FGitCode-API)](https://github.com/Trenza1ore/GitCode-API)
+[![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?color=blue&uuid=96abf98469db4ee7bc12ded4646e76d9)](https://pypi.org/project/gitcode-api) [![PyPI - Downloads](https://img.shields.io/pypi/dm/gitcode-api?color=blue&logo=pypi&logoColor=white&label=pypi%20%E2%86%93&uuid=96abf98469db4ee7bc12ded4646e76d9)](https://pypistats.org/packages/gitcode-api) [![MCP Bundle Downloads](https://img.shields.io/github/downloads/Trenza1ore/GitCode-API/total?color=blue&logo=modelcontextprotocol&label=release%20%E2%86%93&uuid=96abf98469db4ee7bc12ded4646e76d9)](https://github.com/Trenza1ore/GitCode-API/releases)
 
 [![Docs](https://img.shields.io/badge/%E6%96%87%E6%A1%A3-Docs-cyan?style=for-the-badge&logo=readthedocs&link=https%3A%2F%2Fgitcode-api.readthedocs.io%2Fen%2Flatest%2Findex.html)](https://gitcode-api.readthedocs.io) [![中文README](https://img.shields.io/badge/%E4%B8%AD%E6%96%87-README-brown?style=for-the-badge&logo=googledocs&link=README.zh.md)](README.zh.md)
 
-`gitcode-api` is a community-maintained Python SDK for the GitCode REST API. It provides easy-to-use synchronous and asynchronous clients, repository-scoped helpers, and lightweight response models so you can work with GitCode from Python without hand-writing raw HTTP requests. The `gitcode_api.llm` module adds an OpenAI-style function tool, an MCP service, and an [openJiuwen](https://openjiuwen.com) tool integration so agents can reuse the same resource-oriented API.
+`gitcode-api` is a community-maintained Python SDK for the GitCode REST API. It provides easy-to-use synchronous and asynchronous clients, helpers methods grouped by resource groups, and type-hinted response models so you can work with GitCode from Python without hand-writing raw HTTP requests. The `gitcode_api.llm` module adds an OpenAI-style function tool, an MCP service, and an [openJiuwen](https://openjiuwen.com) tool integration so agents can reuse the same resource-oriented API.
 
 ## Why This Project
 
@@ -51,7 +48,7 @@ Dynamic: license-file
 - Sync and async clients with a consistent API surface.
 - Convenient methods not offered by REST API directly: such as fetching Issue and PR templates.
 - Resource groups such as `client.repos`, `client.pulls`, and `client.users`.
-- Repository defaults via `owner=` and `repo=` on the client.
+- Repository defaults via `owner` and `repo` on the client.
 - Sphinx docs plus a mirrored GitCode REST API reference in `docs/`.
 - Provides MCP server, OpenAI tool, and [openJiuwen](https://openjiuwen.com) tool for LLM agent usage.
 - Provide MCP service that directly installs to your IDE of choice, such as Cursor and VS Code!
@@ -77,14 +74,14 @@ For detailed setup (including installing to services like Claude Code / Codex):
 
 ## Authentication
 
-Pass `api_key=` directly, or set `GITCODE_ACCESS_TOKEN` in your environment:
+Pass `api_key` directly, or set `GITCODE_ACCESS_TOKEN` in your environment:
 
 ```bash
 export GITCODE_ACCESS_TOKEN="your-token"
 ```
 
-If your token is stored in encrypted form, pass `decrypt=` to decode either an
-encrypted `api_key=` value or an encrypted `GITCODE_ACCESS_TOKEN` value before
+If your token is stored in encrypted form, pass `decrypt` to decode either an
+encrypted `api_key` value or an encrypted `GITCODE_ACCESS_TOKEN` value before
 the client uses it.
 
 ```python
@@ -171,7 +168,7 @@ meta = as_dict(repo)  # dict
 
 ### Context managers
 
-`GitCode` and `AsyncGitCode` (and the lower-level `SyncAPIClient` / `AsyncAPIClient`) support `with` / `async with`. Leaving the block calls `close()` / `await close()` on the underlying client automatically, including a custom `http_client=` you passed in. `close()` also clears the LRU cache used by each resource group's `method_signature(...)` helper (see the [Available Resources](#available-resources) section).
+`GitCode` and `AsyncGitCode` (and the lower-level `SyncAPIClient` / `AsyncAPIClient`) support `with` / `async with`. Leaving the block calls `close()` / `await close()` on the underlying client automatically, including a custom `http_client` you passed in. `close()` also clears the LRU cache used by each resource group's `method_signature(...)` helper (see the [Available Resources](#available-resources) section).
 
 ```python
 from gitcode_api import GitCode
@@ -328,7 +325,7 @@ while True:
 pip install 'gitcode-api[mcp]'
 ```
 
-- **`create_mcp_server`** — builds a `FastMCP` instance with `gitcode_api_tool` already registered; optional `name=`, `tool=`, and extra keyword arguments are forwarded to `FastMCP(...)`.
+- **`create_mcp_server`** — builds a `FastMCP` instance with `gitcode_api_tool` already registered; optional `name`, `tool`, and extra keyword arguments are forwarded to `FastMCP(...)`.
 - **`GitCodeMCP`** — thin wrapper that constructs that server and registers the tool; unknown attributes are delegated to the underlying `FastMCP` object (for example transport helpers exposed by your FastMCP version).
 - **`create_mcp_gitcode_api_tool`** — returns the standalone async callable used as the tool body (for custom wiring).
 - **`register_mcp_gitcode_api_tool`** — attaches that callable to an existing FastMCP-compatible object (`mcp.tool(...)` or `mcp.add_tool(...)`).
@@ -342,7 +339,7 @@ mcp = create_mcp_server(name="GitCode API", owner="SushiNinja", repo="GitCode-AP
 
 The same server is available from the CLI as `gitcode-api serve` (see the [CLI](#cli) section).
 
-To share auth or clients across tools, build `GitCodeLLMTool` once (`from gitcode_api.llm._tool import GitCodeLLMTool`) and pass it as `tool=` into `GitCodeMCP`, `create_mcp_server`, `register_mcp_gitcode_api_tool`, or `create_mcp_gitcode_api_tool`.
+To share auth or clients across tools, build `GitCodeLLMTool` once (`from gitcode_api.llm._tool import GitCodeLLMTool`) and pass it as `tool` into `GitCodeMCP`, `create_mcp_server`, `register_mcp_gitcode_api_tool`, or `create_mcp_gitcode_api_tool`.
 
 ### openJiuwen (`LocalFunction`)
 
@@ -360,7 +357,7 @@ jiuwen_tool = create_openjiuwen_gitcode_api_tool(owner="SushiNinja", repo="GitCo
 # await jiuwen_tool.invoke({"op_type": "repos", "action": "get", "params": {}})
 ```
 
-Optional `name=` and `description=` override the default tool card. Constructor options otherwise mirror `GitCode` / `AsyncGitCode` (`client=`, `async_client=`, `api_key=`, `owner=`, `repo=`, `base_url=`, `timeout=`, `decrypt=`).
+Optional `name` and `description` override the default tool card. Constructor options otherwise mirror `GitCode` / `AsyncGitCode` (`client`, `async_client`, `api_key`, `owner`, `repo`, `base_url`, `timeout`, `decrypt`).
 
 **Claude Desktop (MCPB):** published GitHub Releases include a `gitcode-<version>.mcpb` bundle for one-click installation as a Claude Desktop extension; see Anthropic’s guide, [Build a desktop extension with MCPB](https://claude.com/docs/connectors/building/mcpb). From a checkout you can run `make mcpb` (requires the [`@anthropic-ai/mcpb`](https://www.npmjs.com/package/@anthropic-ai/mcpb) CLI on your `PATH`).
 
@@ -431,7 +428,7 @@ with GitCode(
 
 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.
+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.
 
 ## Project Status
 

{gitcode_api-1.3.0.dist-info → gitcode_api-1.3.2.dist-info}/RECORD

@@ -13,11 +13,11 @@ gitcode_api/models.py,sha256=Yfkn3zj2iEecOockytFS8lCNaYICYdjHdhpsxyaPkDk,4425
 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=ZNI_hY71Gw-Zbklm1OJ8A3G0N-LSeHiQsfetItTsVmM,6
+gitcode_api/version.txt,sha256=MxWJcqU4d7Qhz-JZi42TyrFpljpJZLRe6InoU0mXkBg,6
 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=azHkuz1JCU0C8F_jwZDDul6pxPR4DunnaV6floGS1Tw,5822
+gitcode_api/llm/mcp.py,sha256=Af-B1hgd1hOHx_IxafM8FygBtnd4BAGuw681fGjmBps,5821
 gitcode_api/llm/openai.py,sha256=FSPA0Jv-k4n1Ud92TDfP1TWRlW4FB7smaLwY331nagk,3257
 gitcode_api/resources/__init__.py,sha256=G5Pmi7J_I3APe8k0lJq9jaAP7Hz1JdFm5O1KwEkSIuw,1743
 gitcode_api/resources/_shared/__init__.py,sha256=JcwcLigNx5OxN0wGNEUlEy6baJdEdWfEVv5QVN0-Mo8,496
@@ -27,14 +27,14 @@ gitcode_api/resources/account/__init__.py,sha256=lZueYwioHR4dRyHoABGM05cT0YkO52T
 gitcode_api/resources/account/oauth_resource_group.py,sha256=kmHHjtRhqtkOqB228nPp-ci5Wy1GAfSr0olWKObA36s,5690
 gitcode_api/resources/account/orgs_resource_group.py,sha256=AnwuP23N9MkmS7QHeNGCG7s6GRTCVL6Cm7VgHGFxP_4,16539
 gitcode_api/resources/account/search_resource_group.py,sha256=0xqJUOEFdCnyEA_EhwhJoNMXo8wpXU-DYfG7Dl0zyIk,6998
-gitcode_api/resources/account/users_resource_group.py,sha256=OJULyX5-yZtx9zPUL0pWiUEOmy2TFq2d27snEafZltY,8977
+gitcode_api/resources/account/users_resource_group.py,sha256=uFUcYS_fPP73If8rIklSyI_swyDtaeCYBfeFzIidv3w,10373
 gitcode_api/resources/collaboration/__init__.py,sha256=jcH-u9KIgLEThoqKShh7MkBdqKioZ93gNY58hJeTWW0,727
 gitcode_api/resources/collaboration/_helpers.py,sha256=t2OYoMo0_jra4hQIrYRpY88ZZNrZJRe6EiCwOM9t0uU,305
-gitcode_api/resources/collaboration/issues_resource_group.py,sha256=oUbkTfT7Tzy1TT3ikvSMRRlrdoUfEBGapzpgyWuIbVg,31345
+gitcode_api/resources/collaboration/issues_resource_group.py,sha256=QXu6wwuozaX4j7l33J-R9ATfOkNB-8k7lIqCmD7w5eg,41677
 gitcode_api/resources/collaboration/labels_resource_group.py,sha256=TML77N2t_IWO3uoPyQNl-wNVPF7L75syHkdFQa89vSk,9549
 gitcode_api/resources/collaboration/members_resource_group.py,sha256=qd_6fV5bllGMJ-9SDvNDLj_XiGloXsiv27qufboUX5g,6770
-gitcode_api/resources/collaboration/milestones_resource_group.py,sha256=kVnZqWLctQ7J4dlc9Bxe9F_xH_ZcFg0Xt1ThaGiEMgg,7084
-gitcode_api/resources/collaboration/pulls_resource_group.py,sha256=pgLbF1i1qoIGn1Sjs11gn_BePK46Cd4BTvxTWCVOO-M,49701
+gitcode_api/resources/collaboration/milestones_resource_group.py,sha256=Nz--QZAHwgIjwVTDrlFTYtPSBtF2f85-cpzUAC1M1ic,8525
+gitcode_api/resources/collaboration/pulls_resource_group.py,sha256=op1NHAfIIcY5NHucn2o3hg0V53DkjVmrGWKrj4ags6U,57561
 gitcode_api/resources/misc/__init__.py,sha256=UWmADs0zoWrn4L2ZlaWTkt3CMQfRE_IADzruNGaJmm4,451
 gitcode_api/resources/misc/releases_resource_group.py,sha256=FuedWSqbAsbSc0ppIVwJl_mB2TWFizYCCyJSE9PtSQI,15244
 gitcode_api/resources/misc/tags_resource_group.py,sha256=jzs9ezJbBanI2LOSBWK7U0zMql0Xxz1hgOaNzC_Ncro,9662
@@ -43,10 +43,10 @@ gitcode_api/resources/repositories/__init__.py,sha256=HuatiYSlbk_yACIvzgVQyMuHQO
 gitcode_api/resources/repositories/branches_resource_group.py,sha256=dGhd6241IzhLuHCmtjYWsTxDhhS9tgLT6zvyz6lYPiY,5673
 gitcode_api/resources/repositories/commits_resource_group.py,sha256=vqgy_-d7Ec-5w6FKWJ0v6QGbh9mtjnmqm7iZ9P5gBLw,11254
 gitcode_api/resources/repositories/repo_contents_resource_group.py,sha256=pPsEMTU_3kbSNlCRtkHM7dUdzAo3lLxdYleMs1vmLBU,14832
-gitcode_api/resources/repositories/repos_resource_group.py,sha256=kAEdbKODhqsGRmf0ZwL0kTo6s3ujhDJgpzBYJ-b2EX4,46548
-gitcode_api-1.3.0.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
-gitcode_api-1.3.0.dist-info/METADATA,sha256=nXpVtzCnuXV9Y1fdxE3mJVlPzryyCGixsOcGPgSoXpM,23648
-gitcode_api-1.3.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gitcode_api-1.3.0.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
-gitcode_api-1.3.0.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
-gitcode_api-1.3.0.dist-info/RECORD,,
+gitcode_api/resources/repositories/repos_resource_group.py,sha256=nUOgMRTzSaA8ZM8tLumMtxWB2a-a0hjYgfLh2UUiSDw,47380
+gitcode_api-1.3.2.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
+gitcode_api-1.3.2.dist-info/METADATA,sha256=1y9U5O2-83k9gdOGv-g4cV9PdOqHu6s9LlfSdyA9WWE,22512
+gitcode_api-1.3.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gitcode_api-1.3.2.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
+gitcode_api-1.3.2.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
+gitcode_api-1.3.2.dist-info/RECORD,,