What is this?
This library defines an object oriented representation of the GitHub API. By "object oriented" we mean
there are classes that correspond to the domain model of GitHub (such as
operations that act on them as defined as methods (such as
GHUser.follow()), and those object references
are used in favor of using string handle (such as
GHUser.isMemberOf(GHOrganization) instead of
The library supports both github.com and GitHub Enterprise.
There are some corners of the GitHub API that's not yet implemented, but the library is implemented with the right abstractions and libraries to make it very easy to improve the coverage.
GitHub github = GitHub.connect(); GHRepository repo = github.createRepository( "new-repository","this is my new repository", "http://www.kohsuke.org/",true/*public*/); repo.addCollaborators(github.getUser("abayer"),github.getUser("rtyler")); repo.delete();
This library allows the caller to supply the credential as parameters, but it also defines a common convention
so that applications using this library will look at the consistent location. In this convention, the library
~/.github property file, which should have the following two values:
Alternatively, you can have just the OAuth token in this file:
This library comes with a pluggable connector to use different HTTP client implementations
HttpConnector. In particular, this means you can use OkHttp,
so we can make use of it's HTTP response cache.
Making a conditional request against the GitHub API and receiving a 304 response
does not count against the rate limit.