الصفحة الرئيسية>المتعلقة بالبرمجة>جافا كود المصدر
تنزيل

Picocli - واجهة سطر أوامر صغيرة جدًا

يهدف Picocli إلى أن يكون الطريقة الأسهل للاستخدام لإنشاء تطبيقات سطر أوامر غنية يمكن تشغيلها داخل وخارج JVM. النظر في بيكوكلي؟ تحقق مما يقوله المستخدمون السعداء عن بيكوكلي.

Picocli عبارة عن مكتبة وإطار عمل حديثين، مكتوبين بلغة Java، ويحتويان على كل من واجهة برمجة تطبيقات التعليقات التوضيحية وواجهة برمجة تطبيقات برمجية. ويتميز بمساعدة الاستخدام مع ألوان وأنماط ANSI والإكمال التلقائي لـ TAB والأوامر الفرعية المتداخلة. في ملف واحد، حتى تتمكن من تضمينه في النموذج المصدر . يتيح ذلك للمستخدمين تشغيل التطبيقات المستندة إلى picocli دون الحاجة إلى picocli كتبعية خارجية.

يمكن تجميع التطبيقات المستندة إلى Picocli مسبقًا إلى صورة أصلية، مع وقت بدء تشغيل سريع للغاية ومتطلبات ذاكرة أقل، والتي يمكن توزيعها كملف واحد قابل للتنفيذ. يأتي Picocli مزودًا بمعالج التعليقات التوضيحية الذي يقوم تلقائيًا بتمكين Graal من الجرة الخاصة بك أثناء التجميع.

يمكن أن تكون تطبيقات Picocli مضغوطة جدًا بدون تعليمات برمجية معيارية: يمكن تنفيذ الأمر (أو الأمر الفرعي) باستخدام سطر واحد من التعليمات البرمجية. ما عليك سوى تنفيذ Runnable أو Callable ، أو وضع منطق العمل الخاص بأمرك في طريقة @Command - المشروحة.

رسالة مساعدة Picocli Demo بألوان ANSI

يُسهل Picocli اتباع إرشادات واجهة سطر الأوامر.

كيف يعمل: قم بإضافة تعليق توضيحي لفصلك وسيقوم picocli بتهيئته من وسيطات سطر الأوامر، وتحويل الإدخال إلى بيانات مكتوبة بقوة. يدعم الأوامر الفرعية المشابهة لـ git (والأوامر الفرعية المتداخلة)، وأي نمط بادئة خيار، والخيارات القصيرة المجمعة بنمط POSIX، ومحولات النوع المخصص، وخيارات كلمة المرور والمزيد.

يميز Picocli بين الخيارات المسماة والمعلمات الموضعية ويسمح بكتابة كليهما بقوة. يمكن للحقول متعددة القيم تحديد عدد محدد من المعلمات أو النطاق (على سبيل المثال، 0..* ، 1..2 ). يدعم خيارات الخريطة مثل -Dkey1=val1 -Dkey2=val2 ، حيث يمكن كتابة كل من المفتاح والقيمة بقوة. يسهل تتبع المحلل اللغوي استكشاف الأخطاء وإصلاحها. تسمح ملفات وسيطة سطر الأوامر (@-files) للتطبيقات بمعالجة أسطر أوامر طويلة جدًا.

يُنشئ مساعدة مصقولة وسهلة الاستخدام ومساعدة في الإصدار، باستخدام ألوان ANSI حيثما أمكن ذلك. يتطلب Java 5 على الأقل، ولكنه مصمم لتسهيل استخدام Java 8 lambdas. تم اختباره على جميع إصدارات Java بين 5 و18 إصدارًا (شاملاً).

يمكن أن تشتمل تطبيقات سطر الأوامر المستندة إلى Picocli على ميزة الإكمال التلقائي لـ TAB، مما يعرض للمستخدمين بشكل تفاعلي الخيارات والأوامر الفرعية المتاحة. عندما يحتوي أحد الخيارات على completionCandidates أو يحتوي على نوع enum ، يمكن أن يقترح الإكمال التلقائي أيضًا قيم الخيارات. يمكن لـ Picocli إنشاء نصوص برمجية إكمال لـ bash وzsh، ويقدم وحدات picocli-shell-jline2 و picocli-shell-jline3 مع تطبيقات JLine Completer لبناء تطبيقات shell التفاعلية.

تتضمن الميزات الفريدة في picocli دعمًا للخيارات السالبة، والقيم المقتبسة المتقدمة، ومجموعات الوسائط. يمكن استخدام مجموعات الوسيطات لإنشاء خيارات حصرية متبادلة وخيارات تعتمد بشكل متبادل وأقسام خيارات في رسالة تعليمات الاستخدام ووسائط مركبة متكررة مثل ([-a=<a> -b=<b> -c=<c>] (-x | -y | -z))... . بالنسبة لحالات الاستخدام المتقدمة، يمكن للتطبيقات الوصول إلى نموذج كائن أمر picocli باستخدام التعليق التوضيحي @Spec ، وتنفيذ معالجة المعلمات المخصصة لمعلمات الخيار إذا كان المنطق المدمج غير كافٍ.

يمكن للتطبيقات المستندة إلى Picocli أن تتكامل بسهولة مع حاويات Dependency حقن. يحتوي إطار عمل الخدمات الصغيرة Micronaut على دعم مدمج لـ picocli. يحتوي Quarkus على وضع الأوامر مع امتداد Picocli لتسهيل إنشاء تطبيقات CLI المستندة إلى picocli مع Quarkus. يأتي Picocli مزودًا بوحدة picocli-spring-boot-starter التي تتضمن التكوين التلقائي لـ PicocliSpringFactory وSpring Boot لاستخدام حقن تبعية Spring في تطبيق سطر أوامر picocli الخاص بك. يحتوي دليل المستخدم على أمثلة للتكامل مع Guice وSpring Boot وMicronaut وQuarkus ومع الحاويات التي تتوافق مع مواصفات CDI 2.0 (JSR 365).

الإصدارات

  • جميع الإصدارات
  • الأحدث: 4.7.6 ملاحظات الإصدار
  • الأقدم: ملاحظات الإصدار Picocli 4.0
  • الأقدم: ملاحظات الإصدار Picocli 3.0
  • الأقدم: ملاحظات الإصدار Picocli 2.0

التوثيق

  • 4.x دليل المستخدم: https://picocli.info
  • 4.x الدليل السريع
  • 4.x API جافادوك
  • معاينة: Javadoc المعياري لجميع القطع الأثرية (4.7.6-SNAPSHOT)
  • الإكمال التلقائي لسطر الأوامر
  • واجهة برمجة التطبيقات البرمجية
  • التعليمات
  • تجميع GraalVM AOT للصورة الأصلية

أقدم

  • 3.x دليل المستخدم
  • 3.x الدليل السريع
  • 3.x API جافادوك
  • 2.x دليل المستخدم
  • 2.x API جافادوك
  • 1.x دليل المستخدم

المقالات والعروض التقديمية

إنجليزي

  • 6 أشياء يمكنك القيام بها مع JBang ولكن لا يمكنك فعلها مع Shell (2022-02-28) بقلم F.Marchioni.
  • [فيديو] Kotlin وCLIs وStarWars! - مقدمة لإنشاء تطبيقات CLI باستخدام Kotlin باستخدام Picocli (2022-02-05) بقلم جوليان لينجراند لامبرت.
  • [فيديو] الإكمال التلقائي لـ Java CLI باستخدام Picocli (2022-01-24) بواسطة raksrahul.
  • Picocli - سهولة وسيطات CLI في Java (2021-10-27) بواسطة agamboa.
  • بناء واجهات سطر الأوامر باستخدام Kotlin باستخدام picoCLI (2021-09-23) بقلم جوليان لينجراند لامبرت.
  • [فيديو] إنشاء تطبيقات Java CLI باستخدام picocli (2021-09-14) بواسطة coder4life.
  • بيكوكلي (2021-06-30) بقلم سيبرين بولاند.
  • بيكوكلي | قم بإنشاء تطبيق Kotlin /JVM CLI الأول الخاص بك باستخدام GraalVM (2021-02-13) بواسطة manserpatrice.
  • [فيديو] إنشاء مكونات kubectl الإضافية باستخدام Quarkus وpicocli وfabric8io وjbang (2021-01-22) بواسطة Sébastien Blanc.
  • [فيديو] J-Fall Virtual 2020: جوليان لينجراند - مقدمة لإنشاء تطبيقات CLI باستخدام picoCLI (2020-12-07) بقلم جوليان لينجراند لامبرت. كانت هذه هي المحادثة الأعلى تقييمًا لـ @nljug #jfall Virtual 2020! تهانينا، جوليان!
  • يؤدي ترقيم الصفحات إلى تطبيق سطر أوامر باستخدام picoCLI (2020-11-17) بواسطة جوليان لينجراند لامبرت.
  • تطبيقات CLI مع GraalVM Native Image (2020-11-13) بواسطة Oleg Šelajev.
  • أوامر بيكوكلي الفرعية - برنامج واحد، لأغراض متعددة (2020-09-22) بقلم جوناس أندرسن.
  • CLI الأصلي مع Picocli وGraalVM (2020-08-20) بواسطة jbebar.
  • كيفية إنشاء تطبيق CLI في Java باستخدام jbang وpicocli (2020-08-13) بقلم ماثيو جيليارد.
  • بناء مكشطة تابعة لـ GitHub باستخدام Quarkus وPicocli (2020-07-31) بقلم مارك نوري.
  • بناء Java CLI لائق (2020-07-27) بواسطة Andreas Textor.
  • [فيديو] (فيديو آخر تم إنتاجه جيدًا بواسطة Szymon Stepniak) تنفيذ OAuth 2.0 في تطبيق سطر أوامر Java باستخدام Micronaut وPicocli وGraalVM (23/07/2020) بواسطة Szymon Stepniak (قناة YouTube).
  • Micronaut وPicocli وGraalVM (2020-07-08) بقلم سيمون ستيبنياك.
  • [فيديو] (منتج جيد للغاية وغني بالمعلومات، موصى به!) إنشاء تطبيق سطر أوامر باستخدام Java 11 وMicronaut وPicocli وGraalVM (2020-07-01) بواسطة Szymon Stepniak (قناة YouTube).
  • [صوت] Scala Valentines #2 (2020-06-21) بودكاست يتحدث عن بيكوكلي (من 18:11).
  • كيفية إنشاء أداة سطر الأوامر باستخدام جافا؟ (2020-06-18) بواسطة فيجاي SRJ.
  • أدوات سطر الأوامر مع Quarkus وPicocli (2020-06-08) بقلم دميترو شابان.
  • دليل Quarkus لوضع أمر Quarkus مع picocli، وذلك بفضل امتداد picocli بواسطة Michał Górniewski المضمن في Quarkus 1.5 (2020-06-03).
  • الصور الأصلية باستخدام Micronaut وGraalVM (2020-06-01) بواسطة Λ: Olivier Revial.
  • تطبيقات CLI مع Micronaut وPicocli (2020-06-01) بواسطة Λ: Olivier Revial.
  • مقدمة Picocli - تحليل سطر أوامر Java الحديث (2020-05-19) بقلم جوناس أندرسن.
  • بناء واجهة سطر الأوامر لتتبع Covid19 الأصلية باستخدام Java وPicoCLI وGraalVM (2020-05-11) بقلم محمد أبو اللعيط.
  • وضع أمر Quarkus مع Picocli (27-04-2020) بواسطة دميترو شابان.
  • إنشاء أدوات CLI باستخدام Scala وPicocli وGraalVM (2020-03-09) بواسطة Naoki Takezoe
  • بناء واجهات سطر أوامر Java الأصلية باستخدام GraalVM وPicocli وGradle (2020-03-08) بقلم ميتش سيمور
  • إنشاء تطبيقات CLI أصلية رائعة في Java باستخدام Graalvm وPicocli (2020-03-07)
  • كائنات Picocli المنظمة (2019-09-10) بقلم فيليب هانسلوفسكي يشرح كيفية استخدام دعم picocli لمجموعات الوسائط المتكررة لإضافة أو تكوين كائنات منظمة من سطر الأوامر.
  • قم بإنشاء برنامج سطر أوامر Java باستخدام Picocli|Baeldung (2019-05-07) بقلم فرانسوا دوبير.
  • جولة سريعة في مجلة picocli JAX "تسليط الضوء على أدوات Java" (2019-04-08).
  • مقدمة إلى PicoCLI (2019-02-10) بواسطة devop.
  • يقدم دليل Corda CLI UX (تجربة المستخدم) (2018 بواسطة R3 Limited) نصائح مفيدة.
  • قم بتطوير أداة واجهة سطر الأوامر (CLI) باستخدام نصوص برمجية رائعة (26/10/2018) بواسطة Chinthaka Dinadasa.
  • الهجرة من كومنز CLI إلى بيكوكلي. لن تندم على ذلك! :-) (أيضًا على: DZone وJava Code Geeks).
  • تجديد Groovy 2.5 CliBuilder (أيضًا على blogs.apache.org). في جزأين: الجزء الأول (أيضًا على: DZone، Java Code Geeks)، الجزء 2 (أيضًا على: DZone، Java Code Geeks).
  • دليل مستخدم Micronaut لتشغيل الخدمات الصغيرة المستقلة مع picocli.
  • واجهات سطر أوامر Java (الجزء 30): ملاحظات داستن ماركس حول picocli 2.0.1 (أيضًا على: DZone، Java Code Geeks)
  • واجهات سطر أوامر Java (الجزء 10): Picocli بواسطة Dustin Marx حول picocli 0.9.7 (أيضًا على: DZone، Java Code Geeks)
  • Picocli 2.0: نصوص رائعة على المنشطات (أيضًا على: DZone، Java Code Geeks)
  • Picocli 2.0: افعل المزيد بموارد أقل (أيضًا على: DZone، Java Code Geeks)
  • الإعلان عن picocli 1.0 (أيضًا على: DZone)

Русский

  • اختيار الخيارات الأساسية Picocli للخيار الرئيسي (2020-05-07)
  • Интейсы командной строки Java: picocli (2018-08-06): الترجمة الروسية بواسطة MaxRokatansky لمنشور مدونة Dustin Marx.

الاسبانية

  • Picocli، إطار عمل قوي لإنشاء تطبيقات خط الأوامر (2023-09-09) بواسطة Darkcrizt
  • Picocli، إطار عمل قوي لإنشاء تطبيقات خط الأوامر (2023-09-09) بواسطة Darkcrizt
  • Quarkus + Picocli: برنامج Web Scaper لمزيد من المشاريع التابعة على GitHub (2020-08-15) بواسطة مارك نوري.
  • Quarkus - المقدمة: بيكوكلي (2020-06-15) بقلم جيراردو أرويو.
  • [فيديو] بيكوكلي - مثال على حذاء الربيع (24-05-2020) مقدمة سريعة مدتها 7 دقائق بقلم غونزالو إتش ميندوزا.

الفرنسية

  • تطبيق الهاتف المحمول: Créez de superbes apps CLI nationals en Java avec Graalvm et Picocli (2020-05-07) ترجمة إنشاء تطبيقات CLI أصلية رائعة في Java باستخدام Graalvm وPicocli بواسطة bouf1450.
  • [فيديو] Des apps en ligne de Commande avec Picocli et GraalVM (N. Peters) (2019-05-07): عرض تقديمي مدته 15 دقيقة يقدمه نيكولاس بيترز خلال Devoxx FR. شرائح العرض التقديمي متاحة على GitHub.

البرتغالية

  • تصميم تطبيقات CLI الأصلية في Java com Graalvm e Picocli (28/08/2020): ترجمة برتغالية لإنشاء تطبيقات CLI رائعة أصلية في Java باستخدام Graalvm وPicocli، وذلك بفضل Rodrigo Ap G Batista.
  • [فيديو] Quarkus #40: Command Mode com Picocli (23/06/2020): عرض تقديمي مدته 13 دقيقة بواسطة Vinícius Ferraz (@viniciusfcf).

日本語

  • تطبيقات CLI مع ترجمة GraalVM Native Image (2020-11-21) بواسطة Logico_jp لمنشور Oleg Šelajev.
  • Picocli + Kotlin + graalvm-native-image plugin でネイティブツールを作る (24-04-2020) منشور مدونة بواسطة مايك-نيك (引きこもり持田 على تويتر).
  • pythonのArgumentParserような使い心地!picocliのご紹介 (2020-04-15) بواسطة @astamuseLab
  • Java の コ マ ン ド ラ イ ン ア プ リ ケ ー シ ョ ン 向 け の フ レ ム ワ ク، Picocli で 遊 ぶ (2020-03-07) منشور مدونة بواسطة か ず ひ ら.
  • Kuromoji のCLI コ マ ン ド とpicocli と GraalVM (2020-02-28) منشور مدونة بواسطة @johtani.
  • GraalVM, PicocliとJavaでときめくネイティブコマンドラインアプリを作ろう (2019-11-23) شرائح العرض التقديمي في JJUG CCC التابعة لمجموعة مستخدمي Java اليابانية مؤتمر خريف 2019.
  • بيكوكلي を使用してJava コマンドラインプログラムを作成する - 開発者ドキュメント (2019-10-18)
  • GraalVM と Picocli で Java の ネ イ テ ィ ブ コ マ ン ド ラ イ ン ア プ リ を 作 ろ う (2019-09-06) شرائح لعرض نقاشي البرق في JJUG تاريخ النشر: 2019/09/6 (金)
  • Picoccli＋Spring Boot でコマンドラインアプリケションを作成してみる (2019-07-20) بواسطة شكرا جزيلا.
  • GraalVM の الصورة الأصلية を使って Java で爆速 Lambda の夢を見る (2019-05-02) بواسطة @kencharos

中文

  • Java命令行界面(第10部分):picocli (2020-06-07) ترجمة بواسطة dnc8371.
  • 如何借助 Graalvm 和 Picocli 构建 Java 编写的原生 CLI 应用 (26-03-2020): الترجمة الصينية لإنشاء تطبيقات CLI أصلية رائعة في Java باستخدام Graalvm وPicocli، بفضل 张卫滨.
  • 从Commons CLI迁移到Picocli (2019-03-13): الترجمة الصينية للهجرة من Commons CLI إلى picocli، بفضل genghaihua.
  • Picocli 2.0: لعبة المنشطات الرائعة
  • بيكوكلي 2.0: 以少求多

القائمة البريدية

انضم إلى مجموعة picocli Google إذا كنت مهتمًا بمناقشة أي شيء متعلق بـ picocli وتلقي إعلانات حول الإصدارات الجديدة.

ائتمان

Reallinfo صممت شعار بيكوكلي! شكرا جزيلا!

الالتزامات

يتبع هذا المشروع الإصدارات الدلالية ويلتزم بالتزام Zero Bugs .

التبني

  • أصبح Picocli الآن جزءًا من Groovy. بدءًا من Groovy 2.5، أصبحت جميع أدوات سطر أوامر Groovy تعتمد على picocli، وpicocli هو المحلل اللغوي الأساسي لـ Groovy's CliBuilder DSL.
  • أصبح Picocli الآن جزءًا من Micronaut. تمت إعادة كتابة Micronaut CLI باستخدام picocli، وقد خصص Micronaut دعمًا لتشغيل الخدمات الصغيرة المستقلة مع picocli. انظر أيضًا دليل ميكرونوت بيكوكلي.
  • يقدم Quarkus الآن وضع الأوامر مع picocli.
  • أصبح Picocli الآن جزءًا من JUnit 5. قام JUnit 5.3 بترحيل ConsoleLauncher الخاص به من jopt-simple إلى picocli لدعم @-files (ملفات الوسائط)؛ يساعد هذا المستخدمين الذين يحتاجون إلى تحديد العديد من الاختبارات في سطر الأوامر والتعرض لقيود النظام.
  • تقدم دبيان الآن حزمة libpicocli-java. شكرا لميروسلاف كرافيك.
  • يتم استخدام Picocli في Intuit Karate JAR المستقل / القابل للتنفيذ.
  • بيكوكلي جزء من راقصة الباليه. تستخدم Ballerina picocli لجميع أدوات سطر الأوامر المساعدة.
  • يتم استخدام Picocli في JAR المستقل CheckStyle / القابل للتنفيذ من Checkstyle 8.15.
  • تم تضمين Picocli في قائمة OpenJDK Quality Outreach لمشاريع البرمجيات المجانية مفتوحة المصدر (FOSS) التي تختبر بشكل فعال بنيات OpenJDK.
  • يتم استخدام Picocli في أدوات سطر أوامر Apache Hadoop Ozone/HDDS، وCLI المعياري لـ Apache Hive، وApache Ignite TensorFlow، وApache Sling Features Model Converter.
  • تم إدراج Picocli في StackShare. يرجى إضافته إلى مجموعتك وإضافة/التصويت الإيجابي على الأسباب التي تجعلك تحب بيكوكلي!
  • يتم استخدام Picocli في Pinterest ktlint.
  • يتم استخدام Picocli في Spring IO nohttp-cli.
  • تسهل مكتبة MinecraftPicocli استخدام picocli في Minecraft Forge.
  • يقدم Simple Java Mail الآن واجهة سطر الأوامر المستندة إلى picocli.
  • لا يستخدم jbang picocli داخليًا فحسب، بل يحتوي أيضًا على قالب CLI لإنشاء برنامج نصي أولي: استخدم jbang --init=cli helloworld.java لإنشاء نموذج برنامج jbang مُمكّن لـ picocli. انظر asciinema.
  • Picocli هي المكتبة الرئيسية المستخدمة في قالب CookieTemple cli-java لبناء ملفات GraalVM الأصلية القابلة للتنفيذ في Java. انظر هذه المعاينة.
  • تم ذكر Picocli في إرشادات واجهة سطر الأوامر.

يسعدني رؤية المزيد من الأشخاص يستخدمون بيكوكلي. يجب أن نفعل شيئًا صحيحًا. :-)

المساهمة من خلال المساعدة في تعزيز بيكوكلي

إذا كنت تحب بيكوكلي، ساعد الآخرين على اكتشاف بيكوكلي:

سهلة ومؤثرة؟

  • امنح بيكوكلي نجمة على جيثب!
  • قم بالتصويت لصالح إجابتي StackOverflow على "كيف يمكنني تحليل وسيطات سطر الأوامر في Java؟"
  • قم بالتصويت لصالح إجابتي في Quora على "ما هي أفضل طريقة لتحليل وسيطات سطر الأوامر باستخدام Java؟"

انشر الفرح! ؟

  • تويت عن بيكوكلي! ما الذي يعجبك في ذلك؟ كيف ساعدتك؟ كيف تختلف عن البدائل؟
  • اذكر أن مشروعك يستخدم picocli في توثيق مشروعك.
  • أظهر أن مشروع GitHub الخاص بك يستخدم picocli، مع هذه الشارة في ملف README.md الخاص بك: 
 [![picocli](https://img.shields.io/badge/picocli-4.7.6-green.svg)](https://github.com/remkop/picocli)

الوعظ به! ؟

  • ربما تكون الطريقة الأكثر تأثيرًا لتوضيح للناس كيف يمكن لبيكوكلي أن يجعل حياتهم أسهل هي كتابة منشور أو مقال على مدونة، أو حتى عمل مقطع فيديو!

مثال

قم بتعليق الحقول بأسماء معلمات سطر الأوامر ووصفها. اختياريًا، قم بتنفيذ Runnable أو Callable لتفويض معالجة الأخطاء وطلبات المساعدة في الاستخدام أو مساعدة الإصدار إلى picocli. على سبيل المثال: 

 import picocli . CommandLine ;
import picocli . CommandLine . Option ;
import picocli . CommandLine . Parameters ;
import java . io . File ;

@ Command ( name = "example" , mixinStandardHelpOptions = true , version = "Picocli example 4.0" )
public class Example implements Runnable {

    @ Option ( names = { "-v" , "--verbose" },
      description = "Verbose mode. Helpful for troubleshooting. Multiple -v options increase the verbosity." )
    private boolean [] verbose = new boolean [ 0 ];

    @ Parameters ( arity = "1..*" , paramLabel = "FILE" , description = "File(s) to process." )
    private File [] inputFiles ;

    public void run () {
        if ( verbose . length > 0 ) {
            System . out . println ( inputFiles . length + " files to process..." );
        }
        if ( verbose . length > 1 ) {
            for ( File f : inputFiles ) {
                System . out . println ( f . getAbsolutePath ());
            }
        }
    }

    public static void main ( String [] args ) {
        // By implementing Runnable or Callable, parsing, error handling and handling user
        // requests for usage help or version help can be done with one line of code.

        int exitCode = new CommandLine ( new Example ()). execute ( args );
        System . exit ( exitCode );
    }
}

قم بتنفيذ Runnable أو Callable ، ويمكن تنفيذ الأمر الخاص بك في سطر واحد من التعليمات البرمجية. يستخدم المثال أعلاه أسلوب CommandLine.execute لتحليل سطر الأوامر ومعالجة الأخطاء ومعالجة طلبات الاستخدام وتعليمات الإصدار واستدعاء منطق الأعمال. يمكن للتطبيقات الاتصال بـ System.exit باستخدام رمز الخروج الذي تم إرجاعه للإشارة إلى النجاح أو الفشل للمتصل. 

$ java Example -v inputFile1 inputFile2

2 files to process...

يقوم الأسلوب CommandLine.execute تلقائيًا بطباعة رسالة تعليمات الاستخدام إذا طلب المستخدم المساعدة أو عندما كان الإدخال غير صالح.

رسالة تعليمات الاستخدام بألوان ANSI

يمكن تخصيص هذا بعدة طرق. راجع قسم دليل المستخدم الخاص بتنفيذ الأوامر للحصول على التفاصيل.

تعليمات الاستخدام مع ألوان وأنماط ANSI

يتم تخصيص الألوان والأنماط والرؤوس والتذييلات وعناوين الأقسام بسهولة باستخدام التعليقات التوضيحية. على سبيل المثال:

رسالة مساعدة أطول بألوان ANSI

انظر الكود المصدري.

واجهة برمجة تطبيقات تعليمات الاستخدام

توفر تعليقات Picocli العديد من الطرق لتخصيص رسالة تعليمات الاستخدام.

إذا لم تكن التعليقات التوضيحية كافية، فيمكنك استخدام واجهة برمجة تطبيقات المساعدة الخاصة بـ picocli لإجراء مزيد من التخصيص. على سبيل المثال، يمكن لتطبيقك إنشاء تعليمات مثل هذه باستخدام تخطيط مخصص:

رسالة تعليمات الاستخدام مع خيارين لكل صف

انظر الكود المصدري.

تحميل

يمكنك إضافة بيكوكلي باعتباره تبعية خارجية لمشروعك، أو يمكنك تضمينه كمصدر. انظر الكود المصدري. انسخه والصقه في ملف يسمى CommandLine.java ، وأضفه إلى مشروعك واستمتع!

جرادل 

 implementation 'info.picocli:picocli:4.7.6'

مخضرم 

 <dependency>
  <groupId>info.picocli</groupId>
  <artifactId>picocli</artifactId>
  <version>4.7.6</version>
</dependency>

سكالا SBT 

 libraryDependencies += "info.picocli" % "picocli" % "4.7.6"

اللبلاب 

 <dependency org="info.picocli" name="picocli" rev="4.7.6" />

العنب 

 @Grapes (
    @ Grab ( group = ' info.picocli ' , module = ' picocli ' , version = ' 4.7.6 ' )
)

لينينجن 

 [info.picocli/picocli "4.7.6"]

منشئ 

 'info.picocli:picocli:jar:4.7.6'

JBang 

 //DEPS info.picocli:picocli:4.7.6
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل