Grasscutters/mitmproxy
3
0
Fork 0
mirror of https://github.com/Grasscutters/mitmproxy.git synced 2024-11-30 03:14:22 +00:00
Code Issues Projects Releases Wiki Activity

Unify offset specifications, and document them.

Browse Source
This commit is contained in:
Aldo Cortesi 2012-07-23 17:19:25 +12:00
parent 2880fee4e3
commit 091d90011b
2 changed files with 197 additions and 165 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
libpathod/rparse.py
View File

@ -96,12 +96,8 @@ DATATYPES = dict(
ascii_uppercase = string.ascii_uppercase,
digits = string.digits,
hexdigits = string.hexdigits,
letters = string.letters,
lowercase = string.lowercase,
octdigits = string.octdigits,
printable = string.printable,
punctuation = string.punctuation,
uppercase = string.uppercase,
whitespace = string.whitespace,
ascii = string.printable,
bytes = "".join(chr(i) for i in range(256))
@ -288,6 +284,15 @@ NakedValue = pp.MatchFirst(
)
Offset = pp.MatchFirst(
[
v_integer,
pp.Literal("r"),
pp.Literal("a")
]
)
class ShortcutContentType:
def __init__(self, value):
self.value = value
@ -402,13 +407,7 @@ class PauseAt:
]
)
e += pp.Literal(",").suppress()
e += pp.MatchFirst(
[
v_integer,
pp.Literal("r"),
pp.Literal("a"),
]
)
e += Offset
return e.setParseAction(lambda x: klass(*x))
def accept(self, settings, r):
@ -441,13 +440,7 @@ class InjectAt:
@classmethod
def expr(klass):
e = pp.Literal("i").suppress()
e = e + pp.MatchFirst(
[
v_integer,
pp.Literal("r"),
pp.Literal("a")
]
)
e += Offset
e += pp.Literal(",").suppress()
e += Value
return e.setParseAction(lambda x: klass(*x))

161
libpathod/templates/docs_lang.html
View File

@ -9,6 +9,7 @@
</div>
<section id="specifying_responses">
<div class="page-header">
<h1>Responses</h1>
</div>
@ -17,107 +18,114 @@
<pre class="example">code[MESSAGE]:[colon-separated list of features]</pre></p>
<table class="table table-bordered">
<tbody >
<tr>
<td>
hKEY=VALUE
h<a href="#valuespec">VALUE</a>=<a href="#valuespec">VALUE</a>
</td>
<td>
Set a header. Both KEY and VALUE are full <a href=#valuespec>Value Specifiers</a>.
Set a header.
</td>
</tr>
<tr>
<td>
bVALUE
b<a href="#valuespec">VALUE</a>
</td>
<td>
Set the body. VALUE is a <a href=#valuespec>Value
Specifier</a>. When the body is set, pathod will
Set the body. When the body is set, pathod will
automatically set the appropriate Content-Length header.
</td>
</tr>
<tr>
<td>
cVALUE
c<a href="#valuespec">VALUE</a>
</td>
<td>
A shortcut for setting the Content-Type header. Equivalent to:
<pre>h"Content-Type"=VALUE</pre>
A shortcut for setting the Content-Type header. Equivalent to
h"Content-Type"=VALUE
</td>
</tr>
<tr>
<td>
iOFFSET,VALUE
i<a href="#offsetspec">OFFSET</a>,<a href="#valuespec">VALUE</a>
</td>
<td>
Inject the specified value at the offset. OFFSET can be an
integer, or "r" to generate a random offset or "a" for an
offset just after all data has been sent.
Inject the specified value at the offset.
</td>
</tr>
<tr>
<td>
lVALUE
l<a href="#valuespec">VALUE</a>
</td>
<td>
A shortcut for setting the Location header. Equivalent to:
<pre>h"Location"=VALUE</pre>
</td>
</tr>
<tr>
<td>
dOFFSET
</td>
<td>
Disconnect after OFFSET bytes. The offset can also be "r", in which case pathod
will disconnect at a random point in the response.
A shortcut for setting the Location header. Equivalent to
h"Location"=VALUE
</td>
</tr>
<tr>
<td>
pSECONDS,OFFSET
d<a href="#offsetspec">OFFSET</a>
</td>
<td>
Pause for SECONDS seconds after OFFSET bytes. SECONDS can also be "f" to pause
forever. OFFSET can also be "r" to generate a random offset, or "a" for an
offset just after all data has been sent.
Disconnect after OFFSET bytes.
</td>
</tr>
<tr>
<td>
pSECONDS,<a href="#offsetspec">OFFSET</a>
</td>
<td>
Pause for SECONDS seconds after OFFSET bytes. SECONDS can
be an integer or "f" to pause forever.
</td>
</tr>
</tbody>
</table>
</section>
<div class="page-header">
<section id="specifying_requests">
<div class="page-header">
<h1>Requests</h1>
</div>
</div>
</section>
<div class="page-header">
<section id="specifying_requests">
<div class="page-header">
<h1>Executing specs from file</h1>
</div>
</div>
<pre class="example">+./path/to/spec</pre>
</section>
<div class="page-header">
<h1>Components</h1>
</div>
<section id="specifying_requests">
<div class="page-header">
<h1>Features</h1>
</div>
<a id="offsetspec"></a>
<h2>OFFSET</h2>
<p>Offsets are calculated relative to the base message, before any
injections or other transforms are applied. They have 3 flavors:</p>
<ul>
<li>An integer byte offset </li>
<li><b>r</b> for a random location</li>
<li><b>a</b> for the end of the message</li>
</ul>
<a id="valuespec"></a>
<h2>VALUEs</h2>
<h2>VALUE</h2>
<h3>Literals</h3>
@ -198,23 +206,54 @@
<p>Supported data types are:</p>
<ul>
<li>ascii</li>
<li>ascii_letters</li>
<li>ascii_lowercase</li>
<li>ascii_uppercase</li>
<li>bytes</li>
<li>digits</li>
<li>hexdigits</li>
<li>letters</li>
<li>lowercase</li>
<li>octdigits</li>
<li>printable</li>
<li>punctuation</li>
<li>uppercase</li>
<li>whitespace</li>
</ul>
<table class="table table-bordered">
<tbody >
<tr>
<td>ascii</td>
<td>All ASCII characters</td>
</tr>
<tr>
<td>ascii_letters</td>
<td>A-Za-z</td>
</tr>
<tr>
<td>ascii_lowercase</td>
<td>a-z</td>
</tr>
<tr>
<td>ascii_uppercase</td>
<td>A-Z</td>
</tr>
<tr>
<td>bytes</td>
<td>All 256 byte values</td>
</tr>
<tr>
<td>digits</td>
<td>0-9</td>
</tr>
<tr>
<td>hexdigits</td>
<td>0-f</td>
</tr>
<tr>
<td>octdigits</td>
<td>0-8</td>
</tr>
<tr>
<td>punctuation</td>
<td>
<pre>!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~</pre>
</td>
</tr>
<tr>
<td>whitespace</td>
<td>
<pre>\t\n\x0b\x0c\r and space</pre>
</td>
</tr>
</tbody>
</table>
</section>
{% endblock %}