github-metrics v0.4.4

github-metrics

a repo to track github stats across different users github repos

Installation

npm install github-metrics -g

Usage

command-line

Usage: github-metrics [options]


Options:

  -V, --version        output the version number
  -u, --user [user]    the name of the user that you want to get metrics for.
  -t, --token [token]  github access token to make requests.
  -k, --keys [keys]    keys to be passed to make the table based on the comma seperated keys you provide.
  -s, --sort [sort]    key to be used to sort against the returned value
  -a, --asc            by default the sorting is descending if this is selected it will be ascending
  -l, --limit [limit]  limit the number of repos that are being returned
  --table              output a table of the data
  -h, --help           output usage information

examples

github-metrics --user gabrielcsapo // this will call github using the public api

github-metrics --user gabrielcsapo --token {token} // this will make the call with an authenticated token

Debugging any errors that occur during your call please preface with DEBUG=github-metrics and example would look like

DEBUG=github-metrics github-metrics --user gabrielcsapo

programatic

const Metrics = require('github-metrics');
Metrics({
    user: '',
    token: '',
    keys: [],
    sort: '',
    sortAsc: false,
    limit: 10
}, function(err, metrics) { });

Keys Available

[
  'archive_url',
  'assignees_url',
  'blobs_url',
  'branches_url',
  'clone_url',
  'collaborators_url',
  'comments_url',
  'commits',
  'commits_url',
  'compare_url',
  'contents_url',
  'contributors_url',
  'created_at',
  'days_stagnant',
  'default_branch',
  'deployments_url',
  'description',
  'deprecated',
  'downloads_url',
  'events_url',
  'fork',
  'forks',
  'forks_count',
  'forks_url',
  'full_name',
  'git_commits_url',
  'git_refs_url',
  'git_tags_url',
  'git_url',
  'has_downloads',
  'has_issues',
  'has_pages',
  'has_wiki',
  'health',
  'homepage',
  'hooks_url',
  'html_url',
  'id',
  'issue_comment_url',
  'issue_events_url',
  'issues_url',
  'keys_url',
  'labels_url',
  'language',
  'languages',
  'languages_url',
  'last_contribution',
  'merges_url',
  'milestones_url',
  'mirror_url',
  'name',
  'notifications_url',
  'open_issues',
  'open_issues_count',
  'owner',
  'permissions',
  'private',
  'pulls_url',
  'pushed_at',
  'releases_url',
  'size',
  'ssh_url',
  'stargazers_count',
  'stargazers_url',
  'statuses_url',
  'subscribers_url',
  'subscription_url',
  'svn_url',
  'tags_url',
  'teams_url',
  'trees_url',
  'topics',
  'updated_at',
  'url',
  'watchers',
  'watchers_count'
 ]

Example

github-metrics --user gabrielcsapo --keys 'full_name, homepage, commits, open_issues_count, days_stagnant, health' --sort 'days_stagnant' --asc --table