Basic Usage
To get a random HTTP proxy from any country:
from swiftshadow.classes import ProxyInterface
swift = ProxyInterface()
print(swift.get().as_string())
Note
When the ProxyInterface class instance is created for the first time, the update() method is called. This method fetches proxies from providers and caches them. This process may take around 10 seconds. The cache will refresh after the cachePeriod expires.
The get() method returns a Proxy object. You can convert it to a string using as_string() or to a dictionary using as_requests_dict(). See the References for more details.
This is the most basic usage of swiftshadow, but there’s more to explore.
Note
From now on, all examples will exclude the import statement for simplicity.
Filtering Proxies
You can filter proxies based on their country of origin or protocol (HTTP/HTTPS).
Country Filter
To filter proxies by country, pass a list of two-letter country codes when initializing the ProxyInterface class.
- For a list of countries and their two-letter codes, visit this Wikipedia page.
Protocol Filter
By default, all proxies are HTTP. For SSL-enabled HTTPS proxies, set the protocol parameter to "https".
Warning
swiftshadow does not validate country codes or protocols. If you provide invalid country codes or protocols, no proxies will be available.
Selecting Providers
Swiftshadow allows the user to select only specific Providers from a list of available Providers to circumvent trying to fetch proxies from unavailable Providers. If you come across a Provider that is consistently failing please make sure to report it on the GitHub for its removal or remedy.
Providers can be imported as needed from the available ones in swiftshadow.providers
from swiftshadow.classes import ProxyInterface
from swiftshadow.providers import Monosans
swift = ProxyInterface(selectedProviders=[Monosans])
print(swift.get())
Proxy Rotation
Manual Rotation
You can manually rotate proxies using the rotate() method. This selects a random proxy from the available list.
from swiftshadow.classes import ProxyInterface
swift = ProxyInterface()
print(swift.get().as_string())
swift.rotate()
print(swift.get().as_string())
Auto Rotation
To enable automatic proxy rotation, set the autoRotate parameter to True when initializing the ProxyInterface object. When enabled, the proxy will rotate every time the get() method is called.
from swiftshadow.classes import ProxyInterface
swift = ProxyInterface(autoRotate=True)
print(swift.get().as_string())
print(swift.get().as_string())
Caching
Proxies are cached to improve performance. The cache expires after the cachePeriod (default: 10 minutes). You can force a cache update by calling the update() method.
Visit References for more information on methods and classes.