#hide
from ghapi.core import *
import os
A delightful and complete interface to GitHub's amazing API
GhApi
provides 100% always-updated coverage of the entire GitHub API. Because we automatically convert the OpenAPI spec to a Pythonic API, GhApi
is always up to date with the latest changes to GitHub APIs.
Using GhApi
, you can do anything that you can do through the GitHub web interface or through the git
client, such as:
Either pip install ghapi
or conda install -c fastai ghapi
.
Throughout this documentation, you will see code inputs and outputs shown in this format:
1+1
2
We recommend reading the documentation on the official site, rather than on GitHub, since not all the functionality described on this page is available through the GitHub viewer.
All of the documentation is available directly as Jupyter Notebooks, for instance the current page you're reading is available as a notebook here. To open any page as an interactive notebook in Google Colab, click the Colab badge at the top of the page.
#hide
github_token = os.environ['FASTRELEASE_TOKEN']
To access the GitHub API, first create a GhApi
object:
api = GhApi()
Every part of the API includes documentation directly in the api
object itself. For instance, here's how to explore the groups of functionality provided by the API by displaying the object:
api
Then we can explore the endpoints provided by the API in each group, e.g. for the git
group:
api.git
Here's how to learn about an endpoint you want to use, e.g.:
api.git.get_ref
git/get_ref(ref, repo, owner): Get a reference
In Jupyter Notebook full tab completion, parameter lists, etc are provided for all endpoints. Endpoints are called as standard Python methods:
api.git.get_ref(owner='fastai', repo='fastcore', ref='heads/master')
For access to authenticated endpoints, pass a GitHub token. You can also pass any parameters you want auto-inserted into relevant methods, such as owner
and repo
:
api = GhApi(owner='fastai', repo='fastcore', token=github_token)
We can now repeat the previous method, but only need to pass ref
:
api.git.get_ref('heads/master')
Now that we've provided our token, we can use authenticated endpoints such as creating an issue:
issue = api.issues.create("Remember to check out GhApi!")
Since we've now checked out GhApi, let's close this issue. 😎
api.issues.update(issue.number, state='closed')