left4me/components/l4d2-host-lib/README.md

l4d2-host-lib

Python host library and CLI for managing L4D2 instances.

CLI

l4d2ctl exposes exactly these commands in v1:

• install
• initialize <name> -f <spec.yaml>
• start <name>
• stop <name>
• delete <name>

Subprocess failures are fail-fast. Raw stderr is written to stderr and the command exits with the same subprocess return code.

Runtime Paths

The host library uses hard-coded runtime paths under /opt/l4d2:

• /opt/l4d2/installation
• /opt/l4d2/overlays/<overlay>
• /opt/l4d2/instances/<name>
• /opt/l4d2/runtime/<name>/{upper,work,merged}

Web App Read APIs

These read APIs are provided for web app integration:

• get_instance_status(name)
• stream_instance_logs(name, lines=200, follow=True)