Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Github API v3 library for Python.
Python
branch: master

This branch is 1 commit behind ChristopherMacGown:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
github3
tests
.gitignore
HACKING
README
setup.py

README

python-github3
==============

Here are the beginning of a python library to take advantage of the new API. It
is still in development and the interfaces may (read: will) change but is full
featured enough now to be used for most tasks of the new API.

Caveats
-------

This is for the APIv3 featureset. If the stuff in APIv2 is a long time coming
then there is some vague chance of adding support for those features here, but
in general the style of the two versions are rather different so it is somewhat
preferable to limit this to the v3 style.


Examples
--------

  from github3 import client

  # Build a client with our auth credentials, works with oauth_token
  # instead of password.
  c = client.Client(username='some_user', password='some_password')

  # Most actions (issues and the like) are actions on a repo
  repo = client.Repo(c,'repo_user', 'repo_name')

  # We use a very pythonic interface to the data, most things act like dicts or
  # lists, though the interfaces still need a little massaging
  issues = repo.issues()

  # Iterate through all the issues, handle pagination for you so may make
  # multiple requests.
  for x in issues:
    print x['title']

  # Create a new issue
  new_issue = issues.append(title='foo')

  # Update that issue
  new_issue.update(milestone=1)

  # Delete that issue
  new_issue.delete()
Something went wrong with that request. Please try again.