Конфигурация
=============

Настройка HTTP-транспорта, обработка ошибок и управление соединением.


HttpConfig
----------

HTTP-параметры передаются при создании бота через объект
``HttpConfig``:

.. code-block:: python

    from vk_bot import VKBot
    from vk_bot.config import HttpConfig

    config = HttpConfig(
        timeout=60,            # Таймаут обычных запросов (сек), по умолчанию 30
        long_poll_timeout=30,  # Таймаут Long Poll (сек), по умолчанию 25
        retries=5,             # Количество повторных попыток, по умолчанию 3
        proxy="http://proxy.example.com:8080",  # HTTP-прокси (опционально)
    )

    bot = VKBot(token="YOUR_TOKEN", http_config=config)

Параметры по умолчанию:

=======================  ==========================  =======================
Параметр                 По умолчанию                Описание
=======================  ==========================  =======================
``timeout``              ``30``                      Таймаут запросов (сек)
``long_poll_timeout``    ``25``                      Таймаут Long Poll (сек)
``retries``              ``3``                       Количество ретраев
``proxy``                ``None``                    HTTP-прокси
``user_agent``           ``"VK Bot Python/0.1"``     User-Agent заголовок
=======================  ==========================  =======================


Автоматические ретраи
---------------------

HTTP-клиент автоматически повторяет запросы с экспоненциальной задержкой
при следующих ситуациях:

- Код ответа ``429`` (Too Many Requests)
- Коды ``5xx`` (ошибки сервера)
- Ошибки соединения (таймаут, обрыв)

Количество повторных попыток задаётся параметром ``retries`` в ``HttpConfig``.


Прокси
------

Для работы через прокси укажите URL в поле ``proxy``:

.. code-block:: python

    config = HttpConfig(proxy="http://user:password@proxy.example.com:3128")
    bot = VKBot(token="YOUR_TOKEN", http_config=config)

Поддерживаются HTTP-прокси (через ``httpx``).


ID сообщества
-------------

По умолчанию ``group_id`` определяется автоматически по токену.
Если нужно указать явно:

.. code-block:: python

    bot = VKBot(token="YOUR_TOKEN", group_id=123456789)

Свойства бота:

.. code-block:: python

    bot.token      # Токен бота
    bot.group_id   # ID сообщества (авто-определение при первом обращении)
    bot.me         # Объект User бота