diadem 1.0.1

What is POP?

This project is built with pop, a Python-based implementation of Plugin Oriented Programming (POP). POP seeks to bring together concepts and wisdom from the history of computing in new ways to solve modern computing problems.

For more information:

• Intro to Plugin Oriented Programming (POP)

• pop-awesome

• pop-create

Prerequisites

• Python 3.10+

• git (if installing from source, or contributing to the project)

Installation

If wanting to use diadem, you can do so by either installing from PyPI or from source.

pip install diadem

pip install diadem[visualize]

# clone repo
git clone git@gitlab.com:Akm0d/diadem.git
cd diadem

# Setup venv
python3 -m virtualenv .venv
source .venv/bin/activate
pip install -e .

Examples

Enumerate cloud resources with idem describe:

idem describe "aws.*" > aws.sls
idem describe "gitlab.*" > gitlab.sls

Create argbind relationships between resources only:

idem compile aws.sls gitlab.sls --match-strategy=pass

Parametrize sls files by creating arg-bind relationships and abstract similarities between resources into params:

idem compile aws.sls gitlab.sls

Parametrize sls files by creating arg-bind relationships, abstract similarities between resources into params, and organize the output into logical groups in a file tree:

idem compile aws.sls gitlab.sls --tree=/srv/idem

Visualize relationships between resources using matplotlib:

idem view /srv/idem/state --params /srv/idem/param

Run idem state on the newly crafted sls/param trees:

idem state /srv/idem/state --params /srv/idem/param

Identify orphan resources and craft absent states for them:

idem view /srv/idem/state  --params /srv/idem/param > orphans.sls

Show a graph of relationships between resources (requires having installed diadem with the “visualize” extras):

idem view /srv/idem/state --params /srv/idem/param --show