aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorThomas Kriechbaumer <thomas@kriechbaumer.name>2016-12-21 22:27:51 +0100
committerThomas Kriechbaumer <thomas@kriechbaumer.name>2016-12-21 22:27:51 +0100
commit42e9448adef2eb9b14616f71472ecae9cd267a84 (patch)
tree981983b4216175d66e60d6bad9c8ce0dd4eca8e8 /docs
parent8fcf08b30ffbbebcf188c62fa70e9c3510d81586 (diff)
downloadmitmproxy-42e9448adef2eb9b14616f71472ecae9cd267a84.tar.gz
mitmproxy-42e9448adef2eb9b14616f71472ecae9cd267a84.tar.bz2
mitmproxy-42e9448adef2eb9b14616f71472ecae9cd267a84.zip
reflow docs
Diffstat (limited to 'docs')
-rw-r--r--docs/install.rst60
-rw-r--r--docs/mitmweb.rst10
2 files changed, 45 insertions, 25 deletions
diff --git a/docs/install.rst b/docs/install.rst
index 70b52731..93b3c364 100644
--- a/docs/install.rst
+++ b/docs/install.rst
@@ -5,7 +5,8 @@ Installation
Please follow the steps for your operating system.
-Once installation is complete, you can run :ref:`mitmproxy`, :ref:`mitmdump` or :ref:`mitmweb` from a terminal.
+Once installation is complete, you can run :ref:`mitmproxy`, :ref:`mitmdump` or
+:ref:`mitmweb` from a terminal.
.. _install-macos:
@@ -27,19 +28,28 @@ Or you can download the pre-built binary packages from `mitmproxy.org`_.
Installation on Windows
-----------------------
-The recommended way to install mitmproxy on Windows is to use the installer provided at `mitmproxy.org`_. After installation, you'll find shortcuts for :ref:`mitmweb` (the web-based interface) and :ref:`mitmdump` in the start menu. Both executables are added to your PATH and can be invoked from the command line.
+The recommended way to install mitmproxy on Windows is to use the installer
+provided at `mitmproxy.org`_. After installation, you'll find shortcuts for
+:ref:`mitmweb` (the web-based interface) and :ref:`mitmdump` in the start menu.
+Both executables are added to your PATH and can be invoked from the command
+line.
.. note::
- mitmproxy's console interface is not supported on Windows, but you can use mitmweb (the web-based interface) and mitmdump.
+ mitmproxy's console interface is not supported on Windows, but you can use
+ mitmweb (the web-based interface) and mitmdump.
.. _install-linux:
Installation on Linux
---------------------
-The recommended way to run mitmproxy on Linux is to use the pre-built binaries provided at `mitmproxy.org`_.
+The recommended way to run mitmproxy on Linux is to use the pre-built binaries
+provided at `mitmproxy.org`_.
-Our pre-built binaries provide you with the latest version of mitmproxy, a self-contained Python 3.5 environment and a recent version of OpenSSL that supports HTTP/2. Of course, you can also install mitmproxy from source if you prefer that (see :ref:`install-advanced`).
+Our pre-built binaries provide you with the latest version of mitmproxy, a
+self-contained Python 3.5 environment and a recent version of OpenSSL that
+supports HTTP/2. Of course, you can also install mitmproxy from source if you
+prefer that (see :ref:`install-advanced`).
.. _install-advanced:
@@ -51,9 +61,8 @@ Advanced Installation
Docker Images
^^^^^^^^^^^^^
-You can also use the official mitmproxy images from `DockerHub`_.
-That being said, our portable binaries are just as easy to install and even easier to use. 😊
-
+You can also use the official mitmproxy images from `DockerHub`_. That being
+said, our portable binaries are just as easy to install and even easier to use. 😊
.. _install-arch:
@@ -66,31 +75,32 @@ mitmproxy has been added into the [community] repository. Use pacman to install
>>> sudo pacman -S mitmproxy
-
.. _install-source-ubuntu:
Installation from Source on Ubuntu
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Ubuntu comes with Python but we need to install pip3, python3-dev and several libraries.
-This was tested on a fully patched installation of Ubuntu 16.04.
+Ubuntu comes with Python but we need to install pip3, python3-dev and several
+libraries. This was tested on a fully patched installation of Ubuntu 16.04.
.. code:: bash
sudo apt-get install python3-pip python3-dev libffi-dev libssl-dev libtiff5-dev libjpeg8-dev zlib1g-dev libwebp-dev
sudo pip3 install mitmproxy # or pip3 install --user mitmproxy
-On older Ubuntu versions, e.g., **12.04** and **14.04**, you may need to install a newer version of Python.
-mitmproxy requires Python 3.5 or higher. Please take a look at pyenv_.
-Make sure to have an up-to-date version of pip by running ``pip3 install -U pip``.
+On older Ubuntu versions, e.g., **12.04** and **14.04**, you may need to install
+a newer version of Python. mitmproxy requires Python 3.5 or higher. Please take
+a look at pyenv_. Make sure to have an up-to-date version of pip by running
+``pip3 install -U pip``.
+
.. _install-source-fedora:
Installation from Source on Fedora
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Fedora comes with Python but we need to install pip3, python3-dev and several libraries.
-This was tested on a fully patched installation of Fedora 24.
+Fedora comes with Python but we need to install pip3, python3-dev and several
+libraries. This was tested on a fully patched installation of Fedora 24.
.. code:: bash
@@ -99,15 +109,19 @@ This was tested on a fully patched installation of Fedora 24.
Make sure to have an up-to-date version of pip by running ``pip3 install -U pip``.
+
+
.. _install-source-windows:
🐱💻 Installation from Source on Windows
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. note::
- mitmproxy's console interface is not supported on Windows, but you can use mitmweb (the web-based interface) and mitmdump.
+ mitmproxy's console interface is not supported on Windows, but you can use
+ mitmweb (the web-based interface) and mitmdump.
-First, install the latest version of Python 3.5 or later from the `Python website`_. During installation, make sure to select `Add Python to PATH`.
+First, install the latest version of Python 3.5 or later from the `Python
+website`_. During installation, make sure to select `Add Python to PATH`.
Now, you can install mitmproxy by running
@@ -115,14 +129,18 @@ Now, you can install mitmproxy by running
pip3 install mitmproxy
+
+
.. _install-dev-version:
Latest Development Version
^^^^^^^^^^^^^^^^^^^^^^^^^^
-If you would like to install mitmproxy directly from the master branch on GitHub or would like to
-get set up to contribute to the project, install the dependencies as you would for a regular installation from source. Then see the Hacking_ section of the README on GitHub.
-You can check your system information by running: ``mitmproxy --sysinfo``
+If you would like to install mitmproxy directly from the master branch on GitHub
+or would like to get set up to contribute to the project, install the
+dependencies as you would for a regular installation from source. Then see the
+Hacking_ section of the README on GitHub. You can check your system information
+by running: ``mitmproxy --sysinfo``
.. _Hacking: https://github.com/mitmproxy/mitmproxy/blob/master/README.rst#hacking
diff --git a/docs/mitmweb.rst b/docs/mitmweb.rst
index e761fdbc..e57af059 100644
--- a/docs/mitmweb.rst
+++ b/docs/mitmweb.rst
@@ -4,13 +4,15 @@
mitmweb
=======
-**mitmweb** is mitmproxy's web-based user interface that allows interactive examination and modification of HTTP traffic. Like mitmproxy, it differs from mitmdump in that all flows are kept in memory, which means that it's intended for taking and manipulating
-small-ish samples.
+**mitmweb** is mitmproxy's web-based user interface that allows interactive
+examination and modification of HTTP traffic. Like mitmproxy, it differs from
+mitmdump in that all flows are kept in memory, which means that it's intended
+for taking and manipulating small-ish samples.
.. warning::
- Mitmweb is currently in beta. We consider it stable for all features currently exposed in the UI, but it still misses a lot of mitmproxy's features.
+ Mitmweb is currently in beta. We consider it stable for all features currently
+ exposed in the UI, but it still misses a lot of mitmproxy's features.
.. image:: screenshots/mitmweb.png
-