GitHub - JoshuaKGoldberg/description-to-co-authors: Parses co-authors from Git/GitHub-style commit messages and issue bodies. ✍️ (original) (raw)

Parses co-authors from Git/GitHub-style commit messages and issue bodies. ✍️

👪 All Contributors: 1 🤝 Code of Conduct: Kept 🧪 Coverage 📝 License: MIT 📦 npm version 💪 TypeScript: Strict

Usage

npm i description-to-co-authors

Pass any variant of Git/GitHub-style commit message or issue body string to this package's exported descriptionToCoAuthors. It will collect data from each case-insensitive co-authored-by: match. Data may include email, name, and/or username:

import { descriptionToCoAuthors } from "description-to-co-authors";

descriptionToCoAuthors(co-authored-by: @DirectUsername Co-authored-by: Josh Goldberg <github@joshuakgoldberg.com>);

[ { "username": "DirectUsername" }, { "email": "github@joshuakgoldberg.com", "name": "Josh Goldberg" } ]

Note

Proper Co-authored-by attributions should use the name <email> format, not @username. The @username extension is only there as a friendly compatibility layer for GitHub users who don't allow seeing their email. Please don't use it unless you absolutely need to.

Development

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

Contributors

💝 This package was templated with create-typescript-app using the Bingo framework.