Skip to content

Reference

Technical reference for the cosalette API and configuration.

  • API Reference

    All public classes, functions, and protocols.

    API Reference

  • Testing Utilities

    Test doubles, factories, and pytest fixtures.

    Testing Utilities

  • Settings

    Configuration fields, environment variables, and defaults.

    Settings Reference

  • MQTT Topics

    Complete topic schema with examples.

    MQTT Topics

  • CLI Options

    Command-line flags and their defaults.

    CLI Options

  • Payload Schemas

    JSON schemas for error and heartbeat payloads.

    Payload Schemas

  • Error Taxonomy

    Complete catalog of all framework-raised exceptions.

    Error Taxonomy

  • Dependency Injection

    DI container mechanics, Optional() marker, scoped adapters, and diagnostic error messages.

    Dependency Injection

  • Telemetry

    Telemetry handler contract, publish lifecycle, and coalescing group semantics.

    Telemetry

  • AI Agent Instructions

    AI agent instruction file for projects applying the framework.

    AI Agent Instructions