proper bootstrap script
This commit is contained in:
949
ctrl/init.py
Normal file
949
ctrl/init.py
Normal file
@@ -0,0 +1,949 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
spr init - Room scaffolding wizard
|
||||
|
||||
Creates a new soleprint room in cfg/<room>/ with layered, interactive setup.
|
||||
Each layer is optional beyond Layer 0 (config + data).
|
||||
|
||||
Usage:
|
||||
python ctrl/init.py myroom # Interactive wizard
|
||||
python ctrl/init.py myroom --from sample # Clone existing room as variant
|
||||
"""
|
||||
|
||||
import argparse
|
||||
import json
|
||||
import shutil
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
SPR_ROOT = Path(__file__).resolve().parent.parent
|
||||
CFG_DIR = SPR_ROOT / "cfg"
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Helpers
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
def ask(prompt: str, default: str = "") -> str:
|
||||
"""Prompt user for input with optional default."""
|
||||
try:
|
||||
if default:
|
||||
val = input(f"{prompt} [{default}]: ").strip()
|
||||
return val or default
|
||||
return input(f"{prompt}: ").strip()
|
||||
except EOFError:
|
||||
if default:
|
||||
return default
|
||||
return ""
|
||||
|
||||
|
||||
def ask_yn(prompt: str, default: bool = True) -> bool:
|
||||
"""Yes/no prompt."""
|
||||
suffix = "[Y/n]" if default else "[y/N]"
|
||||
try:
|
||||
val = input(f"{prompt} {suffix}: ").strip().lower()
|
||||
except EOFError:
|
||||
return default
|
||||
if not val:
|
||||
return default
|
||||
return val in ("y", "yes")
|
||||
|
||||
|
||||
def ask_choice(prompt: str, choices: list[str], default: str = "") -> str:
|
||||
"""Prompt with constrained choices."""
|
||||
choices_str = "/".join(choices)
|
||||
try:
|
||||
if default:
|
||||
val = input(f"{prompt} [{choices_str}] ({default}): ").strip().lower()
|
||||
return val if val in choices else default
|
||||
while True:
|
||||
val = input(f"{prompt} [{choices_str}]: ").strip().lower()
|
||||
if val in choices:
|
||||
return val
|
||||
print(f" Choose one of: {choices_str}")
|
||||
except EOFError:
|
||||
if default:
|
||||
return default
|
||||
return choices[0]
|
||||
|
||||
|
||||
def write_file(path: Path, content: str):
|
||||
"""Write file, creating parent dirs."""
|
||||
path.parent.mkdir(parents=True, exist_ok=True)
|
||||
path.write_text(content)
|
||||
print(f" + {path.relative_to(SPR_ROOT)}")
|
||||
|
||||
|
||||
def next_free_port() -> int:
|
||||
"""Scan existing rooms to find next free hub port."""
|
||||
used = set()
|
||||
for cfg in CFG_DIR.iterdir():
|
||||
config_path = cfg / "config.json"
|
||||
if config_path.exists():
|
||||
try:
|
||||
data = json.loads(config_path.read_text())
|
||||
port = data.get("framework", {}).get("hub_port")
|
||||
if port:
|
||||
used.add(int(port))
|
||||
except (json.JSONDecodeError, ValueError):
|
||||
pass
|
||||
port = 12000
|
||||
while port in used:
|
||||
port += 10
|
||||
return port
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Templates
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
SYSTEMS = [
|
||||
{"key": "data_flow", "name": "artery", "slug": "artery", "title": "Artery", "tagline": "Todo lo vital", "icon": ""},
|
||||
{"key": "documentation", "name": "atlas", "slug": "atlas", "title": "Atlas", "tagline": "Documentacion accionable", "icon": ""},
|
||||
{"key": "execution", "name": "station", "slug": "station", "title": "Station", "tagline": "Monitores, Entornos y Herramientas", "icon": ""},
|
||||
]
|
||||
|
||||
COMPONENTS = {
|
||||
"shared": {
|
||||
"config": {"name": "room", "title": "Room", "description": "Runtime environment configuration", "plural": "rooms"},
|
||||
"data": {"name": "depot", "title": "Depot", "description": "Data storage / provisions", "plural": "depots"},
|
||||
},
|
||||
"data_flow": {
|
||||
"connector": {"name": "vein", "title": "Vein", "description": "Stateless API connector", "plural": "veins"},
|
||||
"mock": {"name": "shunt", "title": "Shunt", "description": "Fake connector for testing", "plural": "shunts"},
|
||||
"composed": {"name": "pulse", "title": "Pulse", "description": "Composed data flow", "plural": "pulses", "formula": "Vein + Room + Depot"},
|
||||
"app": {"name": "plexus", "title": "Plexus", "description": "Full app with backend, frontend and DB", "plural": "plexus"},
|
||||
},
|
||||
"documentation": {
|
||||
"pattern": {"name": "template", "title": "Template", "description": "Documentation pattern", "plural": "templates"},
|
||||
"library": {"name": "book", "title": "Book", "description": "Documentation library"},
|
||||
"composed": {"name": "book", "title": "Book", "description": "Composed documentation", "plural": "books", "formula": "Template + Depot"},
|
||||
},
|
||||
"execution": {
|
||||
"utility": {"name": "tool", "title": "Tool", "description": "Execution utility", "plural": "tools"},
|
||||
"watcher": {"name": "monitor", "title": "Monitor", "description": "Service monitor", "plural": "monitors"},
|
||||
"container": {"name": "cabinet", "title": "Cabinet", "description": "Tool container", "plural": "cabinets"},
|
||||
"workspace": {"name": "desk", "title": "Desk", "description": "Execution workspace"},
|
||||
"composed": {"name": "desk", "title": "Desk", "description": "Composed execution bundle", "plural": "desks", "formula": "Cabinet + Room + Depots"},
|
||||
},
|
||||
}
|
||||
|
||||
DATA_FILES = [
|
||||
"books", "depots", "desks", "monitors", "plexuses",
|
||||
"pulses", "rooms", "shunts", "tables", "templates", "tools", "veins",
|
||||
]
|
||||
|
||||
|
||||
def make_config(room: str, port: int, managed: dict | None = None) -> dict:
|
||||
cfg = {
|
||||
"framework": {
|
||||
"name": "soleprint",
|
||||
"slug": "soleprint",
|
||||
"version": "0.1.0",
|
||||
"description": "Development workflow and documentation system",
|
||||
"tagline": "Mapping development footprints",
|
||||
"icon": "",
|
||||
"hub_port": port,
|
||||
},
|
||||
"systems": SYSTEMS,
|
||||
"components": COMPONENTS,
|
||||
}
|
||||
if managed:
|
||||
cfg["managed"] = managed
|
||||
return cfg
|
||||
|
||||
|
||||
def soleprint_compose() -> str:
|
||||
return """\
|
||||
# Soleprint Services - Docker Compose
|
||||
#
|
||||
# Usage:
|
||||
# cd gen/<room>/soleprint && docker compose up -d
|
||||
|
||||
name: ${DEPLOYMENT_NAME}
|
||||
|
||||
services:
|
||||
soleprint:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile
|
||||
container_name: ${DEPLOYMENT_NAME}
|
||||
user: "${UID:-1000}:${GID:-1000}"
|
||||
volumes:
|
||||
- .:/app
|
||||
ports:
|
||||
- "${SOLEPRINT_PORT}:8000"
|
||||
env_file:
|
||||
- .env
|
||||
environment:
|
||||
- ARTERY_EXTERNAL_URL=/artery
|
||||
- ATLAS_EXTERNAL_URL=/atlas
|
||||
- STATION_EXTERNAL_URL=/station
|
||||
networks:
|
||||
- default
|
||||
command: uvicorn run:app --host 0.0.0.0 --port 8000 --reload
|
||||
|
||||
networks:
|
||||
default:
|
||||
external: true
|
||||
name: ${NETWORK_NAME}
|
||||
"""
|
||||
|
||||
|
||||
def soleprint_env(room: str, port: int) -> str:
|
||||
return f"""\
|
||||
# =============================================================================
|
||||
# {room} — Soleprint Configuration
|
||||
# =============================================================================
|
||||
|
||||
DEPLOYMENT_NAME={room}_spr
|
||||
NETWORK_NAME={room}_network
|
||||
SOLEPRINT_PORT={port}
|
||||
|
||||
# Google OAuth (configure if using Google vein)
|
||||
# GOOGLE_CLIENT_ID=
|
||||
# GOOGLE_CLIENT_SECRET=
|
||||
# GOOGLE_REDIRECT_URI=http://{room}.spr.local.ar/artery/google/oauth/callback
|
||||
|
||||
AUTH_BYPASS=true
|
||||
AUTH_SESSION_SECRET={room}-dev-secret-change-in-production
|
||||
"""
|
||||
|
||||
|
||||
def managed_compose(room: str, app_name: str, has_frontend: bool) -> str:
|
||||
services = f"""\
|
||||
# {room} — Managed App Services
|
||||
|
||||
name: {room}_app
|
||||
|
||||
services:
|
||||
backend:
|
||||
build:
|
||||
context: ./{app_name}/backend
|
||||
dockerfile: ../../Dockerfile.backend
|
||||
container_name: {room}_backend
|
||||
env_file:
|
||||
- .env
|
||||
ports:
|
||||
- "${{BACKEND_PORT}}:8000"
|
||||
networks:
|
||||
- default
|
||||
"""
|
||||
if has_frontend:
|
||||
services += f"""
|
||||
frontend:
|
||||
build:
|
||||
context: ./{app_name}/frontend
|
||||
dockerfile: ../../Dockerfile.frontend
|
||||
container_name: {room}_frontend
|
||||
env_file:
|
||||
- .env
|
||||
ports:
|
||||
- "${{FRONTEND_PORT}}:3000"
|
||||
networks:
|
||||
- default
|
||||
"""
|
||||
services += f"""
|
||||
networks:
|
||||
default:
|
||||
external: true
|
||||
name: {room}_network
|
||||
"""
|
||||
return services
|
||||
|
||||
|
||||
DOCKERFILE_BACKEND = {
|
||||
"django": """\
|
||||
FROM python:3.12-slim
|
||||
WORKDIR /app
|
||||
COPY requirements.txt .
|
||||
RUN pip install --no-cache-dir -r requirements.txt
|
||||
COPY . .
|
||||
EXPOSE 8000
|
||||
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]
|
||||
""",
|
||||
"fastapi": """\
|
||||
FROM python:3.12-slim
|
||||
WORKDIR /app
|
||||
COPY requirements.txt .
|
||||
RUN pip install --no-cache-dir -r requirements.txt
|
||||
COPY . .
|
||||
EXPOSE 8000
|
||||
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]
|
||||
""",
|
||||
"express": """\
|
||||
FROM node:20-slim
|
||||
WORKDIR /app
|
||||
COPY package*.json ./
|
||||
RUN npm ci
|
||||
COPY . .
|
||||
EXPOSE 8000
|
||||
CMD ["node", "index.js"]
|
||||
""",
|
||||
"other": """\
|
||||
# Customize this Dockerfile for your backend framework
|
||||
FROM python:3.12-slim
|
||||
WORKDIR /app
|
||||
COPY . .
|
||||
EXPOSE 8000
|
||||
CMD ["echo", "Configure your start command"]
|
||||
""",
|
||||
}
|
||||
|
||||
DOCKERFILE_FRONTEND = {
|
||||
"nextjs": """\
|
||||
FROM node:20-slim
|
||||
WORKDIR /app
|
||||
COPY package*.json ./
|
||||
RUN npm ci
|
||||
COPY . .
|
||||
EXPOSE 3000
|
||||
CMD ["npm", "run", "dev"]
|
||||
""",
|
||||
"react": """\
|
||||
FROM node:20-slim
|
||||
WORKDIR /app
|
||||
COPY package*.json ./
|
||||
RUN npm ci
|
||||
COPY . .
|
||||
EXPOSE 3000
|
||||
CMD ["npm", "start"]
|
||||
""",
|
||||
"vue": """\
|
||||
FROM node:20-slim
|
||||
WORKDIR /app
|
||||
COPY package*.json ./
|
||||
RUN npm ci
|
||||
COPY . .
|
||||
EXPOSE 3000
|
||||
CMD ["npm", "run", "dev"]
|
||||
""",
|
||||
"other": """\
|
||||
# Customize this Dockerfile for your frontend framework
|
||||
FROM node:20-slim
|
||||
WORKDIR /app
|
||||
COPY . .
|
||||
EXPOSE 3000
|
||||
CMD ["echo", "Configure your start command"]
|
||||
""",
|
||||
}
|
||||
|
||||
|
||||
def managed_env(room: str, backend_port: int, frontend_port: int | None) -> str:
|
||||
lines = f"""\
|
||||
# =============================================================================
|
||||
# {room} — Managed App Configuration
|
||||
# =============================================================================
|
||||
|
||||
BACKEND_PORT={backend_port}
|
||||
"""
|
||||
if frontend_port:
|
||||
lines += f"FRONTEND_PORT={frontend_port}\n"
|
||||
lines += f"""
|
||||
# Database
|
||||
DB_HOST={room}_db
|
||||
DB_PORT=5432
|
||||
DB_NAME={room}
|
||||
DB_USER=postgres
|
||||
DB_PASSWORD=localdev123
|
||||
"""
|
||||
return lines
|
||||
|
||||
|
||||
def link_main() -> str:
|
||||
return """\
|
||||
\"\"\"
|
||||
Link — Database bridge for soleprint tools.
|
||||
|
||||
Provides read access to the managed app's database so soleprint tools
|
||||
(databrowse, datagen, tester) can inspect and manipulate data without
|
||||
touching the app's source code.
|
||||
\"\"\"
|
||||
|
||||
from fastapi import FastAPI
|
||||
|
||||
app = FastAPI(title="Link - DB Bridge")
|
||||
|
||||
|
||||
@app.get("/health")
|
||||
def health():
|
||||
return {"status": "ok"}
|
||||
|
||||
|
||||
# Import adapters here:
|
||||
# from adapters.django import router as django_router
|
||||
# app.include_router(django_router, prefix="/django")
|
||||
"""
|
||||
|
||||
|
||||
def link_adapter_django() -> str:
|
||||
return """\
|
||||
\"\"\"
|
||||
Django adapter — reads Django ORM metadata to provide schema + data access.
|
||||
\"\"\"
|
||||
|
||||
# from fastapi import APIRouter
|
||||
# router = APIRouter()
|
||||
|
||||
# TODO: Implement adapter for your Django models
|
||||
# See cfg/amar/link/adapters/django.py for a working example
|
||||
"""
|
||||
|
||||
|
||||
def link_adapter_fastapi() -> str:
|
||||
return """\
|
||||
\"\"\"
|
||||
FastAPI/SQLAlchemy adapter — reads SQLAlchemy metadata for schema + data access.
|
||||
\"\"\"
|
||||
|
||||
# from fastapi import APIRouter
|
||||
# router = APIRouter()
|
||||
|
||||
# TODO: Implement adapter for your SQLAlchemy models
|
||||
"""
|
||||
|
||||
|
||||
def link_requirements() -> str:
|
||||
return """\
|
||||
fastapi>=0.100.0
|
||||
uvicorn>=0.23.0
|
||||
psycopg2-binary>=2.9.0
|
||||
sqlalchemy>=2.0.0
|
||||
"""
|
||||
|
||||
|
||||
def link_dockerfile() -> str:
|
||||
return """\
|
||||
FROM python:3.12-slim
|
||||
WORKDIR /app
|
||||
COPY requirements.txt .
|
||||
RUN pip install --no-cache-dir -r requirements.txt
|
||||
COPY . .
|
||||
EXPOSE 8000
|
||||
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]
|
||||
"""
|
||||
|
||||
|
||||
def link_compose(room: str) -> str:
|
||||
return f"""\
|
||||
# Link — DB Bridge
|
||||
name: {room}_link
|
||||
|
||||
services:
|
||||
link:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile
|
||||
container_name: {room}_link
|
||||
env_file:
|
||||
- ../soleprint/.env
|
||||
ports:
|
||||
- "${{LINK_PORT:-8001}}:8000"
|
||||
networks:
|
||||
- default
|
||||
|
||||
networks:
|
||||
default:
|
||||
external: true
|
||||
name: {room}_network
|
||||
"""
|
||||
|
||||
|
||||
def ctrl_start(room: str, app_name: str | None) -> str:
|
||||
lines = f"""\
|
||||
#!/bin/bash
|
||||
# Start all {room} services
|
||||
# Usage: ./ctrl/start.sh [-d]
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${{BASH_SOURCE[0]}}")" && pwd)"
|
||||
ROOT_DIR="$(dirname "$SCRIPT_DIR")"
|
||||
|
||||
DETACH=""
|
||||
if [[ "$1" == "-d" ]]; then
|
||||
DETACH="-d"
|
||||
fi
|
||||
|
||||
echo "=== Starting {room} services ==="
|
||||
|
||||
# Start soleprint
|
||||
echo "Starting soleprint..."
|
||||
cd "$ROOT_DIR/soleprint"
|
||||
docker compose up $DETACH &
|
||||
"""
|
||||
if app_name:
|
||||
lines += f"""
|
||||
# Start managed app
|
||||
if [[ -f "$ROOT_DIR/{app_name}/docker-compose.yml" ]]; then
|
||||
echo "Starting {app_name}..."
|
||||
cd "$ROOT_DIR/{app_name}"
|
||||
docker compose up $DETACH &
|
||||
fi
|
||||
"""
|
||||
lines += """
|
||||
wait
|
||||
echo "=== All services started ==="
|
||||
"""
|
||||
return lines
|
||||
|
||||
|
||||
def ctrl_stop(room: str, app_name: str | None) -> str:
|
||||
lines = f"""\
|
||||
#!/bin/bash
|
||||
# Stop all {room} services
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${{BASH_SOURCE[0]}}")" && pwd)"
|
||||
ROOT_DIR="$(dirname "$SCRIPT_DIR")"
|
||||
|
||||
echo "=== Stopping {room} services ==="
|
||||
|
||||
cd "$ROOT_DIR/soleprint"
|
||||
docker compose down
|
||||
"""
|
||||
if app_name:
|
||||
lines += f"""
|
||||
if [[ -f "$ROOT_DIR/{app_name}/docker-compose.yml" ]]; then
|
||||
cd "$ROOT_DIR/{app_name}"
|
||||
docker compose down
|
||||
fi
|
||||
"""
|
||||
lines += f"""
|
||||
echo "=== All {room} services stopped ==="
|
||||
"""
|
||||
return lines
|
||||
|
||||
|
||||
def ctrl_status(room: str) -> str:
|
||||
return f"""\
|
||||
#!/bin/bash
|
||||
# Show status of {room} services
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${{BASH_SOURCE[0]}}")" && pwd)"
|
||||
ROOT_DIR="$(dirname "$SCRIPT_DIR")"
|
||||
|
||||
echo "=== {room} service status ==="
|
||||
cd "$ROOT_DIR"
|
||||
for d in */; do
|
||||
if [[ -f "$d/docker-compose.yml" ]]; then
|
||||
echo ""
|
||||
echo "--- $d ---"
|
||||
cd "$ROOT_DIR/$d"
|
||||
docker compose ps
|
||||
fi
|
||||
done
|
||||
"""
|
||||
|
||||
|
||||
def ctrl_logs(room: str) -> str:
|
||||
return f"""\
|
||||
#!/bin/bash
|
||||
# Show logs for {room} services
|
||||
# Usage: ./ctrl/logs.sh [service_name]
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${{BASH_SOURCE[0]}}")" && pwd)"
|
||||
ROOT_DIR="$(dirname "$SCRIPT_DIR")"
|
||||
|
||||
cd "$ROOT_DIR/soleprint"
|
||||
if [[ -n "$1" ]]; then
|
||||
docker compose logs -f "$1"
|
||||
else
|
||||
docker compose logs -f
|
||||
fi
|
||||
"""
|
||||
|
||||
|
||||
def tester_environments(url: str) -> str:
|
||||
return json.dumps({
|
||||
"environments": [
|
||||
{
|
||||
"name": "local",
|
||||
"url": url,
|
||||
"auth_type": "none",
|
||||
}
|
||||
]
|
||||
}, indent=2) + "\n"
|
||||
|
||||
|
||||
def tester_base() -> str:
|
||||
return """\
|
||||
\"\"\"
|
||||
Room-specific test base class.
|
||||
|
||||
Import from core tester and extend as needed.
|
||||
\"\"\"
|
||||
|
||||
from station.tools.tester.base import ContractTestCase # noqa: F401
|
||||
"""
|
||||
|
||||
|
||||
def nginx_conf(room: str, app_name: str) -> str:
|
||||
return f"""\
|
||||
# {room} — Nginx Config for Docker
|
||||
#
|
||||
# Routes:
|
||||
# {room}.spr.local.ar — frontend with soleprint sidebar
|
||||
# {room}.local.ar — frontend without sidebar
|
||||
|
||||
# {room}.spr.local.ar - frontend with soleprint sidebar
|
||||
server {{
|
||||
listen 80;
|
||||
server_name {room}.spr.local.ar;
|
||||
|
||||
# Soleprint routes
|
||||
location /spr/ {{
|
||||
proxy_pass http://soleprint:8000/;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}}
|
||||
|
||||
# Backend API
|
||||
location /api/ {{
|
||||
proxy_pass http://backend:8000/api/;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}}
|
||||
|
||||
# Frontend with sidebar injection
|
||||
location / {{
|
||||
proxy_pass http://frontend:3000;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection "upgrade";
|
||||
proxy_set_header Accept-Encoding "";
|
||||
|
||||
# Inject sidebar
|
||||
sub_filter '</head>' '<link rel="stylesheet" href="/spr/sidebar.css"><script src="/spr/sidebar.js" defer></script></head>';
|
||||
sub_filter_once off;
|
||||
sub_filter_types text/html;
|
||||
}}
|
||||
}}
|
||||
|
||||
# {room}.local.ar - frontend without sidebar
|
||||
server {{
|
||||
listen 80;
|
||||
server_name {room}.local.ar;
|
||||
|
||||
location /api/ {{
|
||||
proxy_pass http://backend:8000/api/;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}}
|
||||
|
||||
location / {{
|
||||
proxy_pass http://frontend:3000;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection "upgrade";
|
||||
}}
|
||||
}}
|
||||
"""
|
||||
|
||||
|
||||
def nginx_compose(room: str) -> str:
|
||||
return f"""\
|
||||
# Nginx Reverse Proxy for {room}
|
||||
#
|
||||
# Usage:
|
||||
# docker compose -f docker-compose.yml -f docker-compose.nginx.yml up -d
|
||||
#
|
||||
# Requires /etc/hosts entries:
|
||||
# 127.0.0.1 {room}.spr.local.ar {room}.local.ar
|
||||
|
||||
name: ${{DEPLOYMENT_NAME}}_nginx
|
||||
|
||||
services:
|
||||
nginx:
|
||||
image: nginx:alpine
|
||||
container_name: ${{DEPLOYMENT_NAME}}_nginx
|
||||
ports:
|
||||
- "${{NGINX_PORT:-80}}:80"
|
||||
volumes:
|
||||
- ./nginx/local.conf:/etc/nginx/conf.d/default.conf:ro
|
||||
networks:
|
||||
- default
|
||||
depends_on:
|
||||
- soleprint
|
||||
restart: unless-stopped
|
||||
|
||||
networks:
|
||||
default:
|
||||
name: ${{NETWORK_NAME}}
|
||||
"""
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Layers
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
def layer0_config(room_dir: Path, room: str, port: int, is_managed: bool) -> dict:
|
||||
"""Layer 0: config.json + data/*.json"""
|
||||
print("\n-- Layer 0: Config + Data --")
|
||||
|
||||
managed = None
|
||||
if is_managed:
|
||||
# Managed section filled in layer 2
|
||||
managed = {"name": room}
|
||||
|
||||
config = make_config(room, port, managed)
|
||||
write_file(room_dir / "config.json", json.dumps(config, indent=2) + "\n")
|
||||
|
||||
# Data files — empty items
|
||||
data_dir = room_dir / "data"
|
||||
for name in DATA_FILES:
|
||||
write_file(data_dir / f"{name}.json", json.dumps({"items": []}, indent=2) + "\n")
|
||||
write_file(data_dir / "__init__.py", "")
|
||||
|
||||
return config
|
||||
|
||||
|
||||
def layer1_docker(room_dir: Path, room: str, port: int):
|
||||
"""Layer 1: soleprint docker-compose + .env"""
|
||||
print("\n-- Layer 1: Docker --")
|
||||
|
||||
spr_dir = room_dir / "soleprint"
|
||||
write_file(spr_dir / "docker-compose.yml", soleprint_compose())
|
||||
write_file(spr_dir / ".env", soleprint_env(room, port))
|
||||
|
||||
|
||||
def layer2_managed(room_dir: Path, room: str, config: dict) -> dict:
|
||||
"""Layer 2: Managed app scaffolding. Returns app info."""
|
||||
print("\n-- Layer 2: Managed App --")
|
||||
|
||||
app_name = ask("App name", room)
|
||||
backend_path = ask("Backend repo path")
|
||||
backend_framework = ask_choice(
|
||||
"Backend framework?", ["django", "fastapi", "express", "other"], "django"
|
||||
)
|
||||
frontend_path = ask("Frontend repo path [skip]")
|
||||
has_frontend = bool(frontend_path) and frontend_path.lower() != "skip"
|
||||
|
||||
frontend_framework = None
|
||||
if has_frontend:
|
||||
frontend_framework = ask_choice(
|
||||
"Frontend framework?", ["nextjs", "react", "vue", "other"], "nextjs"
|
||||
)
|
||||
|
||||
# Update config.json with managed section
|
||||
repos = {"backend": backend_path}
|
||||
if has_frontend:
|
||||
repos["frontend"] = frontend_path
|
||||
config["managed"] = {"name": app_name, "repos": repos}
|
||||
write_file(room_dir / "config.json", json.dumps(config, indent=2) + "\n")
|
||||
|
||||
# Docker files
|
||||
write_file(room_dir / "docker-compose.yml", managed_compose(room, app_name, has_frontend))
|
||||
write_file(room_dir / "Dockerfile.backend", DOCKERFILE_BACKEND[backend_framework])
|
||||
if has_frontend:
|
||||
write_file(room_dir / "Dockerfile.frontend", DOCKERFILE_FRONTEND[frontend_framework])
|
||||
|
||||
# .env
|
||||
backend_port = next_free_port() + 100 # offset from soleprint ports
|
||||
frontend_port = backend_port + 10 if has_frontend else None
|
||||
write_file(room_dir / ".env", managed_env(room, backend_port, frontend_port))
|
||||
|
||||
# Dumps dir
|
||||
dumps_dir = room_dir / app_name / "dumps"
|
||||
dumps_dir.mkdir(parents=True, exist_ok=True)
|
||||
(dumps_dir / ".gitkeep").touch()
|
||||
print(f" + {(dumps_dir / '.gitkeep').relative_to(SPR_ROOT)}")
|
||||
|
||||
return {
|
||||
"app_name": app_name,
|
||||
"backend_framework": backend_framework,
|
||||
"has_frontend": has_frontend,
|
||||
"frontend_framework": frontend_framework,
|
||||
}
|
||||
|
||||
|
||||
def layer3_link(room_dir: Path, room: str, backend_framework: str):
|
||||
"""Layer 3: Link (DB bridge) scaffolding."""
|
||||
print("\n-- Layer 3: Link --")
|
||||
|
||||
link_dir = room_dir / "link"
|
||||
write_file(link_dir / "main.py", link_main())
|
||||
write_file(link_dir / "adapters" / "__init__.py", "")
|
||||
write_file(link_dir / "requirements.txt", link_requirements())
|
||||
write_file(link_dir / "Dockerfile", link_dockerfile())
|
||||
write_file(link_dir / "docker-compose.yml", link_compose(room))
|
||||
|
||||
# Framework-specific adapter scaffold
|
||||
if backend_framework == "django":
|
||||
write_file(link_dir / "adapters" / "django.py", link_adapter_django())
|
||||
elif backend_framework in ("fastapi", "other"):
|
||||
write_file(link_dir / "adapters" / "sqlalchemy.py", link_adapter_fastapi())
|
||||
|
||||
|
||||
def layer4_scripts(room_dir: Path, room: str, app_name: str | None):
|
||||
"""Layer 4: ctrl/ scripts."""
|
||||
print("\n-- Layer 4: Scripts --")
|
||||
|
||||
ctrl_dir = room_dir / "ctrl"
|
||||
write_file(ctrl_dir / "start.sh", ctrl_start(room, app_name))
|
||||
write_file(ctrl_dir / "stop.sh", ctrl_stop(room, app_name))
|
||||
write_file(ctrl_dir / "status.sh", ctrl_status(room))
|
||||
write_file(ctrl_dir / "logs.sh", ctrl_logs(room))
|
||||
|
||||
|
||||
def layer5_tester(room_dir: Path, room: str):
|
||||
"""Layer 5: Test suite scaffolding."""
|
||||
print("\n-- Layer 5: Test Suite --")
|
||||
|
||||
url = ask("Test target URL", "http://localhost:8000")
|
||||
tester_dir = room_dir / "soleprint" / "station" / "tools" / "tester"
|
||||
write_file(tester_dir / "environments.json", tester_environments(url))
|
||||
write_file(tester_dir / "tests" / "__init__.py", "")
|
||||
write_file(tester_dir / "tests" / "base.py", tester_base())
|
||||
|
||||
|
||||
def layer6_nginx(room_dir: Path, room: str, app_name: str):
|
||||
"""Layer 6: Nginx sidebar injection."""
|
||||
print("\n-- Layer 6: Nginx --")
|
||||
|
||||
spr_dir = room_dir / "soleprint"
|
||||
write_file(spr_dir / "nginx" / "local.conf", nginx_conf(room, app_name))
|
||||
write_file(spr_dir / "docker-compose.nginx.yml", nginx_compose(room))
|
||||
print(f"\n Add to /etc/hosts: 127.0.0.1 {room}.spr.local.ar {room}.local.ar")
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Clone (--from)
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
def clone_room(source_name: str, target_name: str):
|
||||
"""Clone an existing room as a variant with new ports/names."""
|
||||
source_dir = CFG_DIR / source_name
|
||||
target_dir = CFG_DIR / target_name
|
||||
|
||||
if not source_dir.exists():
|
||||
print(f"Error: source room '{source_name}' not found in cfg/")
|
||||
sys.exit(1)
|
||||
|
||||
if target_dir.exists():
|
||||
print(f"Error: '{target_name}' already exists in cfg/")
|
||||
sys.exit(1)
|
||||
|
||||
print(f"\n=== Cloning {source_name} -> {target_name} ===")
|
||||
|
||||
# Copy the whole tree
|
||||
shutil.copytree(source_dir, target_dir)
|
||||
print(f" Copied cfg/{source_name}/ -> cfg/{target_name}/")
|
||||
|
||||
# Patch config.json
|
||||
config_path = target_dir / "config.json"
|
||||
if config_path.exists():
|
||||
config = json.loads(config_path.read_text())
|
||||
new_port = next_free_port()
|
||||
config["framework"]["hub_port"] = new_port
|
||||
config_path.write_text(json.dumps(config, indent=2) + "\n")
|
||||
print(f" Patched config.json: hub_port={new_port}")
|
||||
|
||||
# Patch all .env files: replace source name with target name
|
||||
for env_file in target_dir.rglob(".env"):
|
||||
content = env_file.read_text()
|
||||
content = content.replace(source_name, target_name)
|
||||
env_file.write_text(content)
|
||||
print(f" Patched {env_file.relative_to(SPR_ROOT)}")
|
||||
|
||||
# Patch nginx configs
|
||||
for nginx_conf_file in target_dir.rglob("*.conf"):
|
||||
content = nginx_conf_file.read_text()
|
||||
content = content.replace(source_name, target_name)
|
||||
nginx_conf_file.write_text(content)
|
||||
print(f" Patched {nginx_conf_file.relative_to(SPR_ROOT)}")
|
||||
|
||||
print(f"\nDone! Review cfg/{target_name}/ and adjust ports/paths as needed.")
|
||||
print(f"Build with: python build.py --cfg {target_name}")
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Main
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
def wizard(room: str):
|
||||
"""Interactive room setup wizard."""
|
||||
room_dir = CFG_DIR / room
|
||||
|
||||
if room_dir.exists():
|
||||
print(f"Error: '{room}' already exists in cfg/")
|
||||
sys.exit(1)
|
||||
|
||||
port = next_free_port()
|
||||
|
||||
print(f"\n=== Soleprint Room Setup: {room} ===")
|
||||
print(f" Target: cfg/{room}/")
|
||||
|
||||
room_type = ask_choice("Room type?", ["standalone", "managed"], "standalone")
|
||||
port = int(ask("Hub port", str(port)))
|
||||
is_managed = room_type == "managed"
|
||||
|
||||
# Layer 0: always
|
||||
config = layer0_config(room_dir, room, port, is_managed)
|
||||
|
||||
# Layer 1: docker
|
||||
if ask_yn("\nContinue to Layer 1 (Docker)?"):
|
||||
layer1_docker(room_dir, room, port)
|
||||
else:
|
||||
print(f"\nDone! Build with: python build.py --cfg {room}")
|
||||
return
|
||||
|
||||
app_info = None
|
||||
|
||||
# Layer 2: managed app (only if managed)
|
||||
if is_managed:
|
||||
if ask_yn("\nContinue to Layer 2 (Managed App)?"):
|
||||
app_info = layer2_managed(room_dir, room, config)
|
||||
else:
|
||||
print(f"\nDone! Build with: python build.py --cfg {room}")
|
||||
return
|
||||
|
||||
# Layer 3: link
|
||||
if ask_yn("\nContinue to Layer 3 (Link - DB Bridge)?", default=False):
|
||||
layer3_link(room_dir, room, app_info["backend_framework"])
|
||||
|
||||
# Layer 4: scripts
|
||||
app_name = app_info["app_name"] if app_info else None
|
||||
if ask_yn("\nContinue to Layer 4 (Scripts)?"):
|
||||
layer4_scripts(room_dir, room, app_name)
|
||||
|
||||
# Layer 5: tester
|
||||
if ask_yn("\nContinue to Layer 5 (Test Suite)?", default=False):
|
||||
layer5_tester(room_dir, room)
|
||||
|
||||
# Layer 6: nginx (only if managed with frontend)
|
||||
if is_managed and app_info and app_info["has_frontend"]:
|
||||
if ask_yn("\nContinue to Layer 6 (Nginx Sidebar Injection)?", default=False):
|
||||
layer6_nginx(room_dir, room, app_info["app_name"])
|
||||
|
||||
print(f"\nReady! Build with: python build.py --cfg {room}")
|
||||
|
||||
|
||||
def main():
|
||||
parser = argparse.ArgumentParser(
|
||||
description="Soleprint room scaffolding wizard",
|
||||
usage="python ctrl/init.py <room> [--from <source>]",
|
||||
)
|
||||
parser.add_argument("room", help="Name of the new room")
|
||||
parser.add_argument("--from", dest="from_room", help="Clone from existing room")
|
||||
|
||||
args = parser.parse_args()
|
||||
|
||||
if args.from_room:
|
||||
clone_room(args.from_room, args.room)
|
||||
else:
|
||||
wizard(args.room)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in New Issue
Block a user