أدوات CLI بلغة JavaScript: إنشاؤها من الصفر في 30 دقيقة

لماذا تحتاج أدوات CLI بلغة JavaScript؟

تخيل: كل يوم تقوم يدويًا بإعادة تسمية المجلدات التي تحتوي على تقارير، أو تحويل JSON إلى CSV، أو البحث عن الملفات المكررة. ماذا لو كتبت برنامجًا صغيرًا يقوم بذلك في ثانية بأمر في الطرفية؟ لهذا بالضبط نحتاج أدوات CLI بلغة JavaScript.

على عكس تطبيقات الويب الكاملة، فإن CLI (واجهة سطر الأوامر) هي أدوات خفيفة وسريعة ومريحة للغاية. لا تتطلب متصفحًا، وتعمل على أي منصة، ويمكن دمجها بسهولة في نصوص CI/CD. في PythonLib، نناقش غالبًا الأتمتة، واليوم سأوضح لك كيفية إنشاء أول أداة CLI خاصة بك على Node.js من الصفر. ستندهش من مدى سهولة الأمر!

في هذه المقالة، سنمر بالمسار الكامل: من إعداد المشروع إلى نشر الحزمة الجاهزة في npm. ستحصل ليس فقط على نظرية، بل على كود عملي يمكنك تكييفه فورًا لمهامك.

ما هي أداة CLI ولماذا JavaScript؟

أداة CLI هي برنامج يتم تشغيله من سطر الأوامر. تكتب my-tool --input file.txt - ويقوم بالإجراء المطلوب. JavaScript مثالي لهذا، لأن:

• Node.js مثبت على كل خادم وتقريبًا على كل جهاز كمبيوتر للمطورين.
• عدد هائل من الوحدات الجاهزة (npm) للعمل مع الملفات والشبكة وتنسيقات البيانات.
• سهولة الكتابة: لا حاجة للترجمة، ملف واحد يكفي.
• التوافق عبر المنصات: أداتك ستعمل على Windows وmacOS وLinux.

حتى لو كنت مبتدئًا في Node.js، ستتمكن من ذلك. سنبدأ بأبسط شيء - نص برمجي يطبع تحية.

الخطوة 1: إعداد المشروع لأداة CLI

أنشئ مجلدًا لمشروعك وقم بتهيئة npm:

mkdir my-first-clicd my-first-clinpm init -y

الآن افتح package.json. هذا هو ملف التكوين الرئيسي لأداة CLI المستقبلية بلغة JavaScript. أضف إليه الحقل "bin":

{  "name": "my-first-cli",  "version": "1.0.0",  "description": "أول أداة CLI لي",  "bin": {    "greet": "./index.js"  },  "license": "MIT"}

الحقل "bin" هو السحر. يخبر Node.js: "عندما يدخل المستخدم الأمر greet، قم بتشغيل الملف index.js". لاحظ: اسم الأمر (greet) يمكن أن يكون أي شيء.

الآن أنشئ index.js مع السطر الأول - shebang. هذا إلزامي لـ CLI:

#!/usr/bin/env node

console.log('مرحبًا بالعالم! أنا أول أداة CLI لك!');

يشير Shebang #!/usr/bin/env node للنظام إلى أن النص البرمجي يجب تنفيذه باستخدام Node.js. بدونه، لن يعمل الأمر.

الخطوة 2: جعل الأداة قابلة للتنفيذ واختبارها

لتشغيل أداة CLI بلغة JavaScript محليًا، نفذ الأمر:

npm link

هذا الأمر ينشئ رابطًا عامًا لحزمتك. الآن في أي طرفية يمكنك كتابة:

greet

وسترى: مرحبًا بالعالم! أنا أول أداة CLI لك! تهانينا، لقد أنشأت للتو أول أداة لك!

الخطوة 3: تحليل وسائط سطر الأوامر

مجرد طباعة نص - ممل. أدوات CLI الحقيقية تقبل الوسائط. دعنا نتعلم كيفية معالجتها. في Node.js، هناك مصفوفة مدمجة process.argv، ولكن للمشاريع الجادة من الأفضل استخدام وحدة commander أو yargs.

لنقم بتثبيت commander:

npm install commander

الآن أعد كتابة index.js:

#!/usr/bin/env node

const { Command } = require('commander');const program = new Command();

program  .name