UI Controller Base

# myapp/views/home_view.py
from ui_controller_base import UIResponse
from ui_controller_base.core.context import UIContext
from ui_controller_base.core.response import UIFragment
from ui_controller_base.core.state import UIState
from ui_controller_base.core.view import AbstractView
from ui_controller_base.types import FragmentType


class HomeView(AbstractView):
    plugin_name = "home"
    route = "/home"
    plugin_description = "Welcome page"

    async def render(self, ctx: UIContext, state: UIState) -> UIResponse:
        return UIResponse.ok(
            UIFragment(type=FragmentType.TEXT, content="## Welcome"),
            UIFragment(
                type=FragmentType.FORM,
                content={
                    "action": "greet",
                    "fields": [{"name": "name", "type": "text", "label": "Your name"}],
                    "submit_label": "Greet me!",
                },
            ),
        )

# myapp/controller.py
from typing import Any
from ui_controller_base import (
    AbstractUIController,
    CacheableMixin,
    ObservableMixin,
    StatefulMixin,
    UIResponse,
    UITool,
)
from myapp.views.home_view import HomeView


async def greet(name: str = "World", **_: Any) -> UIResponse:
    """Return a personalised greeting."""
    return UIResponse.text(f"Hello, {name}!", toast=f"Greeted {name}")


class MyController(CacheableMixin, StatefulMixin, ObservableMixin, AbstractUIController):
    views = [HomeView]
    tools = [UITool.from_fn("greet", greet, description="Greet a user by name")]

# myapp/run_streamlit.py
from ui_controller_base import StreamlitAdapter
from myapp.controller import MyController

StreamlitAdapter(MyController(), title="My App").serve()

# myapp/run_fastapi.py
from fastapi import FastAPI
from ui_controller_base import FastAPIAdapter
from myapp.controller import MyController

app = FastAPI(title="My App")
FastAPIAdapter(MyController()).mount_app(app)

# myapp/run_cli.py
from ui_controller_base import CLIAdapter
from myapp.controller import MyController

CLIAdapter(MyController()).serve()

class MyController(
    WithJobs,            # background job scheduling (job-manager)
    WithWorkflows,       # multi-step flows with human approval (workflow-manager)
    WithNotifications,   # push alerts (notification-manager)
    WithApiClients,      # named HTTP clients (api-client-base)
    WithDatabase,        # database access (db-accessor)
    ObservableMixin,     # event bus (event-dispatcher)
    StatefulMixin,       # per-session UIState (optimistic locking)
    CacheableMixin,      # view/tool/session caches (cache-manager)
    AbstractUIController,
):
    ...

from ui_controller_base.testing import ControllerTestHarness

async def test_greet():
    async with ControllerTestHarness(MyController) as adapter:
        resp = await adapter.dispatch("greet", name="Ada")
        adapter.assert_ok(resp)
        assert "Ada" in resp.fragments[0].content

async def test_view_renders():
    async with ControllerTestHarness(MyController) as adapter:
        resp = await adapter.render_view("/home")
        adapter.assert_ok(resp)