multipart/form-data parsing & streaming for actix-web
Go to file
asonix 9ab99f162a
/ check (aarch64-unknown-linux-musl) (push) Successful in 34s Details
/ check (armv7-unknown-linux-musleabihf) (push) Successful in 32s Details
/ check (x86_64-unknown-linux-musl) (push) Successful in 25s Details
/ clippy (push) Successful in 29s Details
/ tests (push) Successful in 36s Details
/ build (aarch64-unknown-linux-musl) (push) Successful in 37s Details
/ build (armv7-unknown-linux-musleabihf) (push) Successful in 37s Details
/ build (x86_64-unknown-linux-musl) (push) Successful in 24s Details
/ publish-forgejo (push) Successful in 8s Details
/ publish-crate (push) Successful in 27s Details
Add forgejo actions
2024-03-27 19:04:02 -05:00
.forgejo/workflows Add forgejo actions 2024-03-27 19:04:02 -05:00
examples Make form construction fallible 2024-03-27 16:16:06 -05:00
src Make form construction fallible 2024-03-27 16:16:06 -05:00
.gitignore Update deps 2023-06-01 16:19:17 -05:00
Cargo.toml Bump version 2024-03-27 19:03:45 -05:00
LICENSE Add Bytes field, add docs, and reorganize 2018-04-30 15:24:01 -05:00
README.md Update repo url, readme examples 2022-03-08 12:07:33 -06:00
flake.lock Update flake 2023-12-10 18:15:42 -06:00
flake.nix Update deps 2023-06-01 16:19:17 -05:00

README.md

Actix Form Data

A library for retrieving form data from Actix Web's multipart streams. It can stream uploaded files onto the filesystem (its main purpose), but it can also parse associated form data.

Usage

Add it to your dependencies.

# Cargo.toml

[dependencies]
actix-web = "4.0.0"
actix-form-data = "0.6.0"

Require it in your project.

// src/lib.rs or src/main.rs

use form_data::{Field, Form, Value};

Overview

First, you'd create a form structure you want to parse from the multipart stream.

let form = Form::<()>::new().field("field-name", Field::text());

This creates a form with one required field named "field-name" that will be parsed as text.

Then, pass it as a middleware.

App::new()
    .wrap(form.clone())
    .service(resource("/upload").route(post().to(upload)))

In your handler, get the value

async fn upload(uploaded_content: Value<()>) -> HttpResponse {
    ...
}

And interact with it

let field_value = match value {
    Value::Map(mut hashmap) => {
        hashmap.remove("field-name")?;
    }
    _ => return None,
};

...

Example

/// examples/simple.rs

use actix_form_data::{Error, Field, Form, Value};
use actix_web::{
    web::{post, resource},
    App, HttpResponse, HttpServer,
};
use futures_util::stream::StreamExt;

async fn upload(uploaded_content: Value<()>) -> HttpResponse {
    println!("Uploaded Content: {:#?}", uploaded_content);
    HttpResponse::Created().finish()
}

#[actix_rt::main]
async fn main() -> Result<(), anyhow::Error> {
    let form = Form::new()
        .field("Hey", Field::text())
        .field(
            "Hi",
            Field::map()
                .field("One", Field::int())
                .field("Two", Field::float())
                .finalize(),
        )
        .field(
            "files",
            Field::array(Field::file(|_, _, mut stream| async move {
                while let Some(res) = stream.next().await {
                    res?;
                }
                Ok(()) as Result<(), Error>
            })),
        );

    println!("{:?}", form);

    HttpServer::new(move || {
        App::new()
            .wrap(form.clone())
            .service(resource("/upload").route(post().to(upload)))
    })
    .bind("127.0.0.1:8080")?
    .run()
    .await?;

    Ok(())
}

Contributing

Feel free to open issues for anything you find an issue with. Please note that any contributed code will be licensed under the GPLv3.

License

Copyright © 2021 Riley Trautman

Actix Form Data is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Actix Form Data is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. This file is part of Actix Form Data.

You should have received a copy of the GNU General Public License along with Actix Form Data. If not, see http://www.gnu.org/licenses/.