loader/_docs/02_document/modules/constants.md

Module: constants

Purpose

Centralizes shared configuration constants and provides the application-wide logging interface via Loguru.

Public Interface

Constants (cdef, module-level)

Name	Type	Value
CONFIG_FILE	str	"config.yaml"
QUEUE_CONFIG_FILENAME	str	"secured-config.json"
AI_ONNX_MODEL_FILE	str	"azaion.onnx"
CDN_CONFIG	str	"cdn.yaml"
MODELS_FOLDER	str	"models"
SMALL_SIZE_KB	int	3
ALIGNMENT_WIDTH	int	32

Note: QUEUE_MAXSIZE, COMMANDS_QUEUE, ANNOTATIONS_QUEUE are declared in the .pxd but not defined in the .pyx — they are unused in this codebase.

Functions (cdef, Cython-only visibility)

Function	Signature	Description
log	cdef log(str log_message)	Logs at INFO level via Loguru
logerror	cdef logerror(str error)	Logs at ERROR level via Loguru

Internal Logic

Loguru is configured with three sinks:

• File sink: Logs/log_loader_{date}.txt, INFO level, daily rotation, 30-day retention, async (enqueue=True)
• Stdout sink: DEBUG level, filtered to INFO/DEBUG/SUCCESS only, colorized
• Stderr sink: WARNING+ level, colorized

Log format: [HH:mm:ss LEVEL] message

Dependencies

• Internal: none (leaf module)
• External: loguru (0.7.3), sys, time

Consumers

• hardware_service — calls log()
• cdn_manager — calls log(), logerror()
• api_client — calls log(), logerror(), reads CDN_CONFIG, SMALL_SIZE_KB

Data Models

None.

Configuration

No env vars consumed directly. Log file path is hardcoded to Logs/log_loader_{date}.txt.

External Integrations

None.

Security

None.

Tests

No tests found.