envfix
أداة تشخيص لإعدادات البيئة لمشاريع Node.js بلا تبعيات، تقارن ملفات البيئة وتكمل المدخلات الناقصة تلقائيًا.
نبذة عن envfix
envfix أداة تشخيص لإعدادات البيئة موجهة لمشاريع Node.js، خالية من التبعيات وسهلة الدمج في CI. تقارن .env مع .env.example عنصرًا بعنصر لاكتشاف المتغيرات الناقصة أو الفارغة بسرعة، وتكشف التعريفات المكررة أو ذات التنسيق الخاطئ، كما تتحقق مما إذا كان .env مُستثنيًا بشكل آمن عبر gitignore. عند الإصلاح، تُضاف المفاتيح الناقصة إلى نهاية .env دون تعديل الأسطر والقيم الموجودة؛ كما يمكنها توليد .env.example أو مزامنته دون كشف الأسرار. ويقيّم أمر doctor ما إذا كانت إعدادات البيئة سليمة ومتسقة وآمنة؛ وفي CI ينتهي البرنامج برمز الخروج 1 عند نقص المتغيرات أو فراغها، مما يساعد الفرق على اكتشاف انحراف الإعدادات قبل وصوله إلى بيئة الإنتاج.
الأنسب لـ
أفضل حالات الاستخدام
مراجعة ملف .env المحلي بعد استنساخ المشروع وإكمال المتغيرات الناقصة تلقائيًا
اعتراض المتغيرات الناقصة أو الفارغة في خطوط CI لمنع انحراف الإعدادات من الوصول إلى بيئة الإنتاج
توليد .env.example ومزامنته للفرق أو المشاريع مفتوحة المصدر دون كشف الأسرار الحقيقية
استخدام أمر doctor لإجراء فحص شامل لصحة إعدادات بيئة المشروع واتساقها وأمانها
الميزات
فحص مقارنة الإعدادات
تقارن .env مع .env.example عنصرًا بعنصر لتكتشف المتغيرات الناقصة أو الفارغة، وتكشف التعريفات المكررة أو ذات التنسيق الخاطئ.
فحص doctor الشامل
تجيب عن أسئلة أوسع من الفحص الأساسي: هل إعدادات بيئة المشروع سليمة ومتسقة وآمنة؟
إصلاح آمن بالإضافة
تُضاف المفاتيح الناقصة إلى .env دون تعديل الأسطر والقيم الموجودة أبدًا.
أمان الأسرار والمستودع
تولّد .env.example أو تزامنه دون كشف الأسرار، وتتحقق مما إذا كان .env مُستثنيًا بشكل آمن عبر gitignore.
المزايا
- بلا تبعيات، تثبيت خفيف وسهولة في الاستخدام داخل CI
- إصلاح بالإضافة فقط دون تعديل الأسطر والقيم الموجودة
- لا تطبع قيم متغيرات البيئة افتراضيًا إلى الطرفية أو JSON أو تعليقات CI التوضيحية، ما يقلل خطر التسريب
- تنتهي برمز الخروج 1 عند نقص المتغيرات أو فراغها ليسهل على خطوط المعالجة اعتراضها مباشرة