97 lines
3.6 KiB
Plaintext
97 lines
3.6 KiB
Plaintext
Metadata-Version: 2.4
|
|
Name: aiohttp_socks
|
|
Version: 0.11.0
|
|
Summary: Proxy connector for aiohttp
|
|
Author-email: Roman Snegirev <snegiryev@gmail.com>
|
|
License: Apache-2.0
|
|
Project-URL: homepage, https://github.com/romis2012/aiohttp-socks
|
|
Project-URL: repository, https://github.com/romis2012/aiohttp-socks
|
|
Keywords: asyncio,aiohttp,socks,socks5,socks4,http,proxy
|
|
Classifier: Development Status :: 4 - Beta
|
|
Classifier: Programming Language :: Python
|
|
Classifier: Programming Language :: Python :: 3
|
|
Classifier: Programming Language :: Python :: 3 :: Only
|
|
Classifier: Programming Language :: Python :: 3.8
|
|
Classifier: Programming Language :: Python :: 3.9
|
|
Classifier: Programming Language :: Python :: 3.10
|
|
Classifier: Programming Language :: Python :: 3.11
|
|
Classifier: Programming Language :: Python :: 3.12
|
|
Classifier: Programming Language :: Python :: 3.13
|
|
Classifier: Programming Language :: Python :: 3.14
|
|
Classifier: Operating System :: MacOS
|
|
Classifier: Operating System :: Microsoft
|
|
Classifier: Operating System :: POSIX :: Linux
|
|
Classifier: Topic :: Internet :: WWW/HTTP
|
|
Classifier: Intended Audience :: Developers
|
|
Classifier: Framework :: AsyncIO
|
|
Classifier: License :: OSI Approved :: Apache Software License
|
|
Requires-Python: >=3.8.0
|
|
Description-Content-Type: text/markdown
|
|
License-File: LICENSE.txt
|
|
Requires-Dist: aiohttp>=3.10.0
|
|
Requires-Dist: python-socks[asyncio]<3.0.0,>=2.4.3
|
|
Dynamic: license-file
|
|
|
|
## aiohttp-socks
|
|
|
|
[](https://github.com/romis2012/aiohttp-socks/actions/workflows/ci.yml)
|
|
[](https://codecov.io/gh/romis2012/aiohttp-socks)
|
|
[](https://pypi.python.org/pypi/aiohttp-socks)
|
|
[](https://github.com/romis2012/aiohttp-socks)
|
|
<!--
|
|
[](https://pepy.tech/project/aiohttp-socks)
|
|
-->
|
|
The `aiohttp-socks` package provides a proxy connector for [aiohttp](https://github.com/aio-libs/aiohttp).
|
|
Supports SOCKS4(a), SOCKS5(h), HTTP (CONNECT) as well as Proxy chains.
|
|
It uses [python-socks](https://github.com/romis2012/python-socks) for core proxy functionality.
|
|
|
|
|
|
## Requirements
|
|
- Python >= 3.8
|
|
- aiohttp >= 3.10.0
|
|
- python-socks[asyncio] >= 2.4.3
|
|
|
|
## Installation
|
|
```
|
|
pip install aiohttp_socks
|
|
```
|
|
|
|
## Usage
|
|
|
|
#### Simple usage
|
|
```python
|
|
import aiohttp
|
|
from aiohttp_socks import ProxyType, ProxyConnector, ChainProxyConnector
|
|
|
|
|
|
async def fetch(url):
|
|
connector = ProxyConnector.from_url('socks5://user:password@127.0.0.1:1080')
|
|
|
|
### or use ProxyConnector constructor
|
|
# connector = ProxyConnector(
|
|
# proxy_type=ProxyType.SOCKS5,
|
|
# host='127.0.0.1',
|
|
# port=1080,
|
|
# username='user',
|
|
# password='password',
|
|
# rdns=True # default is True for socks5
|
|
# )
|
|
|
|
### proxy chaining (since ver 0.3.3)
|
|
# connector = ChainProxyConnector.from_urls([
|
|
# 'socks5://user:password@127.0.0.1:1080',
|
|
# 'socks4://127.0.0.1:1081',
|
|
# 'http://user:password@127.0.0.1:3128',
|
|
# ])
|
|
async with aiohttp.ClientSession(connector=connector) as session:
|
|
async with session.get(url) as response:
|
|
return await response.text()
|
|
```
|
|
|
|
## Why yet another SOCKS connector for aiohttp
|
|
|
|
Unlike [aiosocksy](https://github.com/romis2012/aiosocksy), aiohttp_socks has only single point of integration with aiohttp.
|
|
This makes it easier to maintain compatibility with new aiohttp versions.
|
|
|
|
|