Metadata-Version: 2.1
Name: elephant-socks5
Version: 0.0.14
Summary: Elephant socks5 tunnel client
Home-page: https://github.com/ruanhao/elephant-socks5-client-py
Author: Hao Ruan
Author-email: ruanhao1116@gmail.com
License: MIT
Keywords: proxy,http,non-blocking,py-netty,socks5
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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 :: Only
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.7, <4
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click
Requires-Dist: py-netty
Requires-Dist: websocket-client~=1.7.0
Requires-Dist: attrs~=22.1.0

# elephant-socks5-client-py
python client of Elephant(L4) tunnel for SOCKS5 empowered by [py-netty](https://github.com/ruanhao/py-netty).

[Elephant Server](https://github.com/ruanhao/elephant-socks5-tunnel) should be deployed first, which is a L4 tunnel server designed to provide a secure and high-performance tunneling solution for TCP traffic.

## Usage

```
$ elephant -h
Usage: elephant [OPTIONS]

Options:
  -p, --port INTEGER             Local port to bind  [default: 1080]
  -s, --server TEXT              Elephant tunnel server URL (like: ws[s]://localhost:4443/elephant/ws)  [required]
  -q, --quiet                    Quiet mode
  -l, --log-record               Save log to file (elephant-client.log)
  -t, --request-timeout INTEGER  Session request timeout (seconds)  [default: 3]
  --no-color                     Disable color output
  -v, --verbose                  Verbose mode
  -n, --tunnels INTEGER RANGE    Number of tunnels to achieve load balance  [default: 1; 1<=x<=8]
  --proxy-ip TEXT                Proxy IP
  --proxy-port INTEGER           Proxy port  [default: -1]
  --version                      Show the version and exit.
  -h, --help                     Show this message and exit.
```


