gitcode-api 1.3.1__tar.gz → 1.3.2__tar.gz

{gitcode_api-1.3.1 → gitcode_api-1.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.3.1
+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 (Jin Huang)" <hugo@hugohuang.com>
 License-Expression: MIT
@@ -36,7 +36,7 @@ Requires-Dist: fastmcp; python_version >= "3.10" and extra == "mcp"
 Dynamic: license-file
 
 # 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://pepy.tech/projects/gitcode-api) ![MCP Bundle Downloads](https://img.shields.io/github/downloads/Trenza1ore/GitCode-API/total?color=blue&logo=modelcontextprotocol&label=MCPB%20%E2%86%93&uuid=96abf98469db4ee7bc12ded4646e76d9)
+[![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-1.3.1 → gitcode_api-1.3.2}/README.md

@@ -1,5 +1,5 @@
 # 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://pepy.tech/projects/gitcode-api) ![MCP Bundle Downloads](https://img.shields.io/github/downloads/Trenza1ore/GitCode-API/total?color=blue&logo=modelcontextprotocol&label=MCPB%20%E2%86%93&uuid=96abf98469db4ee7bc12ded4646e76d9)
+[![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-1.3.1 → gitcode_api-1.3.2}/gitcode_api/resources/account/users_resource_group.py

@@ -56,14 +56,26 @@ class AbstractUsersResource(ABC):
         """
 
     @abstractmethod
-    def list_repos(self, *, username: str, **params) -> List[Repository]:
+    def list_repos(
+        self,
+        *,
+        username: str,
+        type: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[Repository]:
         """List public repositories owned by a user.
 
-        Supported filters follow the user repository API documentation, such as
-        ``type``, ``sort``, ``direction``, ``page``, and ``per_page``.
-
         :param username: GitCode username or login.
-        :param params: Query parameters accepted by the REST endpoint.
+        :param type: Ownership filter: ``owner``, ``personal``, ``member``, or ``all``. Default: ``all``.
+        :param sort: Sort field: ``created``, ``updated``, ``pushed``, or ``full_name``. Default: ``full_name``.
+        :param direction: ``asc`` or ``desc``.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Matching repositories.
         """
 
@@ -149,8 +161,30 @@ class UsersResource(SyncResource, AbstractUsersResource):
             params={"year": year, "next": next},
         )
 
-    def list_repos(self, *, username: str, **params) -> List[Repository]:
-        return self._models("GET", self._client._path("users", username, "repos"), Repository, params=params)
+    def list_repos(
+        self,
+        *,
+        username: str,
+        type: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[Repository]:
+        return self._models(
+            "GET",
+            self._client._path("users", username, "repos"),
+            Repository,
+            params={
+                "type": type,
+                "sort": sort,
+                "direction": direction,
+                "page": page,
+                "per_page": per_page,
+                **kwargs,
+            },
+        )
 
     def create_key(self, *, key: str, title: str) -> PublicKey:
         return self._model("POST", self._client._path("user", "keys"), PublicKey, json={"key": key, "title": title})
@@ -210,8 +244,30 @@ class AsyncUsersResource(AsyncResource, AbstractUsersResource):
             params={"year": year, "next": next},
         )
 
-    async def list_repos(self, *, username: str, **params) -> List[Repository]:
-        return await self._models("GET", self._client._path("users", username, "repos"), Repository, params=params)
+    async def list_repos(
+        self,
+        *,
+        username: str,
+        type: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[Repository]:
+        return await self._models(
+            "GET",
+            self._client._path("users", username, "repos"),
+            Repository,
+            params={
+                "type": type,
+                "sort": sort,
+                "direction": direction,
+                "page": page,
+                "per_page": per_page,
+                **kwargs,
+            },
+        )
 
     async def create_key(self, *, key: str, title: str) -> PublicKey:
         return await self._model(

{gitcode_api-1.3.1 → gitcode_api-1.3.2}/gitcode_api/resources/collaboration/issues_resource_group.py

@@ -91,7 +91,7 @@ class AbstractIssuesResource(ABC):
         :param security_hole: Whether the issue is private; form field described in the Issues API (default public).
         :param template_path: issue template path, project templates support files under the .gitcode, .github, .gitee
             directories, and organization templates only support files under the .gitcode directory of .gitcode repo.
-        :param kwargs: Forwarded directly, useful since GitCode has awful documentation...
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Created issue details.
         """
 
@@ -246,28 +246,108 @@ class AbstractIssuesResource(ABC):
         """
 
     @abstractmethod
-    def list_enterprise(self, *, enterprise: str, **params) -> List[Issue]:
+    def list_enterprise(
+        self,
+        *,
+        enterprise: str,
+        state: Optional[str] = None,
+        labels: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        since: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        milestone: Optional[str] = None,
+        assignee: Optional[str] = None,
+        creator: Optional[str] = None,
+        program: Optional[str] = None,
+        created_at: Optional[str] = None,
+        created_before: Optional[str] = None,
+        **kwargs,
+    ) -> List[Issue]:
         """List enterprise issues visible to the caller.
 
         :param enterprise: Enterprise path or login.
-        :param params: Additional query parameters accepted by ``GET .../enterprises/{enterprise}/issues``.
+        :param state: Issue state: ``open``, ``closed``, or ``all``. Default: ``open``.
+        :param labels: Comma-separated list of label names.
+        :param sort: Sort field: ``created`` or ``updated_at``. Default: ``created_at``.
+        :param direction: ``asc`` or ``desc``. Default: ``desc``.
+        :param since: Return issues updated since this timestamp.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param milestone: Milestone name (``none`` for no milestone, ``*`` for any).
+        :param assignee: Assignee username (``none`` for unassigned, ``*`` for any).
+        :param creator: Creator username filter.
+        :param program: Project name (``none`` for unassociated, ``*`` for any).
+        :param created_at: Created-at timestamp filter.
+        :param created_before: Return issues created before this timestamp.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Enterprise-scoped issues.
         """
 
     @abstractmethod
-    def list_user(self, **params) -> List[Issue]:
+    def list_user(
+        self,
+        *,
+        filter: Optional[str] = None,
+        state: Optional[str] = None,
+        labels: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        since: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        schedule: Optional[str] = None,
+        deadline: Optional[str] = None,
+        created_at: Optional[str] = None,
+        finished_at: Optional[str] = None,
+        **kwargs,
+    ) -> List[Issue]:
         """List issues for the authenticated user.
 
-        :param params: Query parameters for ``GET /user/issues`` (filters, pagination, etc.).
+        :param filter: Filter mode: ``assigned``, ``created``, or ``all``. Default: ``assigned``.
+        :param state: Issue state: ``open`` or ``closed``. Default: ``open``.
+        :param labels: Comma-separated list of label names.
+        :param sort: Sort field: ``created`` or ``updated_at``. Default: ``created_at``.
+        :param direction: ``asc`` or ``desc``. Default: ``desc``.
+        :param since: Return issues updated since this timestamp.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param schedule: Schedule filter.
+        :param deadline: Deadline filter.
+        :param created_at: Created-at timestamp filter.
+        :param finished_at: Finished-at timestamp filter.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Issues assigned to or authored by the user, per API rules.
         """
 
     @abstractmethod
-    def list_org(self, *, org: str, **params) -> List[Issue]:
+    def list_org(
+        self,
+        *,
+        org: str,
+        filter: Optional[str] = None,
+        state: Optional[str] = None,
+        labels: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        created_at: Optional[str] = None,
+        **kwargs,
+    ) -> List[Issue]:
         """List organization issues visible to the current user.
 
         :param org: Organization path or login.
-        :param params: Query parameters for ``GET .../orgs/{org}/issues``.
+        :param filter: Filter mode: ``assigned``, ``created``, or ``all``. Default: ``assigned``.
+        :param state: Issue state: ``open`` or ``closed``. Default: ``open``.
+        :param labels: Comma-separated list of label names.
+        :param sort: Sort field: ``created`` or ``updated_at``. Default: ``created_at``.
+        :param direction: ``asc`` or ``desc``. Default: ``desc``.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param created_at: Created-at timestamp filter.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Organization-scoped issues.
         """
 
@@ -281,12 +361,22 @@ class AbstractIssuesResource(ABC):
         """
 
     @abstractmethod
-    def list_enterprise_comments(self, *, enterprise: str, number: Union[int, str], **params) -> List[IssueComment]:
+    def list_enterprise_comments(
+        self,
+        *,
+        enterprise: str,
+        number: Union[int, str],
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[IssueComment]:
         """List comments for an enterprise issue.
 
         :param enterprise: Enterprise path or login.
         :param number: Enterprise issue identifier in the path.
-        :param params: Optional pagination or filter query parameters.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Comments on the enterprise issue.
         """
 
@@ -422,7 +512,8 @@ class IssuesResource(SyncResource, AbstractIssuesResource):
                 "milestone": milestone,
                 "security_hole": security_hole,
                 "template_path": template_path,
-            } | kwargs,
+            }
+            | kwargs,
         )
 
     def update(
@@ -544,24 +635,133 @@ class IssuesResource(SyncResource, AbstractIssuesResource):
     ) -> None:
         self._request("DELETE", self._client._repo_path("issues", number, "labels", name, owner=owner, repo=repo))
 
-    def list_enterprise(self, *, enterprise: str, **params) -> List[Issue]:
-        return self._models("GET", self._client._path("enterprises", enterprise, "issues"), Issue, params=params)
+    def list_enterprise(
+        self,
+        *,
+        enterprise: str,
+        state: Optional[str] = None,
+        labels: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        since: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        milestone: Optional[str] = None,
+        assignee: Optional[str] = None,
+        creator: Optional[str] = None,
+        program: Optional[str] = None,
+        created_at: Optional[str] = None,
+        created_before: Optional[str] = None,
+        **kwargs,
+    ) -> List[Issue]:
+        return self._models(
+            "GET",
+            self._client._path("enterprises", enterprise, "issues"),
+            Issue,
+            params={
+                "state": state,
+                "labels": labels,
+                "sort": sort,
+                "direction": direction,
+                "since": since,
+                "page": page,
+                "per_page": per_page,
+                "milestone": milestone,
+                "assignee": assignee,
+                "creator": creator,
+                "program": program,
+                "created_at": created_at,
+                "created_before": created_before,
+                **kwargs,
+            },
+        )
 
-    def list_user(self, **params) -> List[Issue]:
-        return self._models("GET", self._client._path("user", "issues"), Issue, params=params)
+    def list_user(
+        self,
+        *,
+        filter: Optional[str] = None,
+        state: Optional[str] = None,
+        labels: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        since: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        schedule: Optional[str] = None,
+        deadline: Optional[str] = None,
+        created_at: Optional[str] = None,
+        finished_at: Optional[str] = None,
+        **kwargs,
+    ) -> List[Issue]:
+        return self._models(
+            "GET",
+            self._client._path("user", "issues"),
+            Issue,
+            params={
+                "filter": filter,
+                "state": state,
+                "labels": labels,
+                "sort": sort,
+                "direction": direction,
+                "since": since,
+                "page": page,
+                "per_page": per_page,
+                "schedule": schedule,
+                "deadline": deadline,
+                "created_at": created_at,
+                "finished_at": finished_at,
+                **kwargs,
+            },
+        )
 
-    def list_org(self, *, org: str, **params) -> List[Issue]:
-        return self._models("GET", self._client._path("orgs", org, "issues"), Issue, params=params)
+    def list_org(
+        self,
+        *,
+        org: str,
+        filter: Optional[str] = None,
+        state: Optional[str] = None,
+        labels: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        created_at: Optional[str] = None,
+        **kwargs,
+    ) -> List[Issue]:
+        return self._models(
+            "GET",
+            self._client._path("orgs", org, "issues"),
+            Issue,
+            params={
+                "filter": filter,
+                "state": state,
+                "labels": labels,
+                "sort": sort,
+                "direction": direction,
+                "page": page,
+                "per_page": per_page,
+                "created_at": created_at,
+                **kwargs,
+            },
+        )
 
     def get_enterprise_issue(self, *, enterprise: str, number: Union[int, str]) -> Issue:
         return self._model("GET", self._client._path("enterprises", enterprise, "issues", number), Issue)
 
-    def list_enterprise_comments(self, *, enterprise: str, number: Union[int, str], **params) -> List[IssueComment]:
+    def list_enterprise_comments(
+        self,
+        *,
+        enterprise: str,
+        number: Union[int, str],
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[IssueComment]:
         return self._models(
             "GET",
             self._client._path("enterprises", enterprise, "issues", number, "comments"),
             IssueComment,
-            params=params,
+            params={"page": page, "per_page": per_page, **kwargs},
         )
 
     def list_enterprise_labels(self, *, enterprise: str, issue_id: Union[int, str]) -> List[Label]:
@@ -785,26 +985,133 @@ class AsyncIssuesResource(AsyncResource, AbstractIssuesResource):
     ) -> None:
         await self._request("DELETE", self._client._repo_path("issues", number, "labels", name, owner=owner, repo=repo))
 
-    async def list_enterprise(self, *, enterprise: str, **params) -> List[Issue]:
-        return await self._models("GET", self._client._path("enterprises", enterprise, "issues"), Issue, params=params)
+    async def list_enterprise(
+        self,
+        *,
+        enterprise: str,
+        state: Optional[str] = None,
+        labels: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        since: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        milestone: Optional[str] = None,
+        assignee: Optional[str] = None,
+        creator: Optional[str] = None,
+        program: Optional[str] = None,
+        created_at: Optional[str] = None,
+        created_before: Optional[str] = None,
+        **kwargs,
+    ) -> List[Issue]:
+        return await self._models(
+            "GET",
+            self._client._path("enterprises", enterprise, "issues"),
+            Issue,
+            params={
+                "state": state,
+                "labels": labels,
+                "sort": sort,
+                "direction": direction,
+                "since": since,
+                "page": page,
+                "per_page": per_page,
+                "milestone": milestone,
+                "assignee": assignee,
+                "creator": creator,
+                "program": program,
+                "created_at": created_at,
+                "created_before": created_before,
+                **kwargs,
+            },
+        )
 
-    async def list_user(self, **params) -> List[Issue]:
-        return await self._models("GET", self._client._path("user", "issues"), Issue, params=params)
+    async def list_user(
+        self,
+        *,
+        filter: Optional[str] = None,
+        state: Optional[str] = None,
+        labels: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        since: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        schedule: Optional[str] = None,
+        deadline: Optional[str] = None,
+        created_at: Optional[str] = None,
+        finished_at: Optional[str] = None,
+        **kwargs,
+    ) -> List[Issue]:
+        return await self._models(
+            "GET",
+            self._client._path("user", "issues"),
+            Issue,
+            params={
+                "filter": filter,
+                "state": state,
+                "labels": labels,
+                "sort": sort,
+                "direction": direction,
+                "since": since,
+                "page": page,
+                "per_page": per_page,
+                "schedule": schedule,
+                "deadline": deadline,
+                "created_at": created_at,
+                "finished_at": finished_at,
+                **kwargs,
+            },
+        )
 
-    async def list_org(self, *, org: str, **params) -> List[Issue]:
-        return await self._models("GET", self._client._path("orgs", org, "issues"), Issue, params=params)
+    async def list_org(
+        self,
+        *,
+        org: str,
+        filter: Optional[str] = None,
+        state: Optional[str] = None,
+        labels: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        created_at: Optional[str] = None,
+        **kwargs,
+    ) -> List[Issue]:
+        return await self._models(
+            "GET",
+            self._client._path("orgs", org, "issues"),
+            Issue,
+            params={
+                "filter": filter,
+                "state": state,
+                "labels": labels,
+                "sort": sort,
+                "direction": direction,
+                "page": page,
+                "per_page": per_page,
+                "created_at": created_at,
+                **kwargs,
+            },
+        )
 
     async def get_enterprise_issue(self, *, enterprise: str, number: Union[int, str]) -> Issue:
         return await self._model("GET", self._client._path("enterprises", enterprise, "issues", number), Issue)
 
     async def list_enterprise_comments(
-        self, *, enterprise: str, number: Union[int, str], **params
+        self,
+        *,
+        enterprise: str,
+        number: Union[int, str],
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
     ) -> List[IssueComment]:
         return await self._models(
             "GET",
             self._client._path("enterprises", enterprise, "issues", number, "comments"),
             IssueComment,
-            params=params,
+            params={"page": page, "per_page": per_page, **kwargs},
         )
 
     async def list_enterprise_labels(self, *, enterprise: str, issue_id: Union[int, str]) -> List[Label]:

{gitcode_api-1.3.1 → gitcode_api-1.3.2}/gitcode_api/resources/collaboration/milestones_resource_group.py

@@ -14,12 +14,28 @@ class AbstractMilestonesResource(ABC):
     """Interface for Milestones resource endpoints."""
 
     @abstractmethod
-    def list(self, *, owner: Optional[str] = None, repo: Optional[str] = None, **params) -> List[Milestone]:
+    def list(
+        self,
+        *,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        state: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[Milestone]:
         """List milestones for a repository.
 
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository path. Uses the client default when omitted.
-        :param params: Query parameters accepted by the milestones listing (state, sort, pagination, etc.).
+        :param state: Milestone state: ``open``, ``closed``, or ``all``. Default: ``open``.
+        :param sort: Sort field such as ``due_on``.
+        :param direction: ``asc`` or ``desc``. Default: ``asc``.
+        :param page: Page number.
+        :param per_page: Page size.
+        :param kwargs: Additional arguments forwarded directly in request.
         :returns: Milestones.
         """
 
@@ -90,9 +106,30 @@ class AbstractMilestonesResource(ABC):
 class MilestonesResource(SyncResource, AbstractMilestonesResource):
     """Synchronous milestone endpoints."""
 
-    def list(self, *, owner: Optional[str] = None, repo: Optional[str] = None, **params) -> List[Milestone]:
+    def list(
+        self,
+        *,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        state: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[Milestone]:
         return self._models(
-            "GET", self._client._repo_path("milestones", owner=owner, repo=repo), Milestone, params=params
+            "GET",
+            self._client._repo_path("milestones", owner=owner, repo=repo),
+            Milestone,
+            params={
+                "state": state,
+                "sort": sort,
+                "direction": direction,
+                "page": page,
+                "per_page": per_page,
+                **kwargs,
+            },
         )
 
     def get(self, *, number: Union[int, str], owner: Optional[str] = None, repo: Optional[str] = None) -> Milestone:
@@ -142,9 +179,30 @@ class AsyncMilestonesResource(AsyncResource, AbstractMilestonesResource):
     Mirrors :class:`MilestonesResource`; see that class for parameter documentation.
     """
 
-    async def list(self, *, owner: Optional[str] = None, repo: Optional[str] = None, **params) -> List[Milestone]:
+    async def list(
+        self,
+        *,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        state: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        page: Optional[int] = None,
+        per_page: Optional[int] = None,
+        **kwargs,
+    ) -> List[Milestone]:
         return await self._models(
-            "GET", self._client._repo_path("milestones", owner=owner, repo=repo), Milestone, params=params
+            "GET",
+            self._client._repo_path("milestones", owner=owner, repo=repo),
+            Milestone,
+            params={
+                "state": state,
+                "sort": sort,
+                "direction": direction,
+                "page": page,
+                "per_page": per_page,
+                **kwargs,
+            },
         )
 
     async def get(