contributor.io

Fetch counts of a user's contributions to various platforms (Github, NPM, Gem, CPAN, Nuget, ...)

contributor.io

Fetch counts of a user's contributions to various platforms (Github, NPM, Gem, CPAN, Nuget, ...)

  • Github
  • NPM
  • Rubygems
  • CPAN
  • Nuget
  • Bower
  • Component

Send a GET request to contributor.io/api with each platform/username you'd like as a query parameter.

CLI example

JavaScript example

# install dependencies
npm install
 
# start server
node server
 
# send a request!
curl localhost:5000/api?github=myGithubUsername&npm=myNpmUsername
# => { github: 42, npm: 66 }

To add Github authentication (optional, increase request limit):

  1. Register a Github Application to receive an oauth2 id and secret.

  2. Define process.env.github_oauth_id and process.env.github_oauth_secret somewhere (eg. at the top of contributor.coffee) and set them equal to the keys you got in Step #1.

# install dependencies
npm install

And in your (coffee)script:

contributor = require 'contributor.io'
 
contributor
    gem: 'bcherny'
    github: 'eighttrackmind'
    npm: 'bcherny'
    cpan: 'FAYLAND'
    nuget: 'microsoft'
.then (counts) ->
 
    # returns an object with counts, eg.: 
    # { 
    #   gem: 20 
    #   github: 50 
    #   npm: 45 
    #   cpan: 67 
    #   nuget: 818 
    # } 
contributor = require 'contributor.io'
 
contributor.support #=> returns an array of supported platforms 
  • Node
  • CommonJS
  1. Publish an NPM module which exports a single function that:
    • Accepts one or more arguments. The first must be the username and the rest must be optional.
    • Returns a deferred promise.
    • A resolved promise must return a single Number (aka. the number of contributions).
    • A rejected promise can return anything, but should ideally be a descriptive Object.
    • Ensure that your module is unit tested, and that promises are resolved and rejected appropriately.
  2. Fork contributor.io.
  3. Install your dependency with npm install --save myNewModuleName.
  4. Require your module in the list at the top of contributor.coffee.
  5. Add a human-readable description to the list at the top of index.coffee.
  6. Add it to the list of supported modules in README.md, and as a keyword in package.json.
  7. Commit and send a pull request! :)