rcmt (short for Repository Configuration Management Tool) helps aligning configuration files across many repositories. It creates, modifies or deletes files in multiple repositories, then creates a Pull Request that contains the changes for each repository.
Let's say you want to make flake8 compatible with black. To accomplish this, the file .flake8 can be placed into every repository.
The content of the file .flake8 looks like this:
[flake8]
max-line-length = 88
extend-ignore = E203Having to place this file in every repository, commit the change, create a pull request, wait for a build job to succeed and then merge the pull request is no fun. This is where rcmt can help.
rcmt needs configuration that tells it what to do and to which repositories it should apply changes. This is done via a Run. A Run is written in Python and stored in a file typically named run.py.
python
Everything is ready. Run rcmt:
rcmt run ./run.pyrcmt will find all matching repositories, check them out locally, apply the package and create a Pull Request for each repository.
installation package action run sources configuration encoding customization faq