awmp

Crates.ioawmp
lib.rsawmp
version0.8.1
sourcesrc
created_at2018-10-11 15:09:53.762936
updated_at2022-03-01 03:52:55.626651
descriptionAn easy to use wrapper around multipart/form-data for Actix web
homepage
repositoryhttps://github.com/kardeiz/awmp
max_upload_size
id89262
size138,176
Jacob Brown (kardeiz)

documentation

https://docs.rs/awmp

README

awmp

Docs Crates.io

A convenience library for working with multipart/form-data in actix-web 1.x, 2.x, 3.x, or 4.x.

This library uses actix-multipart internally, and is not a replacement for actix-multipart. It saves multipart file data to tempfiles and collects text data, handling all blocking I/O operations.

Provides some configuration options in PartsConfig:

  • text_limit: Any text field data larger than this number of bytes will be saved as a tempfile
  • file_limit: Any file field data larger than this number of bytes will be discarded/ignored
  • file_fields: Treat fields with these names as file fields
  • text_fields: Treat fields with these names as text fields
  • temp_dir: Use this folder as the tmp directory, rather than tempfile's default

Usage

This crate supports both major versions of actix-web, 1.x, 2.x, 3.x, and 4.x. It supports 4.x by default.

To use with actix-web 1.x, add the following to your Cargo.toml:

awmp = { version = "0.8", default-features = false, features = ["v1"] }

Example

use actix_web::{web, App, Error, FromRequest, HttpResponse, HttpServer};

async fn upload(mut parts: awmp::Parts) -> Result<actix_web::HttpResponse, actix_web::Error> {
    let qs = parts.texts.to_query_string();

    let file_parts = parts
        .files
        .take("file")
        .pop()
        .and_then(|f| f.persist("/tmp").ok())
        .map(|f| format!("File uploaded to: {}", f.display()))
        .unwrap_or_default();

    let body = [format!("Text parts: {}", &qs), file_parts].join(", ");

    Ok(actix_web::HttpResponse::Ok().body(body))
}

#[actix_rt::main]
async fn main() -> Result<(), std::io::Error> {
    actix_web::HttpServer::new(move || {
        actix_web::App::new()
            .data(awmp::PartsConfig::default().with_file_limit(100000))
            .route("/", actix_web::web::post().to(upload))
    })
    .bind("0.0.0.0:3000")?
    .run()
    .await
}

Current version: 0.8.1

License: MIT

Commit count: 42

cargo fmt