simple-module-hosting 0.0.5

FastAPI + Inertia.js host runtime for simple_module — app_builder, middleware stack, CLI (sm / simple-module), scaffolding

simple_module_hosting

FastAPI + Inertia.js host runtime for the simple_module framework — builds the app, wires the middleware pipeline, and contributes the sm host plugin to the standalone sm CLI.

Install

pip install simple_module_hosting

For a new project, most users run the generator instead (shipped by the standalone simple_module_cli distribution):

uvx --from simple_module_cli sm new my-app

What it provides

• create_app(settings) — returns a fully-wired FastAPI instance with all discovered modules registered.
• Middleware pipeline (execution order): CorrelationId → RequestLogging → SecurityHeaders → Session → <module middleware> → Tenant (opt-in) → Locale → InertiaLayoutData → app.
• Inertia wiring — shared props (auth, menus, i18n), InertiaDep, page-route lookup.
• sm host plugin — sm host gen-pages regenerates the frontend pages manifest; sm host sync-js-deps installs JS deps declared by installed modules. The sm binary itself comes from simple_module_cli.

Usage

Minimal main.py:

from simple_module_hosting import create_app
from simple_module_hosting.settings import Settings

settings = Settings()           # reads SM_* env vars
app = create_app(settings)      # discovers + registers every installed module

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)

CLI (after also installing simple_module_cli):

sm host gen-pages               # regenerate client_app/modules.generated.ts
sm host sync-js-deps            # sync module JS deps into client_app/node_modules

Depends on

• simple_module_core, simple_module_db
• fastapi, fastapi-inertia, starlette, uvicorn, click, jinja2, httpx

License

MIT — see LICENSE.