ghapi 2.1.1__tar.gz → 2.1.3__tar.gz

{ghapi-2.1.1/ghapi.egg-info → ghapi-2.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghapi
-Version: 2.1.1
+Version: 2.1.3
 Summary: A python client for the GitHub API
 Author-email: Jeremy Howard <info@fast.ai>
 License: Apache-2.0
@@ -15,8 +15,9 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastcore>=2.2.6
-Requires-Dist: fastspec>=0.2.0
+Requires-Dist: fastcore>=2.2.7
+Requires-Dist: fastspec>=0.2.1
+Requires-Dist: fasttransport>=0.0.2
 Requires-Dist: tomli; python_version < "3.11"
 Provides-Extra: dev
 Requires-Dist: fastgit; extra == "dev"

ghapi-2.1.3/ghapi/__init__.py

@@ -0,0 +1,8 @@
+"""A python client for the GitHub API
+
+Modules:
+
+- `ghapi.graphql`: Query GitHub's GraphQL API: schema-aware chained queries, one-request batching, and raw GraphQL
+- `ghapi.skill`: GitHub REST API access via `GhApi`, plus local git operations via `fastgit.Git`. Trigger: ALWAYS read before reading/creating issues and PRs, checking CI status, managing releases/branches/gists, and doing repo-local git operations."""
+
+__version__ = "2.1.3"

{ghapi-2.1.1 → ghapi-2.1.3}/ghapi/core.py

@@ -5,29 +5,31 @@ Docs: https://ghapi.fast.ai/core.html.md"""
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/00_core.ipynb.
 
 # %% auto #0
-__all__ = ['GH_HOST', 'pspec', 'img_md_pat', 'EMPTY_TREE_SHA', 'GhTransport', 'GhSyncTransport', 'print_summary', 'gh_patch',
-           'GhApi', 'call_gh', 'date2gh', 'gh2date', 'GhRows', 'delete_release', 'create_release', 'list_tags',
-           'list_branches', 'create_branch_empty', 'delete_tag', 'delete_branch', 'get_branch', 'commit_tree',
-           'list_files', 'get_content', 'create_or_update_file', 'create_file', 'delete_file', 'update_contents',
-           'enable_pages', 'read_issue', 'read_pr', 'pr_file_diff', 'PullRow', 'PullRows', 'list_prs', 'issue_template',
-           'issue_body', 'CheckRun', 'CommitStatus', 'check_status', 'pr_status', 'failed_step_log', 'dep_key',
-           'local_dep_graph', 'dep_closure', 'dep_order', 'dep_dependents', 'dep_graph', 'APIError']
+__all__ = ['GH_HOST', 'pspec', 'img_md_pat', 'EMPTY_TREE_SHA', 'MAXLEN', 'GhTransport', 'GhSyncTransport', 'print_summary',
+           'gh_patch', 'GhApi', 'call_gh', 'date2gh', 'gh2date', 'GhRows', 'delete_release', 'create_release',
+           'list_tags', 'list_branches', 'create_branch_empty', 'delete_tag', 'delete_branch', 'get_branch',
+           'commit_tree', 'list_files', 'get_content', 'create_or_update_file', 'create_file', 'delete_file',
+           'update_contents', 'enable_pages', 'read_issue', 'read_pr', 'pr_file_diff', 'PullRow', 'PullRows',
+           'list_prs', 'issue_template', 'issue_body', 'CheckRun', 'CommitStatus', 'check_status', 'pr_status',
+           'failed_step_log', 'dep_key', 'local_dep_graph', 'dep_closure', 'dep_order', 'dep_dependents', 'dep_graph',
+           'APIError']
 
 # %% ../nbs/00_core.ipynb #5b5cba7b
 from contextvars import ContextVar
 
 from fastcore.all import *
+from fastcore.ansi import strip_ansi
 from fastspec.spec import SpecParser
 from fastspec.oapi import OpenAPIClient, OpFunc, SyncOpFunc
-from fastspec.transport import AsyncTransport, SyncTransport
+from fasttransport.core import AsyncTransport, SyncTransport
 from .gh_spec import spec
-from fastspec.errors import APIError
+from fasttransport.errors import APIError
 
 import mimetypes,base64
 from collections import Counter
 from urllib.parse import quote
 from datetime import datetime, timezone
-import os, shutil, tempfile, subprocess, fnmatch, html
+import os, shutil, tempfile, subprocess, fnmatch, html, io, zipfile
 import asyncio
 
 try: import tomllib
@@ -142,7 +144,7 @@ class GhApi(OpenAPIClient):
         if verb is None: verb = 'POST' if data else 'GET'
         if route: path = path.format(**{k:quote(str(v), safe='') for k,v in route.items()})
         if not path.startswith(('http://', 'https://')): path = self.gh_host + path
-        kw = dict(content=data) if isinstance(data, (bytes,str)) else dict(json_data=data)
+        kw = dict(content=data) if isinstance(data, (bytes,str)) else dict(json=data)
         return self.transport.request(verb, path, headers=headers, params=query, **kw)
 
     @property
@@ -487,7 +489,7 @@ async def read_pr(
         diff = _reduce_ctx(_filter_diff(info.diff, folder=folder))
         res += f"\n\n## Diff\n```diff\n{diff}\n```"
     if replies: res += _fmt_replies(info)
-    return res
+    return TruncatedString(res, 8_000)
 
 # %% ../nbs/00_core.ipynb #69d12346
 async def pr_file_diff(
@@ -505,6 +507,8 @@ async def pr_file_diff(
     return f"File `{filename}` not found in PR #{pr_number}"
 
 # %% ../nbs/00_core.ipynb #2c94c2c8
+MAXLEN = 180 # Most characters shown per displayed line
+
 def _age(s):
     "Compact age of ISO-8601 timestamp `s`"
     secs = (datetime.now(timezone.utc) - datetime.fromisoformat(s.replace('Z', '+00:00'))).total_seconds()
@@ -520,21 +524,21 @@ def _pr_mark(r):
 
 class PullRow(AttrDict):
     "One pull request as an actionable line"
-    def line(self, maxlen=120): return f'#{self.number}  {_age(self.updated_at)}  {_pr_mark(self)}{truncstr(self.title, maxlen)}'
+    def line(self, maxlen=MAXLEN): return f'#{self.number}  {_age(self.updated_at)}  {_pr_mark(self)}{truncstr(self.title, maxlen)}'
     __repr__ = line
 
 class PullRows(GhRows):
     "Pull request rows, displayed with titles truncated to `maxlen`"
-    def __init__(self, items, maxlen=120):
+    def __init__(self, items, maxlen=MAXLEN):
         super().__init__(items)
         self.maxlen = maxlen
-    def __repr__(self): return '\n'.join(o.line(self.maxlen) for o in self)
+    def __repr__(self): return '\n'.join(o.line(self.maxlen) for o in self) or 'no PRs'
 
 @gh_patch
 async def list_prs(
     self:GhApi,
     state='open', # 'open', 'closed', or 'all'
-    maxlen=120, # Title characters shown per row
+    maxlen=MAXLEN, # Title characters shown per row
     per_page=100, # PRs per request (100 max)
     page=1, # Page of results, for repos with more than `per_page` PRs
 )->PullRows:
@@ -622,15 +626,14 @@ async def pr_status(self:GhApi, pull_number:int):
 async def failed_step_log(self:GhApi, job_id:int):
     "Log sections of `job_id`'s failed steps, each headed by its step name"
     job = await self.actions.get_job_for_workflow_run(job_id=job_id)
-    log = await self.actions.download_job_logs_for_workflow_run(job_id=job_id)
+    zf = zipfile.ZipFile(io.BytesIO(await self.actions.download_workflow_run_logs(run_id=job.run_id)))
     res = []
     for s in job.steps:
         if s.conclusion!='failure': continue
-        seg = [l[29:] for l in log.splitlines() if s.started_at[:-1] <= l[:19] <= s.completed_at[:-1]]
-        errs = [i for i,l in enumerate(seg) if l.startswith(r'##[error]')]
-        if errs: seg = seg[:errs[-1]+1]
-        res.append(f'# {s.name}\n' + '\n'.join(seg))
-    return '\n\n'.join(res)
+        name = first(n for n in zf.namelist() if n.startswith(f'{job.name}/{s.number}_'))
+        lines = [strip_ansi(l.split(' ', 1)[-1]) for l in zf.read(name).decode().splitlines()]
+        res.append(f'# {s.name}\n' + '\n'.join(lines))
+    return TruncatedString('\n\n'.join(res), 8_000)
 
 # %% ../nbs/00_core.ipynb #751c4e54
 def dep_key(dep):

{ghapi-2.1.1 → ghapi-2.1.3}/ghapi/page.py

@@ -11,7 +11,7 @@ __all__ = ['paged', 'parse_link_hdr', 'pages', 'sync_paged', 'sync_pages', 'Noti
 from fastcore.all import *
 from .core import *
 from .core import _age
-from fastspec.errors import APIError
+from fasttransport.errors import APIError
 
 import re, asyncio
 from datetime import datetime, timedelta, timezone

{ghapi-2.1.1 → ghapi-2.1.3}/ghapi/skill.py

@@ -1,4 +1,4 @@
-"""GitHub REST API access via `GhApi`, plus local git operations via `fastgit.Git`. Use this for day-to-day GitHub work: reading/creating issues and PRs, checking CI status, managing releases/branches/gists, and repo-local git operations -- all from Python, no shelling out to `gh`/`git` needed.
+"""GitHub REST API access via `GhApi`, plus local git operations via `fastgit.Git`. Trigger: ALWAYS read before reading/creating issues and PRs, checking CI status, managing releases/branches/gists, and doing repo-local git operations.
 
 `ghapi` is a full, always-up-to-date wrapper over the entire GitHub REST API, dynamically generated from GitHub's own OpenAPI spec. `fastgit` is a tiny complementary wrapper around the local `git` CLI, for anything that's about the local repo rather than GitHub's servers -- cheaper, and not rate-limited. As of v2, `ghapi` is async by default: `await` every API call (notebooks and modern REPLs support top-level `await`; scripts use `asyncio.run`). For sync code, `GhApi(sync=True)` gives a client whose generated endpoint calls block and return results directly (the convenience methods below stay async-only; drive those with `fastcore.aio.run_sync` on an async client. `paged`/`pages` have sync twins `sync_paged`/`sync_pages`).
 
@@ -90,7 +90,7 @@ Once the PR exists, the fork branch is the source of truth, and the local clone
 - Results with tuned reprs (`read_issue`, `check_status`, `list_prs`, `gh_notifs`) display bare. Raw endpoint results don't, so when only confirmation matters (a `create_comment`, a `pulls.update`), assign the result to a variable and show one key (`r.html_url`, `r.state`) instead of displaying the whole payload.
 - A PR *is* an issue for general comments (`issues.list_comments`, not `pulls.*`) -- inline code-review comments are the separate `pulls.list_review_comments`.
 - Rate limits: register `limit_cb` on `GhApi(...)` to get called back whenever the remaining quota changes, or check `api.limit_rem` any time.
-- HTTP errors raise `fastspec.errors.APIError`, which carries `.status_code` and the endpoint called.
+- HTTP errors raise `fasttransport.errors.APIError`, which carries `.status_code` and the endpoint called.
 - `per_page` maxes out at 100; beyond that, use `paged`/`pages` rather than manually looping `page=`.
 - Per-call headers on named endpoints use `headers_=` (e.g. `await api.pulls.get(n, headers_={'Accept': 'application/vnd.github.v3.diff'})` for the raw diff); plain `headers=` is a kwarg only for direct `api(path, verb, ...)` calls.
 - `GITHUB_TOKEN` unset means unauthenticated (heavily rate-limited, no write access) -- `GhApi()` warns but doesn't raise.

{ghapi-2.1.1 → ghapi-2.1.3}/ghapi/templates.py

@@ -14,8 +14,8 @@ $NEEDS
       matrix: { os: $OPERSYS }
     runs-on: ${{ matrix.os }}-latest
     steps:
-    - uses: actions/checkout@v4
-    - uses: actions/setup-python@v5
+    - uses: actions/checkout@v7
+    - uses: actions/setup-python@v7
       with: {python-version: '3.12'}
     - name: Run script
       env:
@@ -30,8 +30,8 @@ pre_tmpl = """prebuild:
   outputs:
     out: ${{ toJson(steps) }}
   steps:
-  - uses: actions/checkout@v4
-  - uses: actions/setup-python@v5
+  - uses: actions/checkout@v7
+  - uses: actions/setup-python@v7
     with: {python-version: '3.12'}
   - name: Create release
     id: step1

{ghapi-2.1.1 → ghapi-2.1.3/ghapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghapi
-Version: 2.1.1
+Version: 2.1.3
 Summary: A python client for the GitHub API
 Author-email: Jeremy Howard <info@fast.ai>
 License: Apache-2.0
@@ -15,8 +15,9 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastcore>=2.2.6
-Requires-Dist: fastspec>=0.2.0
+Requires-Dist: fastcore>=2.2.7
+Requires-Dist: fastspec>=0.2.1
+Requires-Dist: fasttransport>=0.0.2
 Requires-Dist: tomli; python_version < "3.11"
 Provides-Extra: dev
 Requires-Dist: fastgit; extra == "dev"

{ghapi-2.1.1 → ghapi-2.1.3}/ghapi.egg-info/requires.txt

@@ -1,5 +1,6 @@
-fastcore>=2.2.6
-fastspec>=0.2.0
+fastcore>=2.2.7
+fastspec>=0.2.1
+fasttransport>=0.0.2
 
 [:python_version < "3.11"]
 tomli

{ghapi-2.1.1 → ghapi-2.1.3}/pyproject.toml

@@ -12,7 +12,7 @@ license = {text = "Apache-2.0"}
 authors = [{name = "Jeremy Howard", email = "info@fast.ai"}]
 keywords = ['github', 'api']
 classifiers = ["Natural Language :: English", "Intended Audience :: Developers", "Development Status :: 5 - Production/Stable", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3 :: Only"]
-dependencies = ['fastcore>=2.2.6', 'fastspec>=0.2.0', 'tomli; python_version < "3.11"']
+dependencies = ['fastcore>=2.2.7', 'fastspec>=0.2.1', 'fasttransport>=0.0.2', 'tomli; python_version < "3.11"']
 
 [project.urls]
 Repository = "https://github.com/fastai/ghapi"

ghapi-2.1.1/ghapi/__init__.py

@@ -1,8 +0,0 @@
-"""A python client for the GitHub API
-
-Modules:
-
-- `ghapi.graphql`: Query GitHub's GraphQL API: schema-aware chained queries, one-request batching, and raw GraphQL
-- `ghapi.skill`: GitHub REST API access via `GhApi`, plus local git operations via `fastgit.Git`. Use this for day-to-day GitHub work: reading/creating issues and PRs, checking CI status, managing releases/branches/gists, and repo-local git operations -- all from Python, no shelling out to `gh`/`git` needed."""
-
-__version__ = "2.1.1"