rustfmt.toml

# .rustfmt.toml

# -------------------------------------------------------------------------------------
# LINE WIDTH & INDENTATION
# -------------------------------------------------------------------------------------

# The maximum width of each line. Commonly 80 for narrower displays,
# or 100 if you prefer a bit more breathing room.
max_width = 130

# Number of spaces per tab.
tab_spaces = 4

# Use spaces instead of tabs.
hard_tabs = true

# -------------------------------------------------------------------------------------
# COMMENT FORMATTING
# -------------------------------------------------------------------------------------

# Wrap comments to max_width where possible.
wrap_comments = true

# If you’d like to limit comment lines to something shorter than max_width,
# uncomment and adjust the following:
# comment_width = 80

# -------------------------------------------------------------------------------------
# IMPORTS & GROUPING
# -------------------------------------------------------------------------------------

# Merge imports from the same module.
# merge_imports = true

# Controls the style used for grouping imports:
# - "Preserve": Keep the existing groups untouched.
# - "StdExternalCrate": Group std, external, and crate-specific in separate groups.
# - "One": Put everything in a single group.
group_imports = "StdExternalCrate"

# Adjust how much to split or merge imports. Possible values:
# - "Preserve"
# - "Crate"
# - "Module"
# - "Item"
imports_granularity = "Crate"

# Whether to reorder imports alphabetically within their groups.
reorder_imports = true

# -------------------------------------------------------------------------------------
# BRACES & BLOCKS
# -------------------------------------------------------------------------------------

# Controls brace placement. Common choices:
# - "AlwaysSameLine": e.g. `fn foo() {`
# - "AlwaysNextLine": e.g. `fn foo()\n{`
# - "PreferSameLine": tries same line unless it’s too long
brace_style = "SameLineWhere"

# -------------------------------------------------------------------------------------
# NEWLINES & GENERAL LAYOUT
# -------------------------------------------------------------------------------------

# How many consecutive blank lines are allowed. Setting both to 1 helps keep the code tight.
blank_lines_upper_bound = 1
blank_lines_lower_bound = 0

# The line endings to use. Common options: "Unix", "Windows", or "Auto"
newline_style = "Unix"

# Controls trailing commas in multi-line lists (structs, enums, function params, etc.).
# Recommended to keep them for cleaner diffs:
trailing_comma = "Never"

# If the code becomes too dense, you can force multi-line blocks in match arms, function calls, etc.
# Setting this to "true" can significantly expand vertical space, so use with care.
force_multiline_blocks = false

# -------------------------------------------------------------------------------------
# EDITION & VERSION
# -------------------------------------------------------------------------------------

# Format code as if it's Rust 2021 edition (or 2018 if your project is older).
edition = "2021"

# By default, rustfmt uses the classic style; version=2 is an experimental style in development.
# You can enable it if you prefer or want to try the newer format rules:
# version = 2

# -------------------------------------------------------------------------------------
# OTHER HANDY SETTINGS
# -------------------------------------------------------------------------------------

# Rustfmt can shorten field names if possible in struct initializers, e.g. `x: x` -> `x`.
use_field_init_shorthand = true

# Rustfmt can convert code like `try!(x)` to the `?` operator. 
# Usually not needed anymore, but can be helpful in legacy codebases.
use_try_shorthand = true

# The style for binary operator layout. "Front" places the operator at the start of the new line.
# If you prefer to have the operator at the end of the previous line, set this to "Back".
binop_separator = "Front"

# How to handle function argument layout when they exceed max_width.
# Options include: "Tall", "Block", or "Compressed".
fn_params_layout = "Compressed"