github-contributors
Generate a markdown or JSON list of contributors for a project using the GitHub API.
Install
Install with npm:
$ npm install --save github-contributors
Usage
var contributors = ;var repo = 'assemble/assemble';var opts = {}; ;
Contributors
The response is an array of contributor objects with this format:
login: 'doowb' id: 995160 avatar_url: 'https://avatars.githubusercontent.com/u/995160?v=3' gravatar_id: '' url: 'https://api.github.com/users/doowb' html_url: 'https://github.com/doowb' followers_url: 'https://api.github.com/users/doowb/followers' following_url: 'https://api.github.com/users/doowb/following{/other_user}' gists_url: 'https://api.github.com/users/doowb/gists{/gist_id}' starred_url: 'https://api.github.com/users/doowb/starred{/owner}{/repo}' subscriptions_url: 'https://api.github.com/users/doowb/subscriptions' organizations_url: 'https://api.github.com/users/doowb/orgs' repos_url: 'https://api.github.com/users/doowb/repos' events_url: 'https://api.github.com/users/doowb/events{/privacy}' received_events_url: 'https://api.github.com/users/doowb/received_events' type: 'User' site_admin: false contributions: 577
authentication
You can avoid hitting the GitHub rate limit by passing a client ID and client secret on the options:
var opts = id: processenvCLIENT_ID secret: processenvCLIENT_SECRET;;
formatted list
Instead of JSON, get a markdown-formatted list by defining one of the following on options.format
list
aligned
table
Here are some examples.
list
Contributors from jonschlinkert/micromatch
Commits / Contributor
- 253 jonschlinkert
- 4 es128
- 1 UltCombo
- 1 tomByrer
aligned list
Contributors from jonschlinkert/gray-matter
COMMITS / CONTRIBUTOR------- | -----------107 jonschlinkert7 RobLoach2 doowb1 ianstormtaylor
table
Contributors from assemble/assemble
Commits | Contributor |
---|---|
949 | jonschlinkert |
577 | doowb |
11 | adjohnson916 |
7 | Arkkimaagi |
4 | bendrucker |
2 | avr |
2 | thegreatsunra |
2 | StevenBlack |
2 | xzyfer |
2 | ain |
1 | prettyboymp |
1 | asans |
1 | bauerca |
1 | jordanthomas |
1 | pburtchaell |
1 | oncletom |
1 | tomcode |
1 | tylerhowarth |
About
Related projects
- get-pkgs: Get the package.json for an array of repos from the npm registry, optionally filtering properties… more | homepage
- github-base: JavaScript wrapper that greatly simplifies working with GitHub's API. | homepage
Contributing
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Building docs
(This document was generated by verb-generate-readme (a verb generator), please don't edit the readme directly. Any changes to the readme must be made in .verb.md.)
To generate the readme and API documentation with verb:
$ npm install -g verb verb-generate-readme && verb
Running tests
Install dev dependencies:
$ npm install -d && npm test
Author
Jon Schlinkert
License
Copyright © 2016, Jon Schlinkert. Released under the MIT license.
This file was generated by verb-generate-readme, v0.1.30, on September 09, 2016.