Skip to content

Commit c330f35

Browse files
ashtumashtum
committed
feat: multipart_form_sink
1 parent 2e893d9 commit c330f35

9 files changed

Lines changed: 740 additions & 3 deletions

‎include/boost/http_proto/multipart_form_sink.hpp‎

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
//
2+
// Copyright (c) 2025 Mohammad Nejati
3+
//
4+
// Distributed under the Boost Software License, Version 1.0. (See accompanying
5+
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
6+
//
7+
// Official repository: https://github.com/cppalliance/http_proto
8+
//
9+
10+
#ifndef BOOST_HTTP_PROTO_MULTIPART_FORM_SINK_HPP
11+
#define BOOST_HTTP_PROTO_MULTIPART_FORM_SINK_HPP
12+
13+
#include <boost/capy/file.hpp>
14+
#include <boost/http_proto/sink.hpp>
15+
16+
#include <boost/optional.hpp>
17+
#include <boost/variant2.hpp>
18+
19+
#include <vector>
20+
21+
namespace boost {
22+
namespace http_proto {
23+
24+
class BOOST_HTTP_PROTO_SYMBOL_VISIBLE multipart_form_sink
25+
: public http_proto::sink
26+
{
27+
public:
28+
struct file_field
29+
{
30+
std::string name;
31+
std::string path;
32+
};
33+
34+
struct text_field
35+
{
36+
std::string data;
37+
};
38+
39+
struct part
40+
{
41+
std::string name;
42+
variant2::variant<text_field, file_field> content;
43+
boost::optional<std::string> content_type;
44+
};
45+
46+
BOOST_HTTP_PROTO_DECL
47+
explicit
48+
multipart_form_sink(
49+
core::string_view boundary);
50+
51+
BOOST_HTTP_PROTO_DECL
52+
boost::span<part const>
53+
parts() const noexcept;
54+
55+
private:
56+
BOOST_HTTP_PROTO_DECL
57+
results
58+
on_write(
59+
buffers::const_buffer b,
60+
bool more) override;
61+
62+
void
63+
parse(
64+
bool match,
65+
core::string_view b,
66+
system::error_code& ec);
67+
68+
enum class state
69+
{
70+
preamble,
71+
post_boundary0,
72+
post_boundary1,
73+
post_boundary2,
74+
header,
75+
content,
76+
finished
77+
};
78+
79+
state state_ = state::preamble;
80+
std::string needle_;
81+
std::string leftover_;
82+
std::string header_;
83+
capy::file file_;
84+
std::vector<part> parts_;
85+
};
86+
87+
} // http_proto
88+
} // boost
89+
90+
#endif

‎include/boost/http_proto/rfc/content_disposition_rule.hpp‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
//
2+
// Copyright (c) 2025 Mohammad Nejati
3+
//
4+
// Distributed under the Boost Software License, Version 1.0. (See accompanying
5+
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
6+
//
7+
// Official repository: https://github.com/cppalliance/http_proto
8+
//
9+
10+
#ifndef BOOST_HTTP_PROTO_RFC_CONTENT_DISPOSITION_RULE_HPP
11+
#define BOOST_HTTP_PROTO_RFC_CONTENT_DISPOSITION_RULE_HPP
12+
13+
#include <boost/http_proto/detail/config.hpp>
14+
#include <boost/http_proto/rfc/parameter.hpp>
15+
#include <boost/url/grammar/range_rule.hpp>
16+
17+
namespace boost {
18+
namespace http_proto {
19+
20+
namespace implementation_defined {
21+
struct content_disposition_rule_t
22+
{
23+
struct value_type
24+
{
25+
core::string_view type;
26+
grammar::range<parameter> params;
27+
};
28+
29+
BOOST_HTTP_PROTO_DECL
30+
system::result<value_type>
31+
parse(
32+
char const*& it,
33+
char const* end) const noexcept;
34+
};
35+
} // implementation_defined
36+
37+
/** Rule matching content-disposition
38+
39+
@par Value Type
40+
@code
41+
struct value_type
42+
{
43+
core::string_view type;
44+
grammar::range< parameter > params;
45+
};
46+
@endcode
47+
48+
@par Example
49+
@code
50+
@endcode
51+
52+
@par BNF
53+
@code
54+
content-disposition = disposition-type *( OWS ";" OWS disposition-parm )
55+
56+
disposition-type = token
57+
disposition-parm = token "=" ( token / quoted-string )
58+
@endcode
59+
60+
@par Specification
61+
@li <a href="https://www.rfc-editor.org/rfc/rfc6266#section-4.1"
62+
>4.1. Grammar (rfc6266)</a>
63+
@li <a href="https://www.rfc-editor.org/rfc/rfc7230#section-3.2.6"
64+
>3.2.6. Field Value Components (rfc7230)</a>
65+
66+
@see
67+
@ref quoted_token_view.
68+
*/
69+
BOOST_INLINE_CONSTEXPR implementation_defined::content_disposition_rule_t content_disposition_rule{};
70+
71+
} // http_proto
72+
} // boost
73+
74+
#endif

‎include/boost/http_proto/rfc/parameter.hpp‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@
1313
#include <boost/http_proto/detail/config.hpp>
1414
#include <boost/http_proto/rfc/quoted_token_view.hpp>
1515
#include <boost/system/result.hpp>
16+
#include <boost/url/grammar/range_rule.hpp>
1617

1718
namespace boost {
1819
namespace http_proto {
@@ -48,6 +49,18 @@ struct parameter_rule_t
4849
char const*) const noexcept ->
4950
system::result<value_type>;
5051
};
52+
53+
struct parameters_rule_t
54+
{
55+
using value_type = grammar::range<parameter>;
56+
57+
BOOST_HTTP_PROTO_DECL
58+
auto
59+
parse(
60+
char const*&,
61+
char const*) const noexcept ->
62+
system::result<value_type>;
63+
};
5164
} // implementation_defined
5265

5366
/** Rule matching parameter
@@ -75,6 +88,35 @@ struct parameter_rule_t
7588
*/
7689
BOOST_INLINE_CONSTEXPR implementation_defined::parameter_rule_t parameter_rule{};
7790

91+
//------------------------------------------------
92+
93+
/** Rule matching parameters
94+
95+
@par Value Type
96+
@code
97+
using value_type = grammar::range< parameter >;
98+
@endcode
99+
100+
@par Example
101+
@code
102+
@endcode
103+
104+
@par BNF
105+
@code
106+
parameters = *( OWS ";" OWS parameter )
107+
parameter = token "=" ( token / quoted-string )
108+
@endcode
109+
110+
@par Specification
111+
@li <a href="https://www.rfc-editor.org/rfc/rfc7231#section-3.1.1.1"
112+
>3.1.1.1. Media Type (rfc7231)</a>
113+
114+
@see
115+
@ref parameter,
116+
@ref parameter_rule.
117+
*/
118+
BOOST_INLINE_CONSTEXPR implementation_defined::parameters_rule_t parameters_rule{};
119+
78120
} // http_proto
79121
} // boost
80122

‎include/boost/http_proto/rfc/quoted_token_view.hpp‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ class quoted_token_view final
5050
: string_view_base(s)
5151
, n_(n)
5252
{
53+
// TODO: trim leading and trailing '"' characters?
5354
BOOST_ASSERT(s.size() >= 2);
5455
BOOST_ASSERT(s.front() == '\"');
5556
BOOST_ASSERT(s.back() == '\"');

0 commit comments

Comments
 (0)