Skip to content

Latest commit

 

History

History
91 lines (62 loc) · 2.26 KB

phase_scalafmt.md

File metadata and controls

91 lines (62 loc) · 2.26 KB

Phase Scalafmt

Contents

Overview

A phase extension phase_scalafmt can format Scala source code via Scalafmt.

How to set up

Add this snippet to WORKSPACE

load(
    "@rules_scala//scala:toolchains.bzl",
    "scala_register_toolchains",
    "scala_toolchains",
)

scala_toolchains(
    # Other toolchains settings...
    scalafmt = True,
)

scala_register_toolchains()

To add this phase to a rule, you have to pass the extension to a rule macro. Take scala_binary for example,

load("//scala:advanced_usage/scala.bzl", "make_scala_binary")
load("//scala/scalafmt:phase_scalafmt_ext.bzl", "ext_scalafmt")

scalafmt_scala_binary = make_scala_binary(ext_scalafmt)

Then use scalafmt_scala_binary as normal.

The extension adds 2 additional attributes to the rule

  • format: enable formatting
  • config: the Scalafmt configuration file

When format is set to true, you can do

bazel run <TARGET>.format

to format the source code, and do

bazel run <TARGET>.format-test

to check the format (without modifying source code).

The extension provides default configuration, but there are 2 ways to use custom configuration

  • Put .scalafmt.conf at the root of your workspace

  • Pass .scalafmt.conf in via scala_toolchains:

    scala_toolchains(
    # Other toolchains settings...
    scalafmt = True,
    scalafmt_default_config_path = "//path/to/my/custom:scalafmt.conf",
)

When using Scala 3, you must append runner.dialect = scala3 to .scalafmt.conf.

IntelliJ plugin support

If you use IntelliJ Bazel plugin, then you should check the Customizable Phase page.

TL;DR: you should try naming your scalafmt rules the same way as the default rules_scala rules are named (in your own scope), otherwise external dependency loading won't work in IntelliJ for your Scala targets. E.g.:

# Using this rule won't let you see external dependencies:
scalafmt_scala_binary = make_scala_binary(ext_scalafmt)

# But this will work:
scala_binary = make_scala_binary(ext_scalafmt)