facetkit 0.3.0

A composable dependency container with passive UI and service facets.

facetkit

A composable Python container for application state and passive registries — CLI commands, TUI screens, GUI widgets, web routes, and background services.

facetkit separates three pieces:

Piece	Role
Container	Application root — config, facet mounting, component lifecycle
Facet	Passive registry for a surface area (commands, routes, widgets, …)
Component	Plugin that registers into facets on attach and cleans up on detach

Container
├── config
├── components
└── facets
    ├── cli      → commands
    ├── tui      → screens, keybindings
    ├── gui      → widgets, menus, toolbars, layouts
    ├── web      → routes, middleware, error handlers
    └── service  → tasks, providers

Requirements

• Python 3.10+
• glom

Installation

pip install facetkit

For local development:

git clone https://github.com/Dev-DanielR/py_facetkit.git
cd facetkit
pip install -e ".[dev]"

Quick start

from facetkit import Container, CliFacet, WebFacet

app = Container({"app": {"name": "demo"}})

app.mount_facet("cli", CliFacet())
app.mount_facet("web", WebFacet())

def hello():
    """Say hello."""
    return "Hello!"

app.facets["cli"].add_command("hello", hello)
app.facets["web"].add_route("hello", "/hello", lambda: {"message": "Hello!"}, methods=["GET"])

Register directly on facets (as above) or through components. Your dispatch layer reads the registries and wires them to argparse, FastAPI, Textual, Qt, or whatever you use.

Documentation

• Container — config, lifecycle, introspection
• Facets — facet types, registries, mounting
• Components — attach/detach, dependencies
• Examples — composed app with logger and status components

Development

pip install -e ".[dev]"
pytest

See CHANGELOG.md for release notes. Pre-1.0 (0.3.0) — public APIs may change between minor releases.

License

MIT — see LICENSE.