Lightweight, configurable proxy rotation for Python.
Simplify proxy management for web scraping, data collection, and automation.
Overview
Swiftshadow is a lightweight Python library for retrieving and rotating HTTP proxies. It provides a simple interface for obtaining proxies, filtering them by country and protocol, and configuring proxy selection to suit your workflow.
Whether you're building a small scraping script or a larger data collection pipeline, Swiftshadow helps simplify proxy management without adding unnecessary dependencies.
Features
- Quick proxy retrieval — Get a proxy with a single function call.
- Automatic rotation — Switch proxies when your workflow requires a different endpoint.
- Configurable filtering — Select proxies by country and protocol.
- Caching — Reuse cached proxy data to reduce repeated retrieval overhead.
- Lightweight — Only one third-party dependency:
requests. - Simple API — Start with
QuickProxyor useProxyInterfacefor more control.
Installation
Install Swiftshadow from PyPI:
pip install swiftshadow
uv add swiftshadow
Quick start
Get a proxy
Retrieve a proxy with QuickProxy:
from swiftshadow import QuickProxy
proxy = QuickProxy()
print(proxy)
# Example: http://<ip>:<port>
Filter proxies
Use ProxyInterface when you need to configure proxy selection:
from swiftshadow.classes import ProxyInterface
proxy_pool = ProxyInterface(
countries=["US"],
protocol="https",
)
proxy = proxy_pool.get()
print(proxy.as_string())
# Example: https://<ip>:<port>
These examples illustrate the basic API. See the documentation for supported configuration options, proxy formats, and rotation behavior.
Documentation
Explore configuration options, API references, and advanced usage.
Contributing
Contributions, bug reports, and feature suggestions are welcome.
- Check the existing issues.
- Open an issue to discuss significant changes.
- Submit a pull request with a clear description of your changes.
Please review the project's documentation before reporting issues related to configuration or version compatibility.
License
Swiftshadow is distributed under the GPL 3.0 License.
1 maintainer
Metadata
1 maintainer
Release files for swiftshadow 2.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| swiftshadow-2.4.1.tar.gz | 1.3 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| swiftshadow-2.4.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / swiftshadow-2.4.1.tar.gz
| Download URL | swiftshadow-2.4.1.tar.gz |
|---|---|
| Size | 1.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1d217174165a512e89199bbdf835958128334793c36badd9bf5e468348e70db6
|
|
BLAKE2b-256 checksum How to use checksums |
903aef838ba5efc106d9fb72a21eccc23570dcc73e076252efeb3dedd70b99f8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"NixOS","version":"26.11","id":"zokor","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / swiftshadow-2.4.1-py3-none-any.whl
| Download URL | swiftshadow-2.4.1-py3-none-any.whl |
|---|---|
| Size | 26.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e8981c0aaa708ce20d61e2aa32cfdd7a539effb6dfda443d5ad9f8ff91de2a07
|
|
BLAKE2b-256 checksum How to use checksums |
4ad2713b21b1d033db87f55b12a1ff05d1fd36f26f793bcf9bf216db9749996d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"NixOS","version":"26.11","id":"zokor","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for swiftshadow 2.4.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
