184 lines
6.5 KiB
Python
184 lines
6.5 KiB
Python
from __future__ import absolute_import
|
|
import urwid
|
|
from . import common
|
|
from .. import filt, version
|
|
|
|
footer = [
|
|
("heading", 'mitmproxy v%s '%version.VERSION),
|
|
('heading_key', "q"), ":back ",
|
|
]
|
|
|
|
class HelpView(urwid.ListBox):
|
|
def __init__(self, master, help_context, state):
|
|
self.master, self.state = master, state
|
|
self.help_context = help_context or []
|
|
urwid.ListBox.__init__(
|
|
self,
|
|
self.helptext()
|
|
)
|
|
|
|
def helptext(self):
|
|
text = []
|
|
text.append(urwid.Text([("head", "This view:\n")]))
|
|
text.extend(self.help_context)
|
|
|
|
text.append(urwid.Text([("head", "\n\nMovement:\n")]))
|
|
keys = [
|
|
("j, k", "down, up"),
|
|
("h, l", "left, right (in some contexts)"),
|
|
("space", "page down"),
|
|
("pg up/down", "page up/down"),
|
|
("arrows", "up, down, left, right"),
|
|
]
|
|
text.extend(common.format_keyvals(keys, key="key", val="text", indent=4))
|
|
|
|
text.append(urwid.Text([("head", "\n\nGlobal keys:\n")]))
|
|
keys = [
|
|
("c", "client replay"),
|
|
("H", "edit global header set patterns"),
|
|
("I", "set ignore pattern"),
|
|
("i", "set interception pattern"),
|
|
("M", "change global default display mode"),
|
|
(None,
|
|
common.highlight_key("automatic", "a") +
|
|
[("text", ": automatic detection")]
|
|
),
|
|
(None,
|
|
common.highlight_key("hex", "e") +
|
|
[("text", ": Hex")]
|
|
),
|
|
(None,
|
|
common.highlight_key("html", "h") +
|
|
[("text", ": HTML")]
|
|
),
|
|
(None,
|
|
common.highlight_key("image", "i") +
|
|
[("text", ": Image")]
|
|
),
|
|
(None,
|
|
common.highlight_key("javascript", "j") +
|
|
[("text", ": JavaScript")]
|
|
),
|
|
(None,
|
|
common.highlight_key("json", "s") +
|
|
[("text", ": JSON")]
|
|
),
|
|
(None,
|
|
common.highlight_key("css", "c") +
|
|
[("text", ": CSS")]
|
|
),
|
|
(None,
|
|
common.highlight_key("urlencoded", "u") +
|
|
[("text", ": URL-encoded data")]
|
|
),
|
|
(None,
|
|
common.highlight_key("raw", "r") +
|
|
[("text", ": raw data")]
|
|
),
|
|
(None,
|
|
common.highlight_key("xml", "x") +
|
|
[("text", ": XML")]
|
|
),
|
|
(None,
|
|
common.highlight_key("wbxml", "w") +
|
|
[("text", ": WBXML")]
|
|
),
|
|
(None,
|
|
common.highlight_key("amf", "f") +
|
|
[("text", ": AMF (requires PyAMF)")]
|
|
),
|
|
("o", "toggle options:"),
|
|
(None,
|
|
common.highlight_key("anticache", "a") +
|
|
[("text", ": prevent cached responses")]
|
|
),
|
|
(None,
|
|
common.highlight_key("anticomp", "c") +
|
|
[("text", ": prevent compressed responses")]
|
|
),
|
|
(None,
|
|
common.highlight_key("showhost", "h") +
|
|
[("text", ": use Host header for URL display")]
|
|
),
|
|
(None,
|
|
common.highlight_key("killextra", "k") +
|
|
[("text", ": kill requests not part of server replay")]
|
|
),
|
|
(None,
|
|
common.highlight_key("norefresh", "n") +
|
|
[("text", ": disable server replay response refresh")]
|
|
),
|
|
(None,
|
|
common.highlight_key("upstream certs", "u") +
|
|
[("text", ": sniff cert info from upstream server")]
|
|
),
|
|
|
|
("q", "quit / return to flow list"),
|
|
("Q", "quit without confirm prompt"),
|
|
("R", "edit replacement patterns"),
|
|
("s", "add/remove scripts"),
|
|
("S", "server replay"),
|
|
("t", "set sticky cookie expression"),
|
|
("T", "set tcp proxying pattern"),
|
|
("u", "set sticky auth expression"),
|
|
]
|
|
text.extend(common.format_keyvals(keys, key="key", val="text", indent=4))
|
|
|
|
text.append(urwid.Text([("head", "\n\nFilter expressions:\n")]))
|
|
f = []
|
|
for i in filt.filt_unary:
|
|
f.append(
|
|
("~%s"%i.code, i.help)
|
|
)
|
|
for i in filt.filt_rex:
|
|
f.append(
|
|
("~%s regex"%i.code, i.help)
|
|
)
|
|
for i in filt.filt_int:
|
|
f.append(
|
|
("~%s int"%i.code, i.help)
|
|
)
|
|
f.sort()
|
|
f.extend(
|
|
[
|
|
("!", "unary not"),
|
|
("&", "and"),
|
|
("|", "or"),
|
|
("(...)", "grouping"),
|
|
]
|
|
)
|
|
text.extend(common.format_keyvals(f, key="key", val="text", indent=4))
|
|
|
|
text.append(
|
|
urwid.Text(
|
|
[
|
|
"\n",
|
|
("text", " Regexes are Python-style.\n"),
|
|
("text", " Regexes can be specified as quoted strings.\n"),
|
|
("text", " Header matching (~h, ~hq, ~hs) is against a string of the form \"name: value\".\n"),
|
|
("text", " Expressions with no operators are regex matches against URL.\n"),
|
|
("text", " Default binary operator is &.\n"),
|
|
("head", "\n Examples:\n"),
|
|
]
|
|
)
|
|
)
|
|
examples = [
|
|
("google\.com", "Url containing \"google.com"),
|
|
("~q ~b test", "Requests where body contains \"test\""),
|
|
("!(~q & ~t \"text/html\")", "Anything but requests with a text/html content type."),
|
|
]
|
|
text.extend(common.format_keyvals(examples, key="key", val="text", indent=4))
|
|
return text
|
|
|
|
def keypress(self, size, key):
|
|
key = common.shortcuts(key)
|
|
if key == "q":
|
|
self.master.statusbar = self.state[0]
|
|
self.master.body = self.state[1]
|
|
self.master.header = self.state[2]
|
|
self.master.make_view()
|
|
return None
|
|
elif key == "?":
|
|
key = None
|
|
return urwid.ListBox.keypress(self, size, key)
|