Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

all-contributors-cli

Package Overview
Dependencies
Maintainers
1
Versions
121
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

all-contributors-cli

Tool to easily add recognition for new contributors

  • 2.0.0-beta4
  • beta
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
33K
decreased by-12.11%
Maintainers
1
Weekly downloads
 
Created
Source

all-contributors-cli

All Contributors

This is a tool to help automate adding contributor acknowledgements according to the all-contributors specification.

Installation

You can install it via npm:

npm install all-contributors-cli

Configuration

Create a .all-contributorsrc file

You must create a .all-contributorsrc JSON file. The data used to generate the contributors list will be stored in here, and you can configure how you want all-contributors-cli to generate the list.

{
  "files": ["README.md"],
  "owner": "jfmengels",
  "types": {
    "cheerful": {
      "symbol": ":smiley:"
    }
  },
  "contributors": [{
    "login": "jfmengels",
    "...": "..."
  }]
}

These are the keys you can specify:

  • files: Array of files to update. Default: ['README.md']
  • projectOwner: Name of the user the project is hosted by. Example: jfmengels/all-contributor-cli --> jfmengels. Mandatory.
  • projectName: Name of the project. Example: jfmengels/all-contributor-cli --> all-contributor-cli. Mandatory.
  • types: Specify custom symbols or link templates for contribution types. Can override the documented types.
  • imageSize: Size (in px) of the user's avatar. Default: 100.
  • contributorsPerLine: Maximum number of columns for the contributors table. Default: 7.
  • contributorTemplate: Define your own template to generate the contributor list.
  • badgeTemplate: Define your own template to generate the badge.

Add contributors section

If you don't already have a Contributors section in a Markdown file, create one. Then add the comment tags section below to it. Don't worry, they're visible only to those that read the raw file. The tags must be at the beginning of the line, and each on their separate line.

## Contributors

 <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
 <!-- ALL-CONTRIBUTORS-LIST:END -->

If you wish to add a badge ( All Contributors ) indicating the number of collaborators, add the following tags (again, at the beginning of the line and each on their separate line):

some-badge

 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
some-other-badge

Usage

Generating the contributors list

Use generate to generate the contributors list and inject it into your contributors file. Contributors will be read from your configuration file.

all-contributors generate

Add new contributor

Use add to add new contributors to your project. They will be added to your configuration file. The contributors file will then be updated just as if you used the generate command.

# Add new contributor <username>, who made a contribution of type <contribution>
all-contributors add <username> <contribution>
# Example:
all-contributors add jfmengels code,doc

Where:

  • username is the user's GitHub username
  • contribution is a ,-separated list of ways to contribute, from the following list (see the specs):
    • code: 💻
    • plugin: 🔌
    • tool: 🔧
    • doc: 📖
    • question: ❓
    • test: ⚠️
    • bug: 🐛
    • example: 💡
    • blog: 📝
    • tutorial: ✅
    • translate: 🌍
    • video: 📹
    • talk: 📢
    • design: 🎨
    • review: 👀

Contributors

Thanks goes to these wonderful people (emoji key):

Jeroen Engels
Jeroen Engels

💻 📖 ⚠️
Kent C. Dodds
Kent C. Dodds

📖

This project follows the all-contributors specification. Contributions of any kind welcome!

LICENSE

MIT

Keywords

FAQs

Package last updated on 06 Mar 2016

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc