codex-core 0.2.0

Core utilities, schemas and settings for Codex WaaS toolkit

codex-core

Core utilities, immutable DTOs, and environment-driven settings for the Codex WaaS toolkit. Provides the foundational building blocks and PII masking used by all other Codex components.

---

Install

# Core only
pip install codex-core

# With Loguru support for advanced structured logging
pip install "codex-core[loguru]"

Quick Start

from codex_core.core.base_dto import BaseDTO

# 1. Define an immutable, PII-aware data transfer object
class UserDTO(BaseDTO):
    id: int
    email: str         # Automatically masked in logs
    phone_number: str  # Automatically masked in logs

user = UserDTO(id=42, email="[e-mail]", phone_number="[phone]")

# 2. Safely log the DTO without leaking personal data
print(user)
# Output: UserDTO(id=42, email='***', phone_number='***')

Modules

Module	Extra	Description
codex_core.core	-	Immutable BaseDTO and automated PIIRegistry for GDPR-safe logging.
codex_core.common	[loguru]	Phone/name normalization and structured logging adapters (TaskLogContext).
codex_core.settings	-	Environment-driven configuration via BaseCommonSettings (Pydantic Settings).
codex_core.dev	[dev]	Internal developer tools (BaseCheckRunner, StaticCompiler, ProjectTreeGenerator).

Documentation

Full docs with architecture, API reference, and data flow diagrams:

https://codexdlc.github.io/codex-core/

Part of the Codex ecosystem

• codex-core: Foundational utilities and DTOs.
• codex-platform: Core platform components and HTTP APIs.
• codex-bot: Telegram AI-agent infrastructure.
• codex-services: Business logic engines (Booking, CRM).
• codex-ai: LLM abstraction layer.