pyaddlicense adds license headers to any source file it finds that does not have one. By default it respects .gitignore
and doesn't touch autogenerated files.
It is inspired by addlicense, but includes more features and can be used in environments that might not have go
or docker
.
Default Example:
pyaddlicense -o 'Example Company'
We reccomend installing pyaddlicense
globally via pipx
so that it remains in an isolated environment:
pipx install pyaddlicense
However, pip
should also work if you want to include it solely in your local venv:
pip install pyaddlicense
By default, only the -o
(or --owner
) flag is required to say who the holder/owner of the license is:
pyaddlicense -o 'Example Company'
This will recursively search every file and every directory from the current one and add the default license to every file where a license is missing any the file isn't autogenerated. This will respect any .gitignore entries.
The default license is: (c) Copyright {{ .HOLDER }} {{ .YEAR }}. All rights reserved.
where both {{ .HOLDER }}
and {{ .YEAR }}
are macros that will be replaced by the string given as -o
and the current year respectively.
If you just want to see what files are missing licenses, you can use the -c
(or --check
) flag:
pyaddlicense -o 'Example Company' -c
You can additional files or folders to ignore with the -i
(or --ignore
) flag:
pyaddlicense -o 'Example Company' -i .flake8 -i pyproject.toml
NOTE: This will be additional to .gitignore
, if you want to disable .gitignore
checking and completely manage the ignore rules yourself, also set --ignore-gitignore=0
.
If you want to use your own license, there are two options.
Option 1: Use the -l
flag to pass the license as a string (which can also include macros, as detailed in the Default section):
pyaddlicense -o 'Example Company' -l '{{ .HOLDER }} {{ .YEAR }}. Absolutely no rights reserved and no warranty given.'
Option 2: Use the -f
flag to pass the license as a file (which can also include macros, as detailed in the Default section):
pyaddlicense -o 'Example Company' -f ~/licenses/norightsreserved.tpl
You can disable console output via the -s
(or --silent
) flag. This is useful for integrating pyaddlicense
into a linting/CI pipeline without warping the logs too much:
pyaddlicense -o 'Example Company' -c -s
(When running in check mode
(detailed above), pyaddlicense
will have a non-zero exit code if files are found that need changes)
NOTE: Local development requires poetry
to be installed.
Clone this repo:
git clone https://github.com/kixa/pyaddlicense
Install our dependencies:
poetry install
Run the tests via:
poetry run pytest
Lint any changes with:
poetry run black src/ tests/ && poetry run flake8 src/ tests/ && poetry run isort src/ tests/