Metadata-Version: 2.1
Name: soak
Version: 21
Summary: Process aridity templates en masse, like Helm but much more DRY
Home-page: https://github.com/combatopera/soak
Author: Andrzej Cichocki
License: UNKNOWN
Platform: UNKNOWN
Description-Content-Type: text/markdown
License-File: COPYING
Requires-Dist: aridity (>=62)
Requires-Dist: diapyr (>=22)
Requires-Dist: lagoon (>=24)
Requires-Dist: PyYAML (>=5.2)

# soak
Process aridity templates en masse, like Helm but much more DRY

## Advantages
* Single sourcing of config i.e. DRY
* No need for all of your team to know Helm's many conventions
* Terraform native customisation is limited and verbose, and the override mechanism is another convention
* Multiple instances of your microservice without hacks
* Extensible via Python code

## Install
These are generic installation instructions.

### To use, permanently
The quickest way to get started is to install the current release from PyPI:
```
pip3 install --user soak
```

### To use, temporarily
If you prefer to keep .local clean, install to a virtualenv:
```
python3 -m venv venvname
venvname/bin/pip install soak
. venvname/bin/activate
```

### To develop
First clone the repo using HTTP or SSH:
```
git clone https://github.com/combatopera/soak.git
git clone git@github.com:combatopera/soak.git
```
Now use pyven's pipify to create a setup.py, which pip can then use to install the project editably:
```
python3 -m venv pyvenvenv
pyvenvenv/bin/pip install pyven
pyvenvenv/bin/pipify soak

python3 -m venv venvname
venvname/bin/pip install -e soak
. venvname/bin/activate
```

## Commands

### soak
Process aridity templates as per all soak.arid configs in directory tree.


