README

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.

Installation

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

Usage

adr-init

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.

adr-new

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

adr-list

See above, lists the adrs.

Serving 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/

Source, contribution

The source code is available on bitbucket. If you're interested in collaborating let me know, and/or send a merge request.

Thanks

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.