Skip to content

gitcommitshow/open-community-kit

Repository files navigation

open-community-kit (ock)

Tools and stats for open-source communities

test

Installation

npm install -g open-community-kit

You can use npx as well if you just want to test a CLI command


Usage

Leaderboard - GitHub Contributors

For all the repos of a user/org. Contributor with highest # of contributions at the top.

Using CLI

Run open-community-kit yourGithubOrgName from your terminal

Note: You can also use the shorthand ock in place of open-community-kit i.e.

ock yourGitHubOrgName

This will

  • Fetch data from Github APIs and prepare a leaderboard of all the contributors to public repositories of your GitHub organization/user account
  • Save the leaderboard in a csv file in the same folder

You will hit the API limits soon. To increase API limits, add GITHUB_PERSONAL_TOKEN as well in the arguments i.e.

ock yourGitHubOrgName yourGitHubPersonalToken

Using code

import OCK from 'open-community-kit';
OCK.contributors.github.archive(
    'your_github_org_or_username', 
    { 
        GITHUB_PERSONAL_TOKEN: 'your_gh_personal_token_optional'
    }
);

Settings for repeated usage

If you are going to use this command frequently, you might not want to set organization name and personal token again and again. Instead, you can set following environment variables and then you don't need to pass those variables as CLI arguments or function parameters

# Set these variables in the environment to avoid repeatedly specifying these variables
1. REPO_OWNER
2. GITHUB_PERSONAL_TOKEN