envcheck

نظرة عامة

متغيّرات البيئة الناقصة أو غير الصحيحة تُعطّل التطبيقات وقت التشغيل بصمتٍ ومتأخّرًا. تقرأ envcheck مخطّط .env.example الذي يحتفظ به فريقك أصلًا، وتفحص ملف .env الفعلي مقابله قبل إقلاع التطبيق، مع تلميحات للنوع والصيغة (رقم، رابط، بريد، قيمة من مجموعة، حدّ أدنى للطول) مُعرّفة داخل تعليقات ملف المثال.

التحدّي

متغيّر بيئة واحد ناقص أو خاطئ قد يُسقط عملية نشرٍ كاملة، وغالبًا ما يظهر العطل في عمق النظام برسالةٍ غامضة يصعب تحديد مصدرها.

الحل

أداة بنحو 150 سطرًا وبلا اعتماديات تعامل .env.example كمصدرٍ للحقيقة: تُبلّغ عن المفاتيح الناقصة والقيم الفارغة المطلوبة وعدم تطابق الأنواع والمفاتيح الزائدة، ثم تُنهي بقيمةٍ غير صفرية ليكتشفها خطّ CI.

النتائج

تعمل في أي مكان عبر npx — دون إعداد ودون اعتماديات. أضِفها إلى أي مشروع Node أو خطّ CI بسطرٍ واحد.

التقنيات المستخدمة