# megasniff

### Автоматическая валидация данных по схеме и сборка объекта в одном флаконе

#### Как применять:

```python
# 1. Объявляем схемы
from __future__ import annotations
import dataclasses
import typing


@dataclasses.dataclass
class SomeSchema1:
    a: int
    b: float | str
    c: SomeSchema2 | str | None


class SomeSchema2(typing.TypedDict):
    field1: dict
    field2: float
    field3: typing.Optional[SomeSchema1]


# 2. Генерируем метод для валидации и сборки
import megasniff

infl = megasniff.SchemaInflatorGenerator()
fn = infl.schema_to_inflator(SomeSchema1)

# 3. Проверяем что всё работает

fn({'a': 1, 'b': 2, 'c': {'field1': {}, 'field2': '1.1', 'field3': None}})
# SomeSchema1(a=1, b=2.0, c={'field1': {}, 'field2': 1.1, 'field3': None})

```

Особенности работы:

- поддерживает циклические зависимости
- проверяет `Union`-типы через ретрай на выбросе исключения
- по умолчанию использует готовый щаблон для кодогенерации и исполняет его по запросу, требуется особое внимание к
  сохранности данного шаблона
- проверяет типы списков, может приводить списки к множествам
- не проверяет типы generic-словарей, кортежей (реализация ожидается)
- пользовательские проверки типов должны быть реализованы через наследование и проверки в конструкторе
- опциональный `strict-mode`: выключение приведения базовых типов

----

### Как установить:

#### [uv](https://docs.astral.sh/uv/concepts/projects/dependencies/#dependency-sources):

```bash
uv add megasniff --index sniff_index=https://git.nikto-b.ru/api/packages/nikto_b/pypi/simple
```

#### [poetry](https://python-poetry.org/docs/repositories/#private-repository-example):

1. Добавить репозиторий в `pyproject.toml`

```bash
poetry source add --priority=supplemental sniff_index https://git.nikto-b.ru/api/packages/nikto_b/pypi/simple
```

2. Поставить пакет

```bash
poetry add --source sniff_index megasniff
```

----

### Strict-mode:

#### Strict-mode off:

```
@dataclass
class A:
    a: list[int]
```

```
>>> {"a": [1, 1.1, "321"]}
<<< A(a=[1, 1, 321])
```

#### Strict-mode on:

```
@dataclass
class A:
    a: list[int]
```

```
>>> {"a": [1, 1.1, "321"]}
<<< FieldValidationException, т.к. 1.1 не является int
```