{"id":24270,"library":"proxyproviders","title":"ProxyProviders","description":"A Python library providing a unified interface for different proxy providers. Version 0.2.2, actively maintained with monthly releases. It abstracts API calls to various proxy services (e.g., BrightData, Oxylabs, Smartproxy) into a single API, supporting rotation, session management, and async usage.","status":"active","version":"0.2.2","language":"python","source_language":"en","source_url":"https://github.com/your-repo/proxyproviders","tags":["proxies","web-scraping","proxy-rotation"],"install":[{"cmd":"pip install proxyproviders","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"ProxyClient is re-exported at package level; internal module path may change.","wrong":"from proxyproviders.client import ProxyClient","symbol":"ProxyClient","correct":"from proxyproviders import ProxyClient"},{"note":"ProxyProvider is a class, not a top-level module.","wrong":"import ProxyProvider","symbol":"ProxyProvider","correct":"from proxyproviders import ProxyProvider"},{"note":"Async versions are re-exported at the package level.","wrong":"from proxyproviders.async_client import AsyncProxyClient","symbol":"AsyncProxyClient","correct":"from proxyproviders import AsyncProxyClient"}],"quickstart":{"code":"import os\nfrom proxyproviders import ProxyClient\n\n# Initialize with a provider (e.g., 'brightdata')\nclient = ProxyClient(provider='brightdata', api_key=os.environ.get('BRIGHTDATA_API_KEY', ''))\nproxy = client.get_proxy()\nprint(proxy['http'])","lang":"python","description":"Initialize a proxy client with an API key from environment variable and fetch a proxy."},"warnings":[{"fix":"Use `proxy['http']` instead of treating the return as a string.","message":"The `get_proxy()` method returns a dict with keys 'http', 'https', and 'socks5' — not a string. Always access via dict keys.","severity":"gotcha","affected_versions":"all"},{"fix":"Use `provider='your_provider'` instead of `provider_name='your_provider'`.","message":"In version 0.2.0, the `provider` parameter was renamed from `provider_name`. The old parameter name no longer works.","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Replace `from proxyproviders import BrightData` with `from proxyproviders import ProxyClient; client = ProxyClient(provider='brightdata', ...)`.","message":"The `BrightData` subclass is deprecated in favor of using the generic `ProxyClient` with `provider='brightdata'`.","severity":"deprecated","affected_versions":">=0.2.0"},{"fix":"Check the library's provider docs or error messages for required auth fields.","message":"Not all providers support the same parameters. For example, 'brightdata' requires `api_key`, while 'oxylabs' requires `username` and `password`. Refer to provider-specific documentation.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Change `ProxyClient(provider_name='...')` to `ProxyClient(provider='...')`.","cause":"Using old parameter `provider_name` instead of `provider` after version 0.2.0.","error":"TypeError: __init__() got an unexpected keyword argument 'provider_name'"},{"fix":"Check the return value of `get_proxy()` first: `proxy = client.get_proxy(); if proxy: print(proxy['http'])`.","cause":"Attempting to access proxy['http'] when `get_proxy()` returned None or raised an error, possibly due to invalid API key.","error":"KeyError: 'http'"},{"fix":"Use `from proxyproviders import ProxyClient` instead of `from proxyproviders.client import ProxyClient`.","cause":"Importing from internal module directly instead of the package-level re-export.","error":"ModuleNotFoundError: No module named 'proxyproviders.client'"},{"fix":"Check the supported providers list in the library docs. Correct names are case-insensitive strings.","cause":"Using a provider name that is not in the supported list (brightdata, oxylabs, smartproxy, etc.).","error":"ValueError: Unsupported provider 'invalid_provider'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}