pico-actuator 0.1.0

Spring Boot-style actuator for the Pico ecosystem: /health, /info, /metrics over pico-fastapi.

📦 pico-actuator

Spring Boot-style actuator endpoints for the Pico ecosystem, built on top of pico-fastapi.

Auto-discovered by pico-boot — install it and the endpoints appear:

Endpoint	Purpose
GET /actuator/health	Overall status + per-component detail (200/503)
GET /actuator/health/live	Liveness — process is responding, touches no deps
GET /actuator/health/ready	Readiness — aggregate of all health indicators
GET /actuator/info	Static config + dynamic contributors
GET /actuator/metrics	Prometheus default registry (needs the metrics extra)

Install

pip install pico-actuator
# optional Prometheus /metrics:  pip install pico-actuator[metrics]

Use

Contribute health by implementing HealthIndicator and marking it @component. No registration, no wiring — pico-ioc collects them via List[HealthIndicator]:

from pico_ioc import component
from pico_actuator import HealthIndicator

@component
class DbHealth:  # satisfies HealthIndicator
    name = "db"
    def __init__(self, engine: Engine):
        self.engine = engine
    def check(self):
        self.engine.connect().close()
        return {"status": "UP"}

check() may be sync or async; return a dict ({"status": "UP", ...}) or a truthy value. Indicators run concurrently, each under a configurable timeout (actuator.check_timeout_seconds, default 5s). A raising or hanging indicator is reported DOWN in isolation — it never takes the endpoint down.

Add /info data the same way with InfoContributor, or statically via config:

# application.yaml
actuator:
  enabled: true
  show_components: true
  info:
    app: my-service
    build: "2026.06"

Documentation

Full docs at dperezcabrera.github.io/pico-actuator — getting started, user guide, how-to guides, API reference.

AI Coding Skills

Claude Code and OpenAI Codex skills for AI-assisted development:

curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash -s -- actuator

Why

pico-ioc already exposes @health/@cleanup lifecycle primitives but nothing serves them. This package is the thin layer that turns them into operable HTTP endpoints — the one observability piece you can't improvise in ten lines.

License

MIT