gitcode-api 1.1.3__py3-none-any.whl → 1.2.1__py3-none-any.whl

gitcode_api/__main__.py

@@ -1,3 +1,5 @@
+"""Run the package CLI via ``python -m gitcode_api``."""
+
 from .cli import main
 
 if __name__ == "__main__":

gitcode_api/_base_client.py

@@ -10,6 +10,7 @@ from urllib.parse import quote
 
 import httpx
 
+from ._base_resource import BaseResource
 from ._exceptions import GitCodeConfigurationError, GitCodeHTTPStatusError
 
 DEFAULT_BASE_URL = "https://api.gitcode.com/api/v5"
@@ -181,6 +182,13 @@ class BaseGitCodeClient:
         except ValueError:
             return response.text
 
+    def _close_resources(self) -> None:
+        """Release resource group caches to allow for garbage collection."""
+        for attr in dir(self):
+            resource = getattr(self, attr)
+            if isinstance(resource, BaseResource):
+                resource.method_signature.cache_clear()
+
 
 class SyncAPIClient(BaseGitCodeClient):
     """Low-level synchronous HTTP transport used by resource classes.
@@ -207,7 +215,6 @@ class SyncAPIClient(BaseGitCodeClient):
     ) -> None:
         """Create or reuse an ``httpx.Client`` for synchronous requests."""
         super().__init__(api_key=api_key, owner=owner, repo=repo, base_url=base_url, timeout=timeout, decrypt=decrypt)
-        self._owns_client = http_client is None
         self._client = http_client or httpx.Client(timeout=self.timeout)
 
     def request(
@@ -244,7 +251,8 @@ class SyncAPIClient(BaseGitCodeClient):
         return self._parse_response(response, raw=raw)
 
     def close(self) -> None:
-        """Close the underlying HTTP client."""
+        """Close the underlying HTTP client and clear cache for garbage collection."""
+        self._close_resources()
         self._client.close()
 
     def __enter__(self) -> "SyncAPIClient":
@@ -281,7 +289,6 @@ class AsyncAPIClient(BaseGitCodeClient):
     ) -> None:
         """Create or reuse an ``httpx.AsyncClient`` for asynchronous requests."""
         super().__init__(api_key=api_key, owner=owner, repo=repo, base_url=base_url, timeout=timeout, decrypt=decrypt)
-        self._owns_client = http_client is None
         self._client = http_client or httpx.AsyncClient(timeout=self.timeout)
 
     async def request(
@@ -318,7 +325,8 @@ class AsyncAPIClient(BaseGitCodeClient):
         return self._parse_response(response, raw=raw)
 
     async def close(self) -> None:
-        """Close the underlying async HTTP client."""
+        """Close the underlying async HTTP client and clear cache for garbage collection."""
+        self._close_resources()
         await self._client.aclose()
 
     async def __aenter__(self) -> "AsyncAPIClient":

gitcode_api/_base_resource.py

@@ -0,0 +1,60 @@
+"""Resource base classe for the GitCode SDK."""
+
+from functools import cached_property, lru_cache
+
+_UTILITY_METHODS = {"methods", "method_signature"}
+_DATA_MODEL_PATH = "gitcode_api._models."
+
+
+class BaseResource:
+    """Resource group base class."""
+
+    def __del__(self) -> None:
+        """Attempt to clear the lru cache."""
+        self.method_signature.cache_clear()
+
+    @cached_property
+    def methods(self) -> tuple[str, ...]:
+        """Public callable names on this resource group in stable SDK order.
+
+        Ordering uses :func:`sorted` with a key derived from each name's
+        underscore-separated segments (for example two-part names are ordered
+        as if ``second_first``). This is not plain lexicographic order on the
+        full method string. Excludes ``methods``, names starting with ``_``,
+        and non-callables. The result is cached on first access.
+
+        :returns: Tuple of method names in that order.
+        """
+
+        def _is_valid_func(name: str):
+            return not (name.startswith("_") or name in _UTILITY_METHODS) and callable(getattr(self, name))
+
+        def _sort_helper(method_name: str):
+            name_parts = method_name.split("_")
+            num_part = len(name_parts)
+            if num_part == 2:
+                return f"{name_parts[1]}_{name_parts[0]}"
+            if num_part == 3:
+                return f"{{{name_parts[0]}_"
+            return "_" + method_name
+
+        return tuple(
+            sorted(
+                (func for func in dir(self) if _is_valid_func(func)),
+                key=_sort_helper,
+            )
+        )
+
+    @lru_cache(maxsize=50)
+    def method_signature(self, method_name: str) -> str:
+        """Return signature for a method in this resource group, result is cached.
+
+        For example ``client.pulls.method_signature("list_issues")`` would return:
+        list_issues(*, number: Union[int, str], owner: Optional[str] = None, repo: Optional[str] = None) -> List[Issue]
+
+        :param method_name: Attribute name of a callable on this resource.
+        :returns: Formatted signature.
+        """
+        import inspect
+
+        return method_name + str(inspect.signature(getattr(self, method_name))).replace(_DATA_MODEL_PATH, "")

gitcode_api/_cli_banner.py

@@ -0,0 +1,31 @@
+"""ASCII art banner for command-line interface."""
+
+from functools import lru_cache
+import sys
+
+# ANSI Colour Codes
+CREDBG = "\033[41m"
+CRED = "\033[91m"
+CBLU = "\033[94m"
+CCYN = "\033[96m"
+CGRN = "\033[92m"
+CYEL = "\033[41m"
+CEND = "\033[0m"
+
+# ASCII Art Banner
+BANNER = r"""
+   _____ _ _    _____          _                 _____ _____ 
+  / ____(_) |  / ____|        | |          /\   |  __ \_   _|
+ | |  __ _| |_| |     ___   __| | ___     /  \  | |__) || |  
+ | | |_ | | __| |    / _ \ / _` |/ _ \   / /\ \ |  ___/ | |  
+ | |__| | | |_| |___| (_) | (_| |  __/  / ____ \| |    _| |_ 
+  \_____|_|\__|\_____\___/ \__,_|\___| /_/    \_\_|   |_____|
+""".strip("\n")
+
+
+@lru_cache(maxsize=1)
+def format_default_welcome(version: str) -> str:
+    """Colored banner and version line for the no-arguments launcher (plain if not a TTY)."""
+    if sys.stdout.isatty():
+        return f"{CRED}{BANNER}{CEND}\n{CBLU}  Ver. {version}{CEND}\n\n"
+    return f"{BANNER}\n  Ver. {version}\n\n"

gitcode_api/_client.py

@@ -144,6 +144,7 @@ class GitCode(SyncAPIClient):
         self.oauth = OAuthResource(self)
 
     def __enter__(self) -> "GitCode":
+        """Enter synchronous context and return this client."""
         return self
 
 
@@ -246,4 +247,5 @@ class AsyncGitCode(AsyncAPIClient):
         self.oauth = AsyncOAuthResource(self)
 
     async def __aenter__(self) -> "AsyncGitCode":
+        """Enter asynchronous context and return this client."""
         return self

gitcode_api/_models.py

@@ -73,6 +73,7 @@ class APIObject(Mapping[str, Any]):
     data: MutableMapping[str, Any] = field(init=False, repr=False)
 
     def __init__(self, data: Mapping[str, Any]):
+        """Initialize from API response data."""
         payload = dict(data)
         object.__setattr__(self, "data", payload)
         type_hints = get_type_hints(self.__class__)
@@ -95,24 +96,30 @@ class APIObject(Mapping[str, Any]):
             object.__setattr__(self, model_field.name, value)
 
     def __getitem__(self, key: str) -> Any:
+        """Return the value for ``key`` from the backing mapping."""
         return _wrap_value(self.data[key])
 
     def __iter__(self) -> Iterator[str]:
+        """Iterate keys of the backing mapping."""
         return iter(self.data)
 
     def __len__(self) -> int:
+        """Return the number of keys in the backing mapping."""
         return len(self.data)
 
     def __getattr__(self, name: str) -> Any:
+        """Resolve unknown attributes from the backing mapping."""
         try:
             return _wrap_value(self.data[name])
         except KeyError as exc:
             raise AttributeError(name) from exc
 
     def get(self, key: str, default: Any = None) -> Any:
+        """Return the value for ``key``, or ``default`` if missing."""
         return _wrap_value(self.data.get(key, default))
 
     def to_dict(self) -> Dict[str, Any]:
+        """Return a shallow copy of the backing mapping."""
         return dict(self.data)
 
 

gitcode_api/cli.py

@@ -3,17 +3,39 @@
 import argparse
 import inspect
 import json
+import re
 import sys
+import textwrap
 from collections.abc import Mapping, Sequence
 from pathlib import Path
 from typing import Any, List, Optional, Union, get_args, get_origin
 
+import httpx
+
 from . import GitCode, __version__
 from ._base_client import DEFAULT_BASE_URL, DEFAULT_TOKEN_ENV
+from ._cli_banner import format_default_welcome
 from ._exceptions import GitCodeError
 from .resources._shared import SyncResource
 
 
+class _CLIHelpFormatter(argparse.RawDescriptionHelpFormatter, argparse.ArgumentDefaultsHelpFormatter):
+    """Preserve paragraph breaks in descriptions; wider columns for signatures."""
+
+    def __init__(self, prog: str) -> None:
+        super().__init__(prog, width=108, max_help_position=32)
+
+
+def _plain_cli_inline(text: str) -> str:
+    """Strip Sphinx-style inline markup (roles, doubled literals) for terminal text."""
+    if not text:
+        return ""
+    t = re.sub(r"``\s*([^`]+?)\s*``", r"\1", text)
+    t = re.sub(r":\w+:`([^`]*)`", r"\1", t)
+    t = re.sub(r"`([^`]+)`", r"\1", t)
+    return t
+
+
 def _unwrap_optional(annotation: Any) -> Any:
     origin = get_origin(annotation)
     if origin is Union:
@@ -51,8 +73,17 @@ def _argument_kwargs(parameter: inspect.Parameter) -> dict[str, Any]:
 
 
 def _first_doc_line(obj: Any) -> str:
-    doc = inspect.getdoc(obj) or ""
-    return doc.splitlines()[0] if doc else ""
+    doc = inspect.getdoc(obj).removeprefix("Synchronous ").capitalize() or ""
+    for line in doc.splitlines():
+        stripped = line.strip()
+        if stripped:
+            return _plain_cli_inline(stripped)
+    return ""
+
+
+def _method_cli_summary(doc: str) -> str:
+    """Text before the first ':param' in the docstring, collapsed to one line for CLI help."""
+    return doc.split(":param", 1)[0].strip().replace("\n", " ")
 
 
 def _resource_types() -> dict[str, type[SyncResource]]:
@@ -63,13 +94,25 @@ def _resource_types() -> dict[str, type[SyncResource]]:
     return resources
 
 
-def _iter_resource_methods(resource_type: type[SyncResource]) -> list[tuple[str, Any]]:
-    methods: list[tuple[str, Any]] = []
-    for name, value in resource_type.__dict__.items():
-        if name.startswith("_") or not inspect.isfunction(value):
-            continue
-        methods.append((name, value))
-    return methods
+def _probe_gitcode() -> GitCode:
+    """Lightweight client used only while building -h/--help metadata (no network)."""
+    transport = httpx.MockTransport(lambda _request: httpx.Response(200, json={}))
+    return GitCode(api_key="__cli_help__", http_client=httpx.Client(transport=transport))
+
+
+def _resource_commands_epilog(resource: SyncResource) -> str:
+    """List CLI subcommand names in the same order as resource.methods on the client."""
+    kebab_names = [_kebab_case(name) for name in resource.methods]
+    joined = ", ".join(kebab_names)
+    wrapped = textwrap.fill(
+        joined,
+        width=120,
+        initial_indent="  ",
+        subsequent_indent="  ",
+        break_long_words=False,
+        break_on_hyphens=False,
+    )
+    return "Subcommands (stable SDK order, same as resource.methods):\n" + wrapped
 
 
 def _kebab_case(value: str) -> str:
@@ -130,76 +173,135 @@ def _write_output(value: Any, *, output_file: Optional[str], compact: bool) -> N
         print(text)
 
 
-def _global_parent_parser() -> argparse.ArgumentParser:
+def _invocation_parent_parser() -> argparse.ArgumentParser:
+    """Parser with flags for real API calls (attached only to leaf METHOD parsers, not top-level usage)."""
     parser = argparse.ArgumentParser(add_help=False)
     parser.add_argument("--api-key", help=f"GitCode access token. Defaults to {DEFAULT_TOKEN_ENV}.")
     parser.add_argument("--owner", help="Default repository owner.")
     parser.add_argument("--repo", help="Default repository name.")
-    parser.add_argument("--base-url", default=DEFAULT_BASE_URL, help="Base URL for the GitCode REST API.")
+    parser.add_argument("--base-url", default=DEFAULT_BASE_URL, help="Base URL for the REST API.")
     parser.add_argument("--timeout", type=float, default=None, help="Request timeout in seconds.")
     parser.add_argument("--output-file", help="Write the response to a file instead of stdout.")
     parser.add_argument("--compact", action="store_true", help="Print JSON without indentation.")
     return parser
 
 
+def _root_banner() -> str:
+    return "Connection and defaults are documented on each method's help: %(prog)s RESOURCE METHOD -h."
+
+
 def build_parser() -> argparse.ArgumentParser:
-    common = _global_parent_parser()
+    """Build main parser."""
+    common = _invocation_parent_parser()
+    epilog = """\
+Examples:
+  %(prog)s pulls list --api-key "$GITCODE_ACCESS_TOKEN" --owner my-org --repo my-repo
+  %(prog)s users me --api-key "$GITCODE_ACCESS_TOKEN"
+  %(prog)s pulls list --set only_count=true --set reviewer=demo
+
+Extra keyword arguments (**params / **payload on some methods):
+  Repeat --set key=value (value is JSON if it parses as JSON; otherwise a string).
+  --set-json merges one JSON object (or @path/to/file.json) into those kwargs.
+
+Each resource -h lists subcommands in SDK order (resource.methods).
+Each method -h opens with resource.method_signature("<name>") from the Python SDK.
+"""
     parser = argparse.ArgumentParser(
         prog="gitcode-api",
-        description="Invoke any synchronous gitcode-api resource method from the command line.",
-        epilog='Use `--set key=value` and `--set-json \'{"key": "value"}\'` for methods with `**params` or `**payload`.',
-        formatter_class=argparse.ArgumentDefaultsHelpFormatter,
-        parents=[common],
+        usage="%(prog)s [-h] [--version] RESOURCE ...",
+        description=_root_banner(),
+        epilog=epilog,
+        formatter_class=_CLIHelpFormatter,
     )
     parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
 
-    resource_parsers = parser.add_subparsers(dest="resource", required=True)
-    for resource_name, resource_type in _resource_types().items():
-        resource_parser = resource_parsers.add_parser(
-            _kebab_case(resource_name),
-            help=_first_doc_line(resource_type),
+    client = _probe_gitcode()
+    try:
+        resource_parsers = parser.add_subparsers(
+            dest="resource",
+            required=True,
+            metavar="RESOURCE",
+            title="resources",
+            description="Pick a resource group (same attribute names as on GitCode, e.g. pulls, repos).",
         )
-        method_parsers = resource_parser.add_subparsers(dest="method", required=True)
-
-        for method_name, method in _iter_resource_methods(resource_type):
-            method_parser = method_parsers.add_parser(
-                _kebab_case(method_name),
-                help=_first_doc_line(method),
-                description=inspect.getdoc(method),
-                formatter_class=argparse.ArgumentDefaultsHelpFormatter,
-                parents=[common],
+        for resource_name, resource_type in _resource_types().items():
+            resource = getattr(client, resource_name)
+            class_doc = inspect.getdoc(resource_type).removeprefix("Synchronous ").capitalize() or ""
+            class_lead = class_doc.split("\n\n", maxsplit=1)[0].strip() if class_doc else ""
+            class_lead = _plain_cli_inline(class_lead) if class_lead else ""
+            resource_desc_parts = [
+                class_lead or _first_doc_line(resource_type),
+                "",
+                _resource_commands_epilog(resource),
+            ]
+            resource_parser = resource_parsers.add_parser(
+                _kebab_case(resource_name),
+                help=_first_doc_line(resource_type) or f"GitCode {resource_name} endpoints.",
+                description="\n".join(resource_desc_parts),
+                formatter_class=_CLIHelpFormatter,
             )
-            signature = inspect.signature(method)
-            for parameter in signature.parameters.values():
-                if parameter.name == "self":
-                    continue
-                if parameter.kind == inspect.Parameter.VAR_KEYWORD:
-                    method_parser.add_argument(
-                        "--set",
-                        dest="extra_items",
-                        action="append",
-                        default=None,
-                        metavar="KEY=VALUE",
-                        help="Additional keyword arguments for `**params` or `**payload`.",
-                    )
-                    method_parser.add_argument(
-                        "--set-json",
-                        dest="extra_json",
-                        default=None,
-                        metavar="JSON_OR_@FILE",
-                        help="JSON object merged into extra keyword arguments.",
-                    )
-                    continue
-
-                flag = f"--{parameter.name.replace('_', '-')}"
-                if flag in method_parser._option_string_actions:
-                    continue
-                kwargs = _argument_kwargs(parameter)
-                kwargs["dest"] = parameter.name
-                kwargs["required"] = parameter.default is inspect.Signature.empty
-                method_parser.add_argument(flag, **kwargs)
-
-            method_parser.set_defaults(resource_name=resource_name, method_name=method_name)
+            method_parsers = resource_parser.add_subparsers(
+                dest="method",
+                required=True,
+                title="methods",
+                metavar="METHOD",
+                description=(
+                    "Method names use kebab-case. The opening line of each command's help matches "
+                    "resource.method_signature('<name>') on the Python client."
+                ),
+            )
+
+            for method_name in resource.methods:
+                method = getattr(resource, method_name)
+                sig_line = resource.method_signature(method_name)
+                doc = inspect.getdoc(method).removeprefix("Synchronous ").capitalize() or ""
+                summary = _method_cli_summary(doc)
+                if summary and len(summary) > 90:
+                    method_help = summary[:87] + "..."
+                else:
+                    method_help = summary or (sig_line if len(sig_line) <= 90 else sig_line[:87] + "...")
+                method_description = f"{summary}\n\n{sig_line}" if summary else sig_line
+
+                method_parser = method_parsers.add_parser(
+                    _kebab_case(method_name),
+                    help=method_help,
+                    description=method_description,
+                    formatter_class=_CLIHelpFormatter,
+                    parents=[common],
+                )
+                signature = inspect.signature(method)
+                for parameter in signature.parameters.values():
+                    if parameter.name == "self":
+                        continue
+                    if parameter.kind == inspect.Parameter.VAR_KEYWORD:
+                        method_parser.add_argument(
+                            "--set",
+                            dest="extra_items",
+                            action="append",
+                            default=None,
+                            metavar="KEY=VALUE",
+                            help="Extra keyword argument (merged into **params / **payload).",
+                        )
+                        method_parser.add_argument(
+                            "--set-json",
+                            dest="extra_json",
+                            default=None,
+                            metavar="JSON_OR_@FILE",
+                            help="JSON object merged into extra keyword arguments.",
+                        )
+                        continue
+
+                    flag = f"--{parameter.name.replace('_', '-')}"
+                    if flag in method_parser._option_string_actions:
+                        continue
+                    kwargs = _argument_kwargs(parameter)
+                    kwargs["dest"] = parameter.name
+                    kwargs["required"] = parameter.default is inspect.Signature.empty
+                    method_parser.add_argument(flag, **kwargs)
+
+                method_parser.set_defaults(resource_name=resource_name, method_name=method_name)
+    finally:
+        client.close()
 
     return parser
 
@@ -233,8 +335,19 @@ def _collect_kwargs(args: argparse.Namespace, method: Any) -> dict[str, Any]:
 
 
 def main(argv: Optional[Sequence[str]] = None) -> int:
+    """CLI entry point."""
     parser = build_parser()
-    args = parser.parse_args(argv)
+    effective = list(sys.argv[1:] if argv is None else argv)
+    if not effective:
+        print(format_default_welcome(__version__), end="")
+        saved_epilog = parser.epilog
+        parser.epilog = None
+        try:
+            parser.print_help()
+        finally:
+            parser.epilog = saved_epilog
+        return 0
+    args = parser.parse_args(effective)
 
     try:
         with GitCode(

gitcode_api/resources/_shared.py

@@ -3,10 +3,11 @@
 from typing import Any, Dict, List, Optional, Union
 
 from .._base_client import AsyncAPIClient, SyncAPIClient
+from .._base_resource import BaseResource
 from .._models import APIObject, ModelT, as_model, as_model_list
 
 
-class SyncResource:
+class SyncResource(BaseResource):
     """Base class for synchronous resource groups."""
 
     def __init__(self, client: SyncAPIClient) -> None:
@@ -74,7 +75,7 @@ class SyncResource:
         return APIObject({"value": data})
 
 
-class AsyncResource:
+class AsyncResource(BaseResource):
     """Base class for asynchronous resource groups."""
 
     def __init__(self, client: AsyncAPIClient) -> None:

gitcode_api/resources/collaboration.py

@@ -476,7 +476,7 @@ class PullsResource(SyncResource):
         """Create a pull request.
 
         :param title: Pull request title.
-        :param head: Source branch ref (head branch).
+        :param head: Source branch ref (head branch, in forks use ``owner:branch`` like "SushiNinja:develop").
         :param base: Target branch ref (base branch).
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository path. Uses the client default when omitted.
@@ -490,7 +490,7 @@ class PullsResource(SyncResource):
         :param prune_source_branch: Whether to delete the source branch after merge when applicable.
         :param squash: Squash-merge preference where supported.
         :param squash_commit_message: Custom squash commit message.
-        :param fork_path: Fork namespace/path when opening a PR from a fork.
+        :param fork_path: Fork ``owner/repo`` when opening a PR from a fork, like "SushiNinja/agent-core-contrib".
         :returns: Created pull request.
         """
         return self._model(
@@ -1662,7 +1662,7 @@ class AsyncPullsResource(AsyncResource):
         """Create a pull request.
 
         :param title: Pull request title.
-        :param head: Source branch ref (head branch).
+        :param head: Source branch ref (head branch, in forks use ``owner:branch`` like "SushiNinja:develop").
         :param base: Target branch ref (base branch).
         :param owner: Repository owner path. Uses the client default when omitted.
         :param repo: Repository path. Uses the client default when omitted.
@@ -1676,7 +1676,7 @@ class AsyncPullsResource(AsyncResource):
         :param prune_source_branch: Whether to delete the source branch after merge when applicable.
         :param squash: Squash-merge preference where supported.
         :param squash_commit_message: Custom squash commit message.
-        :param fork_path: Fork namespace/path when opening a PR from a fork.
+        :param fork_path: Fork ``owner/repo`` when opening a PR from a fork, like "SushiNinja/agent-core-contrib".
         :returns: Created pull request.
         """
         return await self._model(

gitcode_api/version.txt

@@ -1 +1 @@
-1.1.3
+1.2.1

{gitcode_api-1.1.3.dist-info → gitcode_api-1.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.1.3
+Version: 1.2.1
 Summary: Easy to use Python SDK for the GitCode REST API, community-maintained.
 Author-email: Hugo Huang <hugo@hugohuang.com>
 License-Expression: MIT
@@ -29,7 +29,7 @@ Dynamic: license-file
 
 [![PyPI - Version](https://img.shields.io/pypi/v/gitcode-api?link=https%3A%2F%2Fpypi.org%2Fproject%2Fgitcode-api%2F)](https://pypi.org/project/gitcode-api) [![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) [![PyPI Downloads](https://static.pepy.tech/personalized-badge/gitcode-api?period=total&units=INTERNATIONAL_SYSTEM&left_color=GRAY&right_color=RED&left_text=downloads)](https://pepy.tech/projects/gitcode-api)
 
-[![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) [![English README](https://img.shields.io/badge/English-README-blue?style=for-the-badge&logo=googledocs&link=README.md)](README.md)
+[![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.
 
@@ -37,7 +37,7 @@ Dynamic: license-file
 
 - Community project for developers who want a practical GitCode Python library.
 - Sync and async clients with a consistent API surface.
-- Resource namespaces such as `client.repos`, `client.pulls`, and `client.users`.
+- Resource groups such as `client.repos`, `client.pulls`, and `client.users`.
 - Repository defaults via `owner=` and `repo=` on the client.
 - Sphinx docs plus a mirrored GitCode REST API reference in `docs/`.
 
@@ -120,7 +120,7 @@ asyncio.run(main())
 
 ### 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.
+`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
@@ -151,16 +151,13 @@ from gitcode_api import GitCode
 
 client = GitCode(owner="SushiNinja", repo="GitCode-API")
 
-try:
-    pull = client.pulls.create(
-        title="Add feature",
-        head="feature-branch",
-        base="main",
-        body="Implements the new flow.",
-    )
-    print(pull.number)
-finally:
-    client.close()
+pull = client.pulls.create(
+    title="Add feature",
+    head="feature-branch",
+    base="main",
+    body="Implements the new flow.",
+)
+print(pull.number)
 ```
 
 Get the authenticated user:
@@ -170,11 +167,8 @@ from gitcode_api import GitCode
 
 client = GitCode()
 
-try:
-    user = client.users.me()
-    print(user.login)
-finally:
-    client.close()
+user = client.users.me()
+print(user.login)
 ```
 
 Search repositories:
@@ -184,12 +178,9 @@ from gitcode_api import GitCode
 
 client = GitCode()
 
-try:
-    repos = client.search.repositories(q="sdk language:python", per_page=10)
-    for repo in repos:
-        print(repo.full_name)
-finally:
-    client.close()
+repos = client.search.repositories(q="sdk language:python", per_page=10)
+for repo in repos:
+    print(repo.full_name)
 ```
 
 ## Available Resources
@@ -203,6 +194,8 @@ Both `GitCode` and `AsyncGitCode` expose:
 - `releases`, `tags`, and `webhooks`
 - `users`, `orgs`, `search`, and `oauth`
 
+Every resource group inherits a cached `methods` property from the shared resource base: a `tuple` of public callable names in stable SDK order (underscore-segment sort key, not plain A–Z on the full identifier). Private names and the introspection helpers `methods` and `method_signature` are omitted. For example, `client.pulls.methods` helps with discovery or tooling without reading the full manual list. For one method’s parameters and return type, call `client.pulls.method_signature("list_issues")` (a cached string from `inspect.signature`, with `gitcode_api._models.` stripped from annotations).
+
 ## Examples
 
 Runnable examples live in `examples/`:

gitcode_api-1.2.1.dist-info/RECORD

@@ -0,0 +1,22 @@
+gitcode_api/__init__.py,sha256=NvLp28D9brVbmv2ROSZ8mxKDuIamE9xeutBKGl9pra8,497
+gitcode_api/__main__.py,sha256=Yd8P4MSNcWFqUTKnUaNibbWX4Vd-MVVNmhPFaohzqcA,137
+gitcode_api/_base_client.py,sha256=PFsTMZJI4p5INjubRa4H4JcybYLGt-B9VkSAfTgpxfI,13280
+gitcode_api/_base_resource.py,sha256=mlKe1b_1AKcqxhptaCpP-AOjKkLNzCbYG-Pkp1HYWrA,2238
+gitcode_api/_cli_banner.py,sha256=res6C4V_rVSLyHMr1PwCpjV2OLn05lWJkRfxai3SCb8,978
+gitcode_api/_client.py,sha256=bmZxBHdfshM5Kv_EurHUVu8rsEj0k3Up3ATSIPaFrvc,8258
+gitcode_api/_exceptions.py,sha256=T5N8gBGmPSktDkLP5P_hxbzOHw3W378TzxN1xja40pA,1140
+gitcode_api/_models.py,sha256=v-GZzCGAb3_frY6wFiQww9m271U5MigivpEHDHnoDcI,109030
+gitcode_api/cli.py,sha256=GyqHg6cn_AqzJis7WshgdQaQv7w2imNWWoBjxiLVpzA,14194
+gitcode_api/version.txt,sha256=bPTghLR_M8mwLveSedFXgzho-PcFFBaadovjU-4yj-o,6
+gitcode_api/resources/__init__.py,sha256=nsCKW0bFDZ5ombJZxLThmO82sOuF7o4OKUMRkAmwbwk,1725
+gitcode_api/resources/_shared.py,sha256=7bCym8bIfs818SiYYrBGI7-ZtiYlxECSDG3RduInu10,5387
+gitcode_api/resources/account.py,sha256=mnc2p7wI-nBnHFNdWPNiHfmZpT6d3RDQC777gewtm4M,38801
+gitcode_api/resources/collaboration.py,sha256=8lyk78GTjVXddiE9fieutsMGovRjteGfTJcAhwLoR0M,101607
+gitcode_api/resources/misc.py,sha256=guDwh4cxbTVsSa7EivaYM3bKMJ8_Op4KucGbKEoayKE,22412
+gitcode_api/resources/repositories.py,sha256=EAK2znZhEsgVUu-NDEQslSEEYJzvb-kHuh4mW57y6sc,78178
+gitcode_api-1.2.1.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
+gitcode_api-1.2.1.dist-info/METADATA,sha256=kcLmsYVqck8eQzFVfttnwc-QrV2sC4N6Soul-XJzuP8,8202
+gitcode_api-1.2.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gitcode_api-1.2.1.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
+gitcode_api-1.2.1.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
+gitcode_api-1.2.1.dist-info/RECORD,,

gitcode_api-1.1.3.dist-info/RECORD

@@ -1,20 +0,0 @@
-gitcode_api/__init__.py,sha256=NvLp28D9brVbmv2ROSZ8mxKDuIamE9xeutBKGl9pra8,497
-gitcode_api/__main__.py,sha256=MHKZ_ae3fSLGTLUUMOx15fWdeOnJSHhq-zslRP5F5Lc,79
-gitcode_api/_base_client.py,sha256=1COCZXzSiCe_LNawsOsTNvh0WMh1JW4A5yYgX56HwjY,12894
-gitcode_api/_client.py,sha256=AOpp1P7vdSlMcn0XP3JMPnAKbQMftMO9WMubBGw2LZc,8129
-gitcode_api/_exceptions.py,sha256=T5N8gBGmPSktDkLP5P_hxbzOHw3W378TzxN1xja40pA,1140
-gitcode_api/_models.py,sha256=2bR6Wxc3Ie7iM3UFNY0ThWeNjxFHzDAC-8QFgcgcT_0,108599
-gitcode_api/cli.py,sha256=R4HUPzrrs_ejHjIAEZw0P5ozUuEfFScJvfVRyrR2HXw,9573
-gitcode_api/version.txt,sha256=QVh-oXE9O_Eto7b8aIGNtIm6f6enRYGYzqERAJEy8sk,5
-gitcode_api/resources/__init__.py,sha256=nsCKW0bFDZ5ombJZxLThmO82sOuF7o4OKUMRkAmwbwk,1725
-gitcode_api/resources/_shared.py,sha256=EB9fr4eQUc9IOdZCn4AoI946SJYCNVAtOOHEo_OzJAQ,5317
-gitcode_api/resources/account.py,sha256=mnc2p7wI-nBnHFNdWPNiHfmZpT6d3RDQC777gewtm4M,38801
-gitcode_api/resources/collaboration.py,sha256=26rQCeayZfUQ_6dIdl5HOGXnYkMLx8V7XsF_Wi-4Qt4,101417
-gitcode_api/resources/misc.py,sha256=guDwh4cxbTVsSa7EivaYM3bKMJ8_Op4KucGbKEoayKE,22412
-gitcode_api/resources/repositories.py,sha256=EAK2znZhEsgVUu-NDEQslSEEYJzvb-kHuh4mW57y6sc,78178
-gitcode_api-1.1.3.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
-gitcode_api-1.1.3.dist-info/METADATA,sha256=Cts4NepBSIfeffRrEec2u7jeHcrqmTCzWLIh-LE08mg,7715
-gitcode_api-1.1.3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gitcode_api-1.1.3.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
-gitcode_api-1.1.3.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
-gitcode_api-1.1.3.dist-info/RECORD,,