ghapi 2.0.2__tar.gz → 2.0.4__tar.gz

{ghapi-2.0.2/ghapi.egg-info → ghapi-2.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghapi
-Version: 2.0.2
+Version: 2.0.4
 Summary: A python client for the GitHub API
 Author-email: Jeremy Howard <info@fast.ai>
 License: Apache-2.0
@@ -16,7 +16,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: fastcore>=1.14.5
-Requires-Dist: fastspec>=0.1.0
+Requires-Dist: fastspec>=0.1.2
 Provides-Extra: dev
 Requires-Dist: fastgit; extra == "dev"
 Requires-Dist: matplotlib; extra == "dev"

ghapi-2.0.4/ghapi/__init__.py

@@ -0,0 +1 @@
+__version__ = "2.0.4"

{ghapi-2.0.2 → ghapi-2.0.4}/ghapi/_modidx.py

@@ -48,34 +48,15 @@ d = { 'settings': { 'branch': 'main',
                             'ghapi.core.GhApi.__init__': ('core.html#ghapi.__init__', 'ghapi/core.py'),
                             'ghapi.core.GhApi._get_repo_files': ('core.html#ghapi._get_repo_files', 'ghapi/core.py'),
                             'ghapi.core.GhApi._repr_markdown_': ('core.html#ghapi._repr_markdown_', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.check_status': ('core.html#ghapi.check_status', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.create_branch_empty': ('core.html#ghapi.create_branch_empty', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.create_file': ('core.html#ghapi.create_file', 'ghapi/core.py'),
                             'ghapi.core.GhApi.create_gist': ('core.html#ghapi.create_gist', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.create_or_update_file': ('core.html#ghapi.create_or_update_file', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.create_release': ('core.html#ghapi.create_release', 'ghapi/core.py'),
                             'ghapi.core.GhApi.debug': ('core.html#ghapi.debug', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.delete_branch': ('core.html#ghapi.delete_branch', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.delete_file': ('core.html#ghapi.delete_file', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.delete_release': ('core.html#ghapi.delete_release', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.delete_tag': ('core.html#ghapi.delete_tag', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.enable_pages': ('core.html#ghapi.enable_pages', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.get_branch': ('core.html#ghapi.get_branch', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.get_content': ('core.html#ghapi.get_content', 'ghapi/core.py'),
                             'ghapi.core.GhApi.get_file_content': ('core.html#ghapi.get_file_content', 'ghapi/core.py'),
                             'ghapi.core.GhApi.get_repo_contents': ('core.html#ghapi.get_repo_contents', 'ghapi/core.py'),
                             'ghapi.core.GhApi.get_repo_files': ('core.html#ghapi.get_repo_files', 'ghapi/core.py'),
                             'ghapi.core.GhApi.gist_file': ('core.html#ghapi.gist_file', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.issue_template': ('core.html#ghapi.issue_template', 'ghapi/core.py'),
                             'ghapi.core.GhApi.limit_rem': ('core.html#ghapi.limit_rem', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.list_branches': ('core.html#ghapi.list_branches', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.list_files': ('core.html#ghapi.list_files', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.list_tags': ('core.html#ghapi.list_tags', 'ghapi/core.py'),
                             'ghapi.core.GhApi.load_gist': ('core.html#ghapi.load_gist', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.pr_status': ('core.html#ghapi.pr_status', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.read_issue': ('core.html#ghapi.read_issue', 'ghapi/core.py'),
                             'ghapi.core.GhApi.recv_hdrs': ('core.html#ghapi.recv_hdrs', 'ghapi/core.py'),
-                            'ghapi.core.GhApi.update_contents': ('core.html#ghapi.update_contents', 'ghapi/core.py'),
                             'ghapi.core.GhApi.update_gist': ('core.html#ghapi.update_gist', 'ghapi/core.py'),
                             'ghapi.core.GhApi.upload_file': ('core.html#ghapi.upload_file', 'ghapi/core.py'),
                             'ghapi.core.GhSyncTransport': ('core.html#ghsynctransport', 'ghapi/core.py'),
@@ -90,6 +71,8 @@ d = { 'settings': { 'branch': 'main',
                             'ghapi.core._CheckStatus._repr_markdown_': ('core.html#_checkstatus._repr_markdown_', 'ghapi/core.py'),
                             'ghapi.core._IssueInfo': ('core.html#_issueinfo', 'ghapi/core.py'),
                             'ghapi.core._IssueInfo._repr_markdown_': ('core.html#_issueinfo._repr_markdown_', 'ghapi/core.py'),
+                            'ghapi.core._LiveDefaults': ('core.html#_livedefaults', 'ghapi/core.py'),
+                            'ghapi.core._LiveDefaults.items': ('core.html#_livedefaults.items', 'ghapi/core.py'),
                             'ghapi.core._filter_diff': ('core.html#_filter_diff', 'ghapi/core.py'),
                             'ghapi.core._find_matches': ('core.html#_find_matches', 'ghapi/core.py'),
                             'ghapi.core._fmt_replies': ('core.html#_fmt_replies', 'ghapi/core.py'),
@@ -98,12 +81,33 @@ d = { 'settings': { 'branch': 'main',
                             'ghapi.core._reduce_ctx': ('core.html#_reduce_ctx', 'ghapi/core.py'),
                             'ghapi.core._run_subp': ('core.html#_run_subp', 'ghapi/core.py'),
                             'ghapi.core.call_gh': ('core.html#call_gh', 'ghapi/core.py'),
+                            'ghapi.core.check_status': ('core.html#check_status', 'ghapi/core.py'),
+                            'ghapi.core.commit_tree': ('core.html#commit_tree', 'ghapi/core.py'),
+                            'ghapi.core.create_branch_empty': ('core.html#create_branch_empty', 'ghapi/core.py'),
+                            'ghapi.core.create_file': ('core.html#create_file', 'ghapi/core.py'),
+                            'ghapi.core.create_or_update_file': ('core.html#create_or_update_file', 'ghapi/core.py'),
+                            'ghapi.core.create_release': ('core.html#create_release', 'ghapi/core.py'),
                             'ghapi.core.date2gh': ('core.html#date2gh', 'ghapi/core.py'),
+                            'ghapi.core.delete_branch': ('core.html#delete_branch', 'ghapi/core.py'),
+                            'ghapi.core.delete_file': ('core.html#delete_file', 'ghapi/core.py'),
+                            'ghapi.core.delete_release': ('core.html#delete_release', 'ghapi/core.py'),
+                            'ghapi.core.delete_tag': ('core.html#delete_tag', 'ghapi/core.py'),
+                            'ghapi.core.enable_pages': ('core.html#enable_pages', 'ghapi/core.py'),
+                            'ghapi.core.get_branch': ('core.html#get_branch', 'ghapi/core.py'),
+                            'ghapi.core.get_content': ('core.html#get_content', 'ghapi/core.py'),
                             'ghapi.core.gh2date': ('core.html#gh2date', 'ghapi/core.py'),
+                            'ghapi.core.gh_patch': ('core.html#gh_patch', 'ghapi/core.py'),
                             'ghapi.core.issue_body': ('core.html#issue_body', 'ghapi/core.py'),
+                            'ghapi.core.issue_template': ('core.html#issue_template', 'ghapi/core.py'),
+                            'ghapi.core.list_branches': ('core.html#list_branches', 'ghapi/core.py'),
+                            'ghapi.core.list_files': ('core.html#list_files', 'ghapi/core.py'),
+                            'ghapi.core.list_tags': ('core.html#list_tags', 'ghapi/core.py'),
                             'ghapi.core.pr_file_diff': ('core.html#pr_file_diff', 'ghapi/core.py'),
+                            'ghapi.core.pr_status': ('core.html#pr_status', 'ghapi/core.py'),
                             'ghapi.core.print_summary': ('core.html#print_summary', 'ghapi/core.py'),
-                            'ghapi.core.read_pr': ('core.html#read_pr', 'ghapi/core.py')},
+                            'ghapi.core.read_issue': ('core.html#read_issue', 'ghapi/core.py'),
+                            'ghapi.core.read_pr': ('core.html#read_pr', 'ghapi/core.py'),
+                            'ghapi.core.update_contents': ('core.html#update_contents', 'ghapi/core.py')},
             'ghapi.event': { 'ghapi.event.GhApi.fetch_events': ('event.html#ghapi.fetch_events', 'ghapi/event.py'),
                              'ghapi.event.GhApi.list_events': ('event.html#ghapi.list_events', 'ghapi/event.py'),
                              'ghapi.event.GhApi.list_events_parallel': ('event.html#ghapi.list_events_parallel', 'ghapi/event.py'),

{ghapi-2.0.2 → ghapi-2.0.4}/ghapi/core.py

@@ -5,10 +5,16 @@ 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', 'GhApi',
-           'call_gh', 'date2gh', 'gh2date', 'read_pr', 'pr_file_diff', 'issue_body', 'APIError']
+__all__ = ['GH_HOST', 'pspec', 'img_md_pat', 'EMPTY_TREE_SHA', 'GhTransport', 'GhSyncTransport', 'print_summary', 'gh_patch',
+           'GhApi', 'call_gh', 'date2gh', 'gh2date', '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', 'issue_template', 'issue_body', 'check_status', 'pr_status',
+           'APIError']
 
 # %% ../nbs/00_core.ipynb #5b5cba7b
+from contextvars import ContextVar
+
 from fastcore.all import *
 from fastspec.spec import SpecParser
 from fastspec.oapi import OpenAPIClient, OpFunc, SyncOpFunc, _build_groups, UNSET
@@ -85,6 +91,23 @@ def print_summary(method, url, kwargs):
     hdrs = {k:v for k,v in (kwargs.get('headers') or {}).items() if k.lower()!='authorization'}
     print(method, url, {**kwargs, 'headers':hdrs})
 
+# %% ../nbs/00_core.ipynb #cecd0177
+_gh_override = ContextVar('_gh_override', default={})
+
+class _LiveDefaults(dict):
+    "Endpoint defaults, superseded at call time by any active `gh_patch` override"
+    def items(self): return {**self, **_gh_override.get()}.items()
+
+def gh_patch(fn):
+    "`patch` `fn` into `GhApi`, adding `owner`/`repo` params that override the client defaults for this call and its internal calls"
+    async def _f(self, *args, owner=UNSET, repo=UNSET, **kwargs):
+        over = {k:v for k,v in zip(('owner','repo'),(owner,repo)) if v is not UNSET}
+        if not over: return await fn(self, *args, **kwargs)
+        token = _gh_override.set({**_gh_override.get(), **over})
+        try: return await fn(self, *args, **kwargs)
+        finally: _gh_override.reset(token)
+    return patch(splice_sig(_f, fn, 'self'))
+
 # %% ../nbs/00_core.ipynb #83e8a9ce
 class GhApi(OpenAPIClient):
     "GitHub API client. Endpoint groups (`issues`, `pulls`, ...) are generated per-instance from GitHub's OpenAPI metadata, so the class shows only convenience methods -- inspect a live instance, e.g. `doc(GhApi())`, to see the full API."
@@ -102,7 +125,7 @@ class GhApi(OpenAPIClient):
         self.token,self.gh_host = token,gh_host or GH_HOST
         tcls,fcls = (GhSyncTransport,SyncOpFunc) if sync else (GhTransport,OpFunc)
         self.transport = tcls(debug=debug, limit_cb=limit_cb, timeout=timeout, base_headers=self.headers)
-        self.ops = [fcls(o, self.transport, self.gh_host, defaults=kwargs) for o in pspec.ops]
+        self.ops = [fcls(o, self.transport, self.gh_host, defaults=_LiveDefaults(kwargs)) for o in pspec.ops]
         self.func_dict = {f'{o.path}:{o.verb.upper()}':o for o in self.ops}
         self.groups = _build_groups(self.ops)
         for k,v in self.groups.items(): setattr(self, k, v)
@@ -195,7 +218,7 @@ async def update_gist(self:GhApi, gist_id:str, content:str):
     return (await self.gists.update(gist_id, files={fname: {'content': content}})).html_url
 
 # %% ../nbs/00_core.ipynb #4b7a278c
-@patch
+@gh_patch
 async def delete_release(self:GhApi, release):
     "Delete a release and its associated tag"
     await self.repos.delete_release(release.id)
@@ -211,7 +234,7 @@ async def upload_file(self:GhApi, rel, fn):
     return await self(url, 'POST', headers={'Content-Type':mime}, query = {'name':fn.name}, data=fn.read_bytes())
 
 # %% ../nbs/00_core.ipynb #3cad71a4
-@patch
+@gh_patch
 async def create_release(self:GhApi, tag_name, branch='master', name=None, body='',
     draft=False, prerelease=False, files=None, make_latest=UNSET):
     "Wrapper for `GhApi.repos.create_release` which also uploads `files`"
@@ -222,13 +245,13 @@ async def create_release(self:GhApi, tag_name, branch='master', name=None, body=
     return rel
 
 # %% ../nbs/00_core.ipynb #2be73ae0
-@patch
+@gh_patch
 async def list_tags(self:GhApi, prefix:str=''):
     "List all tags, optionally filtered to those starting with `prefix`"
     return await self.git.list_matching_refs(f'tags/{prefix}')
 
 # %% ../nbs/00_core.ipynb #303eeec6
-@patch
+@gh_patch
 async def list_branches(self:GhApi, prefix:str=''):
     "List all branches, optionally filtered to those starting with `prefix`"
     return await self.git.list_matching_refs(f'heads/{prefix}')
@@ -238,7 +261,7 @@ async def list_branches(self:GhApi, prefix:str=''):
 EMPTY_TREE_SHA = '4b825dc642cb6eb9a060e54bf8d69288fbee4904'
 
 # %% ../nbs/00_core.ipynb #ba6ab941
-@patch
+@gh_patch
 async def create_branch_empty(self:GhApi, branch):
     t = await self.git.create_tree(base_tree=EMPTY_TREE_SHA, tree = [dict(
         path='.dummy', content='ignore me', mode='100644', type='blob')])
@@ -246,38 +269,56 @@ async def create_branch_empty(self:GhApi, branch):
     return await self.git.create_ref(f'refs/heads/{branch}', c.sha)
 
 # %% ../nbs/00_core.ipynb #68b150fc
-@patch
+@gh_patch
 async def delete_tag(self:GhApi, tag:str):
     "Delete a tag"
     return await self.git.delete_ref(f'tags/{tag}')
 
 # %% ../nbs/00_core.ipynb #75c168a1
-@patch
+@gh_patch
 async def delete_branch(self:GhApi, branch:str):
     "Delete a branch"
     return await self.git.delete_ref(f'heads/{branch}')
 
 # %% ../nbs/00_core.ipynb #96053795
-@patch
+@gh_patch
 async def get_branch(self:GhApi, branch=None):
     branch = branch or (await self.repos.get()).default_branch
     return (await self.list_branches(branch))[0]
 
+# %% ../nbs/00_core.ipynb #9f70ac44
+@gh_patch
+async def commit_tree(self:GhApi, branch, message, tree, base=None):
+    "Commit `tree` entries to `branch`, creating it from `base` when needed"
+    try:
+        ref = await self.git.get_ref(f'heads/{branch}')
+        exists = True
+    except APIError as e:
+        if e.status_code != 404: raise
+        base = base or (await self.repos.get()).default_branch
+        ref,exists = await self.git.get_ref(f'heads/{base}'),False
+    parent = await self.git.get_commit(ref.object.sha)
+    new_tree = await self.git.create_tree(tree, parent.tree.sha)
+    commit = await self.git.create_commit(message, new_tree.sha, [parent.sha])
+    if exists: await self.git.update_ref(f'heads/{branch}', commit.sha)
+    else: await self.git.create_ref(f'refs/heads/{branch}', commit.sha)
+    return commit
+
 # %% ../nbs/00_core.ipynb #93b24881
-@patch
+@gh_patch
 async def list_files(self:GhApi, branch=None):
     ref = await self.get_branch(branch)
     res = (await self.git.get_tree(ref.object.sha)).tree
     return {o.path:o for o in res}
 
 # %% ../nbs/00_core.ipynb #ffc347b2
-@patch
+@gh_patch
 async def get_content(self:GhApi, path):
     res = await self.repos.get_content(path)
     return base64.b64decode(res.content)
 
 # %% ../nbs/00_core.ipynb #9582ee1f
-@patch
+@gh_patch
 async def create_or_update_file(self:GhApi, path, message, committer, author, content=None, sha=None, branch=''):
     if not branch: branch = (await self.repos.get())['default_branch']
     if not isinstance(content,bytes): content = content.encode()
@@ -287,20 +328,20 @@ async def create_or_update_file(self:GhApi, path, message, committer, author, co
         branch=branch, committer=committer or {}, author=author or {}, **kwargs)
 
 # %% ../nbs/00_core.ipynb #5044445d
-@patch
+@gh_patch
 async def create_file(self:GhApi, path, message, committer, author, content=None, branch=None):
     if not branch: branch = (await self.repos.get())['default_branch']
     return await self.create_or_update_file(path, message, branch=branch, committer=committer, content=content, author=author)
 
 # %% ../nbs/00_core.ipynb #4e74c337
-@patch
+@gh_patch
 async def delete_file(self:GhApi, path, message, committer, author, sha=None, branch=None):
     if not branch: branch = (await self.repos.get())['default_branch']
     if sha is None: sha = (await self.list_files())[path].sha
     return await self.repos.delete_file(path, message=message, sha=sha, branch=branch, committer=committer, author=author)
 
 # %% ../nbs/00_core.ipynb #93f6b559
-@patch
+@gh_patch
 async def update_contents(self:GhApi, path, message, committer, author, content, sha=None, branch=None):
     if not branch: branch = (await self.repos.get())['default_branch']
     if sha is None: sha = (await self.list_files())[path].sha
@@ -348,7 +389,7 @@ async def get_repo_contents(self:GhApi, owner, repo, branch='main',
     return L(await parallel_async(self.get_file_content, paths, owner=owner, repo=repo, branch=branch, n_workers=n_workers))
 
 # %% ../nbs/00_core.ipynb #ac4ab4e0
-@patch
+@gh_patch
 async def enable_pages(self:GhApi, branch=None, path="/"):
     "Enable or update pages for a repo to point to a `branch` and `path`."
     if path not in ('/docs','/'): raise Exception("path not in ('/docs','/')")
@@ -370,7 +411,7 @@ class _IssueInfo(AttrDict):
         return '\n\n'.join(res)
     __repr__ = _repr_markdown_
 
-@patch
+@gh_patch
 async def read_issue(self:GhApi, issue_number:int):
     "Fetch an issue or PR: title, body, comments, and (for PRs) diff, review comments, and reviews"
     try: pr = await self.pulls.get(issue_number)
@@ -463,7 +504,7 @@ def _parse_tmpl(name, txt):
             for b in d.get('body', []) if b['type']!='markdown']
     return dict2obj(dict(name=name, title=d.get('name'), description=d.get('description'), sections=secs))
 
-@patch
+@gh_patch
 async def issue_template(self:GhApi):
     "Parsed issue templates for the repo (or the owner's `.github` repo as fallback); pass one to `issue_body`"
     for repo,path in ((None,'.github/ISSUE_TEMPLATE'), ('.github','ISSUE_TEMPLATE'), ('.github','.github/ISSUE_TEMPLATE')):
@@ -501,14 +542,14 @@ class _CheckStatus(AttrDict):
         return '\n'.join([f'**{verdict}**', ''] + [f"- {r.name}: {r.conclusion or r.status}" for r in runs])
     __repr__ = _repr_markdown_
 
-@patch
+@gh_patch
 async def check_status(self:GhApi, ref:str):
     "Combined commit status and check-run results for `ref` (a SHA, branch, or tag)"
     combined = await self.repos.get_combined_status_for_ref(ref)
     checks = await self.checks.list_for_ref(ref)
     return _CheckStatus(dict2obj(dict(state=combined.state, statuses=combined.statuses, check_runs=checks.check_runs)))
 
-@patch
+@gh_patch
 async def pr_status(self:GhApi, pull_number:int):
     "Combined status and check-run results for a PR's head commit"
     return await self.check_status((await self.pulls.get(pull_number)).head.sha)

{ghapi-2.0.2 → ghapi-2.0.4}/ghapi/skill.py

@@ -9,9 +9,17 @@
     api = GhApi(owner='fastai', repo='ghapi')
     await api.issues.list_for_repo(state='open')   # owner/repo already bound
 
+These are only defaults: any endpoint or convenience method accepts `owner=`/`repo=` to override per call (e.g. `await api.check_status('v1.0', repo='other')`), so one client can serve a whole org; convenience methods propagate the override to everything they call internally.
+
 # Discovering the API
 
-`api.<group>` (displayed bare, or via `doc()`) lists every endpoint in a group (issues, pulls, repos, checks, actions, gists, git, search, ...) with its signature and a link to GitHub's docs. `api['/path/{owner}/{repo}', 'GET']` looks up an endpoint by path+verb if you'd rather not use the grouped names. Endpoint names follow `<verb>_<noun>`, e.g. `issues.list_for_repo`, `issues.create`, `pulls.merge`. Displaying `api` itself lists every available group with a docs link. `doc()` works at every level of a live instance: `doc(api)`, `doc(api.issues)`, `doc(api.issues.create)`. It must be a live instance, since the API is generated at construction time: inspecting the `GhApi` *class* shows only the convenience methods and none of the endpoint groups.
+Displaying `api` lists every available group with a docs link. Endpoint names follow `<verb>_<noun>`, e.g. `issues.list_for_repo`, `issues.create`, `pulls.merge`. Groups can contain hundreds of endpoints, so search their names with `pyskills.xdir()` instead of rendering the whole group, then inspect the matching endpoint:
+
+    import pyskills
+    pyskills.xdir(api.actions, 'log')
+    doc(api.actions.download_job_logs_for_workflow_run)
+
+The optional `pyskills.xdir` query is a case-insensitive regex. `doc()` works at every level of a live instance, but `doc(api.actions)` renders that group's complete endpoint list; use it only when the group is small enough to read. The instance must be live because the API is generated at construction time: inspecting the `GhApi` *class* shows only convenience methods, not generated groups. `api['/path/{owner}/{repo}', 'GET']` looks up an endpoint directly by path and verb.
 
 # Reading an issue or PR (including comments and reviews)
 
@@ -60,6 +68,16 @@ For anything that's about the local repo/working tree rather than GitHub itself
 
 `Git.__call__` prints (not raises) on a `CalledProcessError` unless you pass `mute_errors=True` -- check the return value, don't assume no exception means success.
 
+# External PRs
+
+For a PR to another owner's repo, use normal local Git through the commit, ensure your fork exists, then use one client scoped to the fork. `commit_tree` uploads GitHub tree entries as one commit without Git transport authentication; override `owner` only when creating the upstream PR:
+
+    api = GhApi('me', repo)
+    await api.commit_tree(branch, message, entries)
+    await api.pulls.create(owner='upstream', head=f'me:{branch}', base='main', title=title, body=body)
+
+Once the PR exists, the fork branch is the source of truth, and the local clone is residue: reset it (`git restore .` and switch back to the main branch) rather than leaving the edits behind, where a later session will find an unexplained diff. In particular, never build a second PR's edits on a tree still dirty from the first: each PR gets its own branch from main with a clean tree, since layered uncommitted edits ship a merged diff to `commit_tree` and block `git switch` once shared files diverge.
+
 # Gotchas
 
 - A PR *is* an issue for general comments (`issues.list_comments`, not `pulls.*`) -- inline code-review comments are the separate `pulls.list_review_comments`.
@@ -85,8 +103,7 @@ class ReadOnlyGhPolicy(AllowPolicy):
 allow({OpFunc: [('__call__', ReadOnlyGhPolicy())]})
 class GitPolicy(AllowPolicy):
     "Allow only safecmd-default git subcommands"
-    cmds = {
-        'blame','branch','cat-file','config','describe','diff','log','ls-files','ls-tree','merge-base',
+    cmds = {'blame','branch','cat-file','config','describe','diff','log','ls-files','ls-tree','merge-base',
         'remote','rev-parse','shortlog','show','stash','status','tag','fetch','add','commit','switch','checkout'}
 
     def __call__(self, obj, args, kwargs, data):

{ghapi-2.0.2 → ghapi-2.0.4/ghapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghapi
-Version: 2.0.2
+Version: 2.0.4
 Summary: A python client for the GitHub API
 Author-email: Jeremy Howard <info@fast.ai>
 License: Apache-2.0
@@ -16,7 +16,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: fastcore>=1.14.5
-Requires-Dist: fastspec>=0.1.0
+Requires-Dist: fastspec>=0.1.2
 Provides-Extra: dev
 Requires-Dist: fastgit; extra == "dev"
 Requires-Dist: matplotlib; extra == "dev"

{ghapi-2.0.2 → ghapi-2.0.4}/ghapi.egg-info/requires.txt

@@ -1,5 +1,5 @@
 fastcore>=1.14.5
-fastspec>=0.1.0
+fastspec>=0.1.2
 
 [dev]
 fastgit

{ghapi-2.0.2 → ghapi-2.0.4}/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>=1.14.5', 'fastspec>=0.1.0']
+dependencies = ['fastcore>=1.14.5', 'fastspec>=0.1.2']
 
 [project.urls]
 Repository = "https://github.com/fastai/ghapi"

ghapi-2.0.2/ghapi/__init__.py

@@ -1 +0,0 @@
-__version__ = "2.0.2"