o jìEiéã@sxddlmZmZddlmZmZmZGdd„deƒZGdd„deƒZ Gdd„deƒZ Gd d „d e ƒZ Gd d „d e ƒZ d S)é)ÚABCÚabstractmethod)Ú TypedDictÚOptionalÚListc@s eZdZdS)ÚInvalidProxyConfigN)Ú__name__Ú __module__Ú __qualname__©r r ú[/var/www/agentarbitrage/venv/lib/python3.10/site-packages/youtube_transcript_api/proxies.pyrsrc@s"eZdZUdZeed<eed<dS)ÚRequestsProxyConfigDicta This type represents the Dict that is used by the requests library to configure the proxies used. More information on this can be found in the official requests documentation: https://requests.readthedocs.io/en/latest/user/advanced/#proxies ÚhttpÚhttpsN)rr r Ú__doc__ÚstrÚ__annotations__r r r r r s  r c@sFeZdZdZedefdd„ƒZedefdd„ƒZ ede fdd„ƒZ d S) Ú ProxyConfigz° The base class for all proxy configs. Anything can be a proxy config, as longs as it can be turned into a `RequestsProxyConfigDict` by calling `to_requests_dict`. ÚreturncCódS)a Turns this proxy config into the Dict that is expected by the requests library. More information on this can be found in the official requests documentation: https://requests.readthedocs.io/en/latest/user/advanced/#proxies Nr ©Úselfr r r Úto_requests_dictózProxyConfig.to_requests_dictcCr)zá If you are using rotating proxies, it can be useful to prevent the HTTP client from keeping TCP connections alive, as your IP won't be rotated on every request, if your connection stays open. Fr rr r r Ú!prevent_keeping_connections_alive#rz-ProxyConfig.prevent_keeping_connections_alivecCr)aE Defines how many times we should retry if a request is blocked. When using rotating residential proxies with a large IP pool it can make sense to retry a couple of times when a blocked IP is encountered, since a retry will trigger an IP rotation and the next IP might not be blocked. rr rr r r Úretries_when_blocked,sz ProxyConfig.retries_when_blockedN) rr r rrr rÚpropertyÚboolrÚintrr r r r rsrc@s:eZdZdZd deedeefdd„Zdefdd „ZdS) ÚGenericProxyConfigaÜ This proxy config can be used to set up any generic HTTP/HTTPS/SOCKS proxy. As it the requests library is used under the hood, you can follow the requests documentation to get more detailed information on how to set up proxies: https://requests.readthedocs.io/en/latest/user/advanced/#proxies If only an HTTP or an HTTPS proxy is provided, it will be used for both types of connections. However, you will have to provide at least one of the two. NÚhttp_urlÚ https_urlcCs |s|stdƒ‚||_||_dS)aŒ If only an HTTP or an HTTPS proxy is provided, it will be used for both types of connections. However, you will have to provide at least one of the two. :param http_url: the proxy URL used for HTTP requests. Defaults to `https_url` if None. :param https_url: the proxy URL used for HTTPS requests. Defaults to `http_url` if None. zPGenericProxyConfig requires you to define at least one of the two: http or httpsN)rr r!)rr r!r r r Ú__init__Bs  ÿ zGenericProxyConfig.__init__rcCs|jp|j|jp |jdœS)N)rr)r r!rr r r rTs  þz#GenericProxyConfig.to_requests_dict)NN) rr r rrrr"r rr r r r r7s rc @s¦eZdZdZdZdZddeefdededeeed e d ed e f d d „Z e defdd„ƒZ e defdd„ƒZ e defdd„ƒZe defdd„ƒZe de fdd„ƒZdS)ÚWebshareProxyConfigaB Webshare is a provider offering rotating residential proxies, which is the most reliable way to work around being blocked by YouTube. If you don't have a Webshare account yet, you will have to create one at https://www.webshare.io/?referral_code=w0xno53eb50g and purchase a "Residential" proxy package that suits your workload, to be able to use this proxy config (make sure NOT to purchase "Proxy Server" or "Static Residential"!). Once you have created an account you only need the "Proxy Username" and "Proxy Password" that you can find in your Webshare settings at https://dashboard.webshare.io/proxy/settings to set up this config class, which will take care of setting up your proxies as needed, by defaulting to rotating proxies. Note that referral links are used here and any purchases made through these links will support this Open Source project, which is very much appreciated! :) However, you can of course integrate your own proxy solution by using the `GenericProxyConfig` class, if that's what you prefer. z p.webshare.ioéPNé Úproxy_usernameÚproxy_passwordÚfilter_ip_locationsrÚ domain_nameÚ proxy_portcCs,||_||_||_||_|pg|_||_dS)aZ Once you have created a Webshare account at https://www.webshare.io/?referral_code=w0xno53eb50g and purchased a "Residential" package (make sure NOT to purchase "Proxy Server" or "Static Residential"!), this config class allows you to easily use it, by defaulting to the most reliable proxy settings (rotating residential proxies). :param proxy_username: "Proxy Username" found at https://dashboard.webshare.io/proxy/settings :param proxy_password: "Proxy Password" found at https://dashboard.webshare.io/proxy/settings :param filter_ip_locations: If you want to limit the pool of IPs that you will be rotating through to those located in specific countries, you can provide a list of location codes here. By choosing locations that are close to the machine that is running this code, you can reduce latency. Also, this can be used to work around location-based restrictions. You can find the full list of available locations (and how many IPs are available in each location) at https://www.webshare.io/features/proxy-locations?referral_code=w0xno53eb50g :param retries_when_blocked: Define how many times we should retry if a request is blocked. When using rotating residential proxies with a large IP pool it makes sense to retry a couple of times when a blocked IP is encountered, since a retry will trigger an IP rotation and the next IP might not be blocked. Defaults to 10. N)r&r'r)r*Ú_filter_ip_locationsÚ_retries_when_blocked)rr&r'r(rr)r*r r r r"ts #  zWebshareProxyConfig.__init__rc Cs@d dd„|jDƒ¡}d|j›|›d|j›d|j›d|j›d S) NÚcss|] }d| ¡›VqdS)Ú-N)Úupper)Ú.0Ú location_coder r r Ú  s€ ÿz*WebshareProxyConfig.url..zhttp://z-rotate:ú@ú:ú/)Újoinr+r&r'r)r*)rÚlocation_codesr r r Úurlžs ÿÿÿÿzWebshareProxyConfig.urlcCó|jS©N©r8rr r r r ¨ózWebshareProxyConfig.http_urlcCr9r:r;rr r r r!¬r<zWebshareProxyConfig.https_urlcCr)NTr rr r r r°sz5WebshareProxyConfig.prevent_keeping_connections_alivecCr9r:)r,rr r r r´r<z(WebshareProxyConfig.retries_when_blocked)rr r rÚDEFAULT_DOMAIN_NAMEÚ DEFAULT_PORTrrrrr"rr8r r!rrrr r r r r#[s>ùþý üûú ù* r#N) ÚabcrrÚtypingrrrÚ Exceptionrr rrr#r r r r Ús #$