يحوّل أسماء 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.
--help في نص السلسلة.MYAPP_) إن كانت أداتك تتطلب ذلك.listen-port: 8080
log-format: json
max-body-size: 1mbLISTEN_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 مكتوبة بـ Go أو Rust تربط الخيارات بمتغيرات البيئة (كما تتيح viper أو ميزة env في clap)، فإن تحويل قائمة الخيارات يعطيك أسماء المتغيرات التي يجب توثيقها.
عندما تقرأ خدمةٌ 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، لأن الرقم جزء من المقطع الأول.