Metadata-Version: 2.4
Name: codex-core
Version: 0.1.1
Summary: Core utilities, schemas and settings for Codex WaaS toolkit
Project-URL: Homepage, https://github.com/codexdlc/codex-core
Project-URL: Documentation, https://codexdlc.github.io/codex-core/
Project-URL: Repository, https://github.com/codexdlc/codex-core
Project-URL: Changelog, https://github.com/codexdlc/codex-core/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/codexdlc/codex-core/issues
Author: CodexDLC
License: Apache-2.0
Keywords: core,pydantic,toolkit,waas
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.10
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: pydantic<3.0,>=2.0
Provides-Extra: dev
Requires-Dist: bandit>=1.7; extra == 'dev'
Requires-Dist: detect-secrets>=1.5; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pip-audit>=2.7; extra == 'dev'
Requires-Dist: pre-commit>=3.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-include-markdown-plugin; extra == 'docs'
Requires-Dist: mkdocs-material>=9.0; extra == 'docs'
Requires-Dist: mkdocs>=1.5; extra == 'docs'
Requires-Dist: mkdocstrings[python]>=0.24; extra == 'docs'
Provides-Extra: loguru
Requires-Dist: loguru>=0.7.0; extra == 'loguru'
Description-Content-Type: text/markdown

# codex-core

**Core utilities, schemas, and settings for the Codex WaaS toolkit.**

[![PyPI](https://img.shields.io/pypi/v/codex-core)](https://pypi.org/project/codex-core/)
[![Python](https://img.shields.io/pypi/pyversions/codex-core)](https://pypi.org/project/codex-core/)
[![License](https://img.shields.io/badge/license-Apache--2.0-green)](https://github.com/codexdlc/codex-core/blob/main/LICENSE)
[![Documentation](https://img.shields.io/badge/docs-codexdlc.github.io-blue)](https://codexdlc.github.io/codex-core/)

This library provides the foundational building blocks used by all other Codex tools. It focuses on Pydantic-based data models, structured logging, and configuration management.

> **Documentation:**
> [EN](https://codexdlc.github.io/codex-core/en_EN/) · [RU](https://codexdlc.github.io/codex-core/ru_RU/) · [API Reference](https://codexdlc.github.io/codex-core/api/) · [Changelog](https://codexdlc.github.io/codex-core/changelog/)

## 🚀 Key Features

*   **Core Interfaces**: Base classes and protocols for Codex components.
*   **Common Utilities**: Logger setup (Loguru), phone number validation, text processing, and caching.
*   **Schemas**: Shared Pydantic models for cross-service communication.
*   **Settings**: Modern configuration management using `pydantic-settings`.

## 📦 Installation

```bash
pip install codex-core
```

## 🛠️ Quick Start

```python
from codex_tools.common.logger import setup_logger

logger = setup_logger("my-app")
logger.info("Codex Core is ready!")
```

---
*Part of the [Codex WaaS](https://github.com/codexdlc) ecosystem. · [EN Docs](https://codexdlc.github.io/codex-core/en_EN/) · [RU Docs](https://codexdlc.github.io/codex-core/ru_RU/) · [API](https://codexdlc.github.io/codex-core/api/) · [Changelog](https://codexdlc.github.io/codex-core/changelog/) · [Source](https://github.com/codexdlc/codex-core)*
