Formatierung

Elide liefert google-java-format 1.37.0, Netflix jfmt 0.9.0 und ktfmt 0.65 mit. elide format führt die Formatierer für Java und Kotlin aus; elide javaformat und elide ktfmt führen jeweils einen aus.

elide format -- src
elide javaformat -- Hello.java src/main/java
elide ktfmt -- Hello.kt src/main/kotlin

~/demo  bat src/Greeter.kt

───────┬────────────────────────────────────────────────────────────────────────────────────────────

│ File: src/Greeter.kt

│ Size: 161 B

───────┼────────────────────────────────────────────────────────────────────────────────────────────

1 │ package demo

2 │ data class User( val id:Int,val name:String )

3 │

4 │ class Greeter(val users:List<User>){

5 │ fun greet(id:Int)=users.firstOrNull{it.id==id}?.name?:"world"

6 │ }

───────┴────────────────────────────────────────────────────────────────────────────────────────────

~/demo  elide format -- src

✅ Formatted 1 Java sources

✅ Formatted 1 Kotlin sources

~/demo  bat src/Greeter.kt

│ File: src/Greeter.kt

│ Size: 177 B

1 │ package demo

2 │

3 │ data class User(val id: Int, val name: String)

4 │

5 │ class Greeter(val users: List<User>) {

6 │ fun greet(id: Int) = users.firstOrNull { it.id == id }?.name ?: "world"

7 │ }

0:12 / 0:12

Dateien und Verzeichnisse folgen nach -- und werden direkt überschrieben. Für jede Datei wird gemeldet, ob sie unverändert ist, neu geschrieben wurde, neu geschrieben würde oder nicht geparst werden konnte. javaformat akzeptiert außerdem -i:

elide javaformat -- -i Hello.java

Formatierung prüfen

-n oder --dry-run nach -- schreibt nichts und endet mit Exit-Code 1, wenn sich eine Datei ändern würde. --set-exit-if-changed wird akzeptiert; --check gibt es nicht.

elide format -- -n src
elide javaformat -- -n src/main/java
elide ktfmt -- -n src/main/kotlin

Im Prüfmodus melden zwei Elide-Optionen (vor --), was sich ändern würde:

elide format --list-files -- -n src
elide format --list-diffs -- -n src
elide format --list-diffs=5 -- -n src

Option	Ausgabe
`--list-files`	Pfade, die sich ändern würden, einer pro Zeile auf stdout.
`--list-diffs=N`	Unified Diffs, wenn höchstens `N` Dateien abweichen, sonst Pfade. Verwenden Sie `=N`, keinen separaten Wert.

Beide funktionieren auch mit javaformat und ktfmt.

Formatierer-Flags

Alles nach -- wird an den Formatierer übergeben, auch Argumentdateien und Stilschalter (--google-style, --kotlinlang-style, --aosp):

elide ktfmt -- --google-style @kotlin-sources.txt

elide javaformat --help und elide ktfmt --help zeigen die Optionen von Elide und wie Sie die Hilfe des Formatierers anzeigen.

jfmt-Dialekt

--jfmt formatiert Java mit jfmt statt mit google-java-format: Blöcke mit 4 Leerzeichen, Fortsetzungszeilen mit 8 Leerzeichen, keine Spaltenbegrenzung, geschweifte Klammern um jeden Anweisungsrumpf und statische Imports nach den gewöhnlichen.

elide javaformat -- --jfmt src/main/java
elide format -- --jfmt -n src

jfmt hat einen festen Stil, daher lässt sich --jfmt nicht mit --aosp, --fix-imports-only, den --skip-*-Flags oder --lines, --offset und --length kombinieren. Die eigene Auflösung von Wildcard-Imports und die Kürzung qualifizierter Namen von jfmt werden nicht ausgeführt.