This is a project to get a python equivalent of the adr-tools by npryce on github. The tool can make and list and change Architecture Decision Records. For more information on Architecture Decision Records see the page of Joel Parker Henderson on ADRs.
pip install adr-tools-python
or
python3 -m pip install adr-tools-python --user
By adding a --upgrade flag, the tool can be updated if a new version is available
With adr-init, the directory structure can be initialized. Default, a subdircectory doc/adr is generated, but if a different directory is wished for, this can be input:
adr-init foo
In this case, adrs will be stored in a local folder foo/. In the main directory, a file called .adr-dir is generated to indicate to adr-tools that a different location than the default doc/adr/ is used. This behaviour was copied from, and should be compatible with the original adr-tools. adr-init always creates a new adr to say that adrs will be used.
A subject should be given for a new adr:
> adr-new create equal animals
> adr-list
doc/adr/0001-record-architecture-decisions.md
doc/adr/0002-create-equal-animals.md
>
ADRs can be superceded from the command line using the -s option, and be linked by using the -l option.
From the documentation of adr-tools:
Multiple -s and -l options can be given, so that the new ADR can supercede
or link to multiple existing ADRs.
E.g. to create a new ADR with the title "Use MySQL Database":
adr new Use MySQL Database
E.g. to create a new ADR that supercedes ADR 12:
adr new -s 12 Use PostgreSQL Database
E.g. to create a new ADR that supercedes ADRs 3 and 4, and amends ADR 5:
adr new -s 3 -s 4 -l "5:Amends:Amended by" Use Riak CRDTs to cope with scale
The same funcitonality is also available in this python version
See above, lists the adrs.
If you want the ADRs to be served on a webpage, please look for the python package [adr-viewer](https://pypi.org/project/adr-viewer/
The source code is available on bitbucket. If you're interested in collaborating let me know, and/or send a merge request.
Thanks to Michael Nygard for the original idea of ADRs, WesleyKS for his work on adre (which was inspiring, but not the road I followed), and of course to Npryce for making and documenting the bash toolchain I tried to replicate in Python.
FAQs
A package to provide adr-tools to python
We found that adr-tools-python demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.