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

@auto-it/all-contributors

Package Overview
Dependencies
Maintainers
1
Versions
698
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@auto-it/all-contributors

Automatically add contributors as changelogs are produced.

  • 10.18.5
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
7.8K
decreased by-29.86%
Maintainers
1
Weekly downloads
 
Created
Source

All Contributors Plugin

Automatically add contributors as changelogs are produced.

This plugin maps one of the contribution type to a glob or array of globs. Out of the box the plugin will only detect the following contribution types:

  • 📖 doc - Edits to any README ['**/*.mdx', '**/*.md', '**/docs/**/*', '**/documentation/**/*']
  • 💡 example - Edits to ['**/*.stories*', '**/*.story.*']
  • 🚇 infra - Edits to ['**/.circle/**/*', '**/.github/**/*', '**/travis.yml'],
  • ⚠ī¸ test - Edits to ['**/*.test.*']
  • đŸ’ģ code - Edits to ['**/src/**/*', '**/lib/**/*', '**/package.json', '**/tsconfig.json']

Installation

This plugin is not included with the auto CLI installed via NPM. To install:

npm i --save-dev @auto-it/all-contributors
# or
yarn add -D @auto-it/all-contributors

Prerequisites

For this plugin to work your project needs to have initialized an all-contributors RC file.

npx all-contributors init

Usage

{
  "plugins": ["all-contributors"]
}

Configure Contribution Type Matching

You use any of the contribution type. If you configure an pre-configured contribution type the arrays are not merged, it is overridden.

auto.rc

{
  "plugins": [
    [
      "all-contributors",
      {
        "types": {
          "plugin": "**/plugin/**/*",
          "example": ["**/*.stories.*", "**/*.examples.*", "**/*.snippet.*"]
        }
      }
    ]
  ]
}

Adding Non-Code Contributions

Sometimes you worked with a person that didn't touch the code personally so this plugin would never attribute them with any contributions. Since these contributions cannot be automated you can instead just list out another contributor's contributions directly in the PR. These contributors will also be added to all changelogs that auto outputs.

Add the following to a PR body and auto will try to parse it and add contributors from it.

# Contributions

- @some_guy - design, doc

To ensure you are doing it right auto will comment on the PR with the people + contributions you are manually adding.

Exclude Users

Useful for excluding bots from getting into your contributors.

auto.rc

{
  "plugins": [
    [
      "all-contributors",
      {
        "exclude": ["dependabot", "ci-services"]
      }
    ]
  ]
}

Sub-Package Contributors list

Maintain contributors lists for sub-packages in a monorepo setup (lerna/yarn).

All you need to do is initialize each sub-package you want contributors tracked in with an .all-contributorsrc. If no rc file is found nothing will happen for that package. Any non-code contribution listed in the PR body will also be added to the sub-package contributors list.

cd packages/your-package
npx all-contributors init

ℹī¸ Tip: If you only want 1 commit for new contributions set commit to false in all of your .all-contributorsrc. Otherwise a commit will be made for each package's contributor update.

Keywords

FAQs

Package last updated on 11 Mar 2021

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