cmdop-utils

Small framework-neutral utilities shared by CMDOP services.

pip install cmdop-utils

As of 0.2.0, the former umbrella package has been split:

• LLM transport and the current agent harness: pip install cmdop-llm (import cmdop_llm)
• Client generation: pip install cmdop-codegen (import cmdop_codegen)
• The obsolete cmdop_utils.agent implementation was removed; use the harness shipped in cmdop_llm.agent.

cmdop-utils now contains only focused logging and Telegram helpers.

Structured logging

from cmdop_utils.logging import configure_logging, get_logger

configure_logging(service="billing", environment="production")
logger = get_logger(__name__)
logger.info("invoice_created", invoice_id="inv_123", amount="19.00")

The logger uses structlog, async-safe queue-backed sinks, compact machine output, context scoping, redaction, rate limiting, and a Rich console renderer.

Telegram

from cmdop_utils.telegram import DjangoTelegram

telegram = DjangoTelegram(
    bot_token="your-token",
    chat_id="your-chat-id",
)
telegram.send_message("Deployment completed", fail_silently=True)

DjangoTelegram keeps its historical name but does not depend on Django. Credentials can be passed explicitly or supplied through the env-backed cmdop_utils._compat configuration seam.

Development and release

python -m pip install -e ".[dev]"
pytest
python ../publishing/publish.py cmdop-utils --build-only