Metadata-Version: 2.1
Name: various-api-tools
Version: 1.1.1
Summary: A lightweight utility package for common API-related tasks in Python, including JSON and Pydantic error translators that provide user-friendly Russian messages.
Author-Email: dkurchigin <kurchigin.dmitry@yandex.ru>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python
Classifier: Typing :: Typed
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Project-URL: Homepage, https://gitverse.ru/dkurchigin/various-api-tools
Project-URL: Documentation, https://various-api-tools.dkurchigin.ru/
Project-URL: Source, https://gitverse.ru/dkurchigin/various-api-tools
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.12.3
Requires-Dist: email-validator>=2.3.0
Description-Content-Type: text/markdown

# Various_api_tools

**A lightweight utility package for common API-related tasks in Python, including JSON and Pydantic error translators that provide user-friendly Russian messages.**

### Basic Usage

```python
import json
from various_api_tools.translators.json import JSONDecodeErrorTranslator

try:
    json.loads('{"name": "Alice",}')
except json.JSONDecodeError as e:
    print(JSONDecodeErrorTranslator.translate(e))

# Output:
# Ошибка конвертации в формате JSON.
# Позиция: 16.
# Описание: не правильно используются двойные кавычки.
```

```python
from pydantic import BaseModel, ValidationError
from various_api_tools.translators.pydantic import PydanticValidationErrorTranslator

class User(BaseModel):
    email: str

try:
    User(email=123)
except ValidationError as e:
    print(PydanticValidationErrorTranslator.translate(e.errors()))

# Output:
# Поле: "email". Ошибка: "Невалидное строковое значение(str)";
```


### Installation
```bash
pip install various_api_tools
```

### License

MIT License — feel free to use it in any project! 🎉

### Documentation

[https://various-api-tools.dkurchigin.ru/](https://various-api-tools.dkurchigin.ru/)

### Author

Made with ❤️ by [@dkurchigin](https://gitverse.ru/dkurchigin)

### Gitverse

[https://gitverse.ru/dkurchigin/various-api-tools](https://gitverse.ru/dkurchigin/various-api-tools)
