README.md

github-api-promise

A node module for interfacing with the Github API using promises. The full GitHub API documentation can be found at https://developer.github.com/v3/.

Installation

npm install github-api-promise

Resources

• Documentation
• 

Usage

TLDR;

1. import github-api-promise
2. Set settings
3. Make API calls

Basic example code:

import api from "github-api-promise";

// Set settings
api.config.owner = 'OwnersGithubUsername';
api.config.repo = 'RepoName';
api.config.token = 'YourAccessToken';
api.config.debug = true; // Default is false. Logs request information via console.log when true.

// Do stuff
api.repos.releases.getRepositoryReleases()
	.then((res) => {
		// Do your stuff here. res is the JSON object returned by the API
	})
	.catch((err) => {
		console.log(`Request failed: ${err}`);
	});

For help creating an access token, see the GitHub help article Creating an Access Token for Command Line Use. This package only requires either the repo scope for private repos or the public_repo scope for public repos.

API Support

The following APIs are supported. PRs welcome!

• Activity
  • Events
• Issues
  • Comments
  • Events
  • Issues
• Pull Requests
  • Comments
  • Pull Requests
• Repositories
  • Commits
  • Contents
  • Releases
  • Repositories
• Teams
  • Teams

Thanks

Special thanks to jeejkang for the Stormtroopocat image!

Thanks to aktau/github-release (a library for GO) for the inspiration for this project.