Arizona Forum API Async

Асинхронная Python библиотека для взаимодействия с форумом Arizona RP (forum.arizona-rp.com) без необходимости получения API ключа.

Эта библиотека предоставляет современный, асинхронный интерфейс для работы с форумом Arizona RP. Это расширенная и улучшенная асинхронная версия оригинальной библиотеки Arizona-API от TastyBread123, построенная с использованием aiohttp.

✨ Ключевые особенности

• Полностью асинхронная: Построена с использованием asyncio и aiohttp.
• Не требует API ключа: Взаимодействует с форумом, имитируя запросы браузера, что избавляет от необходимости получать официальные ключи XenForo API.
• Обширная функциональность: Поддерживает около 48 методов.
• Объектно-ориентированные модели: Представляет сущности форума, такие как Member, Thread, Post, Category, в виде Python объектов с соответствующими методами.
• Простота использования: Предоставляет чистую и интуитивно понятную структуру API.

📦 Установка и обновление

Установите или обновите библиотеку напрямую из PyPI:

pip install arizona-forum-api-async

Для обновления:

pip install --upgrade arizona-forum-api-async

Если хотите собрать библиотеку вручную:

1. Скачайте репозиторий и перейдите в него:

git clone https://github.com/fakelag28/Arizona-Forum-API-Async.git
cd Arizona-Forum-API-Async

2. Обновите инструменты сборки и соберите дистрибутив:

python -m pip install --upgrade pip setuptools wheel build
python -m build
python -m pip install dist/*.whl

Можно пропустить сборку и сразу установить:

python -m pip install .

🔑 Аутентификация и настройка

Поскольку эта библиотека имитирует действия залогиненного пользователя, вам потребуются Cookie из вашей браузерной сессии на forum.arizona-rp.com:

Как их получить:

1. Войдите в свой форумный аккаунт на forum.arizona-rp.com;
2. Установите двухфакторную аутентификацию и перезайдите в свой аккаунт;
3. Установите расширение "Cookie Editor", после чего с его помощью получите следующие значения:

• xf_tfa_trust
• xf_user

🌐 Прокси

Все запросы библиотеки (включая обход анти-бота) можно направить через прокси:

forum_api = arz_api.ArizonaForumAPI(cookie=cookies, proxy="socks5://login:password@1.2.3.4:1080")

Поддерживаются схемы http, https, socks4, socks4a, socks5, socks5h. Если схема не указана, подставляется http://, поэтому можно передавать и просто 1.2.3.4:8080.

При неверной схеме выбрасывается исключение IncorrectProxyData.

📝 Логирование

Библиотека использует стандартный модуль logging и по умолчанию не выводит логи в консоль. Чтобы включить подробное логирование:

import logging
import arizona_forum_async as arz_api

arz_api.configure_logging(level=logging.DEBUG)

Логи включают подключение, закрытие сессии, прохождение очереди, HTTP-статусы, длительность запросов, сетевые ошибки и события L7-антибота. Cookie, CSRF-токены и тела запросов в лог не записываются.

📚 Документация и примеры

• Папка с примерами: Практические примеры, демонстрирующие различные возможности библиотеки.

📄 Лицензия

Этот проект лицензирован под MIT License.