gitcode-api 1.2.0__py3-none-any.whl → 1.2.2__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_resource.py

@@ -7,7 +7,7 @@ _DATA_MODEL_PATH = "gitcode_api._models."
 
 
 class BaseResource:
-    """Resource group base class"""
+    """Resource group base class."""
 
     def __del__(self) -> None:
         """Attempt to clear the lru cache."""

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

@@ -174,7 +174,7 @@ def _write_output(value: Any, *, output_file: Optional[str], compact: bool) -> N
 
 
 def _invocation_parent_parser() -> argparse.ArgumentParser:
-    """Flags for real API calls (attached only to leaf METHOD parsers, not top-level usage)."""
+    """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.")
@@ -191,6 +191,7 @@ def _root_banner() -> str:
 
 
 def build_parser() -> argparse.ArgumentParser:
+    """Build main parser."""
     common = _invocation_parent_parser()
     epilog = """\
 Examples:
@@ -334,6 +335,7 @@ 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()
     effective = list(sys.argv[1:] if argv is None else argv)
     if not effective:

gitcode_api/version.txt

@@ -1 +1 @@
-1.2.0
+1.2.2

{gitcode_api-1.2.0.dist-info → gitcode_api-1.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.0
+Version: 1.2.2
 Summary: Easy to use Python SDK for the GitCode REST API, community-maintained.
 Author-email: Hugo Huang <hugo@hugohuang.com>
 License-Expression: MIT
@@ -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

{gitcode_api-1.2.0.dist-info → gitcode_api-1.2.2.dist-info}/RECORD

@@ -1,22 +1,22 @@
 gitcode_api/__init__.py,sha256=NvLp28D9brVbmv2ROSZ8mxKDuIamE9xeutBKGl9pra8,497
-gitcode_api/__main__.py,sha256=MHKZ_ae3fSLGTLUUMOx15fWdeOnJSHhq-zslRP5F5Lc,79
+gitcode_api/__main__.py,sha256=Yd8P4MSNcWFqUTKnUaNibbWX4Vd-MVVNmhPFaohzqcA,137
 gitcode_api/_base_client.py,sha256=PFsTMZJI4p5INjubRa4H4JcybYLGt-B9VkSAfTgpxfI,13280
-gitcode_api/_base_resource.py,sha256=4yZftwUh0cRAdLReAAgDULVu5pBCsixxBR_x6l2dPUw,2237
+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=AOpp1P7vdSlMcn0XP3JMPnAKbQMftMO9WMubBGw2LZc,8129
+gitcode_api/_client.py,sha256=bmZxBHdfshM5Kv_EurHUVu8rsEj0k3Up3ATSIPaFrvc,8258
 gitcode_api/_exceptions.py,sha256=T5N8gBGmPSktDkLP5P_hxbzOHw3W378TzxN1xja40pA,1140
-gitcode_api/_models.py,sha256=2bR6Wxc3Ie7iM3UFNY0ThWeNjxFHzDAC-8QFgcgcT_0,108599
-gitcode_api/cli.py,sha256=3fWJokeB9EVJkNYLQEKevoqUcLag_i0Dv97qZoxhktg,14126
-gitcode_api/version.txt,sha256=HltRzeUVOWqfp2KQnPjKZYTMxWSzJdLuvup2F1_pXE0,6
+gitcode_api/_models.py,sha256=v-GZzCGAb3_frY6wFiQww9m271U5MigivpEHDHnoDcI,109030
+gitcode_api/cli.py,sha256=GyqHg6cn_AqzJis7WshgdQaQv7w2imNWWoBjxiLVpzA,14194
+gitcode_api/version.txt,sha256=xipcxhrEUlk1dT9ewoTAoFKksdpLOjWA3OK313ohVK4,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.0.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
-gitcode_api-1.2.0.dist-info/METADATA,sha256=-e38q2ElfQ_LanrAqmY7o6k6i1wdAOr82RgGN0wj20o,8189
-gitcode_api-1.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gitcode_api-1.2.0.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
-gitcode_api-1.2.0.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
-gitcode_api-1.2.0.dist-info/RECORD,,
+gitcode_api-1.2.2.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
+gitcode_api-1.2.2.dist-info/METADATA,sha256=ClJo4MvNHJ-Y1Xig0fwPmcmWCiIOp_elZYKz2AXzJCk,8202
+gitcode_api-1.2.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gitcode_api-1.2.2.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
+gitcode_api-1.2.2.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
+gitcode_api-1.2.2.dist-info/RECORD,,