Simple GitHub

A simple, request-inspired and promise-based wrapper around GitHub's API.

The idea here is to simplify interacting with the GH API for basic scenarios. It uses promises (as promises are such a nicer abstraction then callbacks).

The data set I'm working with and my use cases makes it so that it perfectly reasonable to send multiple gets and lump together the output of paginated data when fulfilling the promise. This might turn out to be a bad idea but I don't know better for now.

Because what I want to do is use the API as quickly as possible, this module supports copy pasting the URLs directly from the documentation:

var gh = require("simple-github")({
  owner: "tobie",
  repo: "simple-github"
});

gh.request("GET /repos/:owner/:repo/pulls/:number", { number: 349 }).then(console.log);

Interpolation is automatic.

Similarly, simple-github also accepts URI templates (as these are common in the GitHub API):

var gh = require("simple-github")({
  owner: "tobie",
  repo: "simple-github"
});

gh.request("https://api.github.com/repos/{owner}/{repo}/commits", { method: "get" }).then(console.log);