🚀 CheatBot API: Асинхронная Python-библиотека

cheatbot — это мощная и интуитивно понятная асинхронная Python-библиотека, разработанная для бесшовного взаимодействия с API сервиса CheatBot. Она предоставляет удобный интерфейс для управления задачами, получения информации о сервисах и профиле, а также автоматизации рутинных операций.

✨ Особенности

• Полностью асинхронная: Построена на asyncio для высокопроизводительных и неблокирующих операций.
• Типобезопасность: Использует pydantic для строгой валидации данных и автодополнения.
• Простота использования: Чистый и понятный API, который легко интегрировать в ваши проекты.
• Надежность: Встроенная обработка ошибок и исключений для стабильной работы.
• Гибкость: Поддержка всех основных функций CheatBot API.

🚀 Начало работы

Эти инструкции помогут вам быстро запустить проект на вашем локальном компьютере.

📋 Предварительные требования

Для работы с проектом вам понадобится uv — чрезвычайно быстрый установщик и распознаватель пакетов Python.

▶️ Быстрый старт

Чтобы использовать библиотеку в своем проекте, вам понадобится API-ключ от сервиса CheatBot. Вы можете получить его в личном кабинете после регистрации.

Установка из PyPI (рекомендуется):

pip install cheatbot

Установка из GitHub (для последней версии):

pip install git+https://github.com/simonether/cheatbot.git

Вот простой пример использования клиента для получения информации о профиле и сервисах:

importasyncioimportosfromcheatbotimportCheatBotClientasyncdefmain():
# Получите ваш API-ключ из переменной окруженияapi_key=os.getenv("CHEATBOT_API_KEY")
ifnotapi_key:
raiseValueError("Переменная окружения CHEATBOT_API_KEY не установлена.")
# Инициализация клиента. Используйте async with для автоматического закрытия сессии.asyncwithCheatBotClient(api_key) asclient:
print("--- Информация о профиле ---")
profile=awaitclient.get_profile_info()
print(f"Баланс: {profile.balance} RUB")
print(f"ID пользователя: {profile.user_id}")
print("\n--- Доступные сервисы ---")
# Получение всех сервисовall_services=client.services.get_all()
print(f"Всего доступных сервисов: {len(all_services)}")
# Пример поиска конкретного сервиса по ID (например, ID 40)service_id_to_find=40service=client.services.get_by_id(service_id_to_find)
ifservice:
print(f"Найден сервис (ID: {service_id_to_find}): {service.name} (Категория: {service.category_name})")
else:
print(f"Сервис с ID {service_id_to_find} не найден.")
if__name__=="__main__":
asyncio.run(main())

🧪 Запуск тестов

Для запуска тестов используйте pytest:

uv run pytest

🤝 Участие

Мы приветствуем любой вклад в развитие проекта! Пожалуйста, ознакомьтесь с нашим руководством по участию и кодексом поведения.

📄 Лицензия

Этот проект распространяется под лицензией MIT. Подробности смотрите в файле LICENSE.

❓ Поддержка

Если у вас есть вопросы, предложения или вы столкнулись с проблемой, пожалуйста, создайте Issue на GitHub. Мы постараемся ответить как можно скорее.