all-contributors-for-repository

All Contributors For Repository

Generates an allcontributors list for an existing repository.

Usage

npm i all-contributors-for-repository

import { createAllContributorsForRepository } from "all-contributors-for-repository";

const contributors = await createAllContributorsForRepository({
	owner: "JoshuaKGoldberg",
	repo: "template-typescript-node-package",
});
/*
{
  john_reilly: [ 'bug', 'code' ],
  joshuakgoldberg: [ 'maintenance', 'tool' ],
}
*/

Warning This tool only sees contributions that can be detected from the last 500 events in GitHub's API. Don't forget to manually add in other forms of contributions!

The types of contributions detected are:

• 🐛 bug: anybody who filed an issue labeled as accepting PRs and a bug (see options)
• 💻 computer: all PR authors and co-authors
• 📖 doc: authors of merged PRs that address issues labeled as accepting PRs and docs (see options)
• 🚧 maintenance: adding labels to issues and PRs, and merging PRs
• 👀 review: submitting a review for a PR
• 🔧 tool: authors of merged PRs that address issues labeled as accepting PRs and tooling (see options)

💡 Given that list of contributors, you might want to run all-contributors add on each contributor & contribution type.

import { $ } from "execa";

for (const [contributor, contributions] of Object.entries(contributors)) {
	for (const contribution of contributions) {
		await $`npx all-contributors add ${contributor} ${contribution}`;
	}
}

Development

See .github/CONTRIBUTING.md, then .github/DEVELOPMENT.md. Thanks! 💖

Contributors

Josh Goldberg 🔧 🐛 💻 🚧 👀 📖

💙 This package is based on @JoshuaKGoldberg's template-typescript-node-package.