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

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

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

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

يحوّل أسماء kebab-case إلى SCREAMING_SNAKE_CASE: listen-port → LISTEN_PORT، max-body-size → MAX_BODY_SIZE. هذه هي الخطوة من خيار CLI أو مفتاح YAML إلى متغير البيئة الذي يتجاوزه، وهو النمط الذي تقوم عليه الأدوات التي تقبل --log-format وLOG_FORMAT كليهما.

الصق مفاتيح ملف إعدادات أو الخيارات من مخرجات --help لتحصل على أسماء المتغيرات المقابلة لملفات .env وملفات Dockerfile وإعدادات CI.

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

  1. اختر kebab-case على اليسار وSCREAMING_SNAKE_CASE على اليمين.
  2. الصق مفاتيح YAML أو أسماء الخيارات أو مقتطفًا من --help في نص السلسلة.
  3. انسخ النتيجة؛ وأضف بادئة تطبيقك (مثل MYAPP_) إن كانت أداتك تتطلب ذلك.

مثال

المدخلات (kebab-case)
listen-port: 8080
log-format: json
max-body-size: 1mb
المخرجات (SCREAMING_SNAKE_CASE)
LISTEN_PORT: 8080
LOG_FORMAT: json
MAX_BODY_SIZE: 1mb

يصبح كل مفتاح YAML اسم متغير بيئة بأحرف كبيرة؛ أما القيم مثل json و1mb فليست kebab-case، فتبقى كما هي.

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

  • يحوّل كل شرطة إلى شرطة سفلية ويكبّر الاسم: log-format → LOG_FORMAT، retry-2-times → RETRY_2_TIMES.
  • تبقى الأحرف المحيطة بالاسم في مكانها، بما فيها -- في البداية.
  • الكلمات التي لا تحوي شرطة لا تُطابَق، فتبقى القيم العادية بأحرف صغيرة.

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

توثيق تجاوزات البيئة لأداة CLI

إذا كانت أداة CLI مكتوبة بـ Go أو Rust تربط الخيارات بمتغيرات البيئة (كما تتيح viper أو ميزة env في clap)، فإن تحويل قائمة الخيارات يعطيك أسماء المتغيرات التي يجب توثيقها.

Docker وCI انطلاقًا من إعدادات YAML

عندما تقرأ خدمةٌ listen-port من config.yaml وتسمح أيضًا بتجاوزه عبر البيئة، فإن الأسماء المحوَّلة هي ما يُكتب في docker-compose.yml أو في إعدادات أسرار CI.

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

  • إذا ألصقت الخيارات مع -- تبقى الشرطتان: --log-level → --LOG_LEVEL. الصق الأسماء دون البادئة.
  • التعبيرات القصيرة مثل x-1 تبدو أيضًا كـ kebab-case وتصبح X_1، لذا أبعد العمليات الحسابية عن الإدخال.

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

هل يضيف بادئة مثل APP_؟

لا. أضفها لاحقًا في محررك، أو ضمّنها في الإدخال بالشكل app-listen-port.

وماذا عن مفاتيح مثل http2-enabled؟

تتحول بشكل سليم إلى HTTP2_ENABLED، لأن الرقم جزء من المقطع الأول.