dprint 0.51.0

on Rust Cargo

dprint is a pluggable, configurable code formatting platform written in Rust. It aims to unify all your code formatters in one tool.

Features

Global Configuration File

dprint now supports a global configuration file that can be used when not in a project. (#1040)

Initialize a global config:

dprint init --global
# or
dprint config init --global

The global config location is customizable via the DPRINT_CONFIG_DIR environment variable, but by default is stored in (this reflects the update that was published in 0.51.1 after feedback):

• Linux/Mac: ~/.config/dprint/dprint.jsonc (or $XDG_CONFIG_HOME/dprint/dprint.jsonc)
  • Note: On Mac it will respect $HOME/Library/Application Support/dprint/dprint.jsonc if it exists
• Windows: %APPDATA%\dprint\dprint.jsonc

Note: You can edit the config by running dprint config edit --global

Use global config for formatting:

Once setup, the global configuration will be used by default when there's no dprint configuration file in the current directory tree; however, to prevent accidentally formatting such directories, a prompt is shown when calling dprint fmt:

> dprint fmt
Warning You're not in a dprint project. Format '/home/david' anyway? (Y/n) █

Hint: Specify the directory to bypass this prompt in the future (ex. `dprint fmt .`)

As the hint states, you can bypass the confirmation prompt by providing the current directory:

> dprint fmt .
Formatted 1 file.

To format files using only the global configuration and ignore local configuration files use:

dprint fmt --config-discovery=global

Manage global config:

# Add plugins to global config
dprint config add --global

# Update global config
dprint config update --global

# Edit global config
dprint config edit --global

Full docs: https://dprint.dev/global-config/

Improved dprint check Output

When files are not formatted, dprint check now suggests running dprint fmt to fix them, making it clearer for new users contributing to your projects what to do next. (#1056)

Found 3 not formatted files. Run dprint fmt to fix.

dprint check --fail-fast

Stops checking files and exit on the first file that isn't formatted. This is useful when you want even faster feedback. (#1054)

dprint check --fail-fast

Note: When using --log-level=silent, --fail-fast is now enabled by default.

Breaking Changes

• dprint config update is now non-recursive by default - The command now only updates the configuration file in the current directory by default, rather than updating all config files in descendant directories. Use --recursive (or -r) to update configuration files recursively. (#1053)

  # Update only the current config (new default)
  dprint config update
  
  # Update current config and all descendant configs
  dprint config update --recursive

Other Changes

• Added updateUrl to editor-info command output (#1027)

New Plugins

Another announcement is dprint now has an Oxc (JS/TS) and Mago (PHP) plugins:

• dprint config add oxc - https://github.com/dprint/dprint-plugin-oxc
• dprint config add mago - https://github.com/dprint/dprint-plugin-mago

Install

Run dprint upgrade or see https://dprint.dev/install/

Checksums