ѫfikddlZddlmZmZddlmZddlmZddlmZm Z m Z ddl m Z erddl mZeGd d ZGd d eZy) N)ABCabstractmethod) dataclass)datetime) TYPE_CHECKINGListOptional)Proxy) Algorithmc eZdZUdZdZeed<y) ProxyConfiga+Provides standard shared configuration options for all proxy providers. Example: .. code-block:: python from proxyproviders import Webshare, ProxyConfig config = ProxyConfig(refresh_interval=5) proxy_provider = Webshare(api_key="your-api-key", config=config) iXrefresh_intervalN)__name__ __module__ __qualname____doc__rfloat__annotations__]/home/homepc/tiktok-worker/venv/lib/python3.12/site-packages/proxyproviders/proxy_provider.pyrr s "e!IrrceZdZdZddeefdZddedee fdZ dded de fd Z e dee fd Z defd Zd ee fdZy) ProxyProvidera Base class for all proxy providers that provides shared functionality across all providers. You'll need to use a specific provider to fetch proxies and this shouldn't directly be initialized. However, this class is useful for type hinting and for creating custom providers that are not included in the library, although consider contributing them to the library if you are making them. :param config: Configuration for the proxy provider. View the ProxyConfig class docs for more information. Nconfigc| t}||_d|_d|_t j |_ddlm}||_ y)Nr ) RoundRobin) rr_proxies _last_refresh threadingLock_lock algorithmsr_default_algorithm)selfrrs r__init__zProxyProvider.__init__*sA > ]F#) /3 15^^%  +",,r force_refreshreturnc |s|js |js!|j}|j||j5|jrt |jngcdddS#1swYyxYw)z Returns the stored proxies. If a format function is provided, it applies that function to each proxy. :param force_refresh: If True, fetches new proxies even if the list is not considered stale. N)should_refreshr_fetch_proxies _set_proxiesr"list)r%r'proxiess r list_proxieszProxyProvider.list_proxies8sh D//1))+G   g & ZZ @*.--4 &R @ @ @s #A99B algorithmr cz|j}|s td| |j}|j|S)aGet a single proxy using the specified selection algorithm. :param algorithm: Selection algorithm to use. If None, uses the provider's default RoundRobin algorithm. :return: Selected proxy :raises ValueError: If no proxies are available Example: >>> from proxyproviders import Webshare >>> from proxyproviders.algorithms import Random, RoundRobin >>> >>> provider = Webshare(api_key="your-key") >>> >>> # Uses default RoundRobin (cycles through proxies) >>> proxy = provider.get_proxy() >>> >>> # Uses Random selection >>> proxy = provider.get_proxy(Random()) >>> >>> # One-liner with requests >>> import requests >>> from proxyproviders.models.proxy import ProxyFormat >>> requests.get("https://httpbin.org/ip", proxies=provider.get_proxy().format(ProxyFormat.REQUESTS)) z"No proxies available from provider)r/ ValueErrorr$select)r%r0r.s r get_proxyzProxyProvider.get_proxyFsC0##%AB B  //I((rcy)zFetch proxies from the provider implementation. This is not meant to be called directly, as it will always pull from the API even if not stale. Nrr%s rr+zProxyProvider._fetch_proxiesjs rc8|j |jy|jjdkDr\|j5t j |jz j|jjk\cdddSy#1swYyxYw)zQReturns True if the proxy list should be refreshed based on the refresh_interval.NTrF)rrrrr"rnow total_secondsr6s rr*zProxyProvider.should_refreshqs == D$6$6$> ;; ' '! + BLLNT%7%77-/T[[%A%AB B B   B s ABBr.c|j5||_tj|_dddy#1swYyxYw)z;Sets the list of proxies and updates the last refresh time.N)r"rrr8r)r%r.s rr,zProxyProvider._set_proxies~s3 ZZ 0#DM!)D  0 0 0s !7A)N)F)rrrrr rr&boolrr r/r4rr+r*r,rrrrr s /x 4 / @$ @4; @)8K#8)E)H U    0DK0rr)r abcrr dataclassesrrtypingrrr models.proxyr r#r rrrrrr@sJ#!00% II I$b0Cb0r