eazy-sdk-core 0.2.0a8__tar.gz

eazy_sdk_core-0.2.0a8/.gitignore

@@ -0,0 +1,79 @@
+# Operating systems and editors
+.DS_Store
+Thumbs.db
+Desktop.ini
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Python bytecode and tool caches
+__pycache__/
+*.py[cod]
+*$py.class
+.cache/
+.hypothesis/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.tox/
+.nox/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+
+# Virtual environments and local configuration
+.venv/
+venv/
+env/
+.env
+.env.*
+!.env.example
+
+# Python build artifacts
+build/
+dist/
+wheels/
+*.egg-info/
+.eggs/
+*.whl
+
+# JavaScript and documentation builds
+node_modules/
+.astro/
+
+# Eazy SDK-generated and temporary artifacts
+.test-tmp/
+.tmp/
+.uv-cache/
+.phase*-build/
+.phase*-venv*/
+generated-preview/
+mutants/
+
+# Local data and logs
+*.db
+*.db-journal
+*.sqlite
+*.sqlite3
+*.log
+
+# Local secrets and credentials
+*.key
+*.pem
+*.p12
+*.pfx
+
+# Notebook checkpoints
+.ipynb_checkpoints/
+/experiments/
+
+# Local AI-assisted development notes and instructions
+*.md
+!plugins/*/README.md
+# Документация плагина — часть плагина, а не локальная заметка.
+!plugins/*/docs/*.md
+/.claude/
+/docs/

eazy_sdk_core-0.2.0a8/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eazy SDK contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eazy_sdk_core-0.2.0a8/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.5
+Name: eazy-sdk-core
+Version: 0.2.0a8
+Summary: Transport-independent runtime for typed HTTP and async WebSocket SDKs.
+Project-URL: Homepage, https://github.com/0cherednoq/eazy-sdk
+Project-URL: Documentation, https://0cherednoq.github.io/eazy-sdk/
+Project-URL: Repository, https://github.com/0cherednoq/eazy-sdk
+Project-URL: Changelog, https://github.com/0cherednoq/eazy-sdk/blob/master/CHANGELOG.md
+Project-URL: Issues, https://github.com/0cherednoq/eazy-sdk/issues
+Author: Eazy SDK contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: asyncapi,http,openapi,sdk,typed,websocket
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: zapros==0.16.0
+Provides-Extra: accounts
+Provides-Extra: adaptix
+Requires-Dist: adaptix>=3.0.0b12; extra == 'adaptix'
+Provides-Extra: all
+Requires-Dist: aiosqlite>=0.20; extra == 'all'
+Requires-Dist: curl-cffi>=0.7; extra == 'all'
+Requires-Dist: httpx>=0.27; extra == 'all'
+Requires-Dist: msgspec>=0.21.1; extra == 'all'
+Requires-Dist: parsel>=1.11; extra == 'all'
+Requires-Dist: pydantic>=2; extra == 'all'
+Requires-Dist: requests>=2.31; extra == 'all'
+Requires-Dist: sqlalchemy[asyncio]>=2; extra == 'all'
+Requires-Dist: sqlmodel>=0.0.22; extra == 'all'
+Requires-Dist: zapros[websocket]==0.16.0; extra == 'all'
+Provides-Extra: asyncapi
+Provides-Extra: browser
+Provides-Extra: camoufox
+Requires-Dist: camoufox>=0.4; extra == 'camoufox'
+Provides-Extra: curl-cffi
+Requires-Dist: curl-cffi>=0.7; extra == 'curl-cffi'
+Provides-Extra: html
+Requires-Dist: parsel>=1.11; extra == 'html'
+Provides-Extra: httpx
+Requires-Dist: httpx>=0.27; extra == 'httpx'
+Provides-Extra: msgspec
+Requires-Dist: msgspec>=0.21.1; extra == 'msgspec'
+Provides-Extra: openapi
+Requires-Dist: datamodel-code-generator<1,>=0.26; extra == 'openapi'
+Requires-Dist: pydantic[email]>=2; extra == 'openapi'
+Provides-Extra: playwright
+Requires-Dist: playwright>=1.55; extra == 'playwright'
+Provides-Extra: presets
+Provides-Extra: pydantic
+Requires-Dist: pydantic>=2; extra == 'pydantic'
+Provides-Extra: pydoll
+Requires-Dist: pydoll-python<4,>=3; extra == 'pydoll'
+Provides-Extra: requests
+Requires-Dist: requests>=2.31; extra == 'requests'
+Provides-Extra: selectolax
+Requires-Dist: selectolax>=0.3; extra == 'selectolax'
+Provides-Extra: selenium
+Requires-Dist: selenium>=4.25; extra == 'selenium'
+Provides-Extra: sqlmodel
+Requires-Dist: aiosqlite>=0.20; extra == 'sqlmodel'
+Requires-Dist: pydantic>=2; extra == 'sqlmodel'
+Requires-Dist: sqlalchemy[asyncio]>=2; extra == 'sqlmodel'
+Requires-Dist: sqlmodel>=0.0.22; extra == 'sqlmodel'
+Provides-Extra: websocket
+Requires-Dist: zapros[websocket]==0.16.0; extra == 'websocket'
+Provides-Extra: xml
+Provides-Extra: yaml
+Requires-Dist: pyyaml>=6; extra == 'yaml'
+Description-Content-Type: text/markdown
+
+# Eazy SDK
+
+[![CI](https://github.com/0cherednoq/eazy-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/0cherednoq/eazy-sdk/actions/workflows/ci.yml)
+[![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue.svg)](https://0cherednoq.github.io/eazy-sdk/)
+[![PyPI](https://img.shields.io/pypi/v/eazy-sdk-core.svg?include_prereleases&cacheSeconds=300)](https://pypi.org/project/eazy-sdk-core/)
+[![Python](https://img.shields.io/pypi/pyversions/eazy-sdk-core.svg?cacheSeconds=300)](https://pypi.org/project/eazy-sdk-core/)
+
+Библиотека для Python, на которой пишут типизированные SDK к чужим HTTP API, WebSocket и сайтам.
+Запрос объявляется классом, ответ разбирается в модель, а вход, обновление сессии, подпись,
+повторы и пагинация описываются рядом с операцией и не попадают в код вызова.
+
+> Статус: alpha, версия `0.2.0a8`. Альфа-версии переименовывают публичные имена без устаревших
+> псевдонимов, список замен ведёт страница
+> [«Миграция»](https://0cherednoq.github.io/eazy-sdk/reference/migration/). Документация собирается в
+> сайт из [docs-site/](https://github.com/0cherednoq/eazy-sdk/tree/master/docs-site) и публикуется на
+> [GitHub Pages](https://0cherednoq.github.io/eazy-sdk/).
+
+## Что это даёт
+
+* Операция описана один раз: поля класса задают путь, query, заголовки и тело, а тип результата
+  виден редактору и тайпчекеру.
+* Один и тот же роутер работает через HTTPX, Requests, curl_cffi или свой обработчик. Пакет без
+  дополнений не ставит ни HTTP-клиент, ни библиотеку моделей.
+* Ответы разбираются в Pydantic, msgspec, dataclass или Adaptix. Ошибка API внутри ответа с
+  кодом 200 становится типизированным исключением.
+* Вход, обновление сессии по сроку и по отказу, подпись HMAC, шифрование тела, капча и
+  пагинация объявляются декларативно и срабатывают на каждой попытке.
+* Тот же SDK может работать через браузер: операции страницы на Playwright или Pydoll и сессия
+  браузера у HTTP-клиента.
+* Генераторы собирают SDK из OpenAPI 3.0-3.2 и AsyncAPI 3.0.
+
+HTTP-клиент, браузер и хранилище аккаунтов остаются за приложением: SDK получает их готовыми.
+
+## Установка
+
+Нужен Python 3.13 или новее.
+
+```bash
+pip install --pre "eazy-sdk-core[httpx,pydantic]"
+```
+
+На PyPI пакет называется `eazy-sdk-core`, а импортируется как `eazy_sdk`. Проект `eazysdk` на PyPI
+к этой библиотеке отношения не имеет. Флаг `--pre` нужен, пока выходят только альфа-версии. Те же файлы приложены к каждому
+[релизу GitHub](https://github.com/0cherednoq/eazy-sdk/releases).
+
+Всё поставляется одним пакетом. Дополнения ставят только сторонние библиотеки и выбираются по
+задаче: `httpx`, `requests`, `curl-cffi`, `websocket`, `pydantic`, `msgspec`, `adaptix`, `html`,
+`xml`, `openapi`, `asyncapi`, `accounts`, `sqlmodel`, `browser`, `playwright`, `pydoll`,
+`presets`. Полная таблица есть на странице
+[«Установка»](https://0cherednoq.github.io/eazy-sdk/start/installation/).
+
+## Быстрый старт
+
+Скрипт ниже получает одно письмо с учебного сайта `mail.example`. Сайт отвечает в том же
+процессе, поэтому для знакомства хватит одного файла и сети не нужно.
+
+```python
+# quickstart.py
+from dataclasses import dataclass
+
+import httpx
+from pydantic import BaseModel
+
+from eazy_sdk import Client, Http, HttpOperation, Path, SyncApi, op
+from eazy_sdk.handlers.httpx import HttpxHandler
+
+
+class Message(BaseModel):
+    id: int
+    sender: str
+    subject: str
+
+
+@dataclass(frozen=True, slots=True, kw_only=True)
+class GetMessage(HttpOperation[Message]):
+    __http__ = Http.get("/messages/{message_id}")  # метод и путь
+
+    message_id: Path[int]  # поле операции уходит в путь
+
+
+class MailApi(SyncApi):
+    message = op(GetMessage)  # операция становится методом роутера
+
+
+def mail_site(request: httpx.Request) -> httpx.Response:
+    # учебный сайт в этом же процессе; в приложении запрос уходит в сеть
+    return httpx.Response(
+        200,
+        json={"id": 42, "sender": "ada@mail.example", "subject": "Планы на пятницу"},
+    )
+
+
+raw = httpx.Client(transport=httpx.MockTransport(mail_site))
+
+with Client(
+    base_url="https://mail.example",
+    handler=HttpxHandler(raw, owns_client=True),
+) as client:
+    message = MailApi(client).message(message_id=42)
+    response = MailApi(client).message.with_response(message_id=42)
+
+print(f"{message.sender}: {message.subject}")
+print(response.status_code)
+
+# ada@mail.example: Планы на пятницу
+# 200
+```
+
+Что здесь произошло:
+
+1. `GetMessage` описал запрос как значение. `__http__` задал метод и путь, поле `message_id`
+   подставилось в путь, а `HttpOperation[Message]` назвал тип успешного ответа.
+2. `op(GetMessage)` опубликовал операцию на роутере. Сигнатура метода `message` совпадает с
+   конструктором класса, поэтому редактор подсказывает `message_id`.
+3. Клиент доставил байты и разобрал JSON в `Message`. Роутер о транспорте не знает: в
+   приложении вместо двух строк с `raw` достаточно `Client.httpx(base_url=...)`.
+4. `.with_response()` вернул тот же результат вместе со статусом и заголовками.
+
+## Дальше
+
+| Задача | Страница |
+|---|---|
+| Разобраться в ролях: операция, роутер, клиент, корень, `Identity` | [Основные понятия](https://0cherednoq.github.io/eazy-sdk/start/concepts/) |
+| Пройти один SDK почты от входа до отправки письма, по HTTP и через браузер | [Разбор на примере](https://0cherednoq.github.io/eazy-sdk/tutorial/) |
+| Объявить параметры, заголовки и тело запроса | [Запросы](https://0cherednoq.github.io/eazy-sdk/guide/requests/) |
+| Разобрать успешный ответ и ошибку API | [Ответы](https://0cherednoq.github.io/eazy-sdk/guide/responses/) |
+| Добавить ключ, токен, cookie, вход и обновление сессии | [Авторизация](https://0cherednoq.github.io/eazy-sdk/guide/auth/) |
+| Обойти список страницами, подписать и зашифровать запрос | [Пагинация](https://0cherednoq.github.io/eazy-sdk/guide/pagination/), [подпись](https://0cherednoq.github.io/eazy-sdk/guide/signing/), [шифрование](https://0cherednoq.github.io/eazy-sdk/guide/encryption/) |
+| Выбрать HTTP-клиент, библиотеку моделей, браузер или генератор | [Интеграции](https://0cherednoq.github.io/eazy-sdk/integrations/) |
+| Проверить SDK без сети | [Тестирование SDK](https://0cherednoq.github.io/eazy-sdk/guide/testing/) |
+| Понять, как устроен путь запроса внутри | [Архитектура](https://0cherednoq.github.io/eazy-sdk/architecture/) |
+| Найти точную сигнатуру | [Справочник API](https://0cherednoq.github.io/eazy-sdk/reference/api/) |
+
+Запускаемые примеры ко всем страницам лежат в [examples/](https://github.com/0cherednoq/eazy-sdk/blob/master/examples/README.md).
+
+## Для ИИ-ассистентов
+
+Сайт документации отдаёт два текстовых файла, собранных из тех же страниц:
+
+* [llms.txt](https://0cherednoq.github.io/eazy-sdk/llms.txt) содержит краткое описание проекта
+  и ссылки на страницы. Он подходит помощнику, который умеет открывать ссылки: в контекст
+  попадают только нужные страницы.
+* [llms-full.txt](https://0cherednoq.github.io/eazy-sdk/llms-full.txt) содержит полный текст
+  документации одним файлом. Он подходит для локального поиска и для инструмента, который по
+  ссылкам не ходит.
+
+Оба файла обновляются при каждой публикации сайта, отдельную копию документации поддерживать не
+нужно.
+
+## Разработка
+
+Нужен [uv](https://docs.astral.sh/uv/). Браузерным тестам нужен Chromium.
+
+```bash
+uv sync --all-extras            # окружение и все инструменты
+uv run playwright install chromium             # браузер для тестов плагина
+uv run pytest -q                               # тесты
+uv run mypy                                    # типы
+uv run ruff check                              # линтер
+uv run python scripts/docs_freshness.py check  # страницы не отстали от кода
+```
+
+Порядок работы описан в [CONTRIBUTING.md](https://github.com/0cherednoq/eazy-sdk/blob/master/CONTRIBUTING.md), об уязвимостях сообщают по
+[SECURITY.md](https://github.com/0cherednoq/eazy-sdk/blob/master/SECURITY.md). План архитектуры лежит в
+[docs/implementation/](https://github.com/0cherednoq/eazy-sdk/blob/master/docs/implementation/README.md).
+
+## Лицензия
+
+[MIT](https://github.com/0cherednoq/eazy-sdk/blob/master/LICENSE)

eazy_sdk_core-0.2.0a8/README.md

@@ -0,0 +1,169 @@
+# Eazy SDK
+
+[![CI](https://github.com/0cherednoq/eazy-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/0cherednoq/eazy-sdk/actions/workflows/ci.yml)
+[![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue.svg)](https://0cherednoq.github.io/eazy-sdk/)
+[![PyPI](https://img.shields.io/pypi/v/eazy-sdk-core.svg?include_prereleases&cacheSeconds=300)](https://pypi.org/project/eazy-sdk-core/)
+[![Python](https://img.shields.io/pypi/pyversions/eazy-sdk-core.svg?cacheSeconds=300)](https://pypi.org/project/eazy-sdk-core/)
+
+Библиотека для Python, на которой пишут типизированные SDK к чужим HTTP API, WebSocket и сайтам.
+Запрос объявляется классом, ответ разбирается в модель, а вход, обновление сессии, подпись,
+повторы и пагинация описываются рядом с операцией и не попадают в код вызова.
+
+> Статус: alpha, версия `0.2.0a8`. Альфа-версии переименовывают публичные имена без устаревших
+> псевдонимов, список замен ведёт страница
+> [«Миграция»](https://0cherednoq.github.io/eazy-sdk/reference/migration/). Документация собирается в
+> сайт из [docs-site/](https://github.com/0cherednoq/eazy-sdk/tree/master/docs-site) и публикуется на
+> [GitHub Pages](https://0cherednoq.github.io/eazy-sdk/).
+
+## Что это даёт
+
+* Операция описана один раз: поля класса задают путь, query, заголовки и тело, а тип результата
+  виден редактору и тайпчекеру.
+* Один и тот же роутер работает через HTTPX, Requests, curl_cffi или свой обработчик. Пакет без
+  дополнений не ставит ни HTTP-клиент, ни библиотеку моделей.
+* Ответы разбираются в Pydantic, msgspec, dataclass или Adaptix. Ошибка API внутри ответа с
+  кодом 200 становится типизированным исключением.
+* Вход, обновление сессии по сроку и по отказу, подпись HMAC, шифрование тела, капча и
+  пагинация объявляются декларативно и срабатывают на каждой попытке.
+* Тот же SDK может работать через браузер: операции страницы на Playwright или Pydoll и сессия
+  браузера у HTTP-клиента.
+* Генераторы собирают SDK из OpenAPI 3.0-3.2 и AsyncAPI 3.0.
+
+HTTP-клиент, браузер и хранилище аккаунтов остаются за приложением: SDK получает их готовыми.
+
+## Установка
+
+Нужен Python 3.13 или новее.
+
+```bash
+pip install --pre "eazy-sdk-core[httpx,pydantic]"
+```
+
+На PyPI пакет называется `eazy-sdk-core`, а импортируется как `eazy_sdk`. Проект `eazysdk` на PyPI
+к этой библиотеке отношения не имеет. Флаг `--pre` нужен, пока выходят только альфа-версии. Те же файлы приложены к каждому
+[релизу GitHub](https://github.com/0cherednoq/eazy-sdk/releases).
+
+Всё поставляется одним пакетом. Дополнения ставят только сторонние библиотеки и выбираются по
+задаче: `httpx`, `requests`, `curl-cffi`, `websocket`, `pydantic`, `msgspec`, `adaptix`, `html`,
+`xml`, `openapi`, `asyncapi`, `accounts`, `sqlmodel`, `browser`, `playwright`, `pydoll`,
+`presets`. Полная таблица есть на странице
+[«Установка»](https://0cherednoq.github.io/eazy-sdk/start/installation/).
+
+## Быстрый старт
+
+Скрипт ниже получает одно письмо с учебного сайта `mail.example`. Сайт отвечает в том же
+процессе, поэтому для знакомства хватит одного файла и сети не нужно.
+
+```python
+# quickstart.py
+from dataclasses import dataclass
+
+import httpx
+from pydantic import BaseModel
+
+from eazy_sdk import Client, Http, HttpOperation, Path, SyncApi, op
+from eazy_sdk.handlers.httpx import HttpxHandler
+
+
+class Message(BaseModel):
+    id: int
+    sender: str
+    subject: str
+
+
+@dataclass(frozen=True, slots=True, kw_only=True)
+class GetMessage(HttpOperation[Message]):
+    __http__ = Http.get("/messages/{message_id}")  # метод и путь
+
+    message_id: Path[int]  # поле операции уходит в путь
+
+
+class MailApi(SyncApi):
+    message = op(GetMessage)  # операция становится методом роутера
+
+
+def mail_site(request: httpx.Request) -> httpx.Response:
+    # учебный сайт в этом же процессе; в приложении запрос уходит в сеть
+    return httpx.Response(
+        200,
+        json={"id": 42, "sender": "ada@mail.example", "subject": "Планы на пятницу"},
+    )
+
+
+raw = httpx.Client(transport=httpx.MockTransport(mail_site))
+
+with Client(
+    base_url="https://mail.example",
+    handler=HttpxHandler(raw, owns_client=True),
+) as client:
+    message = MailApi(client).message(message_id=42)
+    response = MailApi(client).message.with_response(message_id=42)
+
+print(f"{message.sender}: {message.subject}")
+print(response.status_code)
+
+# ada@mail.example: Планы на пятницу
+# 200
+```
+
+Что здесь произошло:
+
+1. `GetMessage` описал запрос как значение. `__http__` задал метод и путь, поле `message_id`
+   подставилось в путь, а `HttpOperation[Message]` назвал тип успешного ответа.
+2. `op(GetMessage)` опубликовал операцию на роутере. Сигнатура метода `message` совпадает с
+   конструктором класса, поэтому редактор подсказывает `message_id`.
+3. Клиент доставил байты и разобрал JSON в `Message`. Роутер о транспорте не знает: в
+   приложении вместо двух строк с `raw` достаточно `Client.httpx(base_url=...)`.
+4. `.with_response()` вернул тот же результат вместе со статусом и заголовками.
+
+## Дальше
+
+| Задача | Страница |
+|---|---|
+| Разобраться в ролях: операция, роутер, клиент, корень, `Identity` | [Основные понятия](https://0cherednoq.github.io/eazy-sdk/start/concepts/) |
+| Пройти один SDK почты от входа до отправки письма, по HTTP и через браузер | [Разбор на примере](https://0cherednoq.github.io/eazy-sdk/tutorial/) |
+| Объявить параметры, заголовки и тело запроса | [Запросы](https://0cherednoq.github.io/eazy-sdk/guide/requests/) |
+| Разобрать успешный ответ и ошибку API | [Ответы](https://0cherednoq.github.io/eazy-sdk/guide/responses/) |
+| Добавить ключ, токен, cookie, вход и обновление сессии | [Авторизация](https://0cherednoq.github.io/eazy-sdk/guide/auth/) |
+| Обойти список страницами, подписать и зашифровать запрос | [Пагинация](https://0cherednoq.github.io/eazy-sdk/guide/pagination/), [подпись](https://0cherednoq.github.io/eazy-sdk/guide/signing/), [шифрование](https://0cherednoq.github.io/eazy-sdk/guide/encryption/) |
+| Выбрать HTTP-клиент, библиотеку моделей, браузер или генератор | [Интеграции](https://0cherednoq.github.io/eazy-sdk/integrations/) |
+| Проверить SDK без сети | [Тестирование SDK](https://0cherednoq.github.io/eazy-sdk/guide/testing/) |
+| Понять, как устроен путь запроса внутри | [Архитектура](https://0cherednoq.github.io/eazy-sdk/architecture/) |
+| Найти точную сигнатуру | [Справочник API](https://0cherednoq.github.io/eazy-sdk/reference/api/) |
+
+Запускаемые примеры ко всем страницам лежат в [examples/](https://github.com/0cherednoq/eazy-sdk/blob/master/examples/README.md).
+
+## Для ИИ-ассистентов
+
+Сайт документации отдаёт два текстовых файла, собранных из тех же страниц:
+
+* [llms.txt](https://0cherednoq.github.io/eazy-sdk/llms.txt) содержит краткое описание проекта
+  и ссылки на страницы. Он подходит помощнику, который умеет открывать ссылки: в контекст
+  попадают только нужные страницы.
+* [llms-full.txt](https://0cherednoq.github.io/eazy-sdk/llms-full.txt) содержит полный текст
+  документации одним файлом. Он подходит для локального поиска и для инструмента, который по
+  ссылкам не ходит.
+
+Оба файла обновляются при каждой публикации сайта, отдельную копию документации поддерживать не
+нужно.
+
+## Разработка
+
+Нужен [uv](https://docs.astral.sh/uv/). Браузерным тестам нужен Chromium.
+
+```bash
+uv sync --all-extras            # окружение и все инструменты
+uv run playwright install chromium             # браузер для тестов плагина
+uv run pytest -q                               # тесты
+uv run mypy                                    # типы
+uv run ruff check                              # линтер
+uv run python scripts/docs_freshness.py check  # страницы не отстали от кода
+```
+
+Порядок работы описан в [CONTRIBUTING.md](https://github.com/0cherednoq/eazy-sdk/blob/master/CONTRIBUTING.md), об уязвимостях сообщают по
+[SECURITY.md](https://github.com/0cherednoq/eazy-sdk/blob/master/SECURITY.md). План архитектуры лежит в
+[docs/implementation/](https://github.com/0cherednoq/eazy-sdk/blob/master/docs/implementation/README.md).
+
+## Лицензия
+
+[MIT](https://github.com/0cherednoq/eazy-sdk/blob/master/LICENSE)

eazy_sdk_core-0.2.0a8/eazy_sdk/__init__.py

@@ -0,0 +1,99 @@
+"""Eazy SDK: declare an API, compose it into an SDK, hand it a client.
+
+What lives here is what an SDK author needs in the first hour: the declaration surface, the
+composition surface, the request markers and the response contract. Everything else stays
+importable from the module that owns it — ``eazy_sdk.models``, ``eazy_sdk.codecs``,
+``eazy_sdk.crypto``, ``eazy_sdk.protection.advanced``, ``eazy_sdk.core.errors`` — because a
+second name in the root is duplication, not convenience.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from eazy_sdk.api import AsyncApi, SyncApi, api, api_group, op
+from eazy_sdk.clients import ClientConfig, Hooks, Resilience, RetryPolicy, Security
+from eazy_sdk.dependencies import Inject
+from eazy_sdk.handlers import HandlerProfile, TransportError
+from eazy_sdk.identity import Identity
+from eazy_sdk.operation import Http, HttpOperation
+from eazy_sdk.preparation import PreparedCall, PrepareOptions
+from eazy_sdk.request import (
+    Body,
+    BodyProjection,
+    Cookie,
+    FormBody,
+    Header,
+    JsonBody,
+    JsonField,
+    Path,
+    Query,
+)
+from eazy_sdk.response import (
+    Html,
+    Json,
+    ResponseEnvelope,
+    UnexpectedResponseError,
+)
+from eazy_sdk.root import AsyncRoot, Binding, SyncRoot, bind
+from eazy_sdk.sentinels import UNSET, Omittable
+from eazy_sdk.serialization import Serialization
+
+__version__ = "0.2.0a8"
+
+if TYPE_CHECKING:
+    from eazy_sdk.clients import AsyncClient, Client
+
+
+def __getattr__(name: str) -> Any:
+    if name not in {"AsyncClient", "Client"}:
+        raise AttributeError(name)
+    from eazy_sdk.clients import AsyncClient, Client
+
+    value = AsyncClient if name == "AsyncClient" else Client
+    globals()[name] = value
+    return value
+
+
+__all__ = [
+    "UNSET",
+    "AsyncApi",
+    "AsyncClient",
+    "AsyncRoot",
+    "Binding",
+    "Body",
+    "BodyProjection",
+    "Client",
+    "ClientConfig",
+    "Cookie",
+    "FormBody",
+    "HandlerProfile",
+    "Header",
+    "Hooks",
+    "Html",
+    "Http",
+    "HttpOperation",
+    "Identity",
+    "Inject",
+    "Json",
+    "JsonBody",
+    "JsonField",
+    "Omittable",
+    "Path",
+    "PrepareOptions",
+    "PreparedCall",
+    "Query",
+    "Resilience",
+    "ResponseEnvelope",
+    "RetryPolicy",
+    "Security",
+    "Serialization",
+    "SyncApi",
+    "SyncRoot",
+    "TransportError",
+    "UnexpectedResponseError",
+    "api",
+    "api_group",
+    "bind",
+    "op",
+]