Установка#
Первому JSON SDK нужны ядро, HTTPX и поддержка моделей Pydantic. Установите их командой
uv add "eazy-sdk-core[httpx,pydantic]".
Пакет ядра на PyPI называется eazy-sdk-core, а в коде импортируется как eazy_sdk. Пока выходят
только альфа-версии, pip требует флаг --pre, а uv - параметр --prerelease allow.
Команда добавляет синхронный и асинхронный адаптер HTTPX. Само ядро не выбирает HTTP-клиент и библиотеку моделей за приложение.
В проекте с pip набор зависимостей остаётся тем же:
python -m pip install "eazy-sdk-core[httpx,pydantic]".
Выберите нужные дополнения#
Не устанавливайте полный набор для каждой задачи. Добавьте только транспорт, формат данных или интеграцию, которые нужны SDK.
Задача |
Дополнение |
Команда для uv |
|---|---|---|
HTTP через HTTPX |
|
|
Синхронный HTTP через Requests |
|
|
HTTP через curl_cffi |
|
|
Модели Pydantic v2 |
|
|
Модели msgspec Struct |
|
|
Разбор HTML |
|
|
Аккаунты и регистрация |
|
|
Хранилище SQLModel |
|
|
WebSocket |
|
|
Браузерный SDK с Playwright |
|
|
Генератор OpenAPI |
|
|
Генератор AsyncAPI |
|
|
Готовые описания защит |
|
|
XML |
|
|
Модели Adaptix |
|
|
Все интеграции входят в один пакет eazy-sdk-core. Дополнение ставит только сторонние библиотеки,
которые нужны интеграции, поэтому несколько дополнений перечисляются через запятую в одной
команде.
Дополнение yaml у генераторов нужно для файлов YAML. Для спецификации JSON достаточно
openapi или asyncapi. У браузерной интеграции вместо playwright можно выбрать selenium,
camoufox или pydoll.
eazy-sdk-core[all] ставит основные HTTP-интеграции, модели и средства работы с данными, но
намеренно не ставит браузерный драйвер. Браузер и его двоичные файлы выбирает приложение.
Проверьте установку#
В проекте с uv запустите
uv run python -c "import eazy_sdk, httpx, pydantic; print(eazy_sdk.__version__)".
В активированном окружении pip уберите префикс uv run и начните команду с python.
Результат содержит только установленную версию:
0.2.0a15
Если вы выбрали другой HTTP-клиент или библиотеку моделей, замените httpx и pydantic в
строке импорта. Трассировки ошибки быть не должно.
Требования#
Python 3.13 или новее.
Менеджер пакетов с поддержкой дополнений Python. Команды выше даны для uv и pip.
Один поддерживаемый HTTP-клиент для HTTP SDK. Список возможностей клиентов находится в руководстве по HTTP-интеграциям.
Драйвер для браузерного SDK. После установки Playwright загрузите Chromium командой
uv run playwright install chromium. В активированном окружении pip используйтеplaywright install chromium.