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.0
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.0.tar.gz | 47.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| contributors_txt-1.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 64.3 kB
Release files / contributors_txt-1.1.0.tar.gz
| Download URL | contributors_txt-1.1.0.tar.gz |
|---|---|
| Size | 47.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e21307a70d1bd1c2230bd485f43f9139e2f75b8159079a0d4d8b2d550bbbcf81
|
|
BLAKE2b-256 checksum How to use checksums |
c68c33280d065b3e46e03d6b97134c0df9ef5e9679a0a8b2ebafa83d6fb79482
|
| 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.0-py3-none-any.whl
| Download URL | contributors_txt-1.1.0-py3-none-any.whl |
|---|---|
| Size | 16.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4b97239003423eddc7a087d9593bee4e93e42c02843d5e55f4bd4ec77b8df28c
|
|
BLAKE2b-256 checksum How to use checksums |
d7ad482396ac9a2b346867499b7eceebb8f0256db4d4884736d08c12119b8578
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
