Merge branch 'docs' into dev

- Simplified the description of the OxiAPI entry point.
- Improved formatting of parameter and property tables for better readability.
- Updated example outputs to reflect changes in node names and configurations.

.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+main.py
+# Virtual environments
+.venv
+.idea
+
+# etc files
+*.txt

.python-version

@@ -0,0 +1 @@
+3.13

README.md

@@ -0,0 +1,323 @@
+# oxipy
+
+Python-клиент для работы с Oxidized API — системой управления конфигурацией сетевых устройств. Предоставляет удобный интерфейс для получения конфигураций узлов, их парсинга и работы с результатами.
+
+## Содержание
+
+- [Установка](#установка)
+- [Быстрый старт](#быстрый-старт)
+- [API Reference](#api-reference)
+  - [OxiAPI](#oxiapi)
+  - [NodeView](#nodeview)
+  - [NodeConfig](#nodeconfig)
+  - [ModelView](#modelview)
+- [Поддерживаемые устройства](#поддерживаемые-устройства)
+- [Дополнительно](#дополнительно)
+
+---
+
+## Установка
+
+> Пакет распространяется через Gitea Package Registry и исходники репозитория.
+> В PyPI пакет не публикуется.
+
+**Требования:** Python 3.11+
+
+### Из Gitea Package Registry
+
+Добавьте registry в конфигурацию pip и установите пакет:
+
+```bash
+pip install oxipy \
+  --index-url https://gitea.imbastark.ru/api/packages/Netbox/pypi/simple/
+```
+
+Или пропишите registry постоянно в `pip.conf` / `pip.ini`, чтобы не указывать `--index-url` каждый раз:
+
+```ini
+# ~/.config/pip/pip.conf  (Linux/macOS)
+# %APPDATA%\pip\pip.ini   (Windows)
+
+[global]
+extra-index-url = https://gitea.imbastark.ru/api/packages/Netbox/pypi/simple/
+```
+
+После этого достаточно:
+
+```bash
+pip install oxipy
+```
+
+Если registry требует аутентификации, передайте токен:
+
+```bash
+pip install oxipy \
+  --index-url https://__token__:<your_token>@gitea.imbastark.ru/api/packages/Netbox/pypi/simple/
+```
+
+### Из репозитория Gitea
+
+Установка напрямую через pip без клонирования:
+
+```bash
+pip install git+https://gitea.imbastark.ru/Netbox/oxipy.git
+```
+
+Конкретный тег или ветка:
+
+```bash
+pip install git+https://gitea.imbastark.ru/Netbox/oxipy.git@v0.1.0
+pip install git+https://gitea.imbastark.ru/Netbox/oxipy.git@dev
+```
+
+Для разработки (editable install):
+
+```bash
+git clone https://gitea.imbastark.ru/Netbox/oxipy
+cd oxipy
+pip install -e .
+```
+
+---
+
+## Быстрый старт
+
+```python
+from oxi import OxiAPI
+
+api = OxiAPI(url="https://oxi.example.com", verify=False)
+
+node = api.node("Router_HOME")
+
+print(node.ip)          
+print(node.model)       
+print(node.full_name)   
+
+>>> 192.168.1.1
+>>> keenetic
+>>> router/HQ
+
+print(node.config.system.model)
+print(node.config.interfaces.json())
+print(node.config.vlans.json())
+
+>>> Sprinter (KN-3710)
+>>> 
+[
+    {"name":"Bridge1","ip_address":"192.168.1.1","mask":24,"description":"\"Guest network\""},
+    {"name":"Bridge0","ip_address":"172.16.1.1","mask":24,"description":"\"Home network\""}
+]
+>>> 
+[
+    {"vlan_id":1,"name":"Home VLAN"},
+    {"vlan_id":2,"name":"Подключение Ethernet"},
+    {"vlan_id":3,"name":"Home network"}
+]
+```
+
+---
+
+## API Reference
+
+### OxiAPI
+
+Точка входа. Управляет HTTP-сессией и предоставляет доступ к узлам.
+
+```python
+OxiAPI(
+    url: str,
+    username: str | None = None,
+    password: str | None = None,
+    verify: bool = True,
+)
+```
+
+
+| Параметр   | Тип    | Описание                                                  |
+| ---------- | ------ | --------------------------------------------------------- |
+| `url`      | `str`  | Базовый URL Oxi API, например `https://oxi.example.com`   |
+| `username` | `str`  | Имя пользователя для базовой аутентификации (опционально) |
+| `password` | `str`  | Пароль для базовой аутентификации (опционально)           |
+| `verify`   | `bool` | Проверять SSL-сертификат. `True` по умолчанию             |
+
+
+**Пример:**
+
+```python
+# Без аутентификации
+api = OxiAPI(url="https://oxi.example.com")
+
+# С базовой аутентификацией
+api = OxiAPI(
+    url="https://oxi.example.com",
+    username="admin",
+    password="secret",
+)
+
+# Использование как контекстного менеджера (автоматически закрывает сессию)
+with OxiAPI(url="https://oxi.example.com") as api:
+    node = api.node("HQ")
+    print(node.ip)
+
+>>>  192.168.1.1
+```
+
+#### `api.node(name)`
+
+Возвращает `[NodeView](#nodeview)` для указанного узла.
+
+```python
+node = api.node("HQ")
+```
+
+---
+
+### NodeView
+
+Представление узла сети. Содержит метаданные и ленивый доступ к конфигурации.
+
+
+| Свойство    | Тип          | Описание                                             |
+| ----------- | ------------ | ---------------------------------------------------- |
+| `ip`        | `str`        | IP-адрес узла                                        |
+| `full_name` | `str`        | Полное имя узла в Oxi                                |
+| `group`     | `str`        | Группа, к которой принадлежит узел                   |
+| `model`     | `str`        | Модель устройства (используется для парсинга)        |
+| `config`    | `NodeConfig` | Конфигурация узла (загружается при первом обращении) |
+
+
+**Пример:**
+
+```python
+node = api.node("HQ")
+
+print(node.ip)
+print(node.group)
+print(node.model)
+
+>>> 192.168.1.1
+>>> branch-office
+>>> keenetic
+```
+
+---
+
+### NodeConfig
+
+Загружает и парсит конфигурацию устройства. Использует TTP-шаблоны, соответствующие модели устройства.
+
+Доступ к секциям конфигурации осуществляется через свойства, возвращающие `[ModelView](#modelview)`.
+
+
+| Свойство     | Возвращает                    | Описание                           |
+| ------------ | ----------------------------- | ---------------------------------- |
+| `system`     | `ModelView[System]`           | Системная информация об устройстве |
+| `interfaces` | `ModelView[list[Interfaces]]` | Список интерфейсов                 |
+| `vlans`      | `ModelView[list[Vlans]]`      | Список VLAN (если есть)            |
+| `text`       | `str`                         | Сырой текст конфигурации           |
+
+
+**Пример:**
+
+```python
+cfg = node.config
+
+# Системная информация
+print(cfg.system.model)          
+print(cfg.system.serial_number)  
+print(cfg.system.version)        
+
+>>> Mikrotik RB951Ui-2nD
+>>> B88C0B31117B
+>>> 7.16.1
+
+# Итерация по интерфейсам
+for iface in cfg.interfaces:
+    print(iface.name, iface.ip_address, iface.mask)
+
+# Индексация
+first_iface = cfg.interfaces[0]
+print(first_iface.name)
+
+# Количество интерфейсов
+print(len(cfg.interfaces))
+
+# JSON-дамп любой секции
+print(cfg.interfaces.json())
+print(cfg.vlans.json())
+print(cfg.system.json())
+
+# Сырая конфигурация текстом
+print(cfg.text)
+```
+
+---
+
+### ModelView
+
+Обёртка над Pydantic-моделью или списком моделей. Обеспечивает сериализацию, итерацию и прозрачный доступ к атрибутам.
+
+
+| Метод / свойство | Применимо к  | Описание                                          |
+| ---------------- | ------------ | ------------------------------------------------- |
+| `.json()`        | оба варианта | Возвращает JSON-строку (с `by_alias=True`)        |
+| `.<attr>`        | оба варианта | Проксирует обращение к атрибутам вложенной модели |
+| `iter(view)`     | список       | Итерация по элементам списка моделей              |
+| `len(view)`      | список       | Количество элементов в списке                     |
+| `view[i]`        | список       | Получение элемента по индексу или срез            |
+
+
+> `__iter__`, `__len__` и `__getitem__` доступны только для `interfaces` и `vlans` (они оборачивают список). Вызов этих методов на `system` (одиночная модель) вызовет `TypeError`.
+
+**Примеры:**
+
+```python
+# Одиночная модель — system
+view = node.config.system
+print(view.json())
+>>> '{"model":"RB951Ui-2nD","serial_number":"B88C0B31117B","version":"7.12.1"}'
+print(view.model)          # 'RB951Ui-2nD'
+print(view.serial_number)  # 'B88C0B31117B'
+
+>>> RB951Ui-2nD
+>>> B88C0B31117B
+# Список — interfaces
+interfaces = node.config.interfaces
+
+# Итерация
+for iface in interfaces:
+    print(iface.name, iface.ip_address)
+
+# Длина
+print(len(interfaces))   # 5
+
+# Индексация и срезы
+first = interfaces[0]
+top3 = interfaces[:3]
+
+# JSON всего списка
+print(interfaces.json())
+```
+
+---
+
+## Поддерживаемые устройства
+
+
+| Устройство | Ключи реестра                    |
+| ---------- | -------------------------------- |
+| Keenetic   | `ndms`, `keenetic`, `keeneticos` |
+| MikroTik   | `routeros`, `ros`, `mikrotik`    |
+
+
+Ключи реестра — это значения поля `model`, возвращаемого API для узла. Регистр не учитывается.
+
+Добавить поддержку нового устройства можно самостоятельно — подробнее в разделе [Расширение моделей](docs/extending-models.md).
+
+---
+
+## Дополнительно
+
+- [Написание TTP-шаблонов](docs/templates.md)
+- [Расширение и переопределение моделей устройств](docs/extending-models.md)
+

docs/extending-models.md

@@ -0,0 +1,325 @@
+# Расширение и переопределение моделей устройств
+
+oxipy предоставляет гибкий механизм расширения через наследование от `BaseDevice`. После того как TTP-шаблон разобрал конфигурацию в сырой словарь `self.raw`, данные проходят через три метода экземпляра — `system()`, `interfaces()`, `vlans()` — перед тем как попасть в контракт. Переопределяя эти методы, можно трансформировать, фильтровать и обогащать данные без изменения шаблона или контракта.
+
+## Содержание
+
+- [Архитектура: путь данных](#архитектура-путь-данных)
+- [Регистрация нового устройства](#регистрация-нового-устройства)
+- [Переопределение методов (monkey patching)](#переопределение-методов-monkey-patching)
+  - [interfaces()](#interfaces)
+  - [vlans()](#vlans)
+  - [system()](#system)
+- [Полный пример: новое устройство](#полный-пример-новое-устройство)
+- [Контракт: ожидаемые структуры](#контракт-ожидаемые-структуры)
+
+---
+
+## Архитектура: путь данных
+
+```
+текст конфигурации
+        │
+        ▼
+   TTP-шаблон (.ttp)
+        │  парсит в сырой словарь
+        ▼
+   self.raw: dict
+        │
+        ├──► system()     → dict
+        ├──► interfaces() → list[dict]
+        └──► vlans()      → list[dict]
+                │
+                ▼
+        _validate_contract()
+                │  создаёт Pydantic-модели
+                ▼
+           Device(system, interfaces, vlans)
+```
+
+Методы `system()`, `interfaces()`, `vlans()` — это точки расширения. Базовая реализация просто возвращает данные из `self.raw`:
+
+```python
+# BaseDevice (упрощённо)
+def interfaces(self) -> list[dict]:
+    return self.raw.get("interfaces", [])
+
+def vlans(self) -> list[dict]:
+    return self.raw.get("vlans", [])
+
+def system(self) -> dict:
+    return self.raw.get("system", None)
+```
+
+---
+
+## Регистрация нового устройства
+
+Чтобы добавить поддержку нового вендора:
+
+1. Создайте файл в `oxi/interfaces/models/`, например `cisco.py`.
+2. Создайте шаблон `oxi/interfaces/models/templates/cisco.ttp`.
+3. Унаследуйте класс от `BaseDevice` и зарегистрируйте его декоратором `@register_parser`.
+
+```python
+# oxi/interfaces/models/cisco.py
+from oxi.interfaces import register_parser
+from oxi.interfaces.base import BaseDevice
+
+
+@register_parser(["ios", "cisco", "cisco_ios"])
+class CiscoIOS(BaseDevice):
+    template = "cisco.ttp"
+```
+
+Декоратор `@register_parser` принимает список строк — это ключи, по которым устройство ищется в реестре. Поле `model` от API сравнивается с этими ключами без учёта регистра.
+
+После добавления файла он автоматически импортируется через `pkgutil` при старте приложения — явно импортировать не нужно.
+
+---
+
+## Переопределение методов (monkey patching)
+
+### interfaces()
+
+Используйте переопределение, когда нужно:
+
+- Преобразовать формат IP-адреса (например, `netmask` → `prefix_length`).
+- Декодировать escape-последовательности в описаниях.
+- Переименовать ключи, не совпадающие с контрактом.
+- Фильтровать служебные интерфейсы.
+
+**Пример: конвертация маски подсети в префикс**
+
+TTP возвращает `netmask` как `255.255.255.0`, а контракт `Interfaces` ожидает `mask` как целое число (prefix length):
+
+```python
+from ipaddress import ip_interface
+from oxi.interfaces import register_parser
+from oxi.interfaces.base import BaseDevice
+
+
+@register_parser(["myvendor"])
+class MyVendor(BaseDevice):
+    template = "myvendor.ttp"
+
+    def interfaces(self) -> list[dict]:
+        result = []
+        for item in self.raw.get("interfaces", []):
+            if item.get("ip_address") and item.get("netmask"):
+                iface = ip_interface(f"{item['ip_address']}/{item['netmask']}")
+                item["mask"] = iface.network.prefixlen
+                item.pop("netmask", None)
+            result.append(item)
+        return result
+```
+
+**Пример: фильтрация служебных интерфейсов**
+
+```python
+def interfaces(self) -> list[dict]:
+    return [
+        item for item in self.raw.get("interfaces", [])
+        if not item.get("name", "").startswith("lo")
+    ]
+```
+
+**Пример: декодирование Unicode escape-последовательностей**
+
+Некоторые устройства (например, Keenetic) хранят кириллические описания как `\xd0\xb8\xd0\xbc\xd1\x8f`:
+
+```python
+def _decode_utf(self, text: str) -> str:
+    if "\\x" in text:
+        return (
+            text.strip('"')
+            .encode("utf-8")
+            .decode("unicode_escape")
+            .encode("latin1")
+            .decode("utf-8")
+        )
+    return text
+
+def interfaces(self) -> list[dict]:
+    interfaces = self.raw.get("interfaces", [])
+    for item in interfaces:
+        if item.get("description"):
+            item["description"] = self._decode_utf(item["description"])
+    return interfaces
+```
+
+---
+
+### vlans()
+
+Аналогично `interfaces()`. Используйте для нормализации ID, декодирования названий, обогащения данными из других секций.
+
+**Пример: добавление префикса к имени VLAN**
+
+```python
+def vlans(self) -> list[dict]:
+    result = []
+    for item in self.raw.get("vlans", []):
+        item["description"] = f"VLAN_{item.get('id', '?')}"
+        result.append(item)
+    return result
+```
+
+**Пример: объединение данных из нескольких секций**
+
+```python
+def vlans(self) -> list[dict]:
+    vlans = {v["id"]: v for v in self.raw.get("vlans", [])}
+    # обогащаем данными из другой секции, если она есть
+    for extra in self.raw.get("vlan_details", []):
+        vlan_id = extra.get("id")
+        if vlan_id in vlans:
+            vlans[vlan_id].update(extra)
+    return list(vlans.values())
+```
+
+---
+
+### system()
+
+Переопределяйте, если структура системной секции отличается от ожидаемой контрактом, или нужно вычислить поля:
+
+**Пример: собрать серийный номер из нескольких полей**
+
+```python
+def system(self) -> dict:
+    raw_system = self.raw.get("system", {})
+    # Устройство возвращает серийный номер в двух частях
+    part1 = raw_system.get("serial_part1", "")
+    part2 = raw_system.get("serial_part2", "")
+    raw_system["serial_number"] = f"{part1}-{part2}"
+    return raw_system
+```
+
+**Пример: нормализация строки версии**
+
+```python
+def system(self) -> dict:
+    raw_system = self.raw.get("system", {})
+    # Убираем лишнее из "7.12.1 (stable)" → "7.12.1"
+    version = raw_system.get("version", "")
+    raw_system["version"] = version.split()[0] if version else version
+    return raw_system
+```
+
+---
+
+## Полный пример: новое устройство
+
+Допустим, нужно добавить поддержку Cisco IOS, где:
+- IP-адрес и маска разделены пробелом в конфигурации (`ip address 10.0.0.1 255.255.255.0`).
+- Описание интерфейса может содержать несколько слов.
+- Серийный номер разделён дефисом в двух строках.
+
+**Шаблон** (`oxi/interfaces/models/templates/cisco.ttp`):
+
+```xml
+<vars>
+default_system = {
+    "model": "",
+    "serial_number": "",
+    "version": ""
+}
+</vars>
+
+<group name="system" default="default_system">
+Cisco IOS Software, {{ ignore }} Version {{ version }},{{ ignore('.*') }}
+Model Number         : {{ model }}
+System serial number : {{ serial_number }}
+</group>
+
+<group name="interfaces">
+interface {{ interface | _start_ }}
+ description {{ description | ORPHRASE }}
+ ip address {{ ip_address }} {{ netmask }}
+</group>
+
+<group name="vlans">
+vlan {{ id | _start_ }}
+ name {{ description }}
+</group>
+```
+
+**Класс устройства** (`oxi/interfaces/models/cisco.py`):
+
+```python
+from ipaddress import ip_interface
+from oxi.interfaces import register_parser
+from oxi.interfaces.base import BaseDevice
+
+
+@register_parser(["ios", "cisco", "cisco_ios"])
+class CiscoIOS(BaseDevice):
+    template = "cisco.ttp"
+
+    def interfaces(self) -> list[dict]:
+        result = []
+        for item in self.raw.get("interfaces", []):
+            # Конвертируем маску подсети в длину префикса
+            if item.get("ip_address") and item.get("netmask"):
+                iface = ip_interface(f"{item['ip_address']}/{item['netmask']}")
+                item["mask"] = iface.network.prefixlen
+                item.pop("netmask", None)
+            # Фильтруем интерфейсы управления
+            if item.get("interface", "").startswith("Mgmt"):
+                continue
+            result.append(item)
+        return result
+
+    def system(self) -> dict:
+        raw_system = self.raw.get("system", {})
+        # Нормализуем версию: "15.2(4)M3" → оставляем как есть
+        # Убираем лишние пробелы в модели
+        if raw_system.get("model"):
+            raw_system["model"] = raw_system["model"].strip()
+        return raw_system
+```
+
+---
+
+## Контракт: ожидаемые структуры
+
+Методы должны возвращать данные в следующем формате. Контракт жёстко проверяется Pydantic.
+
+### `system()` → `dict`
+
+```python
+{
+    "model": "RB951Ui-2nD",       # str, обязательно
+    "serial_number": "B88C0B31117B",  # str, обязательно
+    "version": "7.12.1",          # str, обязательно
+}
+```
+
+### `interfaces()` → `list[dict]`
+
+```python
+[
+    {
+        "interface": "ether1",          # str, обязательно (alias для поля name)
+        "ip_address": "192.168.1.1",    # str | None
+        "mask": 24,                     # int | None (длина префикса)
+        "description": "LAN",          # str | None
+    },
+    ...
+]
+```
+
+### `vlans()` → `list[dict]`
+
+```python
+[
+    {
+        "id": 10,                       # int, обязательно (alias для поля vlan_id)
+        "description": "MGMT",         # str | None (alias для поля name)
+    },
+    ...
+]
+```
+
+> Если имя ключа в словаре совпадает с **alias** поля Pydantic-модели, а не с именем атрибута — используйте alias. Модели сконфигурированы с `populate_by_name=True`, поэтому принимаются оба варианта.

docs/templates.md

@@ -0,0 +1,306 @@
+# Написание TTP-шаблонов
+
+oxipy использует библиотеку [TTP (Template Text Parser)](https://ttp.readthedocs.io/) для парсинга конфигураций сетевых устройств в структурированные данные. Шаблоны хранятся в директории `oxi/interfaces/models/templates/`.
+
+## Содержание
+
+- [Структура шаблона](#структура-шаблона)
+- [Обязательные группы](#обязательные-группы)
+- [Секция system](#секция-system)
+- [Секция interfaces](#секция-interfaces)
+- [Секция vlans](#секция-vlans)
+- [TTP: основные возможности](#ttp-основные-возможности)
+- [Переменные по умолчанию](#переменные-по-умолчанию)
+- [Практические примеры](#практические-примеры)
+- [Валидация шаблона](#валидация-шаблона)
+
+---
+
+## Структура шаблона
+
+Каждый шаблон — это `.ttp`-файл, состоящий из следующих блоков:
+
+```xml
+<doc>
+    Описание шаблона (опционально)
+</doc>
+
+<vars>
+    <!-- Переменные по умолчанию для групп -->
+</vars>
+
+<group name="system">
+    <!-- Правила для системной информации -->
+</group>
+
+<group name="interfaces">
+    <!-- Правила для интерфейсов -->
+</group>
+
+<group name="vlans">
+    <!-- Правила для VLAN (опционально) -->
+</group>
+```
+
+Файл-заготовка находится в `oxi/interfaces/models/templates/_template.ttp`.
+
+---
+
+## Обязательные группы
+
+Фреймворк требует наличия в шаблоне **двух обязательных групп**:
+
+| Группа       | Обязательна | Описание                      |
+|--------------|-------------|-------------------------------|
+| `system`     | Да          | Системная информация          |
+| `interfaces` | Да          | Конфигурация интерфейсов      |
+| `vlans`      | Нет         | Конфигурация VLAN             |
+
+Если обязательная группа отсутствует в шаблоне или TTP не вернул её данные, будет выброшено `ValueError`.
+
+---
+
+## Секция system
+
+Должна возвращать словарь со следующими полями:
+
+| Поле            | Тип  | Обязательное | Описание            |
+|-----------------|------|--------------|---------------------|
+| `model`         | str  | Да           | Модель устройства   |
+| `serial_number` | str  | Да           | Серийный номер      |
+| `version`       | str  | Да           | Версия прошивки     |
+
+**Пример (MikroTik):**
+
+Конфигурация:
+```
+# version: 7.12.1 (stable)
+# model = RB951Ui-2nD
+# serial number = B88C0B31117B
+```
+
+Шаблон:
+```
+<group name="system">
+# version: {{ version }}{{ ignore('.*') }}
+# model = {{ model }}
+# serial number = {{ serial_number }}
+</group>
+```
+
+**Пример (Keenetic):**
+
+Конфигурация:
+```
+! release: 4.1.7.1-1
+! model: Keenetic Extra
+! hw_version: F02B4E7A1C90
+```
+
+Шаблон:
+```
+<group name="system">
+! release: {{ version }}
+! model: {{ model | ORPHRASE }}
+! hw_version: {{ serial_number }}
+</group>
+```
+
+---
+
+## Секция interfaces
+
+Должна возвращать список словарей. Каждый словарь описывает один интерфейс.
+
+Поля, которые ожидает контракт `Interfaces`:
+
+| Поле          | TTP-имя / alias | Тип              | Обязательное |
+|---------------|-----------------|------------------|--------------|
+| `name`        | `interface`     | str              | Да           |
+| `ip_address`  | `ip_address`    | IPv4Address      | Нет          |
+| `mask`        | `mask`          | int (prefix len) | Нет          |
+| `description` | `description`   | str              | Нет          |
+
+> **Важно:** поле `name` в Pydantic-модели имеет алиас `interface`, поэтому в шаблоне переменную нужно называть именно `interface` **или** переопределить метод `interfaces()` в классе модели (см. [Расширение моделей](extending-models.md)).
+
+**Пример (MikroTik):**
+
+Конфигурация:
+```
+/ip address
+add address=192.168.1.1/24 interface=ether1 network=192.168.1.0
+add address=10.0.0.1/30 comment="WAN link" interface=ether2 network=10.0.0.0
+```
+
+Шаблон:
+```
+<group name="interfaces">
+/ip address
+add address={{ ip_address | _start_ }}/{{ mask }} interface={{ interface }} network={{ network }}
+add address={{ ip_address | _start_ }}/{{ mask }} comment={{ description | ORPHRASE | strip('"') }} interface={{ interface }} network={{ network }}
+</group>
+```
+
+**Пример (Keenetic):**
+
+Конфигурация:
+```
+interface GigabitEthernet0/0
+    description "WAN"
+    ip address 10.0.0.2 255.255.255.252
+interface GigabitEthernet0/1
+    ip address 192.168.1.1 255.255.255.0
+```
+
+Шаблон:
+```
+<group name="interfaces">
+interface {{ name | _start_ | exclude("Vlan") }}
+    description {{ description | ORPHRASE }}
+    ip address {{ ip_address }} {{ netmask }}
+</group>
+```
+
+Здесь переменная называется `name`, а не `interface` — это покрывается переопределением метода `interfaces()` в классе `Keenetic`.
+
+---
+
+## Секция vlans
+
+Необязательная группа. Если объявлена в шаблоне, фреймворк ожидает её наличия в результате TTP.
+
+Поля контракта `Vlans`:
+
+| Поле      | TTP-имя / alias | Тип  | Обязательное |
+|-----------|-----------------|------|--------------|
+| `vlan_id` | `id`            | int  | Да           |
+| `name`    | `description`   | str  | Нет          |
+
+> `vlan_id` имеет алиас `id`, поэтому в шаблоне переменная должна называться `id` либо переименовываться в методе `vlans()`.
+
+**Пример (Keenetic):**
+
+Конфигурация:
+```
+interface Bridge0/Vlan10
+    description "MGMT"
+interface Bridge0/Vlan20
+    description "SERVERS"
+```
+
+Шаблон:
+```
+<group name="vlans">
+interface {{ ignore }}/Vlan{{ id }}
+    description {{ description | ORPHRASE | strip('"') }}
+</group>
+```
+
+---
+
+## TTP: основные возможности
+
+### Маркеры строк
+
+| Маркер      | Описание                                                      |
+|-------------|---------------------------------------------------------------|
+| `_start_`   | Строка с этой переменной считается началом нового совпадения  |
+| `_end_`     | Строка с этой переменной завершает совпадение группы          |
+
+```
+add address={{ ip_address | _start_ }}/{{ mask }} interface={{ name }}
+```
+
+### Модификаторы переменных
+
+| Модификатор            | Описание                                                  |
+|------------------------|-----------------------------------------------------------|
+| `ORPHRASE`             | Захватывает одно слово или фразу (до конца строки)        |
+| `exclude("pattern")`   | Пропускает строку, если захваченное значение содержит паттерн |
+| `strip('"')`           | Удаляет символ из начала и конца захваченного значения    |
+| `replace("old","new")` | Заменяет подстроку в захваченном значении                 |
+| `re("pattern")`        | Принимает значение, только если оно соответствует regex   |
+| `ignore`               | Захватывает, но игнорирует значение (не включает в результат) |
+| `ignore('.*')`         | Игнорирует всё до конца строки                            |
+
+### Комментарии в шаблоне
+
+Строки, начинающиеся с `##`, — это комментарии TTP и не влияют на парсинг:
+
+```
+## disabled no comment
+add address={{ ip_address | _start_ }}/{{ mask }} interface={{ name }}
+```
+
+---
+
+## Переменные по умолчанию
+
+Блок `<vars>` позволяет задавать значения по умолчанию для группы через атрибут `default`:
+
+```xml
+<vars>
+default_system = {
+    "model": "",
+    "serial_number": ""
+}
+</vars>
+
+<group name="system" default="default_system">
+# version: {{ version }}
+# model = {{ model }}
+# serial number = {{ serial_number }}
+</group>
+```
+
+Если шаблон не нашёл совпадений для группы, будет возвращён словарь из `default_system`.
+
+---
+
+## Практические примеры
+
+### Полный шаблон для нового устройства (пример: Cisco IOS)
+
+```xml
+<doc>
+    Шаблон для парсинга Cisco IOS running-config
+</doc>
+
+<vars>
+default_system = {
+    "model": "",
+    "serial_number": "",
+    "version": ""
+}
+</vars>
+
+<group name="system" default="default_system">
+Cisco IOS Software, {{ ignore }} Version {{ version }},{{ ignore('.*') }}
+Model Number         : {{ model }}
+System serial number : {{ serial_number }}
+</group>
+
+<group name="interfaces">
+interface {{ interface | _start_ }}
+ description {{ description | ORPHRASE }}
+ ip address {{ ip_address }} {{ netmask }}
+ shutdown {{ shutdown | set("True") }}
+</group>
+
+<group name="vlans">
+vlan {{ id | _start_ }}
+ name {{ description }}
+</group>
+```
+
+---
+
+## Валидация шаблона
+
+Фреймворк автоматически выполняет два уровня проверки:
+
+1. **Валидация структуры шаблона** — при создании объекта устройства парсятся XML-теги `<group>` и проверяется наличие обязательных секций (`system`, `interfaces`).
+
+2. **Валидация результата парсинга** — после запуска TTP проверяется, что обязательные группы действительно присутствуют в результате (т.е. конфигурация содержала соответствующие строки).
+
+При нарушении любого условия выбрасывается `ValueError` с подробным описанием проблемы.

oxi/__init__.py

@@ -0,0 +1,6 @@
+from .core import OxiAPI
+
+
+__all__ = [
+    "OxiAPI",
+]

oxi/conf.py

@@ -0,0 +1,86 @@
+from functools import cached_property
+import json
+from typing import TYPE_CHECKING, Generic, Iterator, Type, TypeVar
+
+from pydantic import BaseModel
+
+from .interfaces import BaseDevice, device_registry
+
+if TYPE_CHECKING:
+    from requests import Session
+
+TModel = TypeVar("TModel", bound=BaseModel)
+
+
+class ModelView(Generic[TModel]):
+    def __init__(self, model: TModel | list[TModel]):
+        self._model = model
+
+    def json(self) -> str:
+        if isinstance(self._model, list):
+            return json.dumps(
+                [item.model_dump(by_alias=True) for item in self._model],
+                ensure_ascii=False,
+            )
+        return self._model.model_dump_json(by_alias=True)
+
+    def __iter__(self) -> Iterator[TModel]:
+        if isinstance(self._model, list):
+            return iter(self._model)
+        raise TypeError("This view wraps a single model, not a list")
+
+    def __len__(self) -> int:
+        if isinstance(self._model, list):
+            return len(self._model)
+        raise TypeError("This view wraps a single model, not a list")
+
+    def __getitem__(self, item):
+        if isinstance(self._model, list):
+            return self._model[item]
+        raise TypeError("This view wraps a single model, not a list")
+
+    def __getattr__(self, item):
+        return getattr(self._model, item)
+
+    def __repr__(self) -> str:
+        return repr(self._model)
+
+
+class NodeConfig:
+    def __init__(self, session: "Session", full_name: str, model: str, base_url: str):
+        self._session = session
+        self._full_name = full_name
+        self._model = model.lower()
+        self._url = f"{base_url}/node/fetch/{full_name}"
+        self._device: type[BaseDevice] = device_registry.get(self._model.lower())
+        if self._device is None:
+            raise ValueError(f"Device model '{self._model}' not found in registry")
+        self._parsed_data = self._device(self.text).parse()
+
+    @cached_property
+    def _response(self):
+        response = self._session.get(self._url)
+        response.raise_for_status()
+        return response
+
+    @property
+    def text(self):
+        return self._response.text
+
+    def json(self):
+        return self._parsed_data.model_dump_json()
+
+    def __str__(self):
+        return self.text
+
+    @property
+    def vlans(self):
+        return ModelView(self._parsed_data.vlans)
+
+    @property
+    def interfaces(self):
+        return ModelView(self._parsed_data.interfaces)
+
+    @property
+    def system(self):
+        return ModelView(self._parsed_data.system)

oxi/core.py

@@ -0,0 +1,28 @@
+from typing import Optional
+from requests import Session
+from .node import Node
+
+
+class OxiAPI:
+    def __init__(
+        self,
+        url: str,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        verify: bool = True,
+    ):
+        self.base_url = url.rstrip("/")
+        self._session = Session()
+        self._session.verify = verify
+        if username and password:
+            self._session.auth = (username, password)
+        self.node = Node(self._session, self.base_url)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+    def close(self):
+        return self._session.close()

oxi/interfaces/__init__.py

@@ -0,0 +1,26 @@
+from typing import Callable, Type
+
+from .base import BaseDevice
+
+device_registry = {}
+
+
+def register_parser(
+    name: list[str],
+) -> Callable[[Type[BaseDevice]], Type[BaseDevice]]:
+    def wrapper(cls):
+        name_list = []
+        if isinstance(name, str):
+            name_list.append(name)
+        else:
+            name_list.extend(name)
+        for item in name_list:
+            device_registry[item.lower()] = cls
+        return cls
+
+    return wrapper
+
+
+from . import models  # noqa: E402, F401
+
+__all__ = ["register_parser", "device_registry"]

oxi/interfaces/base.py

@@ -0,0 +1,130 @@
+from abc import ABC, abstractmethod
+from pathlib import Path
+from ttp import ttp
+from oxi.interfaces.contract import Device
+import xml.etree.ElementTree as ET
+from oxi.interfaces.contract import Interfaces, System, Vlans
+
+
+class BaseDevice(ABC):
+    _REQUIRED_SECTIONS: frozenset[str] = frozenset({"system", "interfaces"})
+    _OPTIONAL_SECTIONS: frozenset[str] = frozenset({"vlans"})
+
+    def __init__(self, config: str):
+        self.config: str = config
+
+        self._loaded_template = self._load_template()
+        self._declared_sections = None
+        self._validate_template_groups()
+        self.raw: dict = self._run_ttp()
+
+    @property
+    @abstractmethod
+    def template(self) -> str:
+        """
+        Expected structure:
+            Название файла с парсером ttp
+        Returns:
+            None
+        """
+
+    def vlans(self) -> list[dict]:
+        """
+        Parse VLAN configuration from self.raw['vlans'].
+
+        Expected structure:
+            [{"id": 10, "description": "MGMT"}, {"id": 15, "name": "SSH"}, ...]
+
+        Returns:
+            list[Vlans]: список VLAN из секции vlans,
+                пустой список если секция отсутствует.
+
+        Raises:
+            ValueError: если raw содержит некорректные данные.
+        """
+        return self.raw.get("vlans", [])
+
+    def interfaces(self) -> list[dict]:
+        """
+        Parse Interface configuration from self.raw['interfaces'].
+
+        Expected raw structure:
+            [{"name": "GEthernet1/0/1", "ip_address": "192.168.1.1", "mask": "24", "description": "IPBB interface"}]
+
+        Raises:
+            ValueError: если raw содержит некорректные данные.
+        """
+        return self.raw.get("interfaces", [])
+
+    def system(self) -> dict:
+        """
+        Parse System configuration from self.raw['system'].
+
+        Expected raw structure:
+            {"model":"RB951Ui-2nD", serial_number: "B88C0B31117B", "version": "7.12.1"}
+
+        Raises:
+            ValueError: если raw содержит некорректные данные.
+        """
+        return self.raw.get("system", None)
+
+    def _validate_contract(self) -> dict:
+        system_data = self.system()
+        interfaces_data = self.interfaces() or []
+        result = {
+            "system": System(**system_data),
+            "interfaces": [Interfaces(**item) for item in interfaces_data],
+            "vlans": [],
+        }
+
+        if "vlans" in self._declared_sections:
+            if "vlans" not in self.raw:
+                raise ValueError(
+                    f"{self.__class__.__name__}: template '{self.template}' declares optional group "
+                    f"'vlans', but TTP did not return it."
+                )
+            vlans_data = self.vlans() or []
+            result["vlans"] = [Vlans(**item) for item in vlans_data]
+        return result
+
+    def _load_template(self):
+        """Подгрузка темплейтов из папки models/templates"""
+        path = Path(__file__).parent / "models" / "templates" / self.template
+        if not path.exists():
+            raise FileNotFoundError(f"Template {self.template} not found")
+        return path.read_text(encoding="utf-8")
+
+    def _validate_template_groups(self) -> None:
+        """Проверяем только обязательные группы в template."""
+        try:
+            root = ET.fromstring(self._loaded_template)
+        except ET.ParseError:
+            root = ET.fromstring(f"<template>{self._loaded_template}</template>")
+
+        declared = {g.get("name") for g in root.iter("group") if g.get("name")}
+        self._declared_sections = declared
+
+        missing_required = self._REQUIRED_SECTIONS - declared
+        if missing_required:
+            raise ValueError(
+                f"{self.__class__.__name__}: template '{self.template}' "
+                f"missing required groups: {sorted(missing_required)}. "
+                f"Declared groups: {sorted(declared)}"
+            )
+
+    def _run_ttp(self) -> dict:
+        """Основной парсер"""
+        p = ttp(data=self.config, template=self._loaded_template)
+        p.parse()
+        raw: dict = p.result()[0][0]
+        missing = self._REQUIRED_SECTIONS - raw.keys()
+        if missing:
+            raise ValueError(
+                f"{self.__class__.__name__}: TTP template '{self.template}' "
+                f"did not produce required groups: {sorted(missing)}. "
+                f"Return only: {(raw.keys())}"
+            )
+        return raw
+
+    def parse(self) -> Device:
+        return Device(**self._validate_contract())

oxi/interfaces/contract.py

@@ -0,0 +1,42 @@
+from ipaddress import IPv4Address
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class Base(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class System(BaseModel):
+    """
+    Requred
+    """
+
+    model: str
+    serial_number: str
+    version: str
+
+
+class Interfaces(Base):
+    """
+    Requred
+    """
+
+    name: str = Field(alias="interface")
+    ip_address: IPv4Address | None = None
+    mask: int | None = None
+    description: str | None = None
+
+
+class Vlans(Base):
+    """
+    Optional
+    """
+
+    vlan_id: int = Field(alias="id")
+    name: str | None = Field(default=None, alias="description")
+
+
+class Device(BaseModel):
+    system: System
+    interfaces: list[Interfaces]
+    vlans: list[Vlans] = []

oxi/interfaces/models/__init__.py

@@ -0,0 +1,7 @@
+import importlib
+import pkgutil
+
+package = __package__
+
+for loader, module_name, is_pkg in pkgutil.iter_modules(__path__):
+    importlib.import_module(f"{package}.{module_name}")

oxi/interfaces/models/keenetic.py

@@ -0,0 +1,49 @@
+from ipaddress import ip_interface
+from oxi.interfaces import register_parser
+from oxi.interfaces.base import BaseDevice
+
+
+@register_parser(["NDMS", "keenetic", "KeeneticOS"])
+class Keenetic(BaseDevice):
+    template = "keenetic.ttp"
+
+    def _decode_utf(self, text: str):
+        if "\\x" in text:
+            desc = text.strip('"')
+            decoded = (
+                desc.encode("utf-8")
+                .decode("unicode_escape")
+                .encode("latin1")
+                .decode("utf-8")
+            )
+            return decoded
+        return text
+
+    def interfaces(self):
+        interfaces: list[dict] = self.raw["interfaces"]
+        for item in interfaces:
+            if item.get("ip_address") and item.get("netmask"):
+                ipaddress = ip_interface(
+                    f"{item.get('ip_address')}/{item.get('netmask')}"
+                )
+                item["mask"] = ipaddress.network.prefixlen
+                item.pop("netmask", "Key not found")
+            if item.get("description"):
+                decoded = self._decode_utf(item.get("description", ""))
+                item["description"] = decoded
+        return interfaces
+
+    def vlans(self):
+        vlans = self.raw["vlans"]
+        for item in vlans:
+            if item.get("description"):
+                decoded = self._decode_utf(item.get("description", ""))
+                item["description"] = decoded
+        return vlans
+
+
+if __name__ == "__main__":
+    with open("./test2.txt") as file:
+        data = file.read()
+    mikr = Keenetic(data)
+    print(mikr.parse().model_dump_json())

oxi/interfaces/models/mikrotik.py

@@ -0,0 +1,16 @@
+import os
+from oxi.interfaces import register_parser
+from oxi.interfaces.base import BaseDevice
+
+
+@register_parser(["routeros", "ros", "mikrotik"])
+class Mikrotik(BaseDevice):
+    template = "mikrotik.ttp"
+
+
+if __name__ == "__main__":
+    print(os.path.abspath(os.curdir))
+    with open("./test.txt") as file:
+        data = file.read()
+    mikr = Mikrotik(data)
+    print(mikr.parse().json())

oxi/interfaces/models/qtech.py

@@ -0,0 +1,49 @@
+from ipaddress import ip_interface
+import os
+from oxi.interfaces import register_parser
+from oxi.interfaces.base import BaseDevice
+
+
+@register_parser(["QTECH"])
+class Qtech(BaseDevice):
+    template = "qtech.ttp"
+
+    def interfaces(self) -> list[dict]:
+        interfaces_ttp = self.raw["interfaces"]
+        for item in interfaces_ttp:
+            if item.get("ip_address") and item.get("netmask"):
+                ipaddress = ip_interface(
+                    f"{item.get('ip_address')}/{item.get('netmask')}"
+                )
+                item["mask"] = ipaddress.network.prefixlen
+                item.pop("netmask", "Key not found")
+        return interfaces_ttp
+
+    def vlans(self) -> list[dict]:
+        vlans_ttp = self.raw["vlans"]
+        vlans = []
+        named_vlan = set()
+        for item in vlans_ttp:
+            if item.get("vlan_id"):
+                named_vlan.add(item.get("vlan_id"))
+                vlans.append(item)
+            else:
+                ids = item.get("vlan_ids", "")
+                tail = item.get("vlan_tail")
+                if tail:
+                    ids = f"{ids},{tail}"
+                for vid in ids.split(","):
+                    vid = vid.strip()
+                    if vid in named_vlan:
+                        continue
+                    vlans.append({"vlan_id": vid})
+        return vlans
+
+
+if __name__ == "__main__":
+    print(os.path.abspath(os.curdir))
+    with open("./test3.txt") as file:
+        data = file.read()
+    qtech = Qtech(data)
+    qt = qtech.parse()
+    # print(qt)

oxi/interfaces/models/templates/_template.ttp

@@ -0,0 +1,58 @@
+<doc>
+Базовый шаблон для нового устройства. Скопируйте этот файл, переименуйте
+в <vendor>.ttp и заполните группы под формат конфигурации вашего устройства.
+
+Обязательные группы: system, interfaces.
+Опциональная группа: vlans — добавляйте только если устройство поддерживает VLAN.
+
+--- Группа system ---
+Должна возвращать одиночный словарь с полями:
+  model         (str)  — модель устройства
+  serial_number (str)  — серийный номер
+  version       (str)  — версия прошивки
+
+--- Группа interfaces ---
+Должна возвращать список словарей. Каждый элемент:
+  interface     (str)           — имя интерфейса (alias поля name)
+  ip_address    (str|None)      — IPv4-адрес
+  mask          (int|None)      — длина префикса (напр. 24)
+  description   (str|None)      — описание интерфейса
+
+  Если устройство возвращает маску в виде 255.255.255.0, конвертируйте
+  её в prefix length в методе interfaces() класса устройства.
+
+--- Группа vlans ---
+Должна возвращать список словарей. Каждый элемент:
+  id            (int)      — номер VLAN (alias поля vlan_id)
+  description   (str|None) — название VLAN (alias поля name)
+
+--- Полезные модификаторы TTP ---
+  {{ field | ORPHRASE }}              — одно слово или фраза до конца строки
+  {{ field | _start_ }}               — начало новой записи группы
+  {{ field | strip('"') }}            — убрать кавычки
+  {{ field | replace("yes","True") }} — замена подстроки
+  {{ field | exclude("pattern") }}    — пропустить строку при совпадении
+  {{ ignore }}                        — захватить и выбросить значение
+  {{ ignore('.*') }}                  — выбросить всё до конца строки
+
+Подробнее: docs/templates.md
+</doc>
+<vars>
+default_system = {
+    "model": "",
+    "serial_number": "",
+    "version": ""
+}
+</vars>
+
+<group name="system" default="default_system">
+    ...
+</group>
+
+<group name="interfaces">
+    ...
+</group>
+
+<group name="vlans">
+    ...
+</group>

oxi/interfaces/models/templates/keenetic.ttp

@@ -0,0 +1,29 @@
+<doc>
+</doc>
+<vars>
+default_system = {
+    "model": "",
+    "serial_number": ""
+}
+default_interfaces = {}
+</vars>
+
+<group name="system" default="default_system">
+! release: {{ version }}
+! model: {{ model | ORPHRASE }}
+! hw_version: {{ serial_number }}
+</group>
+
+<group name="interfaces">
+interface {{ name | _start_ | exclude("Vlan") }}
+    rename {{ rename }}
+    description {{ description | ORPHRASE | strip('"') }}
+    ip address {{ ip_address }} {{ netmask }}
+    {{ shutdown | re("up") | replace("up","False") | strip('"') }}
+    {{ shutdown | re("down") | replace("down","True") | strip('"') }}
+</group>
+
+<group name="vlans">
+interface {{ ignore }}/Vlan{{ vlan_id }}
+    description {{ description | ORPHRASE | strip('"') }}
+</group>

oxi/interfaces/models/templates/mikrotik.ttp

@@ -0,0 +1,47 @@
+<doc>
+    some templates
+</doc>
+<vars>
+default_system = {
+    "model": "",
+    "serial_number": ""
+}
+default_interfaces = {
+    "disabled": "False"
+}
+default_vlans = {
+    "disabled": "False",
+    "mtu": None
+    }
+</vars>
+
+<group name="system" default="default_system">
+# version: {{ version }}{{ ignore('.*') }}
+# model = {{ model }}
+# serial number = {{ serial_number }}
+</group>
+
+<group name="interfaces" default="default_interfaces">
+/ip address
+## not disabled and no comment
+add address={{ ip_address | _start_ }}/{{ mask }} interface={{ name }} network={{ network }}
+## not disabled and comment with/without quotes
+add address={{ ip_address | _start_ }}/{{ mask }} comment={{ description | ORPHRASE | exclude("disabled=") | strip('"')}} interface={{ name }} network={{ network }}
+## disabled no comment
+add address={{ ip_address | _start_ }}/{{ mask }} disabled={{ disabled | replace("yes","True") | strip('"')}} interface={{ name }} network={{ network }}
+## disabled with comment with/without quotes
+add address={{ ip_address | _start_ }}/{{ mask }} comment={{ description | ORPHRASE | exclude("disabled=") | strip('"') }} disabled={{ disabled }} interface={{ name }} network={{ network }}
+</group>
+
+<group name="vlans">
+/interface vlan
+## not disabled and no comment
+add interface={{ interface | _start_ }} name={{ name | ORPHRASE | strip('"') }} vlan-id={{ vlan_id }}
+## not disabled and comment with/without quotes
+add comment={{ comment | _start_ | ORPHRASE | exclude("disabled=") | strip('"')}} interface={{ interface }} name={{ name | ORPHRASE | strip('"') }} vlan-id={{ vlan_id }}
+## disabled with comment with/without quotes
+add comment={{ comment | _start_ | ORPHRASE | exclude("disabled=") | strip('"')}} disabled={{ disabled | replace("yes","True") | strip('"') }} interface={{ interface }} name={{ name | ORPHRASE | strip('"') }} vlan-id={{ vlan_id }}
+## disabled no comment
+add interface={{ interface | _start_ }} name={{ name | ORPHRASE | strip('"') }} vlan-id={{ vlan_id }} disabled={{ disabled | replace("yes","True") | strip('"') }}
+</group>
+

oxi/interfaces/models/templates/qtech.ttp

@@ -0,0 +1,27 @@
+<doc>
+</doc>
+<vars>
+default_system = {
+    "model": "",
+    "serial_number": "",
+    "version": ""
+}
+</vars>
+
+<group name="system" default="default_system">
+! {{ model | ORPHRASE }} Series Software, Version {{ ignore }} Build {{ version | strip(",") }}{{ ignore('.*') }}
+! Serial num:{{ serial_number | strip(",") }}{{ ignore('.*') }}
+</group>
+
+<group name="interfaces">
+interface {{ interface }}
+ description {{ description | ORPHRASE }}
+ ip address {{ ip_address }} {{ netmask }}
+</group>
+
+<group name="vlans">
+vlan {{ vlan_ids | contains(",", "-") | unrange("-", ",") | _start_ }}
+,{{ vlan_tail | unrange("-", ",") }}
+vlan {{ vlan_id | _start_ }}
+ name {{ name | ORPHRASE }}
+</group>

oxi/node.py

@@ -0,0 +1,25 @@
+from typing import TYPE_CHECKING
+
+from .view import NodeView
+
+
+if TYPE_CHECKING:
+    from requests import Session
+
+
+class Node:
+    def __init__(self, session: "Session", base_url: str):
+        self._session = session
+        self._base_url = base_url
+        self._data = None
+
+    def __call__(self, name: str) -> NodeView:
+        url = f"{self._base_url}/node/show/{name}"
+        if not url.endswith(".json"):
+            url += ".json"
+        response = self._session.get(url)
+        if response.status_code == 500:
+            raise ValueError(f"page {url} not found")
+        return NodeView(
+            session=self._session, base_url=self._base_url, data=response.json()
+        )

oxi/view.py

@@ -0,0 +1,35 @@
+from functools import cached_property
+from typing import TYPE_CHECKING
+
+from .conf import NodeConfig
+
+
+if TYPE_CHECKING:
+    from requests import Session
+
+
+class NodeView:
+    def __init__(self, session: "Session", base_url: str, data: dict):
+        self._session = session
+        self._base_url = base_url
+        self._data = data
+
+    @property
+    def ip(self):
+        return self._data.get("ip")
+
+    @property
+    def full_name(self):
+        return self._data.get("full_name")
+
+    @property
+    def group(self):
+        return self._data.get("group")
+
+    @property
+    def model(self):
+        return self._data.get("model")
+
+    @cached_property
+    def config(self):
+        return NodeConfig(self._session, self.full_name, self.model, self._base_url)

pyproject.toml

@@ -7,9 +7,11 @@ name = "oxipy"
 version = "0.1.0"
 description = "Oxi API client"
 readme = "README.md"
-requires-python = ">=3.13"
+requires-python = ">=3.11"
 dependencies = [
+    "pydantic>=2.12.5",
     "requests>=2.32.5",
+    "ttp>=0.10.0",
 ]
 [tool.setuptools.packages.find]
 where = ["."]

uv.lock

@@ -0,0 +1,210 @@
+version = 1
+revision = 3
+requires-python = ">=3.13"
+
+[[package]]
+name = "annotated-types"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.1.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/2d/a891ca51311197f6ad14a7ef42e2399f36cf2f9bd44752b3dc4eab60fdc5/certifi-2026.1.4.tar.gz", hash = "sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120", size = 154268, upload-time = "2026-01-04T02:42:41.825Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e6/ad/3cc14f097111b4de0040c83a525973216457bbeeb63739ef1ed275c1c021/certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c", size = 152900, upload-time = "2026-01-04T02:42:40.15Z" },
+]
+
+[[package]]
+name = "charset-normalizer"
+version = "3.4.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/13/69/33ddede1939fdd074bce5434295f38fae7136463422fe4fd3e0e89b98062/charset_normalizer-3.4.4.tar.gz", hash = "sha256:94537985111c35f28720e43603b8e7b43a6ecfb2ce1d3058bbe955b73404e21a", size = 129418, upload-time = "2025-10-14T04:42:32.879Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/97/45/4b3a1239bbacd321068ea6e7ac28875b03ab8bc0aa0966452db17cd36714/charset_normalizer-3.4.4-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:e1f185f86a6f3403aa2420e815904c67b2f9ebc443f045edd0de921108345794", size = 208091, upload-time = "2025-10-14T04:41:13.346Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/62/73a6d7450829655a35bb88a88fca7d736f9882a27eacdca2c6d505b57e2e/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b39f987ae8ccdf0d2642338faf2abb1862340facc796048b604ef14919e55ed", size = 147936, upload-time = "2025-10-14T04:41:14.461Z" },
+    { url = "https://files.pythonhosted.org/packages/89/c5/adb8c8b3d6625bef6d88b251bbb0d95f8205831b987631ab0c8bb5d937c2/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3162d5d8ce1bb98dd51af660f2121c55d0fa541b46dff7bb9b9f86ea1d87de72", size = 144180, upload-time = "2025-10-14T04:41:15.588Z" },
+    { url = "https://files.pythonhosted.org/packages/91/ed/9706e4070682d1cc219050b6048bfd293ccf67b3d4f5a4f39207453d4b99/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:81d5eb2a312700f4ecaa977a8235b634ce853200e828fbadf3a9c50bab278328", size = 161346, upload-time = "2025-10-14T04:41:16.738Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/0d/031f0d95e4972901a2f6f09ef055751805ff541511dc1252ba3ca1f80cf5/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5bd2293095d766545ec1a8f612559f6b40abc0eb18bb2f5d1171872d34036ede", size = 158874, upload-time = "2025-10-14T04:41:17.923Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/83/6ab5883f57c9c801ce5e5677242328aa45592be8a00644310a008d04f922/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a8a8b89589086a25749f471e6a900d3f662d1d3b6e2e59dcecf787b1cc3a1894", size = 153076, upload-time = "2025-10-14T04:41:19.106Z" },
+    { url = "https://files.pythonhosted.org/packages/75/1e/5ff781ddf5260e387d6419959ee89ef13878229732732ee73cdae01800f2/charset_normalizer-3.4.4-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc7637e2f80d8530ee4a78e878bce464f70087ce73cf7c1caf142416923b98f1", size = 150601, upload-time = "2025-10-14T04:41:20.245Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/57/71be810965493d3510a6ca79b90c19e48696fb1ff964da319334b12677f0/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f8bf04158c6b607d747e93949aa60618b61312fe647a6369f88ce2ff16043490", size = 150376, upload-time = "2025-10-14T04:41:21.398Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/d5/c3d057a78c181d007014feb7e9f2e65905a6c4ef182c0ddf0de2924edd65/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:554af85e960429cf30784dd47447d5125aaa3b99a6f0683589dbd27e2f45da44", size = 144825, upload-time = "2025-10-14T04:41:22.583Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/8c/d0406294828d4976f275ffbe66f00266c4b3136b7506941d87c00cab5272/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:74018750915ee7ad843a774364e13a3db91682f26142baddf775342c3f5b1133", size = 162583, upload-time = "2025-10-14T04:41:23.754Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/24/e2aa1f18c8f15c4c0e932d9287b8609dd30ad56dbe41d926bd846e22fb8d/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c0463276121fdee9c49b98908b3a89c39be45d86d1dbaa22957e38f6321d4ce3", size = 150366, upload-time = "2025-10-14T04:41:25.27Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/5b/1e6160c7739aad1e2df054300cc618b06bf784a7a164b0f238360721ab86/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:362d61fd13843997c1c446760ef36f240cf81d3ebf74ac62652aebaf7838561e", size = 160300, upload-time = "2025-10-14T04:41:26.725Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/10/f882167cd207fbdd743e55534d5d9620e095089d176d55cb22d5322f2afd/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9a26f18905b8dd5d685d6d07b0cdf98a79f3c7a918906af7cc143ea2e164c8bc", size = 154465, upload-time = "2025-10-14T04:41:28.322Z" },
+    { url = "https://files.pythonhosted.org/packages/89/66/c7a9e1b7429be72123441bfdbaf2bc13faab3f90b933f664db506dea5915/charset_normalizer-3.4.4-cp313-cp313-win32.whl", hash = "sha256:9b35f4c90079ff2e2edc5b26c0c77925e5d2d255c42c74fdb70fb49b172726ac", size = 99404, upload-time = "2025-10-14T04:41:29.95Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/26/b9924fa27db384bdcd97ab83b4f0a8058d96ad9626ead570674d5e737d90/charset_normalizer-3.4.4-cp313-cp313-win_amd64.whl", hash = "sha256:b435cba5f4f750aa6c0a0d92c541fb79f69a387c91e61f1795227e4ed9cece14", size = 107092, upload-time = "2025-10-14T04:41:31.188Z" },
+    { url = "https://files.pythonhosted.org/packages/af/8f/3ed4bfa0c0c72a7ca17f0380cd9e4dd842b09f664e780c13cff1dcf2ef1b/charset_normalizer-3.4.4-cp313-cp313-win_arm64.whl", hash = "sha256:542d2cee80be6f80247095cc36c418f7bddd14f4a6de45af91dfad36d817bba2", size = 100408, upload-time = "2025-10-14T04:41:32.624Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/35/7051599bd493e62411d6ede36fd5af83a38f37c4767b92884df7301db25d/charset_normalizer-3.4.4-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:da3326d9e65ef63a817ecbcc0df6e94463713b754fe293eaa03da99befb9a5bd", size = 207746, upload-time = "2025-10-14T04:41:33.773Z" },
+    { url = "https://files.pythonhosted.org/packages/10/9a/97c8d48ef10d6cd4fcead2415523221624bf58bcf68a802721a6bc807c8f/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8af65f14dc14a79b924524b1e7fffe304517b2bff5a58bf64f30b98bbc5079eb", size = 147889, upload-time = "2025-10-14T04:41:34.897Z" },
+    { url = "https://files.pythonhosted.org/packages/10/bf/979224a919a1b606c82bd2c5fa49b5c6d5727aa47b4312bb27b1734f53cd/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74664978bb272435107de04e36db5a9735e78232b85b77d45cfb38f758efd33e", size = 143641, upload-time = "2025-10-14T04:41:36.116Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/33/0ad65587441fc730dc7bd90e9716b30b4702dc7b617e6ba4997dc8651495/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:752944c7ffbfdd10c074dc58ec2d5a8a4cd9493b314d367c14d24c17684ddd14", size = 160779, upload-time = "2025-10-14T04:41:37.229Z" },
+    { url = "https://files.pythonhosted.org/packages/67/ed/331d6b249259ee71ddea93f6f2f0a56cfebd46938bde6fcc6f7b9a3d0e09/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d1f13550535ad8cff21b8d757a3257963e951d96e20ec82ab44bc64aeb62a191", size = 159035, upload-time = "2025-10-14T04:41:38.368Z" },
+    { url = "https://files.pythonhosted.org/packages/67/ff/f6b948ca32e4f2a4576aa129d8bed61f2e0543bf9f5f2b7fc3758ed005c9/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ecaae4149d99b1c9e7b88bb03e3221956f68fd6d50be2ef061b2381b61d20838", size = 152542, upload-time = "2025-10-14T04:41:39.862Z" },
+    { url = "https://files.pythonhosted.org/packages/16/85/276033dcbcc369eb176594de22728541a925b2632f9716428c851b149e83/charset_normalizer-3.4.4-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:cb6254dc36b47a990e59e1068afacdcd02958bdcce30bb50cc1700a8b9d624a6", size = 149524, upload-time = "2025-10-14T04:41:41.319Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/f2/6a2a1f722b6aba37050e626530a46a68f74e63683947a8acff92569f979a/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c8ae8a0f02f57a6e61203a31428fa1d677cbe50c93622b4149d5c0f319c1d19e", size = 150395, upload-time = "2025-10-14T04:41:42.539Z" },
+    { url = "https://files.pythonhosted.org/packages/60/bb/2186cb2f2bbaea6338cad15ce23a67f9b0672929744381e28b0592676824/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:47cc91b2f4dd2833fddaedd2893006b0106129d4b94fdb6af1f4ce5a9965577c", size = 143680, upload-time = "2025-10-14T04:41:43.661Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/a5/bf6f13b772fbb2a90360eb620d52ed8f796f3c5caee8398c3b2eb7b1c60d/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:82004af6c302b5d3ab2cfc4cc5f29db16123b1a8417f2e25f9066f91d4411090", size = 162045, upload-time = "2025-10-14T04:41:44.821Z" },
+    { url = "https://files.pythonhosted.org/packages/df/c5/d1be898bf0dc3ef9030c3825e5d3b83f2c528d207d246cbabe245966808d/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:2b7d8f6c26245217bd2ad053761201e9f9680f8ce52f0fcd8d0755aeae5b2152", size = 149687, upload-time = "2025-10-14T04:41:46.442Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/42/90c1f7b9341eef50c8a1cb3f098ac43b0508413f33affd762855f67a410e/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:799a7a5e4fb2d5898c60b640fd4981d6a25f1c11790935a44ce38c54e985f828", size = 160014, upload-time = "2025-10-14T04:41:47.631Z" },
+    { url = "https://files.pythonhosted.org/packages/76/be/4d3ee471e8145d12795ab655ece37baed0929462a86e72372fd25859047c/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:99ae2cffebb06e6c22bdc25801d7b30f503cc87dbd283479e7b606f70aff57ec", size = 154044, upload-time = "2025-10-14T04:41:48.81Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/6f/8f7af07237c34a1defe7defc565a9bc1807762f672c0fde711a4b22bf9c0/charset_normalizer-3.4.4-cp314-cp314-win32.whl", hash = "sha256:f9d332f8c2a2fcbffe1378594431458ddbef721c1769d78e2cbc06280d8155f9", size = 99940, upload-time = "2025-10-14T04:41:49.946Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/51/8ade005e5ca5b0d80fb4aff72a3775b325bdc3d27408c8113811a7cbe640/charset_normalizer-3.4.4-cp314-cp314-win_amd64.whl", hash = "sha256:8a6562c3700cce886c5be75ade4a5db4214fda19fede41d9792d100288d8f94c", size = 107104, upload-time = "2025-10-14T04:41:51.051Z" },
+    { url = "https://files.pythonhosted.org/packages/da/5f/6b8f83a55bb8278772c5ae54a577f3099025f9ade59d0136ac24a0df4bde/charset_normalizer-3.4.4-cp314-cp314-win_arm64.whl", hash = "sha256:de00632ca48df9daf77a2c65a484531649261ec9f25489917f09e455cb09ddb2", size = 100743, upload-time = "2025-10-14T04:41:52.122Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/4c/925909008ed5a988ccbb72dcc897407e5d6d3bd72410d69e051fc0c14647/charset_normalizer-3.4.4-py3-none-any.whl", hash = "sha256:7a32c560861a02ff789ad905a2fe94e3f840803362c84fecf1851cb4cf3dc37f", size = 53402, upload-time = "2025-10-14T04:42:31.76Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.11"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" },
+]
+
+[[package]]
+name = "oxipy"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "pydantic" },
+    { name = "requests" },
+    { name = "ttp" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "pydantic", specifier = ">=2.12.5" },
+    { name = "requests", specifier = ">=2.32.5" },
+    { name = "ttp", specifier = ">=0.10.0" },
+]
+
+[[package]]
+name = "pydantic"
+version = "2.12.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-types" },
+    { name = "pydantic-core" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5a/87/b70ad306ebb6f9b585f114d0ac2137d792b48be34d732d60e597c2f8465a/pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d", size = 463580, upload-time = "2025-11-26T15:11:44.605Z" },
+]
+
+[[package]]
+name = "pydantic-core"
+version = "2.41.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/87/06/8806241ff1f70d9939f9af039c6c35f2360cf16e93c2ca76f184e76b1564/pydantic_core-2.41.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:941103c9be18ac8daf7b7adca8228f8ed6bb7a1849020f643b3a14d15b1924d9", size = 2120403, upload-time = "2025-11-04T13:40:25.248Z" },
+    { url = "https://files.pythonhosted.org/packages/94/02/abfa0e0bda67faa65fef1c84971c7e45928e108fe24333c81f3bfe35d5f5/pydantic_core-2.41.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:112e305c3314f40c93998e567879e887a3160bb8689ef3d2c04b6cc62c33ac34", size = 1896206, upload-time = "2025-11-04T13:40:27.099Z" },
+    { url = "https://files.pythonhosted.org/packages/15/df/a4c740c0943e93e6500f9eb23f4ca7ec9bf71b19e608ae5b579678c8d02f/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cbaad15cb0c90aa221d43c00e77bb33c93e8d36e0bf74760cd00e732d10a6a0", size = 1919307, upload-time = "2025-11-04T13:40:29.806Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/e3/6324802931ae1d123528988e0e86587c2072ac2e5394b4bc2bc34b61ff6e/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:03ca43e12fab6023fc79d28ca6b39b05f794ad08ec2feccc59a339b02f2b3d33", size = 2063258, upload-time = "2025-11-04T13:40:33.544Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/d4/2230d7151d4957dd79c3044ea26346c148c98fbf0ee6ebd41056f2d62ab5/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc799088c08fa04e43144b164feb0c13f9a0bc40503f8df3e9fde58a3c0c101e", size = 2214917, upload-time = "2025-11-04T13:40:35.479Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/9f/eaac5df17a3672fef0081b6c1bb0b82b33ee89aa5cec0d7b05f52fd4a1fa/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:97aeba56665b4c3235a0e52b2c2f5ae9cd071b8a8310ad27bddb3f7fb30e9aa2", size = 2332186, upload-time = "2025-11-04T13:40:37.436Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/4e/35a80cae583a37cf15604b44240e45c05e04e86f9cfd766623149297e971/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:406bf18d345822d6c21366031003612b9c77b3e29ffdb0f612367352aab7d586", size = 2073164, upload-time = "2025-11-04T13:40:40.289Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/e3/f6e262673c6140dd3305d144d032f7bd5f7497d3871c1428521f19f9efa2/pydantic_core-2.41.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b93590ae81f7010dbe380cdeab6f515902ebcbefe0b9327cc4804d74e93ae69d", size = 2179146, upload-time = "2025-11-04T13:40:42.809Z" },
+    { url = "https://files.pythonhosted.org/packages/75/c7/20bd7fc05f0c6ea2056a4565c6f36f8968c0924f19b7d97bbfea55780e73/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:01a3d0ab748ee531f4ea6c3e48ad9dac84ddba4b0d82291f87248f2f9de8d740", size = 2137788, upload-time = "2025-11-04T13:40:44.752Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/8d/34318ef985c45196e004bc46c6eab2eda437e744c124ef0dbe1ff2c9d06b/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:6561e94ba9dacc9c61bce40e2d6bdc3bfaa0259d3ff36ace3b1e6901936d2e3e", size = 2340133, upload-time = "2025-11-04T13:40:46.66Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/59/013626bf8c78a5a5d9350d12e7697d3d4de951a75565496abd40ccd46bee/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:915c3d10f81bec3a74fbd4faebe8391013ba61e5a1a8d48c4455b923bdda7858", size = 2324852, upload-time = "2025-11-04T13:40:48.575Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/d9/c248c103856f807ef70c18a4f986693a46a8ffe1602e5d361485da502d20/pydantic_core-2.41.5-cp313-cp313-win32.whl", hash = "sha256:650ae77860b45cfa6e2cdafc42618ceafab3a2d9a3811fcfbd3bbf8ac3c40d36", size = 1994679, upload-time = "2025-11-04T13:40:50.619Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/8b/341991b158ddab181cff136acd2552c9f35bd30380422a639c0671e99a91/pydantic_core-2.41.5-cp313-cp313-win_amd64.whl", hash = "sha256:79ec52ec461e99e13791ec6508c722742ad745571f234ea6255bed38c6480f11", size = 2019766, upload-time = "2025-11-04T13:40:52.631Z" },
+    { url = "https://files.pythonhosted.org/packages/73/7d/f2f9db34af103bea3e09735bb40b021788a5e834c81eedb541991badf8f5/pydantic_core-2.41.5-cp313-cp313-win_arm64.whl", hash = "sha256:3f84d5c1b4ab906093bdc1ff10484838aca54ef08de4afa9de0f5f14d69639cd", size = 1981005, upload-time = "2025-11-04T13:40:54.734Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/28/46b7c5c9635ae96ea0fbb779e271a38129df2550f763937659ee6c5dbc65/pydantic_core-2.41.5-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:3f37a19d7ebcdd20b96485056ba9e8b304e27d9904d233d7b1015db320e51f0a", size = 2119622, upload-time = "2025-11-04T13:40:56.68Z" },
+    { url = "https://files.pythonhosted.org/packages/74/1a/145646e5687e8d9a1e8d09acb278c8535ebe9e972e1f162ed338a622f193/pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14", size = 1891725, upload-time = "2025-11-04T13:40:58.807Z" },
+    { url = "https://files.pythonhosted.org/packages/23/04/e89c29e267b8060b40dca97bfc64a19b2a3cf99018167ea1677d96368273/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25e1c2af0fce638d5f1988b686f3b3ea8cd7de5f244ca147c777769e798a9cd1", size = 1915040, upload-time = "2025-11-04T13:41:00.853Z" },
+    { url = "https://files.pythonhosted.org/packages/84/a3/15a82ac7bd97992a82257f777b3583d3e84bdb06ba6858f745daa2ec8a85/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:506d766a8727beef16b7adaeb8ee6217c64fc813646b424d0804d67c16eddb66", size = 2063691, upload-time = "2025-11-04T13:41:03.504Z" },
+    { url = "https://files.pythonhosted.org/packages/74/9b/0046701313c6ef08c0c1cf0e028c67c770a4e1275ca73131563c5f2a310a/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4819fa52133c9aa3c387b3328f25c1facc356491e6135b459f1de698ff64d869", size = 2213897, upload-time = "2025-11-04T13:41:05.804Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/cd/6bac76ecd1b27e75a95ca3a9a559c643b3afcd2dd62086d4b7a32a18b169/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2b761d210c9ea91feda40d25b4efe82a1707da2ef62901466a42492c028553a2", size = 2333302, upload-time = "2025-11-04T13:41:07.809Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/d2/ef2074dc020dd6e109611a8be4449b98cd25e1b9b8a303c2f0fca2f2bcf7/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:22f0fb8c1c583a3b6f24df2470833b40207e907b90c928cc8d3594b76f874375", size = 2064877, upload-time = "2025-11-04T13:41:09.827Z" },
+    { url = "https://files.pythonhosted.org/packages/18/66/e9db17a9a763d72f03de903883c057b2592c09509ccfe468187f2a2eef29/pydantic_core-2.41.5-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c870e99878c634505236d81e5443092fba820f0373997ff75f90f68cd553", size = 2180680, upload-time = "2025-11-04T13:41:12.379Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/9e/3ce66cebb929f3ced22be85d4c2399b8e85b622db77dad36b73c5387f8f8/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0177272f88ab8312479336e1d777f6b124537d47f2123f89cb37e0accea97f90", size = 2138960, upload-time = "2025-11-04T13:41:14.627Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/62/205a998f4327d2079326b01abee48e502ea739d174f0a89295c481a2272e/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:63510af5e38f8955b8ee5687740d6ebf7c2a0886d15a6d65c32814613681bc07", size = 2339102, upload-time = "2025-11-04T13:41:16.868Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/0d/f05e79471e889d74d3d88f5bd20d0ed189ad94c2423d81ff8d0000aab4ff/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:e56ba91f47764cc14f1daacd723e3e82d1a89d783f0f5afe9c364b8bb491ccdb", size = 2326039, upload-time = "2025-11-04T13:41:18.934Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/e1/e08a6208bb100da7e0c4b288eed624a703f4d129bde2da475721a80cab32/pydantic_core-2.41.5-cp314-cp314-win32.whl", hash = "sha256:aec5cf2fd867b4ff45b9959f8b20ea3993fc93e63c7363fe6851424c8a7e7c23", size = 1995126, upload-time = "2025-11-04T13:41:21.418Z" },
+    { url = "https://files.pythonhosted.org/packages/48/5d/56ba7b24e9557f99c9237e29f5c09913c81eeb2f3217e40e922353668092/pydantic_core-2.41.5-cp314-cp314-win_amd64.whl", hash = "sha256:8e7c86f27c585ef37c35e56a96363ab8de4e549a95512445b85c96d3e2f7c1bf", size = 2015489, upload-time = "2025-11-04T13:41:24.076Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/bb/f7a190991ec9e3e0ba22e4993d8755bbc4a32925c0b5b42775c03e8148f9/pydantic_core-2.41.5-cp314-cp314-win_arm64.whl", hash = "sha256:e672ba74fbc2dc8eea59fb6d4aed6845e6905fc2a8afe93175d94a83ba2a01a0", size = 1977288, upload-time = "2025-11-04T13:41:26.33Z" },
+    { url = "https://files.pythonhosted.org/packages/92/ed/77542d0c51538e32e15afe7899d79efce4b81eee631d99850edc2f5e9349/pydantic_core-2.41.5-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:8566def80554c3faa0e65ac30ab0932b9e3a5cd7f8323764303d468e5c37595a", size = 2120255, upload-time = "2025-11-04T13:41:28.569Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/3d/6913dde84d5be21e284439676168b28d8bbba5600d838b9dca99de0fad71/pydantic_core-2.41.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:b80aa5095cd3109962a298ce14110ae16b8c1aece8b72f9dafe81cf597ad80b3", size = 1863760, upload-time = "2025-11-04T13:41:31.055Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/f0/e5e6b99d4191da102f2b0eb9687aaa7f5bea5d9964071a84effc3e40f997/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3006c3dd9ba34b0c094c544c6006cc79e87d8612999f1a5d43b769b89181f23c", size = 1878092, upload-time = "2025-11-04T13:41:33.21Z" },
+    { url = "https://files.pythonhosted.org/packages/71/48/36fb760642d568925953bcc8116455513d6e34c4beaa37544118c36aba6d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:72f6c8b11857a856bcfa48c86f5368439f74453563f951e473514579d44aa612", size = 2053385, upload-time = "2025-11-04T13:41:35.508Z" },
+    { url = "https://files.pythonhosted.org/packages/20/25/92dc684dd8eb75a234bc1c764b4210cf2646479d54b47bf46061657292a8/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cb1b2f9742240e4bb26b652a5aeb840aa4b417c7748b6f8387927bc6e45e40d", size = 2218832, upload-time = "2025-11-04T13:41:37.732Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/09/f53e0b05023d3e30357d82eb35835d0f6340ca344720a4599cd663dca599/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bd3d54f38609ff308209bd43acea66061494157703364ae40c951f83ba99a1a9", size = 2327585, upload-time = "2025-11-04T13:41:40Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/4e/2ae1aa85d6af35a39b236b1b1641de73f5a6ac4d5a7509f77b814885760c/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ff4321e56e879ee8d2a879501c8e469414d948f4aba74a2d4593184eb326660", size = 2041078, upload-time = "2025-11-04T13:41:42.323Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/13/2e215f17f0ef326fc72afe94776edb77525142c693767fc347ed6288728d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d0d2568a8c11bf8225044aa94409e21da0cb09dcdafe9ecd10250b2baad531a9", size = 2173914, upload-time = "2025-11-04T13:41:45.221Z" },
+    { url = "https://files.pythonhosted.org/packages/02/7a/f999a6dcbcd0e5660bc348a3991c8915ce6599f4f2c6ac22f01d7a10816c/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:a39455728aabd58ceabb03c90e12f71fd30fa69615760a075b9fec596456ccc3", size = 2129560, upload-time = "2025-11-04T13:41:47.474Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/b1/6c990ac65e3b4c079a4fb9f5b05f5b013afa0f4ed6780a3dd236d2cbdc64/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:239edca560d05757817c13dc17c50766136d21f7cd0fac50295499ae24f90fdf", size = 2329244, upload-time = "2025-11-04T13:41:49.992Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/02/3c562f3a51afd4d88fff8dffb1771b30cfdfd79befd9883ee094f5b6c0d8/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:2a5e06546e19f24c6a96a129142a75cee553cc018ffee48a460059b1185f4470", size = 2331955, upload-time = "2025-11-04T13:41:54.079Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/96/5fb7d8c3c17bc8c62fdb031c47d77a1af698f1d7a406b0f79aaa1338f9ad/pydantic_core-2.41.5-cp314-cp314t-win32.whl", hash = "sha256:b4ececa40ac28afa90871c2cc2b9ffd2ff0bf749380fbdf57d165fd23da353aa", size = 1988906, upload-time = "2025-11-04T13:41:56.606Z" },
+    { url = "https://files.pythonhosted.org/packages/22/ed/182129d83032702912c2e2d8bbe33c036f342cc735737064668585dac28f/pydantic_core-2.41.5-cp314-cp314t-win_amd64.whl", hash = "sha256:80aa89cad80b32a912a65332f64a4450ed00966111b6615ca6816153d3585a8c", size = 1981607, upload-time = "2025-11-04T13:41:58.889Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/ed/068e41660b832bb0b1aa5b58011dea2a3fe0ba7861ff38c4d4904c1c1a99/pydantic_core-2.41.5-cp314-cp314t-win_arm64.whl", hash = "sha256:35b44f37a3199f771c3eaa53051bc8a70cd7b54f333531c59e29fd4db5d15008", size = 1974769, upload-time = "2025-11-04T13:42:01.186Z" },
+]
+
+[[package]]
+name = "requests"
+version = "2.32.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "charset-normalizer" },
+    { name = "idna" },
+    { name = "urllib3" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c9/74/b3ff8e6c8446842c3f5c837e9c3dfcfe2018ea6ecef224c710c85ef728f4/requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf", size = 134517, upload-time = "2025-08-18T20:46:02.573Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" },
+]
+
+[[package]]
+name = "ttp"
+version = "0.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/83/e6/9169d35574be82df2a0cdd2546f4f83d0d30964cf0043fc9784df855b024/ttp-0.10.0.tar.gz", hash = "sha256:40f1ca61ee1431f5b1ab5326fb55f852a04749e9574792d45455b62c5e7ac97b", size = 64665, upload-time = "2025-11-02T08:47:50.329Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/c3/60abb45bd8eb973997f133eb76949523478d35dfc551a0dbd8906b6a8075/ttp-0.10.0-py3-none-any.whl", hash = "sha256:9985e0ca414e85d41493a6291a924624b9a08c48c78d2d01477cc60ba2a347c1", size = 84287, upload-time = "2025-11-02T08:47:48.656Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]
+
+[[package]]
+name = "typing-inspection"
+version = "0.4.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
+]
+
+[[package]]
+name = "urllib3"
+version = "2.6.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c7/24/5f1b3bdffd70275f6661c76461e25f024d5a38a46f04aaca912426a2b1d3/urllib3-2.6.3.tar.gz", hash = "sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed", size = 435556, upload-time = "2026-01-07T16:24:43.925Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4", size = 131584, upload-time = "2026-01-07T16:24:42.685Z" },
+]