{"id":25188335,"url":"https://github.com/sachin-sankar/swiftshadow","last_synced_at":"2025-04-08T10:14:42.431Z","repository":{"id":153007570,"uuid":"627836114","full_name":"sachin-sankar/swiftshadow","owner":"sachin-sankar","description":"Free IP Proxy rotator library for python","archived":false,"fork":false,"pushed_at":"2025-03-26T16:49:33.000Z","size":1784,"stargazers_count":219,"open_issues_count":4,"forks_count":14,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-01T09:21:11.697Z","etag":null,"topics":["free","library","proxy","proxy-checker","proxy-list","proxy-scraper","python","python3"],"latest_commit_sha":null,"homepage":"https://sachin-sankar.github.io/swiftshadow/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sachin-sankar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-14T09:59:18.000Z","updated_at":"2025-03-30T17:57:28.000Z","dependencies_parsed_at":"2024-02-28T17:52:07.299Z","dependency_job_id":"19700fa8-574b-4f89-8d66-254e1fcbe87a","html_url":"https://github.com/sachin-sankar/swiftshadow","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sachin-sankar%2Fswiftshadow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sachin-sankar%2Fswiftshadow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sachin-sankar%2Fswiftshadow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sachin-sankar%2Fswiftshadow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sachin-sankar","download_url":"https://codeload.github.com/sachin-sankar/swiftshadow/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247819933,"owners_count":21001394,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["free","library","proxy","proxy-checker","proxy-list","proxy-scraper","python","python3"],"created_at":"2025-02-09T20:19:38.541Z","updated_at":"2025-04-08T10:14:42.410Z","avatar_url":"https://github.com/sachin-sankar.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Swiftshadow\n\n![PyPI - Downloads](https://img.shields.io/pypi/dm/swiftshadow)  \n![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/sachin-sankar/swiftshadow?include_prereleases\u0026style=flat)\n\n\u003e [!WARNING]  \n\u003e **Heads up!** If you're using **versions 1.2.1 or below**, please note that **version 2.0.0 and above** includes breaking changes. Before upgrading, read the [documentation](https://sachin-sankar.github.io/swiftshadow/) to understand the changes and ensure compatibility with your code. If you encounter issues, please review the docs before opening a GitHub issue.\n\n## About\n\n**Swiftshadow** is a lightweight and efficient Python library designed to simplify IP proxy rotation for web scraping, data mining, and other automated tasks. It helps you bypass common challenges like IP bans, rate limits, and detection mechanisms, ensuring smooth and uninterrupted data collection.\n\n### Key Features\n- **Speed**: Optimized for fast proxy retrieval and rotation.\n- **Reliability**: Automatically switches to working proxies if one fails.\n- **Customization**: Configure proxy filters, rotation frequency, and caching behavior.\n- **Low Dependencies**: Only one third-party dependency (`requests`), making it easy to use and maintain.\n- **Caching**: Built-in caching mechanism to reduce load times and improve performance.\n\nWhether you're a seasoned developer or a beginner, **Swiftshadow** makes proxy management effortless.\n\n---\n\n## Installation\n\nInstall the library using pip:\n\n```bash\npip install swiftshadow\n```\n\n---\n\n## Quick Start\n\n### Get a Proxy in 2 Lines\nFetch a random proxy with just two lines of code:\n\n```python\nfrom swiftshadow import QuickProxy\n\nprint(QuickProxy())  # Output: http://\u003cip\u003e:\u003cport\u003e\n```\n\n### Advanced Usage\nFor more control, use the `ProxyInterface` class:\n\n```python\nfrom swiftshadow.classes import ProxyInterface\n\n# Fetch HTTPS proxies from the US\nswift = ProxyInterface(countries=[\"US\"], protocol=\"https\")\nprint(swift.get().as_string())  # Output: https://\u003cip\u003e:\u003cport\u003e\n```\n\n---\n\n## Documentation\n\nExplore the full documentation to learn more about **Swiftshadow**'s features and advanced usage:\n\n📚 [Documentation](https://sachin-sankar.github.io/swiftshadow/)\n\n---\n\n## Why Swiftshadow?\n\n- **Lightweight**: Minimal dependencies and easy to integrate.\n- **Flexible**: Supports filtering by country and protocol.\n- **Scalable**: Ideal for both small scripts and large-scale scraping projects.\n- **Open Source**: Free to use, modify, and contribute to under the MIT License.\n\n---\n\n## Contributing\n\nContributions are welcome! If you'd like to improve **Swiftshadow**, feel free to open an issue or submit a pull request on [GitHub](https://github.com/sachin-sankar/swiftshadow).\n\n---\n\n## License\n\n**Swiftshadow** is licensed under the MIT License. See the [LICENSE](https://github.com/sachin-sankar/swiftshadow/blob/main/LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsachin-sankar%2Fswiftshadow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsachin-sankar%2Fswiftshadow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsachin-sankar%2Fswiftshadow/lists"}