contributors-txt
Generate a list of contributors automatically from git data.
Install
pip install contributors-txt
Usage
Run inside a git repository. Without an alias file, contributors are listed straight
from git shortlog:
contributors-txt -o CONTRIBUTORS.txt
Pass an alias file to merge multiple emails under one name and assign teams:
contributors-txt -a aliases.json -o CONTRIBUTORS.txt
Add --no-bots to filter out GitHub Apps (dependabot[bot], pre-commit-ci[bot],
github-actions[bot], Copilot, Claude, …):
contributors-txt --no-bots -a aliases.json -o CONTRIBUTORS.txt
If the output file already exists it is updated in place: missing emails are added and new contributors are inserted in commit-count order, preserving any manual edits.
Alias file
{
"pierre.sassoulas@gmail.com": {
"mails": ["pierre.sassoulas@gmail.com", "pierre.sassoulas@elum-energy.com"],
"name": "Pierre Sassoulas",
"team": "Maintainers"
}
}
Two helpers ship alongside the main command:
contributors-txt-normalize-configuration -a aliases.jsonrewrites an alias file in the canonical sorted form.contributors-txt-extract-comment <CONTRIBUTORS.txt> -a aliases.jsonpulls free-text comments from an existing CONTRIBUTORS file back into the alias file.
Metadata
Release files for contributors-txt 1.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| contributors_txt-1.1.2.tar.gz | 48.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| contributors_txt-1.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 65.5 kB
Release files / contributors_txt-1.1.2.tar.gz
| Download URL | contributors_txt-1.1.2.tar.gz |
|---|---|
| Size | 48.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
de261b51dec2d02ee214582902eab6f0d683d607bd22046a49b1c54e8264cd2b
|
|
BLAKE2b-256 checksum How to use checksums |
df6e97eaacc8b372920ebc8219144a83cc28b4c54ff8f8430a4fe618910f90cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / contributors_txt-1.1.2-py3-none-any.whl
| Download URL | contributors_txt-1.1.2-py3-none-any.whl |
|---|---|
| Size | 17.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a31add28bea4e18bab44460f2ae660801be1cc30f47c1ece0755a83c799e793f
|
|
BLAKE2b-256 checksum How to use checksums |
748bd28f441799ecf387b335b290981e785971d2cdae05ae81a491f98e7de75a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
