7 releases
0.1.6 | Jun 22, 2020 |
---|---|
0.1.5 | May 14, 2020 |
0.1.4 | Apr 29, 2020 |
0.1.0 | Mar 11, 2020 |
#723 in HTTP server
87 downloads per month
32KB
624 lines
Nebula_Form
nebula_form
is a small Rust library that provides a simple interface for
working with form data.
Features
- Parse
application/x-www-form-urlencoded
andmultipart/form-data
forms from request bodies (currently only forwarp
). - A
Form
object that can be manipulated (fields added, removed, etc.) - Create
application/x-www-form-urlencoded
andmultipart/form-data
request bodies from aForm
object.
Non-Features
- Multiple values for a single form field
- Note that there is no standard way to do this.
Usage
use nebula_form::{Form, Field};
use warp::Filter;
fn main() {
let form = Form::new();
form.insert("field-foo", Field::Text(String::from("contents")));
// Don't use `panic!` in actual code
match form.get("field-foo") {
None => panic!("Field expected"),
Some(field) => {
match field {
Field::Text(txt) => println!(txt),
Field::File(_) => panic!("This should not be a file!"),
}
}
}
// `make_request` doesn't actually exist and stands in for any usual way
// of creating an HTTP request.
make_request("POST", form.to_url_encoded().as_bytes());
make_request("POST", form.to_multipart_bytes());
// When using warp, the `form_filter` function parses the request body into
// a `Form`.
let hi = warp::path("some-form")
.and(warp::method::post())
.and(nebula_form::form_filter())
.map(|form: Form| {
format!("Hello {}!", form.get("name").unwrap())
});
}
Dependencies
~0.9–11MB
~127K SLoC