#rustfmt #generator #rustfmt-wrapper

rustfmt-wrapper

Library wrapper around rustfmt for use by code generators

3 unstable releases

0.2.1 Oct 23, 2023
0.2.0 Jun 21, 2022
0.1.0 Oct 9, 2021

#127 in Procedural macros

Download history 22335/week @ 2025-01-29 25752/week @ 2025-02-05 22237/week @ 2025-02-12 33048/week @ 2025-02-19 29895/week @ 2025-02-26 29609/week @ 2025-03-05 35845/week @ 2025-03-12 37389/week @ 2025-03-19 24520/week @ 2025-03-26 24409/week @ 2025-04-02 31846/week @ 2025-04-09 51190/week @ 2025-04-16 42126/week @ 2025-04-23 29354/week @ 2025-04-30 22827/week @ 2025-05-07 21507/week @ 2025-05-14

131,217 downloads per month
Used in 50 crates (26 directly)

Apache-2.0

21KB
332 lines

rustfmt-wrapper

Rust makes it easy to generate more Rust code--for macros, builders, whatever. It's nice to format that code to be a little easier on the eyes. While rustfmt does a pretty good job, it does a pretty good job as a command and isn't usable as a library. This is a probably-too-simple wrapper library.

It's pretty simple to use and mixes well with quote!:

let codegen = quote::quote!{ struct Foo { bar: String } };
let formatted: String = rustfmt_wrapper::rustfmt(codegen).unwrap();

If you need more control over the vast array of rustfmt configuration options, you can use the second form:

let codegen = quote::quote!{
    async fn go() {
        let _ = Client::new().operation_id().send().await?;
    }
};
let config = Config {
    max_width: Some(45),
    ..Default::default()
};

let narrow_formatted = rustfmt_config(config, codegen).unwrap();

Note that in order to use unstable configuration options, you will need to have a the nightly version of rustfmt installed.


Thanks to David Tolnay for so many tools including cargo-expand from which this borrows.

Dependencies

~5–15MB
~210K SLoC