Skip to content

Micro CLI application to get all GitHub contributors for a specified repository

License

Notifications You must be signed in to change notification settings

PrestaShop/traces

Repository files navigation

Traces

Traces is a micro CLI application that is able to get all contributors and their contributions in "developer-readable" JSON format for a specified repository.

Installation

The authentication is a basic login/password for GitHub.

Note: If your Github login uses two-factor authentication, use an API token instead of password

 $ composer require prestashop/traces
 
 # Check a repository
 $ ./vendor/bin/traces -u <login> -p <password> -r <repositoryOwner/repositoryName> --config="config.yml"
 
 # Check an organization
 $ ./vendor/bin/traces -u <login> -p <password> -o <repositoryOwner> --config="config.yml"

A file named contributors.js will be generated, you can manipulate it using any programming language.

Configuring

There are a number of settings that can be configured via the config file. Take a look at the config.dist.yml file for an example.

Option Description
exclusions List of excluded users.
keepExcludedUsers Set to true to flag excluded contributors instead of filtering them out from the output.
fieldsWhitelist List of fields to keep from the API result. Leave blank if you want to keep them all.
extractEmailDomain Set to true to extract the user's email domain and include it in the generated file

License

This project is released under the MIT license.