Contribution Counters

Have you ever wanted to find out how many repos/projects you've contributed to and with how many commits? Well, now you can easily do so with this simple to use module!

This contribution counter is for 3 VCSs: GitHub, Bitbucket & GitLab and is achieved via each of their API's and access tokens.

Instructions

Installing

1. To install locally: npm install contribution-counters --save
2. To install globally: npm install contribution-counters --global

Using module

1. Import the necessary counter like below:

   const { getGitHubCounts } = require("contribution-counters");

2. Set up the configuration for the selected counter

   The config is an object with the following properties (all available on all counters unless specified):

   • username: Your username (string:required)
   • accessToken: An access token for the user above (string:required)
   • minCommits: The minimum number of commits a repo needs to count as a contribution (int:default=1)

   The below two are only used if a commit doesn't have a real user attached (At least one is required for Bitbucket & GitLab & both optional for GitHub BUT advised to use both for all)

   • userEmailAddresses: Array of email addresses which may be associated with your commits (array)
   • userNames: Array of name's which may be associated with your commits (array)

   If you only want counts for after and/or before a particular date (inclusive) (or if you know the date you first and/or last contributed this can be used to minimise API requests)

   • fromDate: Datetime string (ISO-8601 Date/timestamp (YYYY-MM-DDTHH:mm:ss.sssZ))
   • untilDate: Datetime string (ISO-8601 Date/timestamp (YYYY-MM-DDTHH:mm:ss.sssZ))

   To get repos of which you have a min access to

   • minRepoAccessLevel: Only for GitLab (int:default=30)[10, 20, 30, 40, 50] (see here)
   • minRepoRole: Only for Bitbucket (string:default=contributor)[admin, contributor, member, owner] (see here)
   • minRepoRole: Only for GitHub (comma separated string:default=owner,collaborator,organization_member)[owner, collaborator, organization_member] (see here)

   If you have a self hosted GitLab, you will need to use url option

   • url: The URL where your GitLab is located at (for example https://gitlab.jahidulpabelislam.com/ or https://jahidulpabelislam.com/gitlab/)

3. Start the counter with the following:

   const counts = await getGitHubCounts(config);
   

4. The returned result (counts) is a object with two properties:

   • commits is your total commits
   • projects is the number of projects you've contributed to

getGitHubCounts in the above example can be replaced with getBitbucketCounts or getGitLabCounts.

Creating access tokens

• GitHub
• GitLab
• Bitbucket

Upgrading

v1 to v2

In version 2, the only braking change is that only functions can be imported/required, instead of Counter classes.

To upgrade you will need to import/require the 3 new functions: getBitbucketCounts, getGitHubCounts & getGitLabCounts instead of Bitbucket, GitHub & GitLab. Where before you created a instance of a class (e.g. GitHub) and passed in a object of config, then called a function (getCounters) to get the counts. Now the new functions will do both in one. So just call the new function and pass in the existing config object as the only parameter and then your counts will be returned.

Support

If you found this module interesting or useful please do spread the word of this module: share on your social's, star on github, etc.

If you find any issues or have any feature requests, you can open a issue or can email me @ jahidulpabelislam.com :smirk:.

Authors

• Jahidul Pabel Islam me@jahidulpabelislam.com

License

This module is licensed under the General Public License - see the License file for details