ghapi 2.0.2__tar.gz → 2.0.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghapi
-Version: 2.0.2
+Version: 2.0.3
 Summary: A python client for the GitHub API
 Author-email: Jeremy Howard <info@fast.ai>
 License: Apache-2.0

ghapi-2.0.3/ghapi/__init__.py

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

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

@@ -49,6 +49,7 @@ d = { 'settings': { 'branch': 'main',
                             '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.commit_tree': ('core.html#ghapi.commit_tree', '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-2.0.2 → ghapi-2.0.3}/ghapi/core.py

@@ -263,6 +263,24 @@ 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
+@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
 async def list_files(self:GhApi, branch=None):

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

@@ -60,6 +60,14 @@ 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)
+
 # 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`.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghapi
-Version: 2.0.2
+Version: 2.0.3
 Summary: A python client for the GitHub API
 Author-email: Jeremy Howard <info@fast.ai>
 License: Apache-2.0

ghapi-2.0.2/ghapi/__init__.py

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