Documentation is available at https://mikedilger.github.io/formdata
This library provides a function for server-side parsing of a stream in
multipart/form-data format as described by RFC 7578.
It separates embedded files and streams them to temporary files on disk, while collecting
the other form fields into the returned data structure.
HTML forms with enctype=multipart/form-data POST their data in this format.
This enctype is typically used whenever a form has file upload input fields,
as the default application/x-www-form-urlencoded cannot handle file uploads.
Iron users are directed to consider using the https://crates.io/crates/params crate, which is an Iron plugin that works at a higher level and gives a broader scope than this crate does.
``rust
//headersis yourhyper::headers::Headersfrom your hyper or iron request.
//request` is the readable stream, and could be your hyper Request or iron HttpRequest, or
let boundary = try!(getmultipartboundary(&headers)); let formdata = try!(parsemultipart(&mut request, boundary));
for (name, value) in form_data.fields { println!("Posted field name={} value={}",name,value); }
for (name, file) in formdata.files { println!("Posted file name={} filename={:?} contenttype={} size={} temporarypath={:?}", name, file.filename, file.contenttype, file.size, file.path); }
```