Rooba
/
proxy.py
mirror of https://github.com/abhinavsingh/proxy.py.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity
proxy.py/README.md

96 lines
4.4 KiB
Markdown
Raw Normal View History

Link Travis Board for build status image
2019-08-12 05:41:39 +00:00
[![Proxy.Py](ProxyPy.png)](https://github.com/abhinavsingh/proxy.py)
updated README.md
2013-08-31 09:19:22 +00:00
Add option (--log-file) to redirect logs to a file
2019-08-26 16:37:25 +00:00
[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause) [![alt text](https://travis-ci.org/abhinavsingh/proxy.py.svg?branch=develop "Build Status")](https://travis-ci.org/abhinavsingh/proxy.py/) [![Coverage Status](https://coveralls.io/repos/github/abhinavsingh/proxy.py/badge.svg?branch=develop)](https://coveralls.io/github/abhinavsingh/proxy.py?branch=develop)
Add Travis build status
2019-02-09 04:25:09 +00:00
updated README.md
2013-08-31 09:19:22 +00:00
Features
--------
- Distributed as a single file module
Per worker queue instead of shared one. 1. MultiCoreDispatcher now dispatches request in round robin fashion. 2. Added Python3 static type hinting add Google Cloud Run Button Preserve proxy.py name as otherwise it breaks module system. Just provide a custom service name to fix Google Cloud Run issue Custom service name for Google Cloud Run. Specify port in app.json as required by Google Cloud Run Go cannot unmarshall int :) Port desc Looks like PORT cannot be overridden, for now use port 8080 in Dockerfile Remove cloudrun integration. While proxy.py runs successfully within the container, gvisor limitations doesn't allow proxy.py to accept client connections. Specifically membarrier syscall isn't allowed. Update README.md
2019-08-23 00:09:35 +00:00
- Optionally enable builtin Web Server
- Customize proxy and http routing via plugins
Update README to reflect basic auth support. Also refactor proxy exception handling code.
2018-12-13 17:01:56 +00:00
- No external dependency other than standard Python library
Link Travis Board for build status image
2019-08-12 05:41:39 +00:00
- Support for `http`, `https`, `http2` and `websockets` request proxy
Per worker queue instead of shared one. 1. MultiCoreDispatcher now dispatches request in round robin fashion. 2. Added Python3 static type hinting add Google Cloud Run Button Preserve proxy.py name as otherwise it breaks module system. Just provide a custom service name to fix Google Cloud Run issue Custom service name for Google Cloud Run. Specify port in app.json as required by Google Cloud Run Go cannot unmarshall int :) Port desc Looks like PORT cannot be overridden, for now use port 8080 in Dockerfile Remove cloudrun integration. While proxy.py runs successfully within the container, gvisor limitations doesn't allow proxy.py to accept client connections. Specifically membarrier syscall isn't allowed. Update README.md
2019-08-23 00:09:35 +00:00
- Optimized for large file uploads and downloads
Avoid setting open file limits on Windows OS. Python resource module is unavailable on Windows OS.
2018-12-14 13:14:56 +00:00
- IPv4 and IPv6 support
- Basic authentication support
Link Travis Board for build status image
2019-08-12 05:41:39 +00:00
- Can serve a [PAC (Proxy Auto-configuration)](https://en.wikipedia.org/wiki/Proxy_auto-config) file
updated README.md
2013-08-31 09:19:22 +00:00
Install
-------
To install proxy.py, simply:
Add Travis build status
2019-02-09 04:25:09 +00:00
$ pip install --upgrade proxy.py
updated README.md
2013-08-31 09:19:22 +00:00
Release docker container and prep for v0.4
2019-02-09 05:13:34 +00:00
Using docker:
$ docker run -it -p 8899:8899 --rm abhinavsingh/proxy.py
updated README.md
2013-08-31 09:19:22 +00:00
Usage
-----
```
Pre-spawn worker processes to utilize all cores.
2019-07-20 19:47:16 +00:00
$ proxy.py -h
usage: proxy.py [-h] [--backlog BACKLOG] [--basic-auth BASIC_AUTH]
Provision to specify custom buffer sizes. Now --server-recvbuf-size and --client-recvbuf-size flags can be used for customizing maximum recv buffer sizes. Bumping these values will result in higher RAM consumption during download / upload operations but will provide better download / upload speeds / throughputs and lower CPU utilization. Fixes #22
2018-12-13 21:08:08 +00:00
[--client-recvbuf-size CLIENT_RECVBUF_SIZE]
Add --version flag also used by Makefile for releases.
2019-08-24 17:23:30 +00:00
[--hostname HOSTNAME] [--ipv4] [--enable-http-proxy]
[--enable-web-server] [--log-level LOG_LEVEL]
Add option (--log-file) to redirect logs to a file
2019-08-26 16:37:25 +00:00
[--log-file LOG_FILE] [--log-format LOG_FORMAT]
[--num-workers NUM_WORKERS]
Per worker queue instead of shared one. 1. MultiCoreDispatcher now dispatches request in round robin fashion. 2. Added Python3 static type hinting add Google Cloud Run Button Preserve proxy.py name as otherwise it breaks module system. Just provide a custom service name to fix Google Cloud Run issue Custom service name for Google Cloud Run. Specify port in app.json as required by Google Cloud Run Go cannot unmarshall int :) Port desc Looks like PORT cannot be overridden, for now use port 8080 in Dockerfile Remove cloudrun integration. While proxy.py runs successfully within the container, gvisor limitations doesn't allow proxy.py to accept client connections. Specifically membarrier syscall isn't allowed. Update README.md
2019-08-23 00:09:35 +00:00
[--open-file-limit OPEN_FILE_LIMIT] [--pac-file PAC_FILE]
Add --pid-file option to dump parent process ID to a file. Rename to --disable-http-proxy. Is more appropriate since proxy is always enabled. unittest.skipIf right guards for travis
2019-08-26 16:52:43 +00:00
[--pac-file-url-path PAC_FILE_URL_PATH] [--pid-file PID_FILE]
[--plugins PLUGINS] [--port PORT]
[--server-recvbuf-size SERVER_RECVBUF_SIZE] [--version]
updated README.md
2013-08-31 09:19:22 +00:00
Update README.md
2019-07-20 19:17:01 +00:00
proxy.py v0.4
updated README.md
2013-08-31 09:19:22 +00:00
Per worker queue instead of shared one. 1. MultiCoreDispatcher now dispatches request in round robin fashion. 2. Added Python3 static type hinting add Google Cloud Run Button Preserve proxy.py name as otherwise it breaks module system. Just provide a custom service name to fix Google Cloud Run issue Custom service name for Google Cloud Run. Specify port in app.json as required by Google Cloud Run Go cannot unmarshall int :) Port desc Looks like PORT cannot be overridden, for now use port 8080 in Dockerfile Remove cloudrun integration. While proxy.py runs successfully within the container, gvisor limitations doesn't allow proxy.py to accept client connections. Specifically membarrier syscall isn't allowed. Update README.md
2019-08-23 00:09:35 +00:00
optional arguments:
updated README.md
2013-08-31 09:19:22 +00:00
-h, --help show this help message and exit
Update README to reflect basic auth support. Also refactor proxy exception handling code.
2018-12-13 17:01:56 +00:00
--backlog BACKLOG Default: 100. Maximum number of pending connections to
proxy server
--basic-auth BASIC_AUTH
Default: No authentication. Specify colon separated
user:password to enable basic authentication.
Provision to specify custom buffer sizes. Now --server-recvbuf-size and --client-recvbuf-size flags can be used for customizing maximum recv buffer sizes. Bumping these values will result in higher RAM consumption during download / upload operations but will provide better download / upload speeds / throughputs and lower CPU utilization. Fixes #22
2018-12-13 21:08:08 +00:00
--client-recvbuf-size CLIENT_RECVBUF_SIZE
Add option (--log-file) to redirect logs to a file
2019-08-26 16:37:25 +00:00
Default: 1 MB. Maximum amount of data received from
Provision to specify custom buffer sizes. Now --server-recvbuf-size and --client-recvbuf-size flags can be used for customizing maximum recv buffer sizes. Bumping these values will result in higher RAM consumption during download / upload operations but will provide better download / upload speeds / throughputs and lower CPU utilization. Fixes #22
2018-12-13 21:08:08 +00:00
the client in a single recv() operation. Bump this
value for faster uploads at the expense of increased
RAM.
Pre-spawn worker processes to utilize all cores.
2019-07-20 19:47:16 +00:00
--hostname HOSTNAME Default: 127.0.0.1. Server IP address.
Per worker queue instead of shared one. 1. MultiCoreDispatcher now dispatches request in round robin fashion. 2. Added Python3 static type hinting add Google Cloud Run Button Preserve proxy.py name as otherwise it breaks module system. Just provide a custom service name to fix Google Cloud Run issue Custom service name for Google Cloud Run. Specify port in app.json as required by Google Cloud Run Go cannot unmarshall int :) Port desc Looks like PORT cannot be overridden, for now use port 8080 in Dockerfile Remove cloudrun integration. While proxy.py runs successfully within the container, gvisor limitations doesn't allow proxy.py to accept client connections. Specifically membarrier syscall isn't allowed. Update README.md
2019-08-23 00:09:35 +00:00
--ipv4 Whether to listen on IPv4 address. By default server
Pre-spawn worker processes to utilize all cores.
2019-07-20 19:47:16 +00:00
only listens on IPv6.
Add --version flag also used by Makefile for releases.
2019-08-24 17:23:30 +00:00
--enable-http-proxy Default: True. Whether to enable
Per worker queue instead of shared one. 1. MultiCoreDispatcher now dispatches request in round robin fashion. 2. Added Python3 static type hinting add Google Cloud Run Button Preserve proxy.py name as otherwise it breaks module system. Just provide a custom service name to fix Google Cloud Run issue Custom service name for Google Cloud Run. Specify port in app.json as required by Google Cloud Run Go cannot unmarshall int :) Port desc Looks like PORT cannot be overridden, for now use port 8080 in Dockerfile Remove cloudrun integration. While proxy.py runs successfully within the container, gvisor limitations doesn't allow proxy.py to accept client connections. Specifically membarrier syscall isn't allowed. Update README.md
2019-08-23 00:09:35 +00:00
proxy.HttpProxyPlugin.
Add --version flag also used by Makefile for releases.
2019-08-24 17:23:30 +00:00
--enable-web-server Default: False. Whether to enable
Per worker queue instead of shared one. 1. MultiCoreDispatcher now dispatches request in round robin fashion. 2. Added Python3 static type hinting add Google Cloud Run Button Preserve proxy.py name as otherwise it breaks module system. Just provide a custom service name to fix Google Cloud Run issue Custom service name for Google Cloud Run. Specify port in app.json as required by Google Cloud Run Go cannot unmarshall int :) Port desc Looks like PORT cannot be overridden, for now use port 8080 in Dockerfile Remove cloudrun integration. While proxy.py runs successfully within the container, gvisor limitations doesn't allow proxy.py to accept client connections. Specifically membarrier syscall isn't allowed. Update README.md
2019-08-23 00:09:35 +00:00
proxy.HttpWebServerPlugin.
updated README.md
2013-08-31 09:19:22 +00:00
--log-level LOG_LEVEL
Update README.md
2019-07-20 19:17:01 +00:00
Valid options: DEBUG, INFO (default), WARNING, ERROR,
CRITICAL. Both upper and lowercase values are
allowed.You may also simply use the leading character
e.g. --log-level d
Add option (--log-file) to redirect logs to a file
2019-08-26 16:37:25 +00:00
--log-file LOG_FILE Default: sys.stdout. Log file destination.
Core changes: 1. Rename HttpServer to MultiCoreRequestDispatcher, there wasn't anything Http about that class, all Http implementation happens in HttpProxy class 2. PY 2.7 DEPRECATION ERRORS 3. Add --log-format cli option 4. Remove _ from HttpProxy private methods, refactor it's core for clarify (remove redundant close() and other details)
2019-08-20 05:59:11 +00:00
--log-format LOG_FORMAT
Log format for Python logger.
Add --version flag also used by Makefile for releases.
2019-08-24 17:23:30 +00:00
--num-workers NUM_WORKERS
Defaults to number of CPU cores.
Pre-spawn worker processes to utilize all cores.
2019-07-20 19:47:16 +00:00
--open-file-limit OPEN_FILE_LIMIT
Default: 1024. Maximum number of files (TCP
connections) that proxy.py can open concurrently.
Update README.md
2019-07-20 19:17:01 +00:00
--pac-file PAC_FILE A file (Proxy Auto Configuration) or string to serve
when the server receives a direct file request.
Per worker queue instead of shared one. 1. MultiCoreDispatcher now dispatches request in round robin fashion. 2. Added Python3 static type hinting add Google Cloud Run Button Preserve proxy.py name as otherwise it breaks module system. Just provide a custom service name to fix Google Cloud Run issue Custom service name for Google Cloud Run. Specify port in app.json as required by Google Cloud Run Go cannot unmarshall int :) Port desc Looks like PORT cannot be overridden, for now use port 8080 in Dockerfile Remove cloudrun integration. While proxy.py runs successfully within the container, gvisor limitations doesn't allow proxy.py to accept client connections. Specifically membarrier syscall isn't allowed. Update README.md
2019-08-23 00:09:35 +00:00
--pac-file-url-path PAC_FILE_URL_PATH
Web server path to serve the PAC file.
Add --pid-file option to dump parent process ID to a file. Rename to --disable-http-proxy. Is more appropriate since proxy is always enabled. unittest.skipIf right guards for travis
2019-08-26 16:52:43 +00:00
--pid-file PID_FILE Default: None. Save parent process ID to a file.
Per worker queue instead of shared one. 1. MultiCoreDispatcher now dispatches request in round robin fashion. 2. Added Python3 static type hinting add Google Cloud Run Button Preserve proxy.py name as otherwise it breaks module system. Just provide a custom service name to fix Google Cloud Run issue Custom service name for Google Cloud Run. Specify port in app.json as required by Google Cloud Run Go cannot unmarshall int :) Port desc Looks like PORT cannot be overridden, for now use port 8080 in Dockerfile Remove cloudrun integration. While proxy.py runs successfully within the container, gvisor limitations doesn't allow proxy.py to accept client connections. Specifically membarrier syscall isn't allowed. Update README.md
2019-08-23 00:09:35 +00:00
--plugins PLUGINS Comma separated plugins
--port PORT Default: 8899. Server port.
Pre-spawn worker processes to utilize all cores.
2019-07-20 19:47:16 +00:00
--server-recvbuf-size SERVER_RECVBUF_SIZE
Add option (--log-file) to redirect logs to a file
2019-08-26 16:37:25 +00:00
Default: 1 MB. Maximum amount of data received from
Pre-spawn worker processes to utilize all cores.
2019-07-20 19:47:16 +00:00
the server in a single recv() operation. Bump this
value for faster downloads at the expense of increased
RAM.
Add --version flag also used by Makefile for releases.
2019-08-24 17:23:30 +00:00
--version Prints proxy.py version.
updated README.md
2013-08-31 09:19:22 +00:00
Update README.md
2019-07-20 19:17:01 +00:00
Proxy.py not working? Report at:
updated README.md
2013-08-31 09:19:22 +00:00
https://github.com/abhinavsingh/proxy.py/issues/new
```