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

Download history 87/week @ 2024-07-27

87 downloads per month

MPL-2.0 license

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 and multipart/form-data forms from request bodies (currently only for warp).
  • A Form object that can be manipulated (fields added, removed, etc.)
  • Create application/x-www-form-urlencoded and multipart/form-data request bodies from a Form 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