Struct Config 

pub struct Config {

    pub line_width: usize,
    pub tab_size: usize,
    pub use_tabchars: bool,
    pub max_empty_lines: usize,
    pub max_lines_hwrap: usize,
    pub max_pargs_hwrap: usize,
    pub max_subgroups_hwrap: usize,
    pub dangle_parens: bool,
    pub dangle_align: DangleAlign,
    pub min_prefix_chars: usize,
    pub max_prefix_chars: usize,
    pub separate_ctrl_name_with_space: bool,
    pub separate_fn_name_with_space: bool,
    pub command_case: CaseStyle,
    pub keyword_case: CaseStyle,
    pub enable_markup: bool,
    pub reflow_comments: bool,
    pub first_comment_is_literal: bool,
    pub literal_comment_pattern: String,
    pub bullet_char: String,
    pub enum_char: String,
    pub fence_pattern: String,
    pub ruler_pattern: String,
    pub hashruler_min_length: usize,
    pub canonicalize_hashrulers: bool,
    pub per_command_overrides: HashMap<String, PerCommandConfig>,
}

Full formatter configuration.

Construct Config::default and set fields as needed before passing it to format_source or related functions.

use cmakefmt::{Config, CaseStyle, DangleAlign};

let config = Config {
    line_width: 100,
    command_case: CaseStyle::Lower,
    dangle_parens: true,
    dangle_align: DangleAlign::Open,
    ..Config::default()
};

Defaults

Field	Default
line_width	80
tab_size	2
use_tabchars	false
max_empty_lines	1
command_case	CaseStyle::Lower
keyword_case	CaseStyle::Upper
dangle_parens	false
dangle_align	DangleAlign::Prefix
enable_markup	true
reflow_comments	false
first_comment_is_literal	true

Fields

line_width: usize

Maximum rendered line width before wrapping is attempted.

tab_size: usize

Number of spaces that make up one indentation level when Self::use_tabchars is false.

use_tabchars: bool

Emit tab characters for indentation instead of spaces.

max_empty_lines: usize

Maximum number of consecutive empty lines to preserve.

max_lines_hwrap: usize

Maximum number of wrapped lines tolerated before switching to a more vertical layout.

max_pargs_hwrap: usize

Maximum number of positional arguments to keep in a hanging-wrap layout before going vertical.

max_subgroups_hwrap: usize

Maximum number of keyword/flag subgroups to keep in a horizontal wrap.

dangle_parens: bool

Place the closing ) on its own line when a call wraps.

dangle_align: DangleAlign

Alignment strategy for a dangling closing ).

min_prefix_chars: usize

Lower bound used by layout heuristics when deciding whether a command name is short enough to prefer one style over another.

max_prefix_chars: usize

Upper bound used by layout heuristics when deciding whether a command name is long enough to prefer one style over another.

separate_ctrl_name_with_space: bool

Insert a space before ( for control-flow commands such as if.

separate_fn_name_with_space: bool

Insert a space before ( for function/macro definitions.

command_case: CaseStyle

Output casing policy for command names.

keyword_case: CaseStyle

Output casing policy for recognized keywords and flags.

enable_markup: bool

Enable markup-aware comment handling.

reflow_comments: bool

Reflow plain line comments to fit within the configured width.

first_comment_is_literal: bool

Preserve the first comment block in a file literally.

literal_comment_pattern: String

Regex for comments that should never be reflowed.

bullet_char: String

Preferred bullet character when normalizing list markup.

enum_char: String

Preferred enumeration punctuation when normalizing numbered list markup.

fence_pattern: String

Regex describing fenced literal comment blocks.

ruler_pattern: String

Regex describing ruler-style comments.

hashruler_min_length: usize

Minimum ruler length before a #----- style line is treated as a ruler.

canonicalize_hashrulers: bool

Normalize ruler comments when markup handling is enabled.

per_command_overrides: HashMap<String, PerCommandConfig>

Per-command configuration overrides keyed by lowercase command name.

Implementations

impl Config

pub fn for_file(file_path: &Path) -> Result<Self>

Load configuration for a file at the given path.

Searches for the nearest supported user config (.cmakefmt.yaml, .cmakefmt.yml, then .cmakefmt.toml) starting from the file’s directory and walking up to the repository/filesystem root. If none is found, falls back to the same filenames in the home directory.

pub fn from_file(path: &Path) -> Result<Self>

Load configuration from a specific supported config file.

pub fn from_files(paths: &[PathBuf]) -> Result<Self>

Load configuration by merging several supported config files in order.

Later files override earlier files.

pub fn config_sources_for(file_path: &Path) -> Vec<PathBuf>

Return the config files that would be applied for the given file.

When config discovery is used, this is either the nearest supported config file found by walking upward from the file, or a home directory config if no nearer config exists.

impl Config

pub fn for_command(&self, command_name: &str) -> CommandConfig<'_>

Returns a Config with any per-command overrides applied for the given command name, plus the appropriate space-before-paren setting.

pub fn apply_command_case(&self, name: &str) -> String

Apply the command_case rule to a command name.

pub fn apply_keyword_case(&self, keyword: &str) -> String

Apply the keyword_case rule to a keyword token.

pub fn indent_str(&self) -> String

The indentation string (spaces or tab).

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Config

fn eq(&self, other: &Config) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Config

impl StructuralPartialEq for Config