apikeyrotator 0.0.2__tar.gz

apikeyrotator-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Prime Evolution
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

apikeyrotator-0.0.2/PKG-INFO

@@ -0,0 +1,335 @@
+Metadata-Version: 2.4
+Name: apikeyrotator
+Version: 0.0.2
+Summary: Ultra simple API key rotation for bypassing rate limits
+Author-email: Prime Evolution <develop@eclips-team.ru>
+License: MIT License
+        
+        Copyright (c) 2024 Prime Evolution
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Homepage, https://github.com/PrimeevolutionZ/apikeyrotator
+Project-URL: Repository, https://github.com/PrimeevolutionZ/apikeyrotator
+Project-URL: Issues, https://github.com/PrimeevolutionZ/apikeyrotator/issues
+Keywords: api,rotation,rate limit,requests
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# API Key Rotator 🔄
+
+Простая, но мощная библиотека для автоматического вращения API ключей. Обходит лимиты запросов, обрабатывает ошибки 429 и делает ваши запросы неуязвимыми к ограничениям API.
+
+## Особенности ✨
+
+- 🔄 **Автоматическое вращение ключей** - Round-robin алгоритм
+- ⚡ **Автодетект авторизации** - Сам определяет Bearer/API-Key формат
+- 🔁 **Умные ретраи** - Экспоненциальная задержка при ошибках
+- 🛡️ **Обработка ошибок** - 429, 500, 502, 503, 504 автоматически
+- 💻 **Полная совместимость** с библиотекой `requests`
+- 📝 **Понятные ошибки** - Подсказки как исправить проблемы
+
+## Установка 📦
+
+```bash
+pip install apikeyrotator
+```
+
+Или из исходников:
+
+```bash
+git clone https://github.com/PrimeevolutionZ/apikeyrotator.git
+cd apikeyrotator
+pip install -e .
+```
+
+## Быстрый старт 🚀
+
+### Способ 1: Передача ключей напрямую
+
+```python
+from apikeyrotator import APIKeyRotator
+
+# Просто передайте ключи списком
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# Или строкой через запятую
+rotator = APIKeyRotator(api_keys="key1,key2,key3")
+
+# Используйте как обычный requests!
+response = rotator.get("https://api.example.com/data")
+print(response.json())
+```
+
+### Способ 2: Использование переменных окружения
+
+Создайте файл `.env` в корне проекта:
+```env
+API_KEYS=your_key_1,your_key_2,your_key_3
+```
+
+Или установите переменную окружения:
+```bash
+# Linux/Mac
+export API_KEYS="your_key_1,your_key_2,your_key_3"
+
+# Windows
+set API_KEYS=your_key_1,your_key_2,your_key_3
+```
+
+Теперь просто инициализируйте ротатор:
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator()  # Автоматически найдет API_KEYS
+
+response = rotator.get("https://api.example.com/data")
+```
+
+## Примеры использования 📖
+
+### Базовые HTTP-запросы
+
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# GET запрос
+response = rotator.get("https://api.example.com/users")
+
+# POST запрос с данными
+response = rotator.post(
+    "https://api.example.com/users",
+    json={"name": "John", "email": "john@example.com"}
+)
+
+# PUT запрос
+response = rotator.put(
+    "https://api.example.com/users/1",
+    json={"name": "John Updated"}
+)
+
+# DELETE запрос
+response = rotator.delete("https://api.example.com/users/1")
+```
+
+### Кастомные заголовки авторизации
+
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator(api_keys=["key1", "key2"])
+
+# Кастомный заголовок авторизации
+response = rotator.get(
+    "https://api.example.com/data",
+    headers={"X-Custom-Auth": "custom_value"}
+)
+
+# Или переопределите авторизацию полностью
+response = rotator.get(
+    "https://api.example.com/data",
+    headers={"Authorization": "Custom your_token_here"}
+)
+```
+
+### Работа с параметрами запроса
+
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# Параметры запроса
+response = rotator.get(
+    "https://api.example.com/search",
+    params={"query": "python", "limit": 10}
+)
+
+# JSON данные
+response = rotator.post(
+    "https://api.example.com/items",
+    json={"name": "New Item", "price": 99.99}
+)
+
+# Таймаут
+response = rotator.get(
+    "https://api.example.com/data",
+    timeout=10
+)
+```
+
+### Обработка ошибок
+
+```python
+from apikeyrotator import APIKeyRotator, AllKeysExhaustedError
+
+rotator = APIKeyRotator(api_keys=["key1", "key2"], max_retries=5)
+
+try:
+    response = rotator.get("https://api.example.com/limited")
+    print("Успех!", response.json())
+except AllKeysExhaustedError as e:
+    print("Все ключи исчерпаны:", e)
+except Exception as e:
+    print("Другая ошибка:", e)
+```
+
+## Расширенные настройки ⚙️
+
+### Кастомизация параметров
+
+```python
+from apikeyrotator import APIKeyRotator
+
+# Все параметры настройки
+rotator = APIKeyRotator(
+    api_keys=["key1", "key2", "key3"],  # Ключи
+    env_var="CUSTOM_API_KEYS",          # Кастомная переменная окружения
+    max_retries=5,                      # Максимум попыток
+    base_delay=2.0                      # Базовая задержка между попытками
+)
+
+print(f"Количество ключей: {len(rotator)}")
+print(f"Максимум попыток: {rotator.max_retries}")
+```
+
+### Интеграция с существующим кодом
+
+```python
+from apikeyrotator import APIKeyRotator
+import requests
+
+# Существующий код с requests
+response = requests.get("https://api.example.com/data")
+
+# Легко замените на APIKeyRotator
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+response = rotator.get("https://api.example.com/data")  # Тот же API!
+```
+
+## Best Practices ✅
+
+### 1. Используйте переменные окружения для безопасности
+
+```bash
+# Никогда не храните ключи в коде!
+# Вместо этого используйте .env файл или переменные окружения
+export API_KEYS="your_production_key_1,your_production_key_2"
+```
+
+### 2. Настройте адекватное количество попыток
+
+```python
+# Для 3 ключей и 2 попыток на ключ = 6 всего попыток
+rotator = APIKeyRotator(
+    api_keys=["key1", "key2", "key3"],
+    max_retries=6
+)
+```
+
+### 3. Мониторинг использования ключей
+
+```python
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# После нескольких запросов можно посмотреть статистику
+for i in range(10):
+    rotator.get("https://api.example.com/test")
+
+print("Ротатор отработал", len(rotator), "запросов")
+```
+
+## Обработка ошибок ❌
+
+Библиотека предоставляет понятные сообщения об ошибках:
+
+### Если ключи не найдены
+
+```
+❌ No API keys found.
+   Please either:
+   1. Pass keys directly: APIKeyRotator(api_keys=['key1', 'key2'])
+   2. Set environment variable: export API_KEYS='key1,key2'
+   3. Create .env file with: API_KEYS=key1,key2
+```
+
+### Если все ключи исчерпаны
+
+```python
+try:
+    response = rotator.get("https://api.example.com/limited")
+except AllKeysExhaustedError as e:
+    print(e)  # "All 3 keys exhausted after 6 attempts"
+```
+
+## Совместимость 🔄
+
+- **Python**: 3.7+
+- **Зависимости**: только `requests>=2.25.0`
+
+## Разработка 🛠️
+
+### Установка для разработки
+
+```bash
+git clone https://github.com/PrimeevolutionZ/apikeyrotator.git
+cd apikeyrotator
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# или
+venv\Scripts\activate     # Windows
+pip install -e .[dev]
+```
+
+### Запуск тестов
+
+```bash
+pytest tests/
+```
+
+### Сборка пакета
+
+```bash
+python setup.py sdist bdist_wheel
+```
+
+## Лицензия 📄
+
+MIT License - смотрите файл [LICENSE](LICENSE) для деталей.
+
+## Поддержка 🤝
+
+Нашли баг или есть предложения? [Создайте issue](https://github.com/yourusername/apikeyrotator/issues) на GitHub!
+
+---
+
+**API Key Rotator** - сделайте ваши API запросы неуязвимыми к ограничениям! 🚀

apikeyrotator-0.0.2/README.md

@@ -0,0 +1,290 @@
+# API Key Rotator 🔄
+
+Простая, но мощная библиотека для автоматического вращения API ключей. Обходит лимиты запросов, обрабатывает ошибки 429 и делает ваши запросы неуязвимыми к ограничениям API.
+
+## Особенности ✨
+
+- 🔄 **Автоматическое вращение ключей** - Round-robin алгоритм
+- ⚡ **Автодетект авторизации** - Сам определяет Bearer/API-Key формат
+- 🔁 **Умные ретраи** - Экспоненциальная задержка при ошибках
+- 🛡️ **Обработка ошибок** - 429, 500, 502, 503, 504 автоматически
+- 💻 **Полная совместимость** с библиотекой `requests`
+- 📝 **Понятные ошибки** - Подсказки как исправить проблемы
+
+## Установка 📦
+
+```bash
+pip install apikeyrotator
+```
+
+Или из исходников:
+
+```bash
+git clone https://github.com/PrimeevolutionZ/apikeyrotator.git
+cd apikeyrotator
+pip install -e .
+```
+
+## Быстрый старт 🚀
+
+### Способ 1: Передача ключей напрямую
+
+```python
+from apikeyrotator import APIKeyRotator
+
+# Просто передайте ключи списком
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# Или строкой через запятую
+rotator = APIKeyRotator(api_keys="key1,key2,key3")
+
+# Используйте как обычный requests!
+response = rotator.get("https://api.example.com/data")
+print(response.json())
+```
+
+### Способ 2: Использование переменных окружения
+
+Создайте файл `.env` в корне проекта:
+```env
+API_KEYS=your_key_1,your_key_2,your_key_3
+```
+
+Или установите переменную окружения:
+```bash
+# Linux/Mac
+export API_KEYS="your_key_1,your_key_2,your_key_3"
+
+# Windows
+set API_KEYS=your_key_1,your_key_2,your_key_3
+```
+
+Теперь просто инициализируйте ротатор:
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator()  # Автоматически найдет API_KEYS
+
+response = rotator.get("https://api.example.com/data")
+```
+
+## Примеры использования 📖
+
+### Базовые HTTP-запросы
+
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# GET запрос
+response = rotator.get("https://api.example.com/users")
+
+# POST запрос с данными
+response = rotator.post(
+    "https://api.example.com/users",
+    json={"name": "John", "email": "john@example.com"}
+)
+
+# PUT запрос
+response = rotator.put(
+    "https://api.example.com/users/1",
+    json={"name": "John Updated"}
+)
+
+# DELETE запрос
+response = rotator.delete("https://api.example.com/users/1")
+```
+
+### Кастомные заголовки авторизации
+
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator(api_keys=["key1", "key2"])
+
+# Кастомный заголовок авторизации
+response = rotator.get(
+    "https://api.example.com/data",
+    headers={"X-Custom-Auth": "custom_value"}
+)
+
+# Или переопределите авторизацию полностью
+response = rotator.get(
+    "https://api.example.com/data",
+    headers={"Authorization": "Custom your_token_here"}
+)
+```
+
+### Работа с параметрами запроса
+
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# Параметры запроса
+response = rotator.get(
+    "https://api.example.com/search",
+    params={"query": "python", "limit": 10}
+)
+
+# JSON данные
+response = rotator.post(
+    "https://api.example.com/items",
+    json={"name": "New Item", "price": 99.99}
+)
+
+# Таймаут
+response = rotator.get(
+    "https://api.example.com/data",
+    timeout=10
+)
+```
+
+### Обработка ошибок
+
+```python
+from apikeyrotator import APIKeyRotator, AllKeysExhaustedError
+
+rotator = APIKeyRotator(api_keys=["key1", "key2"], max_retries=5)
+
+try:
+    response = rotator.get("https://api.example.com/limited")
+    print("Успех!", response.json())
+except AllKeysExhaustedError as e:
+    print("Все ключи исчерпаны:", e)
+except Exception as e:
+    print("Другая ошибка:", e)
+```
+
+## Расширенные настройки ⚙️
+
+### Кастомизация параметров
+
+```python
+from apikeyrotator import APIKeyRotator
+
+# Все параметры настройки
+rotator = APIKeyRotator(
+    api_keys=["key1", "key2", "key3"],  # Ключи
+    env_var="CUSTOM_API_KEYS",          # Кастомная переменная окружения
+    max_retries=5,                      # Максимум попыток
+    base_delay=2.0                      # Базовая задержка между попытками
+)
+
+print(f"Количество ключей: {len(rotator)}")
+print(f"Максимум попыток: {rotator.max_retries}")
+```
+
+### Интеграция с существующим кодом
+
+```python
+from apikeyrotator import APIKeyRotator
+import requests
+
+# Существующий код с requests
+response = requests.get("https://api.example.com/data")
+
+# Легко замените на APIKeyRotator
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+response = rotator.get("https://api.example.com/data")  # Тот же API!
+```
+
+## Best Practices ✅
+
+### 1. Используйте переменные окружения для безопасности
+
+```bash
+# Никогда не храните ключи в коде!
+# Вместо этого используйте .env файл или переменные окружения
+export API_KEYS="your_production_key_1,your_production_key_2"
+```
+
+### 2. Настройте адекватное количество попыток
+
+```python
+# Для 3 ключей и 2 попыток на ключ = 6 всего попыток
+rotator = APIKeyRotator(
+    api_keys=["key1", "key2", "key3"],
+    max_retries=6
+)
+```
+
+### 3. Мониторинг использования ключей
+
+```python
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# После нескольких запросов можно посмотреть статистику
+for i in range(10):
+    rotator.get("https://api.example.com/test")
+
+print("Ротатор отработал", len(rotator), "запросов")
+```
+
+## Обработка ошибок ❌
+
+Библиотека предоставляет понятные сообщения об ошибках:
+
+### Если ключи не найдены
+
+```
+❌ No API keys found.
+   Please either:
+   1. Pass keys directly: APIKeyRotator(api_keys=['key1', 'key2'])
+   2. Set environment variable: export API_KEYS='key1,key2'
+   3. Create .env file with: API_KEYS=key1,key2
+```
+
+### Если все ключи исчерпаны
+
+```python
+try:
+    response = rotator.get("https://api.example.com/limited")
+except AllKeysExhaustedError as e:
+    print(e)  # "All 3 keys exhausted after 6 attempts"
+```
+
+## Совместимость 🔄
+
+- **Python**: 3.7+
+- **Зависимости**: только `requests>=2.25.0`
+
+## Разработка 🛠️
+
+### Установка для разработки
+
+```bash
+git clone https://github.com/PrimeevolutionZ/apikeyrotator.git
+cd apikeyrotator
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# или
+venv\Scripts\activate     # Windows
+pip install -e .[dev]
+```
+
+### Запуск тестов
+
+```bash
+pytest tests/
+```
+
+### Сборка пакета
+
+```bash
+python setup.py sdist bdist_wheel
+```
+
+## Лицензия 📄
+
+MIT License - смотрите файл [LICENSE](LICENSE) для деталей.
+
+## Поддержка 🤝
+
+Нашли баг или есть предложения? [Создайте issue](https://github.com/yourusername/apikeyrotator/issues) на GitHub!
+
+---
+
+**API Key Rotator** - сделайте ваши API запросы неуязвимыми к ограничениям! 🚀

apikeyrotator-0.0.2/apikeyrotator/__init__.py

@@ -0,0 +1,13 @@
+from .rotator import APIKeyRotator
+from .exceptions import APIKeyError, NoAPIKeysError, AllKeysExhaustedError
+
+__version__ = "0.0.2"
+__author__ = "Prime Evolution"
+__email__ = "develop@eclps-team.ru"
+
+__all__ = [
+    'APIKeyRotator',
+    'APIKeyError',
+    'NoAPIKeysError',
+    'AllKeysExhaustedError'
+]

apikeyrotator-0.0.2/apikeyrotator/exceptions.py

@@ -0,0 +1,11 @@
+class APIKeyError(Exception):
+    """Базовое исключение для ошибок API ключей"""
+    pass
+
+class NoAPIKeysError(APIKeyError):
+    """Не найдено ни одного API ключа"""
+    pass
+
+class AllKeysExhaustedError(APIKeyError):
+    """Все ключи исчерпаны"""
+    pass

apikeyrotator-0.0.2/apikeyrotator/rotator.py

@@ -0,0 +1,162 @@
+import os
+import time
+import requests
+from typing import List, Optional, Dict, Union, Callable
+from .exceptions import NoAPIKeysError, AllKeysExhaustedError
+
+
+class APIKeyRotator:
+    """
+    Супер-простой в использовании, но мощный ротатор API ключей.
+    Автоматически обрабатывает лимиты, ошибки и ретраи.
+    """
+
+    def __init__(
+            self,
+            api_keys: Optional[Union[List[str], str]] = None,
+            env_var: str = "API_KEYS",
+            max_retries: int = 3,
+            base_delay: float = 1.0
+    ):
+        """
+        Простая инициализация - передай ключи или используй переменные окружения
+
+        :param api_keys: Список ключей или строка с ключами через запятую
+        :param env_var: Имя переменной окружения
+        :param max_retries: Максимальное количество попыток
+        :param base_delay: Базовая задержка между попытками
+        """
+        self.keys = self._parse_keys(api_keys, env_var)
+        self.max_retries = max_retries
+        self.base_delay = base_delay
+        self.current_index = 0
+        self.session = requests.Session()
+        print(f"✅ APIKeyRotator инициализирован с {len(self.keys)} ключами")
+
+    def _parse_keys(self, api_keys, env_var) -> List[str]:
+        """Умный парсинг ключей из разных источников с понятными ошибками"""
+        # Если ключи переданы напрямую
+        if api_keys is not None:
+            if isinstance(api_keys, str):
+                keys = [k.strip() for k in api_keys.split(",") if k.strip()]
+            elif isinstance(api_keys, list):
+                keys = api_keys
+            else:
+                raise NoAPIKeysError("❌ API keys must be a list or comma-separated string")
+
+            if not keys:
+                raise NoAPIKeysError("❌ No API keys provided in the api_keys parameter")
+
+            return keys
+
+        # Если ключи ищем в переменных окружения
+        keys_str = os.getenv(env_var)
+
+        if keys_str is None:
+            raise NoAPIKeysError(
+                f"❌ No API keys found.\n"
+                f"   Please either:\n"
+                f"   1. Pass keys directly: APIKeyRotator(api_keys=['key1', 'key2'])\n"
+                f"   2. Set environment variable: export {env_var}='key1,key2'\n"
+                f"   3. Create .env file with: {env_var}=key1,key2"
+            )
+
+        if not keys_str.strip():
+            raise NoAPIKeysError(
+                f"❌ Environment variable ${env_var} is empty.\n"
+                f"   Please set it with: export {env_var}='your_key1,your_key2'"
+            )
+
+        keys = [k.strip() for k in keys_str.split(",") if k.strip()]
+
+        if not keys:
+            raise NoAPIKeysError(
+                f"❌ No valid API keys found in ${env_var}.\n"
+                f"   Format should be: key1,key2,key3\n"
+                f"   Current value: '{keys_str}'"
+            )
+
+        return keys
+
+    def get_next_key(self) -> str:
+        """Получить следующий ключ"""
+        key = self.keys[self.current_index]
+        self.current_index = (self.current_index + 1) % len(self.keys)
+        return key
+
+    def _should_retry(self, response: requests.Response) -> bool:
+        """Определяет, нужно ли повторять запрос"""
+        return response.status_code in [429, 500, 502, 503, 504]
+
+    def _prepare_headers(self, key: str, custom_headers: dict) -> dict:
+        """Подготавливает заголовки с авторизацией"""
+        headers = custom_headers.copy() if custom_headers else {}
+
+        # Автоматически определяем тип авторизации
+        if "Authorization" not in headers:
+            if key.startswith("sk-") or key.startswith("pk-"):  # OpenAI style
+                headers["Authorization"] = f"Bearer {key}"
+            elif len(key) == 32:  # API key style
+                headers["X-API-Key"] = key
+            else:  # Default
+                headers["Authorization"] = f"Key {key}"
+
+        return headers
+
+    def request(
+            self,
+            method: str,
+            url: str,
+            **kwargs
+    ) -> requests.Response:
+        """
+        Выполняет запрос. Просто как requests, но с ротацией ключей!
+        """
+
+        for attempt in range(self.max_retries):
+            key = self.get_next_key()
+
+            # Автоматически готовим заголовки
+            kwargs['headers'] = self._prepare_headers(key, kwargs.get('headers', {}))
+
+            try:
+                response = self.session.request(method, url, **kwargs)
+
+                if not self._should_retry(response):
+                    return response
+
+                print(f"↻ Attempt {attempt + 1}/{self.max_retries}. Key {key[:8]}... rate limited")
+
+            except requests.RequestException as e:
+                print(f"⚠️ Network error: {e}. Trying next key...")
+
+            # Экспоненциальная задержка
+            if attempt < self.max_retries - 1:
+                delay = self.base_delay * (2 ** attempt)
+                time.sleep(delay)
+
+        raise AllKeysExhaustedError(f"All {len(self.keys)} keys exhausted after {self.max_retries} attempts")
+
+    # Простейшие методы-обертки
+    def get(self, url, **kwargs):
+        return self.request('GET', url, **kwargs)
+
+    def post(self, url, **kwargs):
+        return self.request('POST', url, **kwargs)
+
+    def put(self, url, **kwargs):
+        return self.request('PUT', url, **kwargs)
+
+    def delete(self, url, **kwargs):
+        return self.request('DELETE', url, **kwargs)
+
+    # Удобные свойства
+    @property
+    def key_count(self):
+        return len(self.keys)
+
+    def __len__(self):
+        return len(self.keys)
+
+    def __repr__(self):
+        return f"<APIKeyRotator keys={self.key_count} retries={self.max_retries}>"

apikeyrotator-0.0.2/apikeyrotator/utils.py

@@ -0,0 +1,29 @@
+import time
+from typing import Callable, Any, Type
+import requests
+
+
+def retry_with_backoff(
+        func: Callable,
+        retries: int = 3,
+        backoff_factor: float = 0.5,
+        exceptions: Type[Exception] = Exception
+) -> Any:
+    """
+    Универсальная функция для повторных попыток с экспоненциальной задержкой.
+
+    Пример использования:
+    response = retry_with_backoff(
+        lambda: requests.get('https://api.example.com'),
+        exceptions=requests.RequestException
+    )
+    """
+    for attempt in range(retries):
+        try:
+            return func()
+        except exceptions as e:
+            if attempt == retries - 1:
+                raise e
+            delay = backoff_factor * (2 ** attempt)
+            time.sleep(delay)
+            print(f"Retry {attempt + 1}/{retries} after {delay:.1f}s delay")

apikeyrotator-0.0.2/apikeyrotator.egg-info/PKG-INFO

@@ -0,0 +1,335 @@
+Metadata-Version: 2.4
+Name: apikeyrotator
+Version: 0.0.2
+Summary: Ultra simple API key rotation for bypassing rate limits
+Author-email: Prime Evolution <develop@eclips-team.ru>
+License: MIT License
+        
+        Copyright (c) 2024 Prime Evolution
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Homepage, https://github.com/PrimeevolutionZ/apikeyrotator
+Project-URL: Repository, https://github.com/PrimeevolutionZ/apikeyrotator
+Project-URL: Issues, https://github.com/PrimeevolutionZ/apikeyrotator/issues
+Keywords: api,rotation,rate limit,requests
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# API Key Rotator 🔄
+
+Простая, но мощная библиотека для автоматического вращения API ключей. Обходит лимиты запросов, обрабатывает ошибки 429 и делает ваши запросы неуязвимыми к ограничениям API.
+
+## Особенности ✨
+
+- 🔄 **Автоматическое вращение ключей** - Round-robin алгоритм
+- ⚡ **Автодетект авторизации** - Сам определяет Bearer/API-Key формат
+- 🔁 **Умные ретраи** - Экспоненциальная задержка при ошибках
+- 🛡️ **Обработка ошибок** - 429, 500, 502, 503, 504 автоматически
+- 💻 **Полная совместимость** с библиотекой `requests`
+- 📝 **Понятные ошибки** - Подсказки как исправить проблемы
+
+## Установка 📦
+
+```bash
+pip install apikeyrotator
+```
+
+Или из исходников:
+
+```bash
+git clone https://github.com/PrimeevolutionZ/apikeyrotator.git
+cd apikeyrotator
+pip install -e .
+```
+
+## Быстрый старт 🚀
+
+### Способ 1: Передача ключей напрямую
+
+```python
+from apikeyrotator import APIKeyRotator
+
+# Просто передайте ключи списком
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# Или строкой через запятую
+rotator = APIKeyRotator(api_keys="key1,key2,key3")
+
+# Используйте как обычный requests!
+response = rotator.get("https://api.example.com/data")
+print(response.json())
+```
+
+### Способ 2: Использование переменных окружения
+
+Создайте файл `.env` в корне проекта:
+```env
+API_KEYS=your_key_1,your_key_2,your_key_3
+```
+
+Или установите переменную окружения:
+```bash
+# Linux/Mac
+export API_KEYS="your_key_1,your_key_2,your_key_3"
+
+# Windows
+set API_KEYS=your_key_1,your_key_2,your_key_3
+```
+
+Теперь просто инициализируйте ротатор:
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator()  # Автоматически найдет API_KEYS
+
+response = rotator.get("https://api.example.com/data")
+```
+
+## Примеры использования 📖
+
+### Базовые HTTP-запросы
+
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# GET запрос
+response = rotator.get("https://api.example.com/users")
+
+# POST запрос с данными
+response = rotator.post(
+    "https://api.example.com/users",
+    json={"name": "John", "email": "john@example.com"}
+)
+
+# PUT запрос
+response = rotator.put(
+    "https://api.example.com/users/1",
+    json={"name": "John Updated"}
+)
+
+# DELETE запрос
+response = rotator.delete("https://api.example.com/users/1")
+```
+
+### Кастомные заголовки авторизации
+
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator(api_keys=["key1", "key2"])
+
+# Кастомный заголовок авторизации
+response = rotator.get(
+    "https://api.example.com/data",
+    headers={"X-Custom-Auth": "custom_value"}
+)
+
+# Или переопределите авторизацию полностью
+response = rotator.get(
+    "https://api.example.com/data",
+    headers={"Authorization": "Custom your_token_here"}
+)
+```
+
+### Работа с параметрами запроса
+
+```python
+from apikeyrotator import APIKeyRotator
+
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# Параметры запроса
+response = rotator.get(
+    "https://api.example.com/search",
+    params={"query": "python", "limit": 10}
+)
+
+# JSON данные
+response = rotator.post(
+    "https://api.example.com/items",
+    json={"name": "New Item", "price": 99.99}
+)
+
+# Таймаут
+response = rotator.get(
+    "https://api.example.com/data",
+    timeout=10
+)
+```
+
+### Обработка ошибок
+
+```python
+from apikeyrotator import APIKeyRotator, AllKeysExhaustedError
+
+rotator = APIKeyRotator(api_keys=["key1", "key2"], max_retries=5)
+
+try:
+    response = rotator.get("https://api.example.com/limited")
+    print("Успех!", response.json())
+except AllKeysExhaustedError as e:
+    print("Все ключи исчерпаны:", e)
+except Exception as e:
+    print("Другая ошибка:", e)
+```
+
+## Расширенные настройки ⚙️
+
+### Кастомизация параметров
+
+```python
+from apikeyrotator import APIKeyRotator
+
+# Все параметры настройки
+rotator = APIKeyRotator(
+    api_keys=["key1", "key2", "key3"],  # Ключи
+    env_var="CUSTOM_API_KEYS",          # Кастомная переменная окружения
+    max_retries=5,                      # Максимум попыток
+    base_delay=2.0                      # Базовая задержка между попытками
+)
+
+print(f"Количество ключей: {len(rotator)}")
+print(f"Максимум попыток: {rotator.max_retries}")
+```
+
+### Интеграция с существующим кодом
+
+```python
+from apikeyrotator import APIKeyRotator
+import requests
+
+# Существующий код с requests
+response = requests.get("https://api.example.com/data")
+
+# Легко замените на APIKeyRotator
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+response = rotator.get("https://api.example.com/data")  # Тот же API!
+```
+
+## Best Practices ✅
+
+### 1. Используйте переменные окружения для безопасности
+
+```bash
+# Никогда не храните ключи в коде!
+# Вместо этого используйте .env файл или переменные окружения
+export API_KEYS="your_production_key_1,your_production_key_2"
+```
+
+### 2. Настройте адекватное количество попыток
+
+```python
+# Для 3 ключей и 2 попыток на ключ = 6 всего попыток
+rotator = APIKeyRotator(
+    api_keys=["key1", "key2", "key3"],
+    max_retries=6
+)
+```
+
+### 3. Мониторинг использования ключей
+
+```python
+rotator = APIKeyRotator(api_keys=["key1", "key2", "key3"])
+
+# После нескольких запросов можно посмотреть статистику
+for i in range(10):
+    rotator.get("https://api.example.com/test")
+
+print("Ротатор отработал", len(rotator), "запросов")
+```
+
+## Обработка ошибок ❌
+
+Библиотека предоставляет понятные сообщения об ошибках:
+
+### Если ключи не найдены
+
+```
+❌ No API keys found.
+   Please either:
+   1. Pass keys directly: APIKeyRotator(api_keys=['key1', 'key2'])
+   2. Set environment variable: export API_KEYS='key1,key2'
+   3. Create .env file with: API_KEYS=key1,key2
+```
+
+### Если все ключи исчерпаны
+
+```python
+try:
+    response = rotator.get("https://api.example.com/limited")
+except AllKeysExhaustedError as e:
+    print(e)  # "All 3 keys exhausted after 6 attempts"
+```
+
+## Совместимость 🔄
+
+- **Python**: 3.7+
+- **Зависимости**: только `requests>=2.25.0`
+
+## Разработка 🛠️
+
+### Установка для разработки
+
+```bash
+git clone https://github.com/PrimeevolutionZ/apikeyrotator.git
+cd apikeyrotator
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# или
+venv\Scripts\activate     # Windows
+pip install -e .[dev]
+```
+
+### Запуск тестов
+
+```bash
+pytest tests/
+```
+
+### Сборка пакета
+
+```bash
+python setup.py sdist bdist_wheel
+```
+
+## Лицензия 📄
+
+MIT License - смотрите файл [LICENSE](LICENSE) для деталей.
+
+## Поддержка 🤝
+
+Нашли баг или есть предложения? [Создайте issue](https://github.com/yourusername/apikeyrotator/issues) на GitHub!
+
+---
+
+**API Key Rotator** - сделайте ваши API запросы неуязвимыми к ограничениям! 🚀

apikeyrotator-0.0.2/apikeyrotator.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+apikeyrotator/__init__.py
+apikeyrotator/exceptions.py
+apikeyrotator/rotator.py
+apikeyrotator/utils.py
+apikeyrotator.egg-info/PKG-INFO
+apikeyrotator.egg-info/SOURCES.txt
+apikeyrotator.egg-info/dependency_links.txt
+apikeyrotator.egg-info/requires.txt
+apikeyrotator.egg-info/top_level.txt

apikeyrotator-0.0.2/apikeyrotator.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

apikeyrotator-0.0.2/apikeyrotator.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

apikeyrotator-0.0.2/apikeyrotator.egg-info/top_level.txt

@@ -0,0 +1 @@
+apikeyrotator

apikeyrotator-0.0.2/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "apikeyrotator"
+version = "0.0.2"
+description = "Ultra simple API key rotation for bypassing rate limits"
+readme = "README.md"
+authors = [
+    { name = "Prime Evolution", email = "develop@eclips-team.ru" }
+]
+license = { file = "LICENSE" }
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+keywords = ["api", "rotation", "rate limit", "requests"]
+dependencies = ["requests>=2.25.0"]
+
+[project.urls]
+Homepage = "https://github.com/PrimeevolutionZ/apikeyrotator"
+Repository = "https://github.com/PrimeevolutionZ/apikeyrotator"
+Issues = "https://github.com/PrimeevolutionZ/apikeyrotator/issues"

apikeyrotator-0.0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+