Metadata-Version: 2.1
Name: http-tools
Version: 2.0.0
Summary: httptools helps you to capture, repeat and live intercept HTTP requests. It is built on top of [mitmproxy](https://mitmproxy.org/)
Home-page: https://github.com/MobSF/httptools
Author: Ajin Abraham
Author-email: ajin25@gmail.com
License: GPL v3
Description: # httptools
        
        ## capture | intercept | repeat
        httptools helps you to capture, repeat and live intercept HTTP requests with scripting capabilities. It is built on top of [mitmproxy v5](https://mitmproxy.org/)
        
        [![Requirements Status](https://requires.io/github/MobSF/httptools/requirements.svg?branch=master)](https://requires.io/github/MobSF/httptools/requirements/?branch=master)
        [![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/MobSF/httptools.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/MobSF/httptools/context:python)
        [![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/MobSF/httptools.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/MobSF/httptools/context:javascript)
        
        ### Install
        
        ```
        pip install http-tools
        ```
        
        ### Develop
        ```
        $ git clone https://github.com/MobSF/httptools.git
        $ cd httptools
        $ python setup.py develop
        ```
        
        ### Usage
        
        ```
        $ httptools
        usage: httptools [-h] [-m MODE] [-p PORT] [-i IP] [-n NAME] [-u UPSTREAM]
        
        optional arguments:
          -h, --help            show this help message and exit
          -m MODE, --mode MODE  Supported modes
                                1. capture: Capture requests.
                                2. repeat: Repeat captured requests.
                                3. intercept: Intercept and tamper the request.
                                4. server: Start httptools server.
          -p PORT, --port PORT  Proxy Port
          -i IP, --ip IP        Proxy Host
          -n NAME, --name NAME  Project Name
          -u UPSTREAM, --upstream UPSTREAM
                                Upstream Proxy
        ```
        
        1. Capture - `httptools -m capture`
           * Starts HTTPS proxy at `0.0.0.0:1337` by default.
           * Install Root CA cert from `http://mitm.it/`
        2. Repeat - `httptools -m repeat`
           * Replay the captured traffic. Use --upstream to forward it to
             a fuzzer like BurpSuite or OWASP ZAP.
        3. Intercept - `httptools -m intercept`
           * To Fiddle with HTTP request and response in live.
           * Use: `http_tools/modules/interceptor.py` (The location will be relative to where httptools is installed)
        3. Server Web UI - `httptools -m server`
           * Starts the Web UI at `https://0.0.0.0:1337` by default.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 (LGPLv2)
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
