xyz.block.kotlin-formatter:kotlin-formatter

Kotlin Formatter

A command-line tool for formatting Kotlin source code files, implemented as a wrapper around ktfmt.

It can be used to automate code formatting, ensuring a clean and consistent codebase, while integrating seamlessly into development workflows.

The tool can:

• Format files and directories: Apply consistent formatting to files, directories, or standard input.
• Integrate with Git workflows:
  • Pre-commit: Format staged files before committing.
  • Pre-push: Check committed files before pushing.

Usage

kotlin-format [OPTIONS] [FILES...]

Options

Option	Description
--set-exit-if-changed	Exit with a non-zero code if any files needed changes.
--dry-run	Display the changes that would be made without writing them to disk.
--pre-commit	Format staged files as part of the pre-commit process. Mutually exclusive with --pre-push.
--pre-push	Check committed files as part of the pre-push process. Mutually exclusive with --pre-commit.
--push-commit=<text>	The SHA of the commit to use for pre-push. Defaults to HEAD.
--print-stats	Emit performance-related statistics to help diagnose performance issues.
-h, --help	Show help message and exit.

Arguments

Argument	Description
<files>	Files or directories to format. Use - for standard input.

CLI

A fat jar of the CLI is available on Maven Central. To download the CLI, replace $version with the latest version number in the following URL:

https://repo1.maven.org/maven2/xyz/block/kotlin-formatter/kotlin-formatter/$version/kotlin-formatter-$version-all.jar

After downloading, you can run the CLI using the following command:

java -jar path/to/kotlin-formatter-$version-all.jar [OPTIONS] [FILES...]