Skip to content

Latest commit

 

History

History
53 lines (36 loc) · 1.51 KB

api.rst

File metadata and controls

53 lines (36 loc) · 1.51 KB
Raw

Anonymous Functional API

github3

github3.api

This part of the documentation covers the API. This is intended to be a beautifully written module which allows the user (developer) to interact with github3.py elegantly and easily.

Module Contents

To interact with the GitHub API you can either authenticate to access protected functionality or you can interact with it anonymously. Authenticating provides more functionality to the user (developer).

To authenticate, you may use github3.login.

github3.login

With the ~github3.github.GitHub object that is returned you have access to more functionality. See that object's documentation for more information.

To use the API anonymously, you can also create a new ~github3.github.GitHub object, e.g.,

from github3 import GitHub

gh = GitHub()

Enterprise Use

If you're using github3.py to interact with an enterprise installation of GitHub, you must use the ~github3.github.GitHubEnterprise object. Upon initialization, the only parameter you must supply is the URL of your enterprise installation, e.g.

from github3 import GitHubEnterprise

g = GitHubEnterprise('https://github.examplesintl.com')
stats = g.admin_stats('all')
assert 'issues' in stats, ('Key issues is not included in the admin'
                           'statistics')