# belal-i/lampsible architecture

> Architecture diagram of the GitHub repository belal-i/lampsible, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/belal-i/lampsible
- Repository: https://github.com/belal-i/lampsible

## Overview

Lampsible is a Python CLI and library for configuring LAMP deployments with Ansible. The main workflow accepts a target and action, validates and fills deployment options, then runs Ansible against the target. The project tree and README show broad deployment capabilities, including CMS/framework installs, standalone stack components, Apache customization, and SSL options. Playbook and role internals were not sampled, so their detailed execution links are omitted; the graph shows only documented or excerpt-supported relationships.

Main entry points: [`src/lampsible/project`](https://github.com/belal-i/lampsible/tree/dev/v2/src/lampsible/project) (Ansible playbooks), [`src/lampsible/lampsible.py`](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/lampsible.py) (Python library API), [`src/lampsible/cli.py`](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/cli.py) (CLI arguments), [`src/lampsible/arg_validator.py`](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/arg_validator.py) (Argument validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_cli["CLI arguments<br/>[cli.py]"]
  node_validator["Argument validation<br/>[arg_validator.py]"]
end

subgraph group_orchestration["Deployment orchestration"]
  node_library["Python library API<br/>[lampsible.py]"]
  node_helpers["Host utilities<br/>[helpers.py]"]
  node_constants["Actions and defaults<br/>[constants.py]"]
  node_runner["Ansible Runner"]
end

subgraph group_playbooks["Ansible project"]
  node_project["Ansible playbooks"]
  node_requirements["Galaxy requirements"]
end

subgraph group_capabilities["Deployment capabilities"]
  node_stack["LAMP components<br/>[lamp-stack.yml]"]
  node_apache["Apache setup<br/>[apache.yml]"]
  node_mysql["MySQL setup<br/>[mysql.yml]"]
  node_php["PHP setup<br/>[php.yml]"]
  node_cms["CMS playbooks<br/>[wordpress.yml]"]
  node_joomla["Joomla playbook<br/>[joomla.yml]"]
  node_drupal["Drupal playbook<br/>[drupal.yml]"]
  node_typo3["TYPO3 playbook<br/>[typo3.yml]"]
  node_laravel["Laravel playbook<br/>[laravel.yml]"]
  node_suitecrm["SuiteCRM playbook<br/>[suitecrm.yml]"]
  node_roles["Ansible roles"]
  node_ssl["SSL certificates<br/>[main.yml]"]
  node_apache_custom["Apache configuration<br/>[main.yml]"]
end

node_user(("CLI user"))

node_user -->|"provides options"| node_cli
node_cli -->|"validates arguments"| node_validator
node_cli -->|"constructs and runs"| node_library
node_validator -->|"uses host checks"| node_helpers
node_validator -->|"uses defaults"| node_constants
node_library -->|"uses host utilities"| node_helpers
node_library -->|"uses deployment defaults"| node_constants
node_library -->|"runs deployment"| node_runner
node_library -.->|"configures playbook"| node_project
node_library -->|"installs dependencies"| node_requirements
node_project -.->|"includes deployment actions"| node_stack
node_project -.->|"includes deployment actions"| node_apache
node_project -.->|"includes deployment actions"| node_mysql
node_project -.->|"includes deployment actions"| node_php
node_project -.->|"includes app installs"| node_cms
node_project -.->|"includes app installs"| node_joomla
node_project -.->|"includes app installs"| node_drupal
node_project -.->|"includes app installs"| node_typo3
node_project -.->|"includes app installs"| node_laravel
node_project -.->|"includes app installs"| node_suitecrm
node_project -.->|"uses roles"| node_roles
node_user -.->|"can request SSL"| node_ssl
node_user -.->|"can customize Apache"| node_apache_custom

click node_cli "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/cli.py"
click node_validator "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/arg_validator.py"
click node_library "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/lampsible.py"
click node_helpers "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/helpers.py"
click node_constants "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/constants.py"
click node_project "https://github.com/belal-i/lampsible/tree/dev/v2/src/lampsible/project"
click node_requirements "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/ansible-galaxy-requirements.yml"
click node_stack "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/lamp-stack.yml"
click node_apache "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/apache.yml"
click node_mysql "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/mysql.yml"
click node_php "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/php.yml"
click node_cms "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/wordpress.yml"
click node_joomla "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/joomla.yml"
click node_drupal "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/drupal.yml"
click node_typo3 "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/typo3.yml"
click node_laravel "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/laravel.yml"
click node_suitecrm "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/suitecrm.yml"
click node_roles "https://github.com/belal-i/lampsible/tree/dev/v2/src/lampsible/project/roles"
click node_ssl "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/roles/ssl-certbot/tasks/main.yml"
click node_apache_custom "https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/roles/apache-conf/tasks/main.yml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_validator,node_user toneBlue
class node_library,node_helpers,node_constants,node_runner toneAmber
class node_project,node_requirements toneMint
class node_stack,node_apache,node_mysql,node_php,node_cms,node_joomla,node_drupal,node_typo3,node_laravel,node_suitecrm,node_roles,node_ssl,node_apache_custom toneRose
```

## Components

### User interface

- [CLI arguments](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/cli.py): `src/lampsible/cli.py`
- [Argument validation](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/arg_validator.py): `src/lampsible/arg_validator.py`

### Deployment orchestration

- [Python library API](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/lampsible.py): `src/lampsible/lampsible.py`
- [Host utilities](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/helpers.py): `src/lampsible/helpers.py`
- [Actions and defaults](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/constants.py): `src/lampsible/constants.py`
- **Ansible Runner**

### Ansible project

- [Ansible playbooks](https://github.com/belal-i/lampsible/tree/dev/v2/src/lampsible/project): `src/lampsible/project`
- [Galaxy requirements](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/ansible-galaxy-requirements.yml): `src/lampsible/project/ansible-galaxy-requirements.yml`

### Deployment capabilities

- [LAMP components](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/lamp-stack.yml): `src/lampsible/project/lamp-stack.yml`
- [Apache setup](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/apache.yml): `src/lampsible/project/apache.yml`
- [MySQL setup](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/mysql.yml): `src/lampsible/project/mysql.yml`
- [PHP setup](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/php.yml): `src/lampsible/project/php.yml`
- [CMS playbooks](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/wordpress.yml): `src/lampsible/project/wordpress.yml`
- [Joomla playbook](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/joomla.yml): `src/lampsible/project/joomla.yml`
- [Drupal playbook](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/drupal.yml): `src/lampsible/project/drupal.yml`
- [TYPO3 playbook](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/typo3.yml): `src/lampsible/project/typo3.yml`
- [Laravel playbook](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/laravel.yml): `src/lampsible/project/laravel.yml`
- [SuiteCRM playbook](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/suitecrm.yml): `src/lampsible/project/suitecrm.yml`
- [Ansible roles](https://github.com/belal-i/lampsible/tree/dev/v2/src/lampsible/project/roles): `src/lampsible/project/roles`
- [SSL certificates](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/roles/ssl-certbot/tasks/main.yml): `src/lampsible/project/roles/ssl-certbot/tasks/main.yml`
- [Apache configuration](https://github.com/belal-i/lampsible/blob/dev/v2/src/lampsible/project/roles/apache-conf/tasks/main.yml): `src/lampsible/project/roles/apache-conf/tasks/main.yml`

### Other components

- **CLI user**

## Connections

- CLI user → CLI arguments: provides options (evidence: `README.md`)
- CLI arguments → Argument validation: validates arguments (evidence: `src/lampsible/cli.py`)
- CLI arguments → Python library API: constructs and runs (evidence: `src/lampsible/cli.py`)
- Argument validation → Host utilities: uses host checks (evidence: `src/lampsible/arg_validator.py`)
- Argument validation → Actions and defaults: uses defaults (evidence: `src/lampsible/arg_validator.py`)
- Python library API → Host utilities: uses host utilities (evidence: `src/lampsible/lampsible.py`)
- Python library API → Actions and defaults: uses deployment defaults (evidence: `src/lampsible/lampsible.py`)
- Python library API → Ansible Runner: runs deployment (evidence: `src/lampsible/lampsible.py`)
- Python library API → Ansible playbooks: configures playbook
- Python library API → Galaxy requirements: installs dependencies (evidence: `src/lampsible/lampsible.py`)
- Ansible playbooks → LAMP components: includes deployment actions
- Ansible playbooks → Apache setup: includes deployment actions
- Ansible playbooks → MySQL setup: includes deployment actions
- Ansible playbooks → PHP setup: includes deployment actions
- Ansible playbooks → CMS playbooks: includes app installs
- Ansible playbooks → Joomla playbook: includes app installs
- Ansible playbooks → Drupal playbook: includes app installs
- Ansible playbooks → TYPO3 playbook: includes app installs
- Ansible playbooks → Laravel playbook: includes app installs
- Ansible playbooks → SuiteCRM playbook: includes app installs
- Ansible playbooks → Ansible roles: uses roles
- CLI user → SSL certificates: can request SSL
- CLI user → Apache configuration: can customize Apache
