Adding `remove_empty_query_params` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add remove_empty_query_params

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

remove_empty_query_params = "0.1.1"

The remove_empty_query_params library will be automatically available globally. Read the remove_empty_query_params library documentation.

Back to the crate overview.

Readme

no_empty_query_params

Sumary

Middleware layer that removes params with empty values.

Motivation

In nginx configuration, when rewriting URLs (e.g. to pass to the upstream server), query params can be interpolated using $arg_

Example:

proxy_pass http://upstream/some/route?format=$arg_param;

Axum makes it easy to write handlers that automatically deserialize the query parameters:

#[derive(Deserialize)]
enum Format {
    Json,
    Html,
    Text
}

#[derive(Deserialize)]
struct RouteArgs {
    format: Option<Format>
}

Annoyingly, the above example will fail. Since format= is always unconditionally passed to the handler via the nginx configuratio, the default deserialization will try to deserialize Format from "".

Adding remove_empty_query_params library as a dependency

Adding `remove_empty_query_params` library as a dependency