Formatage

Elide intègre google-java-format 1.37.0, Netflix jfmt 0.9.0 et ktfmt 0.65. elide format exécute les formateurs Java et Kotlin ; elide javaformat et elide ktfmt en exécutent un seul.

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

Les fichiers et répertoires se placent après -- et sont réécrits sur place. Chaque fichier est signalé comme inchangé, réécrit, à réécrire ou impossible à analyser. javaformat accepte aussi -i :

elide javaformat -- -i Hello.java

Vérifier le formatage

-n ou --dry-run après -- n’écrit rien et quitte avec 1 si un fichier changerait. --set-exit-if-changed est accepté ; --check n’existe pas.

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

En mode vérification, deux options d’Elide (avant --) indiquent ce qui changerait :

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

Option	Sortie
`--list-files`	Chemins qui changeraient, un par ligne sur stdout.
`--list-diffs=N`	Diffs unifiés si au plus `N` fichiers échouent, sinon les chemins. Utilisez `=N`, pas une valeur séparée.

Les deux fonctionnent aussi avec javaformat et ktfmt.

Options du formateur

Tout ce qui suit -- est transmis au formateur, y compris les fichiers d’arguments et les sélecteurs de style (--google-style, --kotlinlang-style, --aosp) :

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

elide javaformat --help et elide ktfmt --help affichent les options d’Elide et indiquent comment afficher l’aide du formateur.

Dialecte jfmt

--jfmt formate Java avec jfmt au lieu de google-java-format : blocs de 4 espaces, continuations de 8 espaces, aucune limite de colonnes, accolades autour de chaque corps d’instruction et imports statiques après les imports ordinaires.

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

jfmt applique un style fixe : --jfmt ne peut donc pas être combiné avec --aosp, --fix-imports-only, les options --skip-*, ni --lines, --offset et --length. L’expansion des imports génériques et le raccourcissement des noms qualifiés propres à jfmt ne sont pas exécutés.