cheatbot 0.1.0

Асинхронная Python-библиотека для взаимодействия с API сервиса CheatBot.

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

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

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

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

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

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

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

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

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

Чтобы использовать библиотеку в своем проекте, вы можете установить ее прямо из PyPI или GitHub:

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

pip install cheatbot

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

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

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

import asyncio
import os

from cheatbot import CheatBotClient

async def main():
    # Убедитесь, что переменная окружения CHEATBOT_API_KEY установлена
    api_key = os.getenv("CHEATBOT_API_KEY")
    if not api_key:
        raise ValueError("Переменная окружения CHEATBOT_API_KEY не установлена. Пожалуйста, установите ее.")

    # Инициализация клиента. Используйте async with для автоматического закрытия сессии.
    async with CheatBotClient(api_key) as client:
        print("\n--- Информация о профиле ---")
        profile = await client.get_profile_info()
        print(f"Баланс: {profile.balance} RUB")
        print(f"ID пользователя: {profile.user_id}")

        print("\n--- Доступные сервисы ---")
        # Получение всех сервисов
        services = client.services.get_all()
        print(f"Всего доступных сервисов: {len(services)}")

        # Пример поиска конкретного сервиса по ID
        service_id_to_find = 40 # Пример ID сервиса
        service = client.services.get_by_id(service_id_to_find)
        if service:
            print(f"Найден сервис (ID: {service_id_to_find}): {service.name} (Категория: {service.category_name})")
        else:
            print(f"Сервис с ID {service_id_to_find} не найден.")

        # Пример создания задачи (замените на реальные данные)
        # try:
        #     new_task = await client.create_task(
        #         service_id=1, # Замените на реальный ID сервиса
        #         link="https://example.com/post", # Замените на реальную ссылку
        #         quantity=10 # Замените на желаемое количество
        #     )
        #     print(f"\nЗадача успешно создана! ID задачи: {new_task.id}, Статус: {new_task.status}")
        # except Exception as e:
        #     print(f"\nОшибка при создании задачи: {e}")

if __name__ == "__main__":
    asyncio.run(main())

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

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

uv run pytest

🤝 Участие

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

📄 Лицензия

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

❓ Поддержка

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