diff options
| -rw-r--r-- | doc-src/install.html | 88 | ||||
| -rw-r--r-- | doc-src/screenshots/winpythoninstaller.jpg | bin | 0 -> 46628 bytes | |||
| -rw-r--r-- | libmproxy/console/__init__.py | 1 | ||||
| -rw-r--r-- | libmproxy/console/common.py | 16 | ||||
| -rw-r--r-- | libmproxy/console/flowlist.py | 2 |
5 files changed, 68 insertions, 39 deletions
diff --git a/doc-src/install.html b/doc-src/install.html index 682e317e..0afd2bad 100644 --- a/doc-src/install.html +++ b/doc-src/install.html @@ -1,40 +1,33 @@ +## On This Page -## Installing from source +* [Installation On Ubuntu](#docUbuntu) +* [Installation On Mac OS X](#docOSX) +* [Installation On Windows](#docWindows) -The preferred way to install mitmproxy - whether you're installing the latest -release or from source - is to use [pip](http://www.pip-installer.org/). If you -don't already have pip on your system, you can find installation instructions -[here](http://www.pip-installer.org/en/latest/installing.html). +## <a id=docUbuntu></a>Installation On Ubuntu + +Ubuntu comes with Python but we need to install pip, python-dev and several libraries. This was tested on a fully patched installation of Ubuntu 14.04. <pre class="terminal"> -pip install mitmproxy +$ sudo apt-get install python-pip python-dev libffi-dev libssl-dev libxml2-dev libxslt1-dev + +$ sudo pip install mitmproxy </pre> -If you also want to install the optional packages AMF, protobuf and CSS -content views, do this: +Once installation is complete you can run <a href="mitmproxy.html">mitmproxy</a> or <a href="mitmdump.html">mitmdump</a> from a terminal. -<pre class="terminal"> -pip install "mitmproxy[contentviews]" -</pre> +### Installation From Source +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 mitmproxy installation (see previous section). +Then see the <a href="https://github.com/mitmproxy/mitmproxy/blob/master/README.mkd#hacking">Hacking</a> section of the README on GitHub. -## OSX -The easiest way to get up and running on OSX is to download the pre-built -binary packages from [mitmproxy.org](http://mitmproxy.org). If you still want -to install using pip, there are a few things to keep in mind: +## <a id=docOSX></a>Installation On Mac OS X -- If you're running a Python interpreter installed with homebrew (or similar), -you may have to install some dependencies by hand. -- Make sure that XCode is installed from the App Store, and that the -command-line tools have been downloaded (XCode/Preferences/Downloads). +The easiest way to get up and running on OSX is to download the pre-built binary packages from [mitmproxy.org](http://mitmproxy.org). -There are a few bits of customization you might want to do to make mitmproxy -comfortable to use on OSX. The default color scheme is optimized for a dark -background terminal, but you can select a palette for a light terminal -background with the --palette option. You can use the OSX <b>open</b> program -to create a simple and effective <b>~/.mailcap</b> file to view request and -response bodies: +There are a few bits of customization you might want to do to make mitmproxy comfortable to use on OSX. The default color scheme is optimized for a dark background terminal, but you can select a palette for a light terminal background with the --palette option. You can use the OSX <b>open</b> program to create a simple and effective <b>~/.mailcap</b> file to view request and response bodies: <pre class="terminal"> application/*; /usr/bin/open -Wn %s @@ -43,17 +36,44 @@ image/*; /usr/bin/open -Wn %s video/*; /usr/bin/open -Wn %s </pre> +Once installation is complete you can run <a href="mitmproxy.html">mitmproxy</a> or <a href="mitmdump.html">mitmdump</a> from a terminal. + +### Installation From Source + +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, ithere are a few OS X specific things to keep in mind. + +- Make sure that XCode is installed from the App Store, and that the command-line tools have been downloaded (XCode/Preferences/Downloads). +- If you're running a Python interpreter installed with homebrew (or similar), you may have to install some dependencies by hand. + +Then see the <a href="https://github.com/mitmproxy/mitmproxy/blob/master/README.mkd#hacking">Hacking</a> section of the README on GitHub. + +## <a id=docWindows></a>Installation On Windows + +Please note that mitmdump is the only component of mitmproxy that is supported on Windows at the moment. +There is no interactive user interface on Windows. + + +First, install the latest version of Python 2.7 from the <a href="https://www.python.org/downloads/windows/">Python website</a>. +If you already have an older version of Python 2.7 installed, make sure to install <a href="https://pip.pypa.io/en/latest/installing.html">pip</a> +(pip is included in Python 2.7.9+ by default). + +Next, add Python and the Python Scripts directory to your <strong>PATH</strong> variable. You can do this easily by running the following in powershell: + +<pre class="terminal"> +[Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Python27\;C:\Python27\Scripts\", "User") +</pre> + + +Now, you can install mitmproxy by running + +<pre class="terminal"> +pip install mitmproxy +</pre> -## Ubuntu +Once the installation is complete, you can run <a href="mitmdump.html">mitmdump</a> from a command prompt. -On Ubuntu, you will need the following native packages to install mitmproxy -from source: +### Installation From Source -- build-essential -- python-dev -- libffi-dev -- libssl-dev -- libxml2-dev -- libxslt1-dev +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 Python as outlined above, then see the <a href="https://github.com/mitmproxy/mitmproxy/blob/master/README.mkd#hacking">Hacking</a> section of the README on GitHub. diff --git a/doc-src/screenshots/winpythoninstaller.jpg b/doc-src/screenshots/winpythoninstaller.jpg Binary files differnew file mode 100644 index 00000000..0473c66a --- /dev/null +++ b/doc-src/screenshots/winpythoninstaller.jpg diff --git a/libmproxy/console/__init__.py b/libmproxy/console/__init__.py index dc551a22..527ed07d 100644 --- a/libmproxy/console/__init__.py +++ b/libmproxy/console/__init__.py @@ -299,6 +299,7 @@ class ConsoleMaster(flow.FlowMaster): def toggle_eventlog(self): self.eventlog = not self.eventlog + signals.pop_view_state.send(self) self.view_flowlist() def _readflows(self, path): diff --git a/libmproxy/console/common.py b/libmproxy/console/common.py index f417aade..ba6ba5b0 100644 --- a/libmproxy/console/common.py +++ b/libmproxy/console/common.py @@ -202,6 +202,7 @@ def save_data(path, data, master, state): except IOError, v: signals.status_message.send(message=v.strerror) + def ask_save_overwite(path, data, master, state): if not path: return @@ -222,6 +223,7 @@ def ask_save_overwite(path, data, master, state): else: save_data(path, data, master, state) + def ask_save_path(prompt, data, master, state): signals.status_prompt_path.send( prompt = prompt, @@ -236,6 +238,8 @@ def copy_flow_format_data(part, scope, flow): else: data = "" if scope in ("q", "a"): + if flow.request.content is None or flow.request.content == CONTENT_MISSING: + return None, "Request content is missing" with decoded(flow.request): if part == "h": data += flow.request.assemble() @@ -247,6 +251,8 @@ def copy_flow_format_data(part, scope, flow): # Add padding between request and response data += "\r\n" * 2 if scope in ("s", "a") and flow.response: + if flow.response.content is None or flow.response.content == CONTENT_MISSING: + return None, "Response content is missing" with decoded(flow.response): if part == "h": data += flow.response.assemble() @@ -254,15 +260,19 @@ def copy_flow_format_data(part, scope, flow): data += flow.response.content else: raise ValueError("Unknown part: {}".format(part)) - return data + return data, False def copy_flow(part, scope, flow, master, state): """ - part: _c_ontent, _a_ll, _u_rl + part: _c_ontent, _h_eaders+content, _u_rl scope: _a_ll, re_q_uest, re_s_ponse """ - data = copy_flow_format_data(part, scope, flow) + data, err = copy_flow_format_data(part, scope, flow) + + if err: + signals.status_message.send(message=err) + return if not data: if scope == "q": diff --git a/libmproxy/console/flowlist.py b/libmproxy/console/flowlist.py index c7a0d1b7..6ab45bad 100644 --- a/libmproxy/console/flowlist.py +++ b/libmproxy/console/flowlist.py @@ -233,8 +233,6 @@ class ConnectionItem(urwid.WidgetWrap): class FlowListWalker(urwid.ListWalker): def __init__(self, master, state): self.master, self.state = master, state - if self.state.flow_count(): - self.set_focus(0) signals.flowlist_change.connect(self.sig_flowlist_change) def sig_flowlist_change(self, sender): |
