Package dfmt on DUB

To use this package, run the following command in your project's root directory:

dfmt

dfmt is a formatter for D source code

Status

dfmt is beta quality. Make backups of your files or use source control when using the --inplace option.

Building

Using Make

Clone the repository
Run `git submodule update --init --recursive` in the dfmt directory
To compile with DMD, run `makein the dfmt directory. To compile with LDC, runmake ldc instead. The generated binary will be placed in dfmt/bin/`.

Installing with DUB

> dub fetch --version='~master' dfmt && dub run dfmt -- -h

Using

By default, dfmt reads its input from stdin and writes to stdout. If a file name is specified on the command line, input will be read from the file instead, and output will be written to stdout.

dfmt uses EditorConfig files for configuration. If you run dfmt on a source file it will look for .editorconfig files that apply to that source file. If no file is specified on the command line, dfmt will look for .editorconfig files that would apply to a D file in the current working directory. Command line options can be used instead of .editorconfig files, or to override options found in .editorconfig files.

Options

--help | -h: Display command line options
--inplace | -i: A file name is required and the file will be edited in-place.
--align_switch_statements: See dfmt_align_switch_statements below
--brace_style: See brace_style below
--end_of_line: See end_of_line below
--indent_size: See indent_size below
--indent_style | -t: See indent_style below
--max_line_length: See max_line_length below
--soft_max_line_length: See dfmt_soft_max_line_length below
--outdent_attributes: See dfmt_outdent_attributes below
--single_template_constraint_indent: See dfmt_template_constraint_style below
--space_after_cast: See dfmt_space_after_cast below
--space_before_function_parameters: See dfmt_space_before_function_parameters below
--split_operator_at_line_end: See dfmt_split_operator_at_line_end below
--tab_width: See tab_width below
--selective_import_space: See dfmt_selective_import_space below
--compact_labeled_statements: See dfmt_compact_labeled_statements below
--template_constraint_style: See dfmt_template_constraint_style below

Example

dfmt --inplace --space_after_cast=false --max_line_length=80 \
    --soft_max_line_length=70 --brace_style=otbs file.d

Disabling formatting

Formatting can be temporarily disabled by placing the comments `// dfmt offand// dfmt on` around code that you do not want formatted.

void main(string[] args)
{
    bool optionOne, optionTwo, optionThree;

    // dfmt has no way of knowing that "getopt" is special, so it wraps the
    // argument list normally
	getopt(args, "optionOne", &optionOne, "optionTwo", &optionTwo, "optionThree", &optionThree);

    // dfmt off
    getopt(args,
        "optionOne", &optionOne,
        "optionTwo", &optionTwo,
        "optionThree", &optionThree);
    // dfmt on
}

Configuration

dfmt uses EditorConfig configuration files. dfmt-specific properties are prefixed with dfmt_.

Standard EditorConfig properties

Property Name	Allowed Values	Default Value	Description
endofline	`cr`, `crlf` and `lf`	`lf`	See EditorConfig documentation.
insertfinalnewline		`true`	Not supported. `dfmt` always inserts a final newline.
charset		`UTF-8`	Not supported. `dfmt` only works correctly on UTF-8.
indent_style	`tab`, `space`	`space`	See EditorConfig documentation.
indent_size	positive integers	`4`	See EditorConfig documentation.
tab_width	positive integers	`4`	See EditorConfig documentation.
trimtrailingwhitespace		`true`	Not supported. `dfmt` does not emit trailing whitespace.
maxlinelength	positive integers	`120`	See EditorConfig documentation.

dfmt-specific properties

Property Name	Allowed Values	Default Value	Description
dfmtbracestyle	`allman`, `otbs`, or `stroustrup`	`allman`	See Wikipedia
dfmtsoftmaxlinelength	positive integers	`80`	The formatting process will usually keep lines below this length, but they may be up to maxlinelength columns long.
dfmtalignswitch_statements (Not yet implemented)	`true`, `false`	`true`	Align labels, cases, and defaults with their enclosing switch.
dfmtoutdentattributes (Not yet implemented)	`true`, `false`	`true`	Decrease the indentation level of attributes.
dfmtsplitoperatoratline_end	`true`, `false`	`false`	Place operators on the end of the previous line when splitting lines.
dfmtspaceafter_cast	`true`, `false`	`true`	Insert space after the closing paren of a `cast` expression.
dfmtspaceafter_keywords (Not yet implemented)	`true`, `false`	`true`	Insert space after `if`, `while`, `foreach`, etc, and before the `(`.
dfmtspacebeforefunctionparameters	`true`, `false`	`false`	Insert space before the opening paren of a function parameter list.
dfmtselectiveimport_space	`true`, `false`	`true`	Insert space after the module name and before the `:` for selective imports.
dfmtcompactlabeled_statements	`true`, `false`	`true`	Place labels on the same line as the labeled `switch`, `for`, `foreach`, or `while` statement.
dfmttemplateconstraint_style	`conditional_newline_indent` `conditional_newline` `always_newline` `always_newline_indent`	`conditional_newline_indent`	Control the formatting of template constraints.
dfmtsingletemplateconstraintindent	`true`, `false`	`false`	Set if the constraints are indented by a single tab instead of two. Has only an effect for if indentation style if set to `always_newline_indent` or `conditional_newline_indent`.

Terminology

Braces - { and }
Brackets - [ and ]
Parenthesis / Parens - ( and )

0.15.2	2024-Aug-21
0.15.1	2023-Jul-19
0.15.0	2023-Apr-07
0.15.0-beta.2	2023-Feb-06
0.15.0-beta.1	2022-Oct-15

dfmt 0.7.0