pyspapi v3.3.1

pyspapi v3.3.1 [01.02.2026]

🎉 Что нового

🔄 Улучшения

• Специализированная иерархия исключений - исключений для разных сценариев ошибок (ValidationError, UnauthorizedError, NotFoundError, InsufficientBalanceError и др.)
• Логирование ошибок - Детальное извлечение сообщений об ошибках из ответов API
• Умная логика повторов - Автоматические повторы с экспоненциальной задержкой для временных сбоев (408, 429, 5xx)
• Идемпотентное управление сессией - Контекстный менеджер корректно обрабатывает существующие сессии
• Исправленные __repr__ методы - Исправлено представление объектов с ключевыми полями
• Опциональное логирование - Библиотека использует NullHandler, логирование можно включить и настроить.

📝 Журнал изменений

• 6906afb - refactor: enhance error handling and logging in API interactions, improve exception classes
• e22a22b - bump version to 3.3.1 and enable package mode in pyproject.toml
• 6906afb - refactor: replace get_event_loop with asyncio.run for better async handling in example scripts

Full Changelog: 3.3.0...3.3.1

pyspapi v3.3.0

pyspapi v3.3.0 [17.01.2026]

🎉 Что нового

✨ Новые функции

• Локализация документации - полный перевод документации на русский язык и обновление Makefile для Sphinx с целью улучшения поддержки локализации.

🔄 Улучшения

• Рефакторинг кода - улучшена структура кода, добавлена поддержка прокси в классах APISession и SPAPI для повышения гибкости.

📦 Сборка и инфраструктура

• Миграция системы сборки - переход на Poetry для современного управления зависимостями и конфигурации проекта, что обеспечивает лучшую воспроизводимость и удобство сопровождения.
• Обновления CI/CD - обновление версии Python до 3.12 в workflow GitHub Actions для использования новейших возможностей языка и улучшений в области безопасности.

📝 Журнал изменений

• 047dbb3 - chore: update Python version to 3.12 in GitHub Actions workflow
• 6da906e - feat(docs): localize documentation to Russian and update Makefile for Sphinx
• 4fc530c - refactor: improve code structure and add proxy support in APISession and SPAPI
• 6e77bac - feat: migrate to poetry for dependency management and project configuration

Full Changelog: 3.2.0...3.3.0

pyspapi v3.2.0

🚀 pyspapi v3.2.0 — Выпуск от 14 июля 2025

🎉 Нововведения (feat)

• Добавлен параметр raise_exception в APISession и SPAPI для контроля исключений.
• Добавлены кастомные исключения:
  • SPAPIError, ValidationError (422 Unprocessable Entity).
• Модель City теперь включает:
  • x, z, nether_x, nether_z, lane, role, created_at
• Account: добавлено поле minecraftuuid; city заменён на список cities.

🔧 Рефакторинг (refactor)

• Переписан APISession: логика обработки запросов, повторы, логгирование, типизация.
• Оптимизированы классы Account, City, Card: упрощён код, улучшена читаемость, удалены дублирования.
• Улучшена реализация SPAPI методов: возвращаемые значения теперь корректно типизированы.

🐛 Исправления (fix)

• В examples/transaction.py поправлен синтаксис и кавычки.
• Приведение к PEP‑8: лишние пустые строки, формат импорта, стиль кода.

🔖 Обновление версии (chore)

• Версия обновлена с 3.1.2 до 3.2.0
• Fixes #16

---

Если ты используешь библиотеку в async-проектах — теперь ты можешь управлять тем, выбрасываются ли ошибки API, или обрабатываются вручную.

3.1.2

Full Changelog: 3.1.1...3.1.2

3.1.1

Module load fix

Full Changelog: 3.1.0...3.1.1

3.1.0

API update and async

What's Changed

• Fix Linux/Mac OS installation in README by @stepanzubkov in #11
• new version by @deesiigneer in #15

New Contributors

• @stepanzubkov made their first contribution in #11

Full Changelog: 2.1.2...3.1.0

3.0.0a0

Full Changelog: 2.1.2...3.0.0a0

2.1.2

Full Changelog: 2.1.1...2.1.2

transaction fix

2.1.1

What's Changed

• v2.0.0! by @deesiigneer in #5

Full Changelog: 1.0.2...2.1.1

add MANIFEST.in for #8 fix

1.0.2

What's Changed

• Добавление webhook_verify by @deesiigneer in #3

New Contributors

• @deesiigneer made their first contribution in #3

Full Changelog: 1.0.1...1.0.2