# waitress-raw
[](https://pypi.org/project/waitress-raw/)
[](https://pepy.tech/project/waitress-raw)

Raw HTTP Echo Server For Security Researchers and HTTP Debug

## Installation
### Prerequisites
* Python 3.7+.
* waitress (https://docs.pylonsproject.org/projects/waitress/en/latest/).
### From pip
```shell
pip3 install waitress-raw
```
### From Docker
```shell
docker pull realgam3/waitress-raw
```
### From Source
```shell
git clone https://github.com/realgam3/waitress-raw.git
cd waitress-raw
# Install python dependencies.
pip3 install -r requirements.txt
# Confirm that everything works
python3 waitress-raw.py --help
```
Bug reports on installation issues are welcome!
## Usage
### Basic Usage
```shell
waitress-raw -lh 0.0.0.0 -lp 8000 -c ./examples/loggers/streamhandler.yml
```
### Docker Usage
```shell
docker run -v "${PWD}/examples/loggers/streamhandler.yml:/usr/src/app/config.yml:ro" -p 8000:8000 --rm realgam3/waitress-raw
```
### Command Line Arguments
```shell
waitress-raw --help
```
```text
usage: waitress-raw [-h] [-v] [-lh HOST] [-lp PORT] [-s SCHEME] [-t CHANNEL_TIMEOUT] [-r] [-V] [-c CONFIG_PATH]
options:
-h, --help show this help message and exit
-v, --version show program's version number and exit
-lh HOST, --host HOST
listen host. (default: 0.0.0.0)
-lp PORT, --port PORT
listen port (default: 8000)
-s SCHEME, --scheme SCHEME
url scheme (default: http)
-t CHANNEL_TIMEOUT, --timeout CHANNEL_TIMEOUT
timeout in seconds (default: 5)
-r, --reset-on-timeout
reset on timeout (default: False)
-V, --verbose verbose (default: False)
-c CONFIG_PATH, --config CONFIG_PATH
config path (default: config.yml)
```
Raw data
{
"_id": null,
"home_page": "https://github.com/realgam3/waitress-raw",
"name": "waitress-raw",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Tomer Zait (realgam3)",
"author_email": "realgam3@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/84/18/2f625f7cd532bfa1fcf7fb3d94d055ad6389f39d59c3669d73ebeabd3f08/waitress-raw-1.0.0.tar.gz",
"platform": "any",
"description": "# waitress-raw\n\n[](https://pypi.org/project/waitress-raw/)\n[](https://pepy.tech/project/waitress-raw)\n \n\nRaw HTTP Echo Server For Security Researchers and HTTP Debug\n\n\n\n## Installation\n\n### Prerequisites\n\n* Python 3.7+.\n* waitress (https://docs.pylonsproject.org/projects/waitress/en/latest/).\n\n### From pip\n\n```shell\npip3 install waitress-raw\n```\n\n### From Docker\n\n```shell\ndocker pull realgam3/waitress-raw\n```\n\n### From Source\n\n```shell\ngit clone https://github.com/realgam3/waitress-raw.git\ncd waitress-raw\n\n# Install python dependencies.\npip3 install -r requirements.txt\n\n# Confirm that everything works\npython3 waitress-raw.py --help\n```\n\nBug reports on installation issues are welcome!\n\n## Usage\n\n### Basic Usage\n\n ```shell\n waitress-raw -lh 0.0.0.0 -lp 8000 -c ./examples/loggers/streamhandler.yml\n ``` \n\n### Docker Usage\n\n```shell\ndocker run -v \"${PWD}/examples/loggers/streamhandler.yml:/usr/src/app/config.yml:ro\" -p 8000:8000 --rm realgam3/waitress-raw\n```\n\n### Command Line Arguments\n\n```shell\nwaitress-raw --help\n```\n\n```text\nusage: waitress-raw [-h] [-v] [-lh HOST] [-lp PORT] [-s SCHEME] [-t CHANNEL_TIMEOUT] [-r] [-V] [-c CONFIG_PATH]\n\noptions:\n -h, --help show this help message and exit\n -v, --version show program's version number and exit\n -lh HOST, --host HOST\n listen host. (default: 0.0.0.0)\n -lp PORT, --port PORT\n listen port (default: 8000)\n -s SCHEME, --scheme SCHEME\n url scheme (default: http)\n -t CHANNEL_TIMEOUT, --timeout CHANNEL_TIMEOUT\n timeout in seconds (default: 5)\n -r, --reset-on-timeout\n reset on timeout (default: False)\n -V, --verbose verbose (default: False)\n -c CONFIG_PATH, --config CONFIG_PATH\n config path (default: config.yml)\n```\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Raw HTTP Echo Server",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/realgam3/waitress-raw",
"Source": "https://github.com/realgam3/waitress-raw"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "37c690c60a29121cf00560acf16b7d0bb2305fa3c1d5e1a8bf1221ffcb6eb2f4",
"md5": "41b000eb523a19cb6488f6471b4cb671",
"sha256": "dd00f940f41ba5823d7d39fcfa7ee8e3d898ed56c5df82255a5ec5c1ba232ca2"
},
"downloads": -1,
"filename": "waitress_raw-1.0.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "41b000eb523a19cb6488f6471b4cb671",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 10212,
"upload_time": "2024-01-06T11:48:27",
"upload_time_iso_8601": "2024-01-06T11:48:27.394774Z",
"url": "https://files.pythonhosted.org/packages/37/c6/90c60a29121cf00560acf16b7d0bb2305fa3c1d5e1a8bf1221ffcb6eb2f4/waitress_raw-1.0.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "84182f625f7cd532bfa1fcf7fb3d94d055ad6389f39d59c3669d73ebeabd3f08",
"md5": "f8c9118365a054f2376c89fead24e977",
"sha256": "20d104eb94b9309699d9e3b3cd9abce2e5f91fd324191e673ff67ffe809ec09e"
},
"downloads": -1,
"filename": "waitress-raw-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "f8c9118365a054f2376c89fead24e977",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 9922,
"upload_time": "2024-01-06T11:48:28",
"upload_time_iso_8601": "2024-01-06T11:48:28.286821Z",
"url": "https://files.pythonhosted.org/packages/84/18/2f625f7cd532bfa1fcf7fb3d94d055ad6389f39d59c3669d73ebeabd3f08/waitress-raw-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-06 11:48:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "realgam3",
"github_project": "waitress-raw",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pyyaml",
"specs": [
[
">=",
"6.0.1"
]
]
},
{
"name": "waitress",
"specs": [
[
">=",
"2.1.2"
]
]
}
],
"lcname": "waitress-raw"
}