1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
.. _nested-multipart-forms:
Parsing Nested Multipart Forms
==============================
Out of the box, Falcon does not offer official support for parsing nested
multipart forms (i.e., where multiple files for a single field are transmitted
using a nested ``multipart/mixed`` part).
.. note::
Nested multipart forms are considered deprecated according to the
`living HTML5 standard
<https://html.spec.whatwg.org/multipage/form-control-infrastructure.html>`_
and
`RFC 7578, Section 4.3 <https://tools.ietf.org/html/rfc7578#section-4.3>`_.
If your app needs to handle nested forms, this can be done in the same
fashion as any other part embedded in the form -- by installing an appropriate
media handler.
Let us extend the multipart form parser :attr:`media handlers
<falcon.media.multipart.MultipartParseOptions.media_handlers>` to recursively
parse embedded forms of the ``multipart/mixed`` content type:
.. code:: python
import falcon
import falcon.media
parser = falcon.media.MultipartFormHandler()
parser.parse_options.media_handlers['multipart/mixed'] = (
falcon.media.MultipartFormHandler())
.. note::
Here we create a new parser (with default options) for nested parts,
effectively disallowing further recursion.
If traversing into even deeper multipart form hierarchy is desired, we
can just reuse the same parser.
Let us now use the nesting-aware parser in an app:
.. code:: python
import falcon
import falcon.media
class Forms:
def on_post(self, req, resp):
example = {}
for part in req.media:
if part.content_type.startswith('multipart/mixed'):
for nested in part.media:
example[nested.filename] = nested.text
resp.media = example
parser = falcon.media.MultipartFormHandler()
parser.parse_options.media_handlers['multipart/mixed'] = (
falcon.media.MultipartFormHandler())
app = falcon.App()
app.req_options.media_handlers[falcon.MEDIA_MULTIPART] = parser
app.add_route('/forms', Forms())
We should now be able to consume a form containing a nested ``multipart/mixed``
part (the example is adapted from the now-obsolete
`RFC 1867 <https://tools.ietf.org/html/rfc1867>`_)::
--AaB03x
Content-Disposition: form-data; name="field1"
Joe Blow
--AaB03x
Content-Disposition: form-data; name="docs"
Content-Type: multipart/mixed; boundary=BbC04y
--BbC04y
Content-Disposition: attachment; filename="file1.txt"
This is file1.
--BbC04y
Content-Disposition: attachment; filename="file2.txt"
Hello, World!
--BbC04y--
--AaB03x--
Note that all line endings in the form above are assumed to be CRLF.
The form should be ``POST``\ed with the ``Content-Type`` header set to
``multipart/form-data; boundary=AaB03x``.
|
