تحويل SCREAMING_SNAKE_CASE إلى kebab-case!

نص السلسلة
النتيجة

تحويل SCREAMING_SNAKE_CASE إلى kebab-case!

هل تسميات متغيرات الكود المنسوخة من مصادر أخرى غير متوافقة مع كودك؟ لا داعي للقلق! قم بتحويل المتغيرات إلى التنسيق المطلوب!

يحوّل الأسماء المكتوبة بأسلوب متغيرات البيئة إلى kebab-case: LOG_LEVEL → log-level، WORKER_COUNT → worker-count. كثيرًا ما يصف النمطان الإعداد نفسه في أماكن مختلفة: متغير بيئة من جهة، ومن الجهة الأخرى خيار سطر أوامر --log-level أو قيمة Helm أو مفتاح ConfigMap في Kubernetes.

الصق ملف .env أو قائمة متغيرات لتحصل على الأسماء الصغيرة الموصولة بشرطات التي تستخدمها أدوات CLI وكثير من الأدوات المعتمدة على YAML.

طريقة الاستخدام

  1. اختر SCREAMING_SNAKE_CASE → kebab-case.
  2. الصق المتغيرات في نص السلسلة، مع قيمها أو دونها.
  3. انسخ النتيجة؛ وأضف -- في البداية إن احتجت إلى صيغة الخيارات.

مثال

المدخلات (SCREAMING_SNAKE_CASE)
LOG_LEVEL=debug
CACHE_DIR=/tmp/app-cache
WORKER_COUNT=4
المخرجات (kebab-case)
log-level=debug
cache-dir=/tmp/app-cache
worker-count=4

تُحوَّل الأسماء التي قبل =؛ أما المسار /tmp/app-cache فيستخدم أصلًا الشرطات والأحرف الصغيرة، فلا يُتعرّف عليه كـ SCREAMING_SNAKE_CASE ويبقى دون تغيير.

الميزات المدعومة

  • يصغّر الاسم ويستبدل كل شرطة سفلية بين المقاطع بشرطة: CACHE_DIR → cache-dir.
  • تُترك القيم والمسارات في السطر نفسه كما هي.
  • تُحذف الشرطة السفلية في بداية الأسماء ذات الأسلوب الخاص: _INTERNAL_FLAG → internal-flag.

حالات الاستخدام

عرض إعدادات البيئة كخيارات CLI

تقبل أدوات كثيرة الخيار نفسه بالصيغة MYAPP_LOG_LEVEL أو --log-level. تحويل قائمة متغيرات البيئة يساعد في كتابة تعريفات الخيارات ونص المساعدة.

مفاتيح إعدادات Helm وKubernetes

تستخدم Helm charts وConfigMaps غالبًا مفاتيح موصولة بشرطات أو بصيغة camelCase، بينما تقرأ الحاويات متغيرات بصيغة SCREAMING_SNAKE_CASE. التحويل يعطيك أسماء المفاتيح لجانب الـ chart في هذا الربط.

ملاحظات وقيود

  • المقاطع الرقمية تحصل على شرطات كبقية المقاطع: HTTP_2_ENABLED → http-2-enabled.
  • المتغيرات المكوّنة من كلمة واحدة مثل PORT لا تُحوَّل.

الأسئلة الشائعة

هل يمكنني استخدام النتيجة أسماءً لمتغيرات البيئة؟

ليس بشكل محمول. معظم الـ shells لا تسمح بالشرطات في أسماء المتغيرات، لذا أبقِ SCREAMING_SNAKE_CASE للمتغيرات نفسها واستخدم kebab-case للخيارات ومفاتيح الإعدادات.

هل يضيف البادئة --؟

لا. الاسم وحده يتغير. وإن كان الإدخال يحوي -- أصلًا فإنه يُحفظ.