GitHub's Statuses API is one of the more popular recent additions to GitHub's large and all-encompassing API. This API allows you to create and list statuses like those created by popular Continuous Integration services (e.g., Jenkins, Travis CI, etc.). github3.py provides unfettered access to these functions and the following should help explore that functionality.
In [5]:
import github3
repository = github3.repository('sigmavirus24', 'github3.py')
With a repository object, we can now retrieve the statuses from a number of different commit-like objects which we can retrieve using the repository's commit method.
In [7]:
commit = repository.commit('9df71a9772d5f43e332c855a32d4689f28289989')
tag = repository.commit('0.9.3')
branch = repository.commit('stable/0.9')
Each of these bindings now hold a reference to a different RepoCommit object and each has a statuses method. We can retrieve statuses about each reference and print them.
In [8]:
for ref in (commit, tag, branch):
print('Showing statuses for "{0.sha}" ({0.html_url})'.format(ref))
for status in ref.statuses():
print(" State: {0.state}; Description: {0.description}; Context: {0.context}".format(status))
In [1]:
import github3
import os
g = github3.login(os.environ['GH_USERNAME'], os.environ['GH_PASSWORD'])
repository = g.repository('sigmavirus24', 'github3.py')
With our repository object, we can now create a status for an arbitrary commit using the create_status method.
In [2]:
status = repository.create_status(sha='020cfe6422e3b2a0a5ff985c9e1c0aa921555bd8',
state='success',
description='Documentation status',
context='default')
print('Status {0.state} for context {0.context} with description {0.description}'.format(status))
We now have a "success" status defined on our commit and can retrieve it by listing statuses (as described above).