التنسيق

يضمّ Elide الأدوات google-java-format 1.37.0 و Netflix jfmt 0.9.0 و ktfmt 0.65. يشغّل elide format أداتَي تنسيق Java و Kotlin، ويشغّل كل من elide javaformat و elide ktfmt أداة واحدة.

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

تأتي الملفات والمجلدات بعد -- وتُعاد كتابتها في مكانها. يُبلَّغ عن كل ملف بأنه لم يتغيّر أو أُعيدت كتابته أو ستُعاد كتابته أو تعذّر تحليله. يقبل javaformat أيضًا -i:

elide javaformat -- -i Hello.java

التحقق من التنسيق

لا يكتب -n أو --dry-run بعد -- أي شيء، ويخرج بالرمز 1 إن كان ملف ما سيتغيّر. يُقبَل --set-exit-if-changed، ولا يوجد --check.

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

في وضع التحقق، يعرض خياران من خيارات Elide (قبل --) ما سيتغيّر:

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

الخيار	المخرجات
`--list-files`	المسارات التي ستتغيّر، مسار في كل سطر على stdout.
`--list-diffs=N`	فروق موحّدة إن لم يفشل أكثر من `N` ملفات، وإلا فالمسارات. استخدم `=N` لا قيمة منفصلة.

يعمل الخياران مع javaformat و ktfmt أيضًا.

خيارات أداة التنسيق

يُمرَّر كل ما بعد -- إلى أداة التنسيق، بما في ذلك ملفات الوسائط ومبدّلات النمط (--google-style و --kotlinlang-style و --aosp):

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

يعرض elide javaformat --help و elide ktfmt --help خيارات Elide وطريقة عرض مساعدة أداة التنسيق.

لهجة jfmt

ينسّق --jfmt شيفرة Java باستخدام jfmt بدلًا من ⁦google-java-format:⁩ كتل بإزاحة 4 مسافات، وأسطر متابعة بإزاحة 8 مسافات، ولا حدّ لعدد الأعمدة، وأقواس معقوفة حول جسم كل عبارة، واستيرادات ثابتة بعد الاستيرادات العادية.

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

نمط jfmt ثابت، لذا لا يمكن الجمع بين --jfmt و --aosp أو --fix-imports-only أو خيارات --skip-* أو --lines و --offset و --length. لا يُشغَّل توسيع استيرادات البدل ولا تقصير الأسماء المؤهّلة الخاصّان بأداة jfmt.