#openapi #auto-generate #config #fastapi #fastapi-gen

fastapi-config

Config for controlling fastapi's various aspects

1 unstable release

new 0.1.1 Dec 3, 2024

#21 in #auto-generate

Download history 120/week @ 2024-12-01

120 downloads per month
Used in 2 crates (via fastapi-gen)

MIT/Apache

13KB
101 lines

fastapi-config

Fastapi build crates.io rustc

This crate provides global configuration capabilities for fastapi.

Config options

  • Define rust type aliases for fastapi with .alias_for(...) method.
  • Define schema collect mode for fastapi with .schema_collect(...) method.
    • SchemaCollect:All will collect all schemas from usages including inlined with inline(T)
    • SchemaCollect::NonInlined will only collect non inlined schemas from usages.

[!WARNING] The build config will be stored to projects OUTPUT directory. It is then read from there via OUTPUT environment variable which will return any instance rust compiler might find at that time (Whatever the OUTPUT environment variable points to). Be aware that sometimes you might face a situation where the config is not aligned with your Rust aliases. This might need you to change something on your code before changed config might apply.

Install

Add dependency declaration to Cargo.toml.

[build-dependencies]
fastapi-config = "0.1"

Examples

Create build.rs file with following content, then in your code you can just use MyType as alternative for i32.

use fastapi_config::Config;

fn main() {
    Config::new()
        .alias_for("MyType", "i32")
        .write_to_file();
}

See full example for fastapi-config.

License

Licensed under either of Apache 2.0 or MIT license at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, shall be dual licensed, without any additional terms or conditions.

Dependencies

~0.7–1.5MB
~33K SLoC