Skip to content
This repository has been archived by the owner on Jan 21, 2024. It is now read-only.

Latest commit

 

History

History
63 lines (48 loc) · 2.67 KB

README.md

File metadata and controls

63 lines (48 loc) · 2.67 KB

Actix Easy Multipart

Build status crates.io docs.rs

Typed multipart form extractor for actix-web.

⚠ Deprecation notice

This functionality has been now been merged into the official actix-multipart crate (as of version 0.6.0).

Please use the actix-multipart module instead, read the documentation here.

This repository will no longer be maintained.

Example

use actix_web::Responder;
use actix_easy_multipart::tempfile::Tempfile;
use actix_easy_multipart::text::Text;
use actix_easy_multipart::MultipartForm;

#[derive(MultipartForm)]
struct Upload {
    description: Option<Text<String>>,
    timestamp: Text<i64>,
    #[multipart(rename="image_set[]")]
    image_set: Vec<Tempfile>,
}

async fn route(form: MultipartForm<Upload>) -> impl Responder {
    format!("Received 5 images: {}", form.image_set.len())
}

Features

  • Receiving optional fields, using Option.
  • Receiving lists of fields, using Vec<T>.
  • Deserialize integers, floats, enums from plain text fields using Text<T>.
  • Deserialize complex data from JSON uploads, using Json<T>.
  • Receive file uploads into temporary files on disk, using Tempfile.
  • User customisable asynchronous field readers, for example you may want to stream form data to an object storage service, just implement the FieldReader trait.

Versions and Compatibility

actix-easy-multipart actix-web tokio
0.x 2.x 0.2
1.x 3.x 0.2
2.x 4.x 1
3.x 4.x 1

See Also