mirror of
https://github.com/azaion/loader.git
synced 2026-04-22 08:26:32 +00:00
Oleksandr Bezdieniezhnykh
69 lines
2.1 KiB
Markdown
69 lines
2.1 KiB
Markdown
# 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.
|