Lilya Converter

Convert web framework codebases into Lilya with deterministic rules, explicit diagnostics, and reproducible reports.

Documentation: https://lilya-converter.dymmond.com 📚

Source Code: https://github.com/dymmond/lilya-converter 💻

lilya_converter is a modular CLI for converting source framework projects into Lilya.

Supported Sources

Architecture

• framework-agnostic core orchestration,
• explicit adapter registry,
• framework-specific adapters,
• shared filesystem utilities,
• deterministic report and diagnostic models.

Installation

pip install lilya-converter

Optional framework extras (useful when you also want local framework packages installed):

pip install "lilya-converter[fastapi]"
pip install "lilya-converter[flask]"
pip install "lilya-converter[django]"
pip install "lilya-converter[litestar]"
pip install "lilya-converter[starlette]"

Install with all supported framework extras:

pip install "lilya-converter[fastapi,flask,django,litestar,starlette]"

For local development:

pip install -e .

CLI entrypoint:

lilya-converter --help

Usage

FastAPI remains the default source:

lilya-converter analyze ./my-fastapi-app
lilya-converter convert ./my-fastapi-app ./my-lilya-app --dry-run --diff

Select another framework explicitly:

lilya-converter analyze ./my-django-app --source django
lilya-converter convert ./my-flask-app ./my-lilya-app --source flask
lilya-converter convert ./my-litestar-app ./my-lilya-app --source litestar
lilya-converter convert ./my-starlette-app ./my-lilya-app --source starlette
lilya-converter verify ./my-lilya-app --source django --report ./reports/verify.json

Full source-key matrix:

lilya-converter convert ./my-fastapi-app ./my-lilya-app
lilya-converter convert ./my-flask-app ./my-lilya-app --source flask
lilya-converter convert ./my-django-app ./my-lilya-app --source django
lilya-converter convert ./my-litestar-app ./my-lilya-app --source litestar
lilya-converter convert ./my-starlette-app ./my-lilya-app --source starlette

Commands

lilya-converter analyze SOURCE [--source SOURCE_KEY] [--json] [--output REPORT.json]
lilya-converter convert SOURCE TARGET [--source SOURCE_KEY] [--dry-run] [--diff] [--report REPORT.json]
lilya-converter scaffold SOURCE TARGET [--source SOURCE_KEY] [--dry-run]
lilya-converter map rules [--source SOURCE_KEY]
lilya-converter map applied REPORT.json
lilya-converter verify TARGET [--source SOURCE_KEY] [--report REPORT.json]

Run lilya-converter convert --help to see supported source keys in deterministic order.

Adapter Extension Guide

See Adding a New Adapter for:

• adapter package skeleton,
• explicit registry registration,
• test expectations,
• typing, docstring, and error-handling conventions.

Testing

Run full test suite:

hatch run test:test -q

Building docs

hatch run docs:build