codex-core 0.3.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]"

Requires Python 3.12 or newer.

Development

uv sync --extra dev
uv run pytest
uv run mypy src/codex_core/
uv run pre-commit run --all-files
uv build --no-sources

Requires Python 3.12 or newer.

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

Package	Role
codex-core	Foundation — immutable DTOs, PII masking, env settings
codex-platform	Infrastructure — Redis, Streams, ARQ workers, Notifications
codex-ai	LLM layer — unified async interface for OpenAI, Gemini, Anthropic
codex-services	Business logic — Booking engine, CRM, Calendar

Each library is fully standalone — install only what your project needs. Together they form the backbone of codex-bot (Telegram AI-agent infrastructure built on aiogram) and codex-django (Django integration layer).