Metadata-Version: 2.4
Name: excel-schema-engine
Version: 0.1.0
Summary: 
License: MIT
License-File: LICENSE
Author: g_perevalov
Author-email: grigoriiperevalov@gmail.com
Requires-Python: >=3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: openpyxl (>=3.1.5,<4.0.0)
Description-Content-Type: text/markdown

# Excel Schema Engine

A lightweight Python library for generating, validating, and reading Excel files using a declarative schema.

Define your Excel structure once and use it to:

- generate Excel templates
- validate uploaded files
- read rows as structured data
- highlight errors directly in Excel

Built on top of **openpyxl**.

---

## Features

- Declarative Excel schema
- Multi-level headers
- Cell styles and comments
- Excel validation
- Row parsing
- Error highlighting
- Column autosizing
- Localization support

---

### Localization

The validator supports multiple languages for error messages.

You can define your own translations by implementing a custom message mapper in your project.

If you'd like to add a new localization, feel free to open an issue, submit a pull request, or contact the author.

#### Example:

```python
ValidatorErrComment.messages[Language.FR] = {
    "missing_column": "Colonne manquante: {column}"
}
```

---

## Installation

```bash
pip install excel-schema
```
or
```bash
poetry add excel-schema
```

![License](https://img.shields.io/badge/license-MIT-blue)
