Maximum width of an array literal before falling back to vertical formatting.
\nPossible values: any positive integer that is less than or equal to the value specified for max_width
Stable: Yes
\nBy default this option is set as a percentage of max_width provided by use_small_heuristics, but a value set directly for array_width will take precedence.
See also max_width and use_small_heuristics
Maximum width of the args of a function-like attributes before falling back to vertical formatting.
\nPossible values: any positive integer that is less than or equal to the value specified for max_width
Stable: Yes
\nBy default this option is set as a percentage of max_width provided by use_small_heuristics, but a value set directly for attr_fn_like_width will take precedence.
See also max_width and use_small_heuristics
Where to put a binary operator when a binary expression goes multiline.
\nStable: No (tracking issue: #3368)
\n"Front" (default):fn main() {\n let or = foofoofoofoofoofoofoofoofoofoofoofoofoofoofoofoo\n || barbarbarbarbarbarbarbarbarbarbarbarbarbarbarbar;\n\n let sum = 123456789012345678901234567890\n + 123456789012345678901234567890\n + 123456789012345678901234567890;\n\n let range = aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\n ..bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb;\n}\n"Back":fn main() {\n let or = foofoofoofoofoofoofoofoofoofoofoofoofoofoofoofoo ||\n barbarbarbarbarbarbarbarbarbarbarbarbarbarbarbar;\n\n let sum = 123456789012345678901234567890 +\n 123456789012345678901234567890 +\n 123456789012345678901234567890;\n\n let range = aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa..\n bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb;\n}\nMinimum number of blank lines which must be put between items. If two items have fewer blank lines between\nthem, additional blank lines are inserted.
\nPossible values: unsigned integer
\nStable: No (tracking issue: #3382)
\nOriginal Code (rustfmt will not change it with the default value of 0):
#![rustfmt::skip]\n\nfn foo() {\n println!("a");\n}\nfn bar() {\n println!("b");\n println!("c");\n}\n1fn foo() {\n\n println!("a");\n}\n\nfn bar() {\n\n println!("b");\n\n println!("c");\n}\nMaximum number of blank lines which can be put between items. If more than this number of consecutive empty\nlines are found, they are trimmed down to match this integer.
\nPossible values: any non-negative integer
\nStable: No (tracking issue: #3381)
\nOriginal Code:
\n#![rustfmt::skip]\n\nfn foo() {\n println!("a");\n}\n\n\n\nfn bar() {\n println!("b");\n\n\n println!("c");\n}\n1 (default):fn foo() {\n println!("a");\n}\n\nfn bar() {\n println!("b");\n\n println!("c");\n}\n2:fn foo() {\n println!("a");\n}\n\n\nfn bar() {\n println!("b");\n\n\n println!("c");\n}\nSee also: blank_lines_lower_bound
Brace style for items
\nStable: No (tracking issue: #3376)
\n"SameLineWhere" (default):fn lorem() {\n // body\n}\n\nfn lorem(ipsum: usize) {\n // body\n}\n\nfn lorem<T>(ipsum: T)\nwhere\n T: Add + Sub + Mul + Div,\n{\n // body\n}\n"AlwaysNextLine":fn lorem()\n{\n // body\n}\n\nfn lorem(ipsum: usize)\n{\n // body\n}\n\nfn lorem<T>(ipsum: T)\nwhere\n T: Add + Sub + Mul + Div,\n{\n // body\n}\n"PreferSameLine":fn lorem() {\n // body\n}\n\nfn lorem(ipsum: usize) {\n // body\n}\n\nfn lorem<T>(ipsum: T)\nwhere\n T: Add + Sub + Mul + Div, {\n // body\n}\n"SameLineWhere" (default):struct Lorem {\n ipsum: bool,\n}\n\nstruct Dolor<T>\nwhere\n T: Eq,\n{\n sit: T,\n}\n"AlwaysNextLine":struct Lorem\n{\n ipsum: bool,\n}\n\nstruct Dolor<T>\nwhere\n T: Eq,\n{\n sit: T,\n}\n"PreferSameLine":struct Lorem {\n ipsum: bool,\n}\n\nstruct Dolor<T>\nwhere\n T: Eq, {\n sit: T,\n}\nMaximum width of a chain to fit on one line.
\nPossible values: any positive integer that is less than or equal to the value specified for max_width
Stable: Yes
\nBy default this option is set as a percentage of max_width provided by use_small_heuristics, but a value set directly for chain_width will take precedence.
See also max_width and use_small_heuristics
Whether to use colored output or not.
\nStable: No (tracking issue: #3385)
\n", "default": "Auto", "enum": [ "Auto", "Always", "Never" ] }, "combine_control_expr": { "type": "boolean", "description": "Combine control expressions with function calls.\n\nStable: No (tracking issue: [#3369](https://github.com/rust-lang/rustfmt/issues/3369))\n\n\n#### `true` (default):\n\n```rust\nfn example() {\n // If\n foo!(if x {\n foo();\n } else {\n bar();\n });\n\n // IfLet\n foo!(if let Some(..) = x {\n foo();\n } else {\n bar();\n });\n\n // While\n foo!(while x {\n foo();\n bar();\n });\n\n // WhileLet\n foo!(while let Some(..) = x {\n foo();\n bar();\n });\n\n // ForLoop\n foo!(for x in y {\n foo();\n bar();\n });\n\n // Loop\n foo!(loop {\n foo();\n bar();\n });\n}\n```\n\n#### `false`:\n\n```rust\nfn example() {\n // If\n foo!(\n if x {\n foo();\n } else {\n bar();\n }\n );\n\n // IfLet\n foo!(\n if let Some(..) = x {\n foo();\n } else {\n bar();\n }\n );\n\n // While\n foo!(\n while x {\n foo();\n bar();\n }\n );\n\n // WhileLet\n foo!(\n while let Some(..) = x {\n foo();\n bar();\n }\n );\n\n // ForLoop\n foo!(\n for x in y {\n foo();\n bar();\n }\n );\n\n // Loop\n foo!(\n loop {\n foo();\n bar();\n }\n );\n}\n```", "markdownDescription": "Combine control expressions with function calls.\n\nStable: No (tracking issue: [#3369](https://github.com/rust-lang/rustfmt/issues/3369))\n\n\n#### `true` (default):\n\n```rust\nfn example() {\n // If\n foo!(if x {\n foo();\n } else {\n bar();\n });\n\n // IfLet\n foo!(if let Some(..) = x {\n foo();\n } else {\n bar();\n });\n\n // While\n foo!(while x {\n foo();\n bar();\n });\n\n // WhileLet\n foo!(while let Some(..) = x {\n foo();\n bar();\n });\n\n // ForLoop\n foo!(for x in y {\n foo();\n bar();\n });\n\n // Loop\n foo!(loop {\n foo();\n bar();\n });\n}\n```\n\n#### `false`:\n\n```rust\nfn example() {\n // If\n foo!(\n if x {\n foo();\n } else {\n bar();\n }\n );\n\n // IfLet\n foo!(\n if let Some(..) = x {\n foo();\n } else {\n bar();\n }\n );\n\n // While\n foo!(\n while x {\n foo();\n bar();\n }\n );\n\n // WhileLet\n foo!(\n while let Some(..) = x {\n foo();\n bar();\n }\n );\n\n // ForLoop\n foo!(\n for x in y {\n foo();\n bar();\n }\n );\n\n // Loop\n foo!(\n loop {\n foo();\n bar();\n }\n );\n}\n```", "x-intellij-html-description": "Combine control expressions with function calls.
\nStable: No (tracking issue: #3369)
\ntrue (default):fn example() {\n // If\n foo!(if x {\n foo();\n } else {\n bar();\n });\n\n // IfLet\n foo!(if let Some(..) = x {\n foo();\n } else {\n bar();\n });\n\n // While\n foo!(while x {\n foo();\n bar();\n });\n\n // WhileLet\n foo!(while let Some(..) = x {\n foo();\n bar();\n });\n\n // ForLoop\n foo!(for x in y {\n foo();\n bar();\n });\n\n // Loop\n foo!(loop {\n foo();\n bar();\n });\n}\nfalse:fn example() {\n // If\n foo!(\n if x {\n foo();\n } else {\n bar();\n }\n );\n\n // IfLet\n foo!(\n if let Some(..) = x {\n foo();\n } else {\n bar();\n }\n );\n\n // While\n foo!(\n while x {\n foo();\n bar();\n }\n );\n\n // WhileLet\n foo!(\n while let Some(..) = x {\n foo();\n bar();\n }\n );\n\n // ForLoop\n foo!(\n for x in y {\n foo();\n bar();\n }\n );\n\n // Loop\n foo!(\n loop {\n foo();\n bar();\n }\n );\n}\nMaximum length of comments. No effect unless wrap_comments = true.
Possible values: any positive integer
\nStable: No (tracking issue: #3349)
\nNote: A value of 0 results in wrap_comments being applied regardless of a line's width.
80 (default; comments shorter than comment_width):// Lorem ipsum dolor sit amet, consectetur adipiscing elit.\n60 (comments longer than comment_width):// Lorem ipsum dolor sit amet,\n// consectetur adipiscing elit.\nSee also wrap_comments.
Replace strings of _ wildcards by a single .. in tuple patterns
\nStable: No (tracking issue: #3384)
\nfalse (default):fn main() {\n let (lorem, ipsum, _, _) = (1, 2, 3, 4);\n let (lorem, ipsum, ..) = (1, 2, 3, 4);\n}\ntrue:fn main() {\n let (lorem, ipsum, ..) = (1, 2, 3, 4);\n}\nBrace style for control flow constructs
\nStable: No (tracking issue: #3377)
\n"AlwaysSameLine" (default):fn main() {\n if lorem {\n println!("ipsum!");\n } else {\n println!("dolor!");\n }\n}\n"AlwaysNextLine":fn main() {\n if lorem\n {\n println!("ipsum!");\n }\n else\n {\n println!("dolor!");\n }\n}\n"ClosingNextLine":fn main() {\n if lorem {\n println!("ipsum!");\n }\n else {\n println!("dolor!");\n }\n}\nDon't reformat anything.
\nNote that this option may be soft-deprecated in the future once the ignore option is stabilized. Nightly toolchain users are encouraged to use ignore instead when possible.
\nStable: Yes
\n", "default": false }, "edition": { "type": "string", "description": "Specifies which edition is used by the parser.\n\nStable: Yes\n\nThe `edition` option determines the Rust language edition used for parsing the code. This is important for syntax compatibility but does not directly control formatting behavior (see [style_edition](#style_edition)).\n\nWhen running `cargo fmt`, the `edition` is automatically read from the `Cargo.toml` file. However, when running `rustfmt` directly the `edition` defaults to 2015 if not explicitly configured. For consistent parsing between rustfmt and `cargo fmt` you should configure the `edition`.\nFor example in your `rustfmt.toml` file:\n\n```toml\nedition = \"2018\"\n```\n\nAlternatively, you can use the `--edition` flag when running `rustfmt` directly.", "markdownDescription": "Specifies which edition is used by the parser.\n\nStable: Yes\n\nThe `edition` option determines the Rust language edition used for parsing the code. This is important for syntax compatibility but does not directly control formatting behavior (see [style_edition](#style_edition)).\n\nWhen running `cargo fmt`, the `edition` is automatically read from the `Cargo.toml` file. However, when running `rustfmt` directly the `edition` defaults to 2015 if not explicitly configured. For consistent parsing between rustfmt and `cargo fmt` you should configure the `edition`.\nFor example in your `rustfmt.toml` file:\n\n```toml\nedition = \"2018\"\n```\n\nAlternatively, you can use the `--edition` flag when running `rustfmt` directly.", "x-intellij-html-description": "Specifies which edition is used by the parser.
\nStable: Yes
\nThe edition option determines the Rust language edition used for parsing the code. This is important for syntax compatibility but does not directly control formatting behavior (see style_edition).
When running cargo fmt, the edition is automatically read from the Cargo.toml file. However, when running rustfmt directly the edition defaults to 2015 if not explicitly configured. For consistent parsing between rustfmt and cargo fmt you should configure the edition.\nFor example in your rustfmt.toml file:
edition = "2018"\nAlternatively, you can use the --edition flag when running rustfmt directly.
Put empty-body functions and impls on a single line
\nStable: No (tracking issue: #3356)
\ntrue (default):fn lorem() {}\n\nimpl Lorem {}\nfalse:fn lorem() {\n}\n\nimpl Lorem {\n}\nSee also brace_style, control_brace_style.
The maximum length of enum variant having discriminant, that gets vertically aligned with others.\nVariants without discriminants would be ignored for the purpose of alignment.
\nNote that this is not how much whitespace is inserted, but instead the longest variant name that\ndoesn't get ignored when aligning.
\nPossible values: any positive integer
\nStable: No (tracking issue: #3372)
\n0 (default):enum Foo {\n A = 0,\n Bb = 1,\n RandomLongVariantGoesHere = 10,\n Ccc = 71,\n}\n\nenum Bar {\n VeryLongVariantNameHereA = 0,\n VeryLongVariantNameHereBb = 1,\n VeryLongVariantNameHereCcc = 2,\n}\n20:enum Foo {\n A = 0,\n Bb = 1,\n RandomLongVariantGoesHere = 10,\n Ccc = 2,\n}\n\nenum Bar {\n VeryLongVariantNameHereA = 0,\n VeryLongVariantNameHereBb = 1,\n VeryLongVariantNameHereCcc = 2,\n}\nError if Rustfmt is unable to get all lines within max_width, except for comments and string\nliterals. If this happens, then it is a bug in Rustfmt. You might be able to work around the bug by\nrefactoring your code to avoid long/complex expressions, usually by extracting a local variable or\nusing a shorter name.
Stable: No (tracking issue: #3391)
\nSee also max_width.
Error if unable to get comments or string literals within max_width, or they are left with\ntrailing whitespaces.
Stable: No (tracking issue: #3392)
\n", "default": false }, "fn_args_layout": { "type": "string", "description": "This option is deprecated and has been renamed to `fn_params_layout` to better communicate that\nit affects the layout of parameters in function signatures.\n\nStable: Yes\n\n\n#### `\"Tall\"` (default):\n\n```rust\ntrait Lorem {\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet);\n\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n ) {\n // body\n }\n}\n```\n\n#### `\"Compressed\"`:\n\n```rust\ntrait Lorem {\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet);\n\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet, consectetur: Consectetur,\n adipiscing: Adipiscing, elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet, consectetur: Consectetur,\n adipiscing: Adipiscing, elit: Elit,\n ) {\n // body\n }\n}\n```\n\n#### `\"Vertical\"`:\n\n```rust\ntrait Lorem {\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n ) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n ) {\n // body\n }\n}\n```\n\nSee also `fn_params_layout`", "markdownDescription": "This option is deprecated and has been renamed to `fn_params_layout` to better communicate that\nit affects the layout of parameters in function signatures.\n\nStable: Yes\n\n\n#### `\"Tall\"` (default):\n\n```rust\ntrait Lorem {\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet);\n\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n ) {\n // body\n }\n}\n```\n\n#### `\"Compressed\"`:\n\n```rust\ntrait Lorem {\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet);\n\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet, consectetur: Consectetur,\n adipiscing: Adipiscing, elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet, consectetur: Consectetur,\n adipiscing: Adipiscing, elit: Elit,\n ) {\n // body\n }\n}\n```\n\n#### `\"Vertical\"`:\n\n```rust\ntrait Lorem {\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n ) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n ) {\n // body\n }\n}\n```\n\nSee also `fn_params_layout`", "x-intellij-html-description": "This option is deprecated and has been renamed to fn_params_layout to better communicate that\nit affects the layout of parameters in function signatures.
Stable: Yes
\n"Tall" (default):trait Lorem {\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet);\n\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n ) {\n // body\n }\n}\n"Compressed":trait Lorem {\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet);\n\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet, consectetur: Consectetur,\n adipiscing: Adipiscing, elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet, consectetur: Consectetur,\n adipiscing: Adipiscing, elit: Elit,\n ) {\n // body\n }\n}\n"Vertical":trait Lorem {\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n ) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n ) {\n // body\n }\n}\nSee also fn_params_layout
Maximum width of the args of a function call before falling back to vertical formatting.
\nPossible values: any positive integer that is less than or equal to the value specified for max_width
Stable: Yes
\nBy default this option is set as a percentage of max_width provided by use_small_heuristics, but a value set directly for fn_call_width will take precedence.
See also max_width and use_small_heuristics
Control the layout of parameters in function signatures.
\nStable: Yes
\n"Tall" (default):trait Lorem {\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet);\n\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n ) {\n // body\n }\n}\n"Compressed":trait Lorem {\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet);\n\n fn lorem(ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet, consectetur: Consectetur,\n adipiscing: Adipiscing, elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum, dolor: Dolor, sit: Sit, amet: Amet, consectetur: Consectetur,\n adipiscing: Adipiscing, elit: Elit,\n ) {\n // body\n }\n}\n"Vertical":trait Lorem {\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n ) {\n // body\n }\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n );\n\n fn lorem(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n consectetur: Consectetur,\n adipiscing: Adipiscing,\n elit: Elit,\n ) {\n // body\n }\n}\nPut single-expression functions on a single line
\nStable: No (tracking issue: #3358)
\nfalse (default):fn lorem() -> usize {\n 42\n}\n\nfn lorem() -> usize {\n let ipsum = 42;\n ipsum\n}\ntrue:fn lorem() -> usize { 42 }\n\nfn lorem() -> usize {\n let ipsum = 42;\n ipsum\n}\nSee also control_brace_style.
Always print the abi for extern items
\nStable: Yes
\nNote: Non-"C" ABIs are always printed. If false then "C" is removed.
true (default):extern "C" {\n pub static lorem: c_int;\n}\nfalse:extern {\n pub static lorem: c_int;\n}\nForce multiline closure and match arm bodies to be wrapped in a block
\nStable: No (tracking issue: #3374)
\nfalse (default):fn main() {\n result.and_then(|maybe_value| match maybe_value {\n None => foo(),\n Some(value) => bar(),\n });\n\n match lorem {\n None => |ipsum| {\n println!("Hello World");\n },\n Some(dolor) => foo(),\n }\n}\ntrue:fn main() {\n result.and_then(|maybe_value| {\n match maybe_value {\n None => foo(),\n Some(value) => bar(),\n }\n });\n\n match lorem {\n None => {\n |ipsum| {\n println!("Hello World");\n }\n }\n Some(dolor) => foo(),\n }\n}\nFormat code snippet included in doc comments.
\nStable: No (tracking issue: #3348)
\nfalse (default):/// Adds one to the number given.\n///\n/// # Examples\n///\n/// ```rust\n/// let five=5;\n///\n/// assert_eq!(\n/// 6,\n/// add_one(5)\n/// );\n/// # fn add_one(x: i32) -> i32 {\n/// # x + 1\n/// # }\n/// ```\nfn add_one(x: i32) -> i32 {\n x + 1\n}\ntrue/// Adds one to the number given.\n///\n/// # Examples\n///\n/// ```rust\n/// let five = 5;\n///\n/// assert_eq!(6, add_one(5));\n/// # fn add_one(x: i32) -> i32 {\n/// # x + 1\n/// # }\n/// ```\nfn add_one(x: i32) -> i32 {\n x + 1\n}\nMax width for code snippets included in doc comments. Only used if format_code_in_doc_comments is true.
Possible values: any positive integer that is less than or equal to the value specified for max_width
Stable: No (tracking issue: #5359)
\n", "default": 100 }, "format_generated_files": { "type": "boolean", "description": "Format generated files. A file is considered generated if any of the first several lines contain a `@generated` comment marker. The number of lines to check is configured by `generated_marker_line_search_limit`.\n\nBy default, generated files are reformatted, i. e. `@generated` marker is ignored.\nThis option is currently ignored for stdin (`@generated` in stdin is ignored.)\n\nStable: No (tracking issue: [#5080](https://github.com/rust-lang/rustfmt/issues/5080))", "markdownDescription": "Format generated files. A file is considered generated if any of the first several lines contain a `@generated` comment marker. The number of lines to check is configured by `generated_marker_line_search_limit`.\n\nBy default, generated files are reformatted, i. e. `@generated` marker is ignored.\nThis option is currently ignored for stdin (`@generated` in stdin is ignored.)\n\nStable: No (tracking issue: [#5080](https://github.com/rust-lang/rustfmt/issues/5080))", "x-intellij-html-description": "Format generated files. A file is considered generated if any of the first several lines contain a @generated comment marker. The number of lines to check is configured by generated_marker_line_search_limit.
By default, generated files are reformatted, i. e. @generated marker is ignored.\nThis option is currently ignored for stdin (@generated in stdin is ignored.)
Stable: No (tracking issue: #5080)
\n", "default": true }, "generated_marker_line_search_limit": { "type": "integer", "description": "Number of lines to check for a `@generated` pragma header, starting from the top of the file. Setting this value to `0` will treat all files as non-generated. When`format_generated_files` is `true`, this option has no effect.\n\nPossible values: any positive integer\n\nStable: No (tracking issue: [#5080](https://github.com/rust-lang/rustfmt/issues/5080))\n\nSee also [format_generated_files](#format_generated_files) link here.", "markdownDescription": "Number of lines to check for a `@generated` pragma header, starting from the top of the file. Setting this value to `0` will treat all files as non-generated. When`format_generated_files` is `true`, this option has no effect.\n\nPossible values: any positive integer\n\nStable: No (tracking issue: [#5080](https://github.com/rust-lang/rustfmt/issues/5080))\n\nSee also [format_generated_files](#format_generated_files) link here.", "x-intellij-html-description": "Number of lines to check for a @generated pragma header, starting from the top of the file. Setting this value to 0 will treat all files as non-generated. Whenformat_generated_files is true, this option has no effect.
Possible values: any positive integer
\nStable: No (tracking issue: #5080)
\nSee also format_generated_files link here.
\n", "default": 5 }, "format_macro_matchers": { "type": "boolean", "description": "Format the metavariable matching patterns in macros.\n\nStable: No (tracking issue: [#3354](https://github.com/rust-lang/rustfmt/issues/3354))\n\n\n#### `false` (default):\n\n```rust\nmacro_rules! foo {\n ($a: ident : $b: ty) => {\n $a(42): $b;\n };\n ($a: ident $b: ident $c: ident) => {\n $a = $b + $c;\n };\n}\n```\n\n#### `true`:\n\n```rust\nmacro_rules! foo {\n ($a:ident : $b:ty) => {\n $a(42): $b;\n };\n ($a:ident $b:ident $c:ident) => {\n $a = $b + $c;\n };\n}\n```\n\nSee also `format_macro_bodies`.", "markdownDescription": "Format the metavariable matching patterns in macros.\n\nStable: No (tracking issue: [#3354](https://github.com/rust-lang/rustfmt/issues/3354))\n\n\n#### `false` (default):\n\n```rust\nmacro_rules! foo {\n ($a: ident : $b: ty) => {\n $a(42): $b;\n };\n ($a: ident $b: ident $c: ident) => {\n $a = $b + $c;\n };\n}\n```\n\n#### `true`:\n\n```rust\nmacro_rules! foo {\n ($a:ident : $b:ty) => {\n $a(42): $b;\n };\n ($a:ident $b:ident $c:ident) => {\n $a = $b + $c;\n };\n}\n```\n\nSee also `format_macro_bodies`.", "x-intellij-html-description": "Format the metavariable matching patterns in macros.
\nStable: No (tracking issue: #3354)
\nfalse (default):macro_rules! foo {\n ($a: ident : $b: ty) => {\n $a(42): $b;\n };\n ($a: ident $b: ident $c: ident) => {\n $a = $b + $c;\n };\n}\ntrue:macro_rules! foo {\n ($a:ident : $b:ty) => {\n $a(42): $b;\n };\n ($a:ident $b:ident $c:ident) => {\n $a = $b + $c;\n };\n}\nSee also format_macro_bodies.
Format the bodies of declarative macro definitions.
\nStable: No (tracking issue: #3355)
\ntrue (default):macro_rules! foo {\n ($a: ident : $b: ty) => {\n $a(42): $b;\n };\n ($a: ident $b: ident $c: ident) => {\n $a = $b + $c;\n };\n}\nfalse:macro_rules! foo {\n ($a: ident : $b: ty) => { $a(42): $b; };\n ($a: ident $b: ident $c: ident) => { $a=$b+$c; };\n}\nSee also format_macro_matchers.
Skip formatting the bodies of macro invocations with the following names.
\nrustfmt will not format any macro invocation for macros with names set in this list.\nIncluding the special value "*" will prevent any macro invocations from being formatted.
\nNote: This option does not have any impact on how rustfmt formats macro definitions.
\nPossible values: a list of macro name idents, ["name_0", "name_1", ..., "*"]
Stable: No (tracking issue: #5346)
\n[] (default):rustfmt will follow its standard approach to formatting macro invocations.
\nNo macro invocations will be skipped based on their name. More information about rustfmt's standard macro invocation formatting behavior can be found in #5437.
\nlorem!(\n const _: u8 = 0;\n);\n\nipsum!(\n const _: u8 = 0;\n);\n["lorem"]:The named macro invocations will be skipped.
\nlorem!(\n const _: u8 = 0;\n);\n\nipsum!(\n const _: u8 = 0;\n);\n["*"]:The special selector * will skip all macro invocations.
lorem!(\n const _: u8 = 0;\n);\n\nipsum!(\n const _: u8 = 0;\n);\nFormat string literals where necessary
\nStable: No (tracking issue: #3353)
\nfalse (default):fn main() {\n let lorem = "ipsum dolor sit amet consectetur adipiscing elit lorem ipsum dolor sit amet consectetur adipiscing";\n}\ntrue:fn main() {\n let lorem = "ipsum dolor sit amet consectetur adipiscing elit lorem ipsum dolor sit amet \\\n consectetur adipiscing";\n}\nSee also max_width.
Use tab characters for indentation, spaces for alignment
\nStable: Yes
\nfalse (default):fn lorem() -> usize {\n 42 // spaces before 42\n}\ntrue:fn lorem() -> usize {\n\t42 // tabs before 42\n}\nSee also: tab_spaces.
Control the case of the letters in hexadecimal literal values
\nStable: No (tracking issue: #5081)
\n", "default": "Preserve", "enum": [ "Preserve", "Upper", "Lower" ] }, "float_literal_trailing_zero": { "type": "string", "description": "Control the presence of trailing zero in floating-point literal values\n\nStable: No (tracking issue: [#6471](https://github.com/rust-lang/rustfmt/issues/6471))\n\n\n#### `Preserve` (default):\n\nLeave the literal as-is.\n\n```rust\nfn main() {\n let values = [1.0, 2., 3.0e10, 4f32];\n}\n```\n\n#### `Always`:\n\nAdd a trailing zero to the literal:\n\n```rust\nfn main() {\n let values = [1.0, 2.0, 3.0e10, 4.0f32];\n}\n```\n\n#### `IfNoPostfix`:\n\nAdd a trailing zero by default. If the literal contains an exponent or a suffix, the zero\nand the preceding period are removed:\n\n```rust\nfn main() {\n let values = [1.0, 2.0, 3e10, 4f32];\n}\n```\n\n#### `Never`:\n\nRemove the trailing zero. If the literal contains an exponent or a suffix, the preceding\nperiod is also removed:\n\n```rust\nfn main() {\n let values = [1., 2., 3e10, 4f32];\n}\n```", "markdownDescription": "Control the presence of trailing zero in floating-point literal values\n\nStable: No (tracking issue: [#6471](https://github.com/rust-lang/rustfmt/issues/6471))\n\n\n#### `Preserve` (default):\n\nLeave the literal as-is.\n\n```rust\nfn main() {\n let values = [1.0, 2., 3.0e10, 4f32];\n}\n```\n\n#### `Always`:\n\nAdd a trailing zero to the literal:\n\n```rust\nfn main() {\n let values = [1.0, 2.0, 3.0e10, 4.0f32];\n}\n```\n\n#### `IfNoPostfix`:\n\nAdd a trailing zero by default. If the literal contains an exponent or a suffix, the zero\nand the preceding period are removed:\n\n```rust\nfn main() {\n let values = [1.0, 2.0, 3e10, 4f32];\n}\n```\n\n#### `Never`:\n\nRemove the trailing zero. If the literal contains an exponent or a suffix, the preceding\nperiod is also removed:\n\n```rust\nfn main() {\n let values = [1., 2., 3e10, 4f32];\n}\n```", "x-intellij-html-description": "Control the presence of trailing zero in floating-point literal values
\nStable: No (tracking issue: #6471)
\nPreserve (default):Leave the literal as-is.
\nfn main() {\n let values = [1.0, 2., 3.0e10, 4f32];\n}\nAlways:Add a trailing zero to the literal:
\nfn main() {\n let values = [1.0, 2.0, 3.0e10, 4.0f32];\n}\nIfNoPostfix:Add a trailing zero by default. If the literal contains an exponent or a suffix, the zero\nand the preceding period are removed:
\nfn main() {\n let values = [1.0, 2.0, 3e10, 4f32];\n}\nNever:Remove the trailing zero. If the literal contains an exponent or a suffix, the preceding\nperiod is also removed:
\nfn main() {\n let values = [1., 2., 3e10, 4f32];\n}\nThis option is deprecated and has been renamed to show_parse_errors to avoid confusion around the double negative default of hide_parse_errors=false.
Stable: No (tracking issue: #3390)
\n", "default": false }, "show_parse_errors": { "type": "boolean", "description": "Show parse errors if the parser failed to parse files.\n\nStable: No (tracking issue: [#5977](https://github.com/rust-lang/rustfmt/issues/5977))", "markdownDescription": "Show parse errors if the parser failed to parse files.\n\nStable: No (tracking issue: [#5977](https://github.com/rust-lang/rustfmt/issues/5977))", "x-intellij-html-description": "Show parse errors if the parser failed to parse files.
\nStable: No (tracking issue: #5977)
\n", "default": true }, "ignore": { "description": "Skip formatting files and directories that match the specified pattern.\nThe pattern format is the same as [.gitignore](https://git-scm.com/docs/gitignore#_pattern_format). Be sure to use Unix/forwardslash `/` style paths. This path style will work on all platforms. Windows style paths with backslashes `\\` are not supported.\n\nDefault value: format every file\n\nPossible values: See an example below\n\nStable: No (tracking issue: [#3395](https://github.com/rust-lang/rustfmt/issues/3395))\n\n\n### Example\n\nIf you want to ignore specific files, put the following to your config file:\n\n```toml\nignore = [\n \"src/types.rs\",\n \"src/foo/bar.rs\",\n]\n```\n\nIf you want to ignore every file under `examples/`, put the following to your config file:\n\n```toml\nignore = [\n \"examples\",\n]\n```\n\nIf you want to ignore every file under the directory where you put your rustfmt.toml:\n\n```toml\nignore = [\"/\"]\n```\n\nIf you want to allow specific paths that would otherwise be ignored, prefix those paths with a `!`:\n\n```toml\nignore = [\"bar_dir/*\", \"!bar_dir/*/what.rs\"]\n```\n\nIn this case, all files under `bar_dir` will be ignored, except files like `bar_dir/sub/what.rs`\nor `bar_dir/another/what.rs`.", "markdownDescription": "Skip formatting files and directories that match the specified pattern.\nThe pattern format is the same as [.gitignore](https://git-scm.com/docs/gitignore#_pattern_format). Be sure to use Unix/forwardslash `/` style paths. This path style will work on all platforms. Windows style paths with backslashes `\\` are not supported.\n\nDefault value: format every file\n\nPossible values: See an example below\n\nStable: No (tracking issue: [#3395](https://github.com/rust-lang/rustfmt/issues/3395))\n\n\n### Example\n\nIf you want to ignore specific files, put the following to your config file:\n\n```toml\nignore = [\n \"src/types.rs\",\n \"src/foo/bar.rs\",\n]\n```\n\nIf you want to ignore every file under `examples/`, put the following to your config file:\n\n```toml\nignore = [\n \"examples\",\n]\n```\n\nIf you want to ignore every file under the directory where you put your rustfmt.toml:\n\n```toml\nignore = [\"/\"]\n```\n\nIf you want to allow specific paths that would otherwise be ignored, prefix those paths with a `!`:\n\n```toml\nignore = [\"bar_dir/*\", \"!bar_dir/*/what.rs\"]\n```\n\nIn this case, all files under `bar_dir` will be ignored, except files like `bar_dir/sub/what.rs`\nor `bar_dir/another/what.rs`.", "x-intellij-html-description": "Skip formatting files and directories that match the specified pattern.\nThe pattern format is the same as .gitignore. Be sure to use Unix/forwardslash / style paths. This path style will work on all platforms. Windows style paths with backslashes \\ are not supported.
Default value: format every file
\nPossible values: See an example below
\nStable: No (tracking issue: #3395)
\nIf you want to ignore specific files, put the following to your config file:
\nignore = [\n "src/types.rs",\n "src/foo/bar.rs",\n]\nIf you want to ignore every file under examples/, put the following to your config file:
ignore = [\n "examples",\n]\nIf you want to ignore every file under the directory where you put your rustfmt.toml:
\nignore = ["/"]\nIf you want to allow specific paths that would otherwise be ignored, prefix those paths with a !:
ignore = ["bar_dir/*", "!bar_dir/*/what.rs"]\nIn this case, all files under bar_dir will be ignored, except files like bar_dir/sub/what.rs\nor bar_dir/another/what.rs.
Indent style of imports
\nStable: No (tracking issue: #3360)
\n"Block" (default):use foo::{\n xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx, yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy,\n zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz,\n};\n"Visual":use foo::{xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx, yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy,\n zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz};\nSee also: imports_layout.
Item layout inside a imports block
\nStable: No (tracking issue: #3361)
\n"Mixed" (default):use foo::{xxxxxxxxxxxxxxxxxx, yyyyyyyyyyyyyyyyyy, zzzzzzzzzzzzzzzzzz};\n\nuse foo::{\n aaaaaaaaaaaaaaaaaa, bbbbbbbbbbbbbbbbbb, cccccccccccccccccc, dddddddddddddddddd,\n eeeeeeeeeeeeeeeeee, ffffffffffffffffff,\n};\n"Horizontal":Note: This option forces all imports onto one line and may exceed max_width.
use foo::{xxx, yyy, zzz};\n\nuse foo::{aaa, bbb, ccc, ddd, eee, fff};\n"HorizontalVertical":use foo::{xxxxxxxxxxxxxxxxxx, yyyyyyyyyyyyyyyyyy, zzzzzzzzzzzzzzzzzz};\n\nuse foo::{\n aaaaaaaaaaaaaaaaaa,\n bbbbbbbbbbbbbbbbbb,\n cccccccccccccccccc,\n dddddddddddddddddd,\n eeeeeeeeeeeeeeeeee,\n ffffffffffffffffff,\n};\n"Vertical":use foo::{\n xxx,\n yyy,\n zzz,\n};\n\nuse foo::{\n aaa,\n bbb,\n ccc,\n ddd,\n eee,\n fff,\n};\nIndent on expressions or items.
\nStable: No (tracking issue: #3346)
\n"Block" (default):fn main() {\n let lorem = vec![\n "ipsum",\n "dolor",\n "sit",\n "amet",\n "consectetur",\n "adipiscing",\n "elit",\n ];\n}\n"Visual":fn main() {\n let lorem = vec!["ipsum",\n "dolor",\n "sit",\n "amet",\n "consectetur",\n "adipiscing",\n "elit"];\n}\n"Block" (default):fn main() {\n if lorem_ipsum\n && dolor_sit\n && amet_consectetur\n && lorem_sit\n && dolor_consectetur\n && amet_ipsum\n && lorem_consectetur\n {\n // ...\n }\n}\n"Visual":fn main() {\n if lorem_ipsum\n && dolor_sit\n && amet_consectetur\n && lorem_sit\n && dolor_consectetur\n && amet_ipsum\n && lorem_consectetur\n {\n // ...\n }\n}\nSee also: control_brace_style.
"Block" (default):fn lorem() {}\n\nfn lorem(ipsum: usize) {}\n\nfn lorem(\n ipsum: usize,\n dolor: usize,\n sit: usize,\n amet: usize,\n consectetur: usize,\n adipiscing: usize,\n elit: usize,\n) {\n // body\n}\n"Visual":fn lorem() {}\n\nfn lorem(ipsum: usize) {}\n\nfn lorem(ipsum: usize,\n dolor: usize,\n sit: usize,\n amet: usize,\n consectetur: usize,\n adipiscing: usize,\n elit: usize) {\n // body\n}\n"Block" (default):fn main() {\n lorem(\n "lorem",\n "ipsum",\n "dolor",\n "sit",\n "amet",\n "consectetur",\n "adipiscing",\n "elit",\n );\n}\n"Visual":fn main() {\n lorem("lorem",\n "ipsum",\n "dolor",\n "sit",\n "amet",\n "consectetur",\n "adipiscing",\n "elit");\n}\n"Block" (default):fn lorem<\n Ipsum: Eq = usize,\n Dolor: Eq = usize,\n Sit: Eq = usize,\n Amet: Eq = usize,\n Adipiscing: Eq = usize,\n Consectetur: Eq = usize,\n Elit: Eq = usize,\n>(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n adipiscing: Adipiscing,\n consectetur: Consectetur,\n elit: Elit,\n) -> T {\n // body\n}\n"Visual":fn lorem<Ipsum: Eq = usize,\n Dolor: Eq = usize,\n Sit: Eq = usize,\n Amet: Eq = usize,\n Adipiscing: Eq = usize,\n Consectetur: Eq = usize,\n Elit: Eq = usize>(\n ipsum: Ipsum,\n dolor: Dolor,\n sit: Sit,\n amet: Amet,\n adipiscing: Adipiscing,\n consectetur: Consectetur,\n elit: Elit)\n -> T {\n // body\n}\n"Block" (default):fn main() {\n let lorem = Lorem {\n ipsum: dolor,\n sit: amet,\n };\n}\n"Visual":fn main() {\n let lorem = Lorem { ipsum: dolor,\n sit: amet };\n}\nSee also: struct_lit_single_line, indent_style.
"Block" (default):fn lorem<Ipsum, Dolor, Sit, Amet>() -> T\nwhere\n Ipsum: Eq,\n Dolor: Eq,\n Sit: Eq,\n Amet: Eq,\n{\n // body\n}\n"Visual":fn lorem<Ipsum, Dolor, Sit, Amet>() -> T\n where Ipsum: Eq,\n Dolor: Eq,\n Sit: Eq,\n Amet: Eq\n{\n // body\n}\nWrite an item and its attribute on the same line if their combined width is below a threshold
\nPossible values: any positive integer
\nStable: No (tracking issue: #3343)
\n0 (default):#[cfg(feature = "alloc")]\nuse core::slice;\n50:#[cfg(feature = "alloc")] use core::slice;\nControls whether arm bodies are wrapped in cases where the first line of the body cannot fit on the same line as the => operator.
The Style Guide requires that bodies are block wrapped by default if a line break is required after the =>, but this option can be used to disable that behavior to prevent wrapping arm bodies in that event, so long as the body contains neither multiple statements nor line comments.
Stable: No (tracking issue: #3373)
\ntrue (default):fn main() {\n match lorem {\n ipsum => {\n foooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo(x)\n }\n dolor => println!("{}", sit),\n sit => foo(\n "foooooooooooooooooooooooo",\n "baaaaaaaaaaaaaaaaaaaaaaaarr",\n "baaaaaaaaaaaaaaaaaaaazzzzzzzzzzzzz",\n "qqqqqqqqquuuuuuuuuuuuuuuuuuuuuuuuuuxxx",\n ),\n }\n}\nfalse:fn main() {\n match lorem {\n lorem =>\n foooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo(x),\n ipsum => println!("{}", sit),\n sit => foo(\n "foooooooooooooooooooooooo",\n "baaaaaaaaaaaaaaaaaaaaaaaarr",\n "baaaaaaaaaaaaaaaaaaaazzzzzzzzzzzzz",\n "qqqqqqqqquuuuuuuuuuuuuuuuuuuuuuuuuuxxx",\n ),\n }\n}\nSee also: match_block_trailing_comma.
Controls whether to include a leading pipe on match arms
\nStable: Yes
\nNever (default):// Leading pipes are removed from this:\n// fn foo() {\n// match foo {\n// | "foo" | "bar" => {}\n// | "baz"\n// | "something relatively long"\n// | "something really really really realllllllllllllly long" => println!("x"),\n// | "qux" => println!("y"),\n// _ => {}\n// }\n// }\n\n// Becomes\nfn foo() {\n match foo {\n "foo" | "bar" => {}\n "baz"\n | "something relatively long"\n | "something really really really realllllllllllllly long" => println!("x"),\n "qux" => println!("y"),\n _ => {}\n }\n}\nAlways:// Leading pipes are emitted on all arms of this:\n// fn foo() {\n// match foo {\n// "foo" | "bar" => {}\n// "baz"\n// | "something relatively long"\n// | "something really really really realllllllllllllly long" => println!("x"),\n// "qux" => println!("y"),\n// _ => {}\n// }\n// }\n\n// Becomes:\nfn foo() {\n match foo {\n | "foo" | "bar" => {}\n | "baz"\n | "something relatively long"\n | "something really really really realllllllllllllly long" => println!("x"),\n | "qux" => println!("y"),\n | _ => {}\n }\n}\nPreserve:fn foo() {\n match foo {\n | "foo" | "bar" => {}\n | "baz"\n | "something relatively long"\n | "something really really really realllllllllllllly long" => println!("x"),\n | "qux" => println!("y"),\n _ => {}\n }\n\n match baz {\n "qux" => {}\n "foo" | "bar" => {}\n _ => {}\n }\n}\nControls whether match arms are indented. If disabled, match arms will be formatted at the same indentation level as the outer match statement. Meaning that match blocks will only be indented once, not twice.
Stable: No (tracking issue: #6533)
\ntrue (default):fn main() {\n match value {\n Enum::A => {\n let mut work = first();\n work += second();\n }\n Enum::B => short_work(),\n }\n}\nfalse:fn main() {\n match value {\n Enum::A => {\n let mut work = first();\n work += second();\n }\n Enum::B => short_work(),\n }\n}\nPut a trailing comma after a block based match arm (non-block arms are not affected)
\nStable: Yes
\nfalse (default):fn main() {\n match lorem {\n Lorem::Ipsum => {\n println!("ipsum");\n }\n Lorem::Dolor => println!("dolor"),\n }\n}\ntrue:fn main() {\n match lorem {\n Lorem::Ipsum => {\n println!("ipsum");\n },\n Lorem::Dolor => println!("dolor"),\n }\n}\nSee also: trailing_comma, match_arm_blocks.
Maximum width of each line
\nPossible values: any positive integer
\nStable: Yes
\nSee also error_on_line_overflow.
Merge multiple derives into a single one.
\nStable: Yes
\ntrue (default):#[derive(Eq, PartialEq, Debug, Copy, Clone)]\npub enum Foo {}\nfalse:#[derive(Eq, PartialEq, Debug, Copy, Clone)]\npub enum Bar {}\n\n#[derive(Eq, PartialEq)]\n#[derive(Debug)]\n#[derive(Copy, Clone)]\npub enum Foo {}\nControls how imports are structured in use statements. Imports will be merged or split to the configured level of granularity.
Similar to other import related configuration options, this option operates within the bounds of user-defined groups of imports. See group_imports for more information on import groups.
Note that rustfmt will not modify the granularity of imports containing comments if doing so could potentially lose or misplace said comments.
\nStable: No (tracking issue: #4991)
\nPreserve (default):Do not change the granularity of any imports and preserve the original structure written by the developer.
\nuse foo::b;\nuse foo::b::{f, g};\nuse foo::{a, c, d::e};\nuse qux::{h, i};\nCrate:Merge imports from the same crate into a single use statement. Conversely, imports from different crates are split into separate statements.
use foo::{\n a, b,\n b::{f, g},\n c,\n d::e,\n};\nuse qux::{h, i};\nModule:Merge imports from the same module into a single use statement. Conversely, imports from different modules are split into separate statements.
use foo::b::{f, g};\nuse foo::d::e;\nuse foo::{a, b, c};\nuse qux::{h, i};\nItem:Flatten imports so that each has its own use statement.
use foo::a;\nuse foo::b;\nuse foo::b::f;\nuse foo::b::g;\nuse foo::c;\nuse foo::d::e;\nuse qux::h;\nuse qux::i;\nOne:Merge all imports into a single use statement as long as they have the same visibility.
pub use foo::{x, y};\nuse {\n bar::{\n a,\n b::{self, f, g},\n c,\n d::e,\n },\n qux::{h, i},\n};\nThis option is deprecated. Use imports_granularity = "Crate" instead.
Stable: undefined
\nfalse (default):use foo::{a, c, d};\nuse foo::{b, g};\nuse foo::{e, f};\ntrue:use foo::{a, b, c, d, e, f, g};\nUnix or Windows line endings
\nStable: Yes
\nAuto (default):The newline style is detected automatically on a per-file basis. Files\nwith mixed line endings will be converted to the first detected line\nending style.
\nNativeLine endings will be converted to \\r\\n on Windows and \\n on all\nother platforms.
UnixLine endings will be converted to \\n.
WindowsLine endings will be converted to \\r\\n.
Convert /* */ comments to // comments where possible
\nStable: No (tracking issue: #3350)
\nfalse (default):// Lorem ipsum:\nfn dolor() -> usize {}\n\n/* sit amet: */\nfn adipiscing() -> usize {}\ntrue:// Lorem ipsum:\nfn dolor() -> usize {}\n\n// sit amet:\nfn adipiscing() -> usize {}\nConvert #![doc] and #[doc] attributes to //! and /// doc comments.
Stable: No (tracking issue: #3351)
\nfalse (default):#![doc = "Example documentation"]\n\n#[doc = "Example item documentation"]\npub enum Bar {}\n\n/// Example item documentation\npub enum Foo {}\ntrue://! Example documentation\n\n/// Example item documentation\npub enum Foo {}\nWhen structs, slices, arrays, and block/array-like macros are used as the last\nargument in an expression list, allow them to overflow (like blocks/closures)\ninstead of being indented on a new line.
\nStable: No (tracking issue: #3370)
\nfalse (default):fn example() {\n foo(ctx, |param| {\n action();\n foo(param)\n });\n\n foo(\n ctx,\n Bar {\n x: value,\n y: value2,\n },\n );\n\n foo(\n ctx,\n &[\n MAROON_TOMATOES,\n PURPLE_POTATOES,\n ORGANE_ORANGES,\n GREEN_PEARS,\n RED_APPLES,\n ],\n );\n\n foo(\n ctx,\n vec![\n MAROON_TOMATOES,\n PURPLE_POTATOES,\n ORGANE_ORANGES,\n GREEN_PEARS,\n RED_APPLES,\n ],\n );\n}\ntrue:fn example() {\n foo(ctx, |param| {\n action();\n foo(param)\n });\n\n foo(ctx, Bar {\n x: value,\n y: value2,\n });\n\n foo(ctx, &[\n MAROON_TOMATOES,\n PURPLE_POTATOES,\n ORGANE_ORANGES,\n GREEN_PEARS,\n RED_APPLES,\n ]);\n\n foo(ctx, vec![\n MAROON_TOMATOES,\n PURPLE_POTATOES,\n ORGANE_ORANGES,\n GREEN_PEARS,\n RED_APPLES,\n ]);\n}\nRemove nested parens.
\nStable: Yes
\ntrue (default):fn main() {\n (foo());\n}\nfalse:fn main() {\n (foo());\n\n ((((foo()))));\n}\nReorder impl items. type and const are put first, then macros and methods.
Stable: No (tracking issue: #3363)
\nfalse (default)struct Dummy;\n\nimpl Iterator for Dummy {\n fn next(&mut self) -> Option<Self::Item> {\n None\n }\n\n type Item = i32;\n}\n\nimpl Iterator for Dummy {\n type Item = i32;\n\n fn next(&mut self) -> Option<Self::Item> {\n None\n }\n}\ntruestruct Dummy;\n\nimpl Iterator for Dummy {\n type Item = i32;\n\n fn next(&mut self) -> Option<Self::Item> {\n None\n }\n}\nReorder import and extern crate statements alphabetically in groups (a group is\nseparated by a newline).
\nStable: Yes
\ntrue (default):use dolor;\nuse ipsum;\nuse lorem;\nuse sit;\nfalse:use lorem;\nuse ipsum;\nuse dolor;\nuse sit;\nControls the strategy for how consecutive imports are grouped together.
\nControls the strategy for grouping sets of consecutive imports. Imports may contain newlines between imports and still be grouped together as a single set, but other statements between imports will result in different grouping sets.
\nStable: No (tracking issue: #5083)
\nEach set of imports (one or more use statements, optionally separated by newlines) will be formatted independently. Other statements such as mod ... or extern crate ... will cause imports to not be grouped together.
Preserve (default):Preserve the source file's import groups.
\nuse super::update::convert_publish_payload;\nuse chrono::Utc;\n\nuse alloc::alloc::Layout;\nuse juniper::{FieldError, FieldResult};\nuse uuid::Uuid;\n\nuse std::sync::Arc;\n\nuse broker::database::PooledConnection;\n\nuse super::schema::{Context, Payload};\nuse crate::models::Event;\nuse core::f32;\nStdExternalCrate:Discard existing import groups, and create three groups for:
\nstd, core and alloc,self, super and crate imports.use alloc::alloc::Layout;\nuse core::f32;\nuse std::sync::Arc;\n\nuse broker::database::PooledConnection;\nuse chrono::Utc;\nuse juniper::{FieldError, FieldResult};\nuse uuid::Uuid;\n\nuse super::schema::{Context, Payload};\nuse super::update::convert_publish_payload;\nuse crate::models::Event;\nOne:Discard existing import groups, and create a single group for everything
\nuse super::schema::{Context, Payload};\nuse super::update::convert_publish_payload;\nuse crate::models::Event;\nuse alloc::alloc::Layout;\nuse broker::database::PooledConnection;\nuse chrono::Utc;\nuse core::f32;\nuse juniper::{FieldError, FieldResult};\nuse std::sync::Arc;\nuse uuid::Uuid;\nReorder mod declarations alphabetically in group.
Stable: Yes
\ntrue (default)mod a;\nmod b;\n\nmod dolor;\nmod ipsum;\nmod lorem;\nmod sit;\nfalsemod b;\nmod a;\n\nmod lorem;\nmod ipsum;\nmod dolor;\nmod sit;\nNote mod with #[macro_export] will not be reordered since that could change the semantics\nof the original source code.
Require a specific version of rustfmt. If you want to make sure that the\nspecific version of rustfmt is used in your CI, use this option.
\nPossible values: semver compliant values, such as defined on semver.org.
Stable: No (tracking issue: #3386)
\nrequired_version="1.0.0"\nrequired_version=">=1.0.0"\nrequired_version="<=1.0.0"\nrequired_version="^1.0.0"\nrequired_version="~1.0.0"\nrequired_version="*" # matches any version.\nrequired_version="1.*" # matches any version with the same major version\nrequired_version="1.0.*" # matches any version with the same major and minor version\nA comma separated list of version requirements.\nThe match succeeds when the current rustfmt version matches all version requirements.
\nThe one notable exception is that a wildcard matching any version cannot be used in the list.\nFor example, *, <1.0.0 will always fail.
Additionally, the version match will always fail if any of the version requirements contradict themselves.\nSome examples of contradictory requirements are 1.*, >2.0.0, 1.0.*, >2.0.0 and <1.5.0, >1.10.*.
required_version=">=1.0.0, <2.0.0"\nThe width threshold for an array element to be considered "short".
\nThe layout of an array is dependent on the length of each of its elements. \nIf the length of every element in an array is below this threshold (all elements are "short") then the array can be formatted in the mixed/compressed style, but if any one element has a length that exceeds this threshold then the array elements will have to be formatted vertically.
\nPossible values: any positive integer that is less than or equal to the value specified for max_width
Stable: Yes
\n10 (default):fn main() {\n pub const FORMAT_TEST: [u64; 5] = [\n 0x0000000000000000,\n 0xaaaaaaaaaaaaaaaa,\n 0xbbbbbbbbbbbbbbbb,\n 0xcccccccccccccccc,\n 0xdddddddddddddddd,\n ];\n}\n20:fn main() {\n pub const FORMAT_TEST: [u64; 5] = [\n 0x0000000000000000, 0xaaaaaaaaaaaaaaaa, 0xbbbbbbbbbbbbbbbb, 0xcccccccccccccccc,\n 0xdddddddddddddddd,\n ];\n}\nSee also max_width.
Don't reformat out of line modules
\nStable: No (tracking issue: #3389)
\n", "default": false }, "single_line_if_else_max_width": { "type": "integer", "description": "Maximum line length for single line if-else expressions. A value of `0` (zero) results in if-else expressions always being broken into multiple lines. Note this occurs when `use_small_heuristics` is set to `Off`.\n\nPossible values: any positive integer that is less than or equal to the value specified for `max_width`\n\nStable: Yes\n\nBy default this option is set as a percentage of `max_width` provided by `use_small_heuristics`, but a value set directly for `single_line_if_else_max_width` will take precedence.\n\nSee also `max_width` and `use_small_heuristics`", "markdownDescription": "Maximum line length for single line if-else expressions. A value of `0` (zero) results in if-else expressions always being broken into multiple lines. Note this occurs when `use_small_heuristics` is set to `Off`.\n\nPossible values: any positive integer that is less than or equal to the value specified for `max_width`\n\nStable: Yes\n\nBy default this option is set as a percentage of `max_width` provided by `use_small_heuristics`, but a value set directly for `single_line_if_else_max_width` will take precedence.\n\nSee also `max_width` and `use_small_heuristics`", "x-intellij-html-description": "Maximum line length for single line if-else expressions. A value of 0 (zero) results in if-else expressions always being broken into multiple lines. Note this occurs when use_small_heuristics is set to Off.
Possible values: any positive integer that is less than or equal to the value specified for max_width
Stable: Yes
\nBy default this option is set as a percentage of max_width provided by use_small_heuristics, but a value set directly for single_line_if_else_max_width will take precedence.
See also max_width and use_small_heuristics
Maximum line length for single line let-else statements.\nSee the let-else statement section of the Rust Style Guide for more details on when a let-else statement may be written on a single line.\nA value of 0 (zero) means the divergent else block will always be formatted over multiple lines.\nNote this occurs when use_small_heuristics is set to Off.
By default this option is set as a percentage of max_width provided by use_small_heuristics, but a value set directly for single_line_let_else_max_width will take precedence.
Possible values: any positive integer that is less than or equal to the value specified for max_width
Stable: Yes
\n50 (default):fn main() {\n let Some(w) = opt else { return Ok(()) };\n\n let Some(x) = opt else { return };\n\n let Some(y) = opt else {\n return;\n };\n\n let Some(z) = some_very_very_very_very_long_name else {\n return;\n };\n}\n0:fn main() {\n let Some(w) = opt else {\n return Ok(());\n };\n\n let Some(x) = opt else {\n return;\n };\n\n let Some(y) = opt else {\n return;\n };\n\n let Some(z) = some_very_very_very_very_long_name else {\n return;\n };\n}\n100:fn main() {\n let Some(w) = opt else { return Ok(()) };\n\n let Some(x) = opt else { return };\n\n let Some(y) = opt else {\n return;\n };\n\n let Some(z) = some_very_very_very_very_long_name else { return };\n}\nSee also max_width and use_small_heuristics
Leave a space after the colon.
\nStable: No (tracking issue: #3366)
\ntrue (default):fn lorem<T: Eq>(t: T) {\n let lorem: Dolor = Lorem {\n ipsum: dolor,\n sit: amet,\n };\n}\nfalse:fn lorem<T:Eq>(t:T) {\n let lorem:Dolor = Lorem {\n ipsum:dolor,\n sit:amet,\n };\n}\nSee also: space_before_colon.
Leave a space before the colon.
\nStable: No (tracking issue: #3365)
\nfalse (default):fn lorem<T: Eq>(t: T) {\n let lorem: Dolor = Lorem {\n ipsum: dolor,\n sit: amet,\n };\n}\ntrue:fn lorem<T : Eq>(t : T) {\n let lorem : Dolor = Lorem {\n ipsum : dolor,\n sit : amet,\n };\n}\nSee also: space_after_colon.
Put spaces around the .., ..=, and ... range operators
\nStable: No (tracking issue: #3367)
\nfalse (default):fn main() {\n let lorem = 0..10;\n let ipsum = 0..=10;\n\n match lorem {\n 1..5 => foo(),\n _ => bar,\n }\n\n match lorem {\n 1..=5 => foo(),\n _ => bar,\n }\n\n match lorem {\n 1...5 => foo(),\n _ => bar,\n }\n}\ntrue:fn main() {\n let lorem = 0 .. 10;\n let ipsum = 0 ..= 10;\n\n match lorem {\n 1 .. 5 => foo(),\n _ => bar,\n }\n\n match lorem {\n 1 ..= 5 => foo(),\n _ => bar,\n }\n\n match lorem {\n 1 ... 5 => foo(),\n _ => bar,\n }\n}\nThe maximum diff of width between struct fields to be aligned with each other.
\nPossible values: any non-negative integer
\nStable: No (tracking issue: #3371)
\n0 (default):struct Foo {\n x: u32,\n yy: u32,\n zzz: u32,\n}\n20:struct Foo {\n x: u32,\n yy: u32,\n zzz: u32,\n}\nPut small struct literals on a single line
\nStable: No (tracking issue: #3357)
\ntrue (default):fn main() {\n let lorem = Lorem { foo: bar, baz: ofo };\n}\nfalse:fn main() {\n let lorem = Lorem {\n foo: bar,\n baz: ofo,\n };\n}\nSee also: indent_style.
Maximum width in the body of a struct literal before falling back to vertical formatting. A value of 0 (zero) results in struct literals always being broken into multiple lines. Note this occurs when use_small_heuristics is set to Off.
Possible values: any positive integer that is less than or equal to the value specified for max_width
Stable: Yes
\nBy default this option is set as a percentage of max_width provided by use_small_heuristics, but a value set directly for struct_lit_width will take precedence.
See also max_width, use_small_heuristics, and struct_lit_single_line
Maximum width in the body of a struct variant before falling back to vertical formatting. A value of 0 (zero) results in struct literals always being broken into multiple lines. Note this occurs when use_small_heuristics is set to Off.
Possible values: any positive integer that is less than or equal to the value specified for max_width
Stable: Yes
\nBy default this option is set as a percentage of max_width provided by use_small_heuristics, but a value set directly for struct_variant_width will take precedence.
See also max_width and use_small_heuristics
Controls the edition of the Rust Style Guide to use for formatting (RFC 3338)
\nPossible values: "2015", "2018", "2021", "2024" (unstable variant)
Stable: No
\nThis option is inferred from the edition if not specified.
See Rust Style Editions for details on formatting differences between style editions.\nrustfmt has a default style edition of 2015 while cargo fmt infers the style edition from the edition set in Cargo.toml. This can lead to inconsistencies between rustfmt and cargo fmt if the style edition is not explicitly configured.
To ensure consistent formatting, it is recommended to specify the style_edition in a rustfmt.toml configuration file. For example:
style_edition = "2024"\nAlternatively, you can use the --style-edition flag when running rustfmt directly.
Number of spaces per tab
\nPossible values: any positive integer
\nStable: Yes
\n4 (default):fn lorem() {\n let ipsum = dolor();\n let sit = vec![\n "amet consectetur adipiscing elit amet",\n "consectetur adipiscing elit amet consectetur.",\n ];\n}\n2:fn lorem() {\n let ipsum = dolor();\n let sit = vec![\n "amet consectetur adipiscing elit amet",\n "consectetur adipiscing elit amet consectetur.",\n ];\n}\nSee also: hard_tabs.
How to handle trailing commas for lists
\nStable: No (tracking issue: #3379)
\n"Vertical" (default):fn main() {\n let Lorem { ipsum, dolor, sit } = amet;\n let Lorem {\n ipsum,\n dolor,\n sit,\n amet,\n consectetur,\n adipiscing,\n } = elit;\n}\n"Always":fn main() {\n let Lorem { ipsum, dolor, sit, } = amet;\n let Lorem {\n ipsum,\n dolor,\n sit,\n amet,\n consectetur,\n adipiscing,\n } = elit;\n}\n"Never":fn main() {\n let Lorem { ipsum, dolor, sit } = amet;\n let Lorem {\n ipsum,\n dolor,\n sit,\n amet,\n consectetur,\n adipiscing\n } = elit;\n}\nSee also: match_block_trailing_comma.
Add trailing semicolon after break, continue and return
\nStable: No (tracking issue: #3378)
\ntrue (default):fn foo() -> usize {\n return 0;\n}\nfalse:fn foo() -> usize {\n return 0\n}\nDetermines if + or = are wrapped in spaces in the punctuation of types
Stable: No (tracking issue: #3364)
\n"Wide" (default):fn lorem<Ipsum: Dolor + Sit = Amet>() {\n // body\n}\n"Compressed":fn lorem<Ipsum: Dolor+Sit=Amet>() {\n // body\n}\nEnable unstable features on the unstable channel.
\nStable: No (tracking issue: #3387)
\n", "default": false }, "use_field_init_shorthand": { "type": "boolean", "description": "Use field initialize shorthand if possible.\n\nStable: Yes\n\n\n#### `false` (default):\n\n```rust\nstruct Foo {\n x: u32,\n y: u32,\n z: u32,\n}\n\nfn main() {\n let x = 1;\n let y = 2;\n let z = 3;\n let a = Foo { x, y, z };\n let b = Foo { x: x, y: y, z: z };\n}\n```\n\n#### `true`:\n\n```rust\nstruct Foo {\n x: u32,\n y: u32,\n z: u32,\n}\n\nfn main() {\n let x = 1;\n let y = 2;\n let z = 3;\n let a = Foo { x, y, z };\n let b = Foo { x, y, z };\n}\n```", "markdownDescription": "Use field initialize shorthand if possible.\n\nStable: Yes\n\n\n#### `false` (default):\n\n```rust\nstruct Foo {\n x: u32,\n y: u32,\n z: u32,\n}\n\nfn main() {\n let x = 1;\n let y = 2;\n let z = 3;\n let a = Foo { x, y, z };\n let b = Foo { x: x, y: y, z: z };\n}\n```\n\n#### `true`:\n\n```rust\nstruct Foo {\n x: u32,\n y: u32,\n z: u32,\n}\n\nfn main() {\n let x = 1;\n let y = 2;\n let z = 3;\n let a = Foo { x, y, z };\n let b = Foo { x, y, z };\n}\n```", "x-intellij-html-description": "Use field initialize shorthand if possible.
\nStable: Yes
\nfalse (default):struct Foo {\n x: u32,\n y: u32,\n z: u32,\n}\n\nfn main() {\n let x = 1;\n let y = 2;\n let z = 3;\n let a = Foo { x, y, z };\n let b = Foo { x: x, y: y, z: z };\n}\ntrue:struct Foo {\n x: u32,\n y: u32,\n z: u32,\n}\n\nfn main() {\n let x = 1;\n let y = 2;\n let z = 3;\n let a = Foo { x, y, z };\n let b = Foo { x, y, z };\n}\nThis option can be used to simplify the management and bulk updates of the granular width configuration settings (fn_call_width, attr_fn_like_width, struct_lit_width, struct_variant_width, array_width, chain_width, single_line_if_else_max_width), that respectively control when formatted constructs are multi-lined/vertical based on width.
Note that explicitly provided values for the width configuration settings take precedence and override the calculated values determined by use_small_heuristics.
Stable: Yes
\nDefault (default):When use_small_heuristics is set to Default, the values for the granular width settings are calculated as a ratio of the value for max_width.
The ratios are:
\nfn_call_width - 60%attr_fn_like_width - 70%struct_lit_width - 18%struct_variant_width - 35%array_width - 60%chain_width - 60%single_line_if_else_max_width - 50%single_line_let_else_max_width - 50%For example when max_width is set to 100, the width settings are:
fn_call_width=60attr_fn_like_width=70struct_lit_width=18struct_variant_width=35array_width=60chain_width=60single_line_if_else_max_width=50single_line_let_else_max_width=50and when max_width is set to 200:
fn_call_width=120attr_fn_like_width=140struct_lit_width=36struct_variant_width=70array_width=120chain_width=120single_line_if_else_max_width=100single_line_let_else_max_width=100enum Lorem {\n Ipsum,\n Dolor(bool),\n Sit { amet: Consectetur, adipiscing: Elit },\n}\n\nfn main() {\n lorem(\n "lorem",\n "ipsum",\n "dolor",\n "sit",\n "amet",\n "consectetur",\n "adipiscing",\n );\n\n let lorem = Lorem {\n ipsum: dolor,\n sit: amet,\n };\n let lorem = Lorem { ipsum: dolor };\n\n let lorem = if ipsum { dolor } else { sit };\n}\nOff:When use_small_heuristics is set to Off, the granular width settings are functionally disabled and ignored. See the documentation for the respective width config options for specifics.
enum Lorem {\n Ipsum,\n Dolor(bool),\n Sit {\n amet: Consectetur,\n adipiscing: Elit,\n },\n}\n\nfn main() {\n lorem("lorem", "ipsum", "dolor", "sit", "amet", "consectetur", "adipiscing");\n\n let lorem = Lorem {\n ipsum: dolor,\n sit: amet,\n };\n\n let lorem = if ipsum {\n dolor\n } else {\n sit\n };\n}\nMax:When use_small_heuristics is set to Max, then each granular width setting is set to the same value as max_width.
So if max_width is set to 200, then all the width settings are also set to 200.
fn_call_width=200attr_fn_like_width=200struct_lit_width=200struct_variant_width=200array_width=200chain_width=200single_line_if_else_max_width=200single_line_let_else_max_width=200enum Lorem {\n Ipsum,\n Dolor(bool),\n Sit { amet: Consectetur, adipiscing: Elit },\n}\n\nfn main() {\n lorem("lorem", "ipsum", "dolor", "sit", "amet", "consectetur", "adipiscing");\n\n let lorem = Lorem { ipsum: dolor, sit: amet };\n\n let lorem = if ipsum { dolor } else { sit };\n}\nSee also:
\nmax_widthfn_call_widthattr_fn_like_widthstruct_lit_widthstruct_variant_widtharray_widthchain_widthsingle_line_if_else_max_widthsingle_line_let_else_max_widthReplace uses of the try! macro by the ? shorthand
\nStable: Yes
\nfalse (default):fn main() {\n let lorem = ipsum.map(|dolor| dolor.sit())?;\n\n let lorem = try!(ipsum.map(|dolor| dolor.sit()));\n}\ntrue:fn main() {\n let lorem = ipsum.map(|dolor| dolor.sit())?;\n}\nThis option is deprecated and has been replaced by style_edition.\nversion = "One" is equivalent to style_edition = "(2015|2018|2021)" and\nversion = "Two" is equivalent to style_edition = "2024"
Stable: No (tracking issue: #3383)
\nversion = "Two"\nForces the where clause to be laid out on a single line.
Stable: No (tracking issue: #3359)
\nfalse (default):impl<T> Lorem for T\nwhere\n Option<T>: Ipsum,\n{\n // body\n}\ntrue:impl<T> Lorem for T\nwhere Option<T>: Ipsum\n{\n // body\n}\nSee also brace_style, control_brace_style.
Break comments to fit on the line
\nNote that no wrapping will happen if:
\nStable: No (tracking issue: #3347)
\nfalse (default):// Lorem ipsum dolor sit amet, consectetur adipiscing elit,\n// sed do eiusmod tempor incididunt ut labore et dolore\n// magna aliqua. Ut enim ad minim veniam, quis nostrud\n// exercitation ullamco laboris nisi ut aliquip ex ea\n// commodo consequat.\n\n// Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.\n\n// Information on the lorem ipsum can be found at the following url: https://en.wikipedia.org/wiki/Lorem_ipsum. Its text is: lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.\n\n/// # This doc comment is a very long header (it starts with a '#'). Had it not been a header it would have been wrapped. But because it is a header, it will not be. That is because wrapping a markdown header breaks it.\nstruct Foo {}\ntrue:// Lorem ipsum dolor sit amet, consectetur adipiscing elit,\n// sed do eiusmod tempor incididunt ut labore et dolore\n// magna aliqua. Ut enim ad minim veniam, quis nostrud\n// exercitation ullamco laboris nisi ut aliquip ex ea\n// commodo consequat.\n\n// Lorem ipsum dolor sit amet, consectetur adipiscing elit,\n// sed do eiusmod tempor incididunt ut labore et dolore\n// magna aliqua. Ut enim ad minim veniam, quis nostrud\n// exercitation ullamco laboris nisi ut aliquip ex ea\n// commodo consequat.\n\n// Information on the lorem ipsum can be found at the following url: https://en.wikipedia.org/wiki/Lorem_ipsum. Its text is: lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.\n\n/// # This doc comment is a very long header (it starts with a '#'). Had it not been a header it would have been wrapped. But because it is a header, it will not be. That is because wrapping a markdown header breaks it.\nstruct Foo {}\n