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 flag یا YAML key سے اس environment variable تک کا قدم ہے جو اسے override کرتا ہے، یعنی وہ pattern جس کے تحت ٹولز --log-format اور LOG_FORMAT دونوں قبول کرتے ہیں۔

config فائل کی keys یا --help آؤٹ پٹ کے flags پیسٹ کریں اور .env فائلوں، Dockerfiles اور CI settings کے لیے مطابقت رکھنے والے variable نام حاصل کریں۔

استعمال کا طریقہ

  1. بائیں جانب kebab-case اور دائیں جانب SCREAMING_SNAKE_CASE چنیں۔
  2. YAML keys، flag نام یا --help کا اقتباس متنی سٹرنگ میں پیسٹ کریں۔
  3. نتیجہ کاپی کریں؛ اگر آپ کا ٹول تقاضا کرے تو اپنی ایپ کا prefix (مثلاً 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 key بڑے حروف والا environment variable نام بن جاتی ہے؛ json اور 1mb جیسی values kebab-case نہیں، اس لیے برقرار رہتی ہیں۔

معاون خصوصیات

  • ہر hyphen کو underscore بنا کر نام کو بڑے حروف میں کر دیتا ہے: log-format → LOG_FORMAT، retry-2-times → RETRY_2_TIMES۔
  • نام کے آس پاس کے حروف، شروع کے -- سمیت، اپنی جگہ رہتے ہیں۔
  • بغیر hyphen والے الفاظ match نہیں ہوتے، اس لیے سادہ values چھوٹے حروف میں رہتی ہیں۔

استعمال کے کیس

CLI کے env overrides کی دستاویز بنانا

اگر کوئی Go یا Rust CLI flags کو environment variables سے باندھتا ہے (جیسا کہ viper یا clap کا env فیچر کر سکتا ہے)، تو flags کی فہرست تبدیل کرنے سے دستاویز میں لکھنے کے لیے variable نام مل جاتے ہیں۔

YAML config سے Docker اور CI

جب کوئی سروس config.yaml سے listen-port پڑھتی ہو لیکن environment override کی اجازت بھی دیتی ہو، تو تبدیل شدہ نام ہی docker-compose.yml یا CI secret settings میں جاتے ہیں۔

نوٹس اور حدود

  • اگر آپ -- کے ساتھ flags پیسٹ کریں تو dashes باقی رہتے ہیں: --log-level → --LOG_LEVEL۔ نام prefix کے بغیر پیسٹ کریں۔
  • x-1 جیسے چھوٹے expressions بھی kebab-case جیسے لگتے ہیں اور X_1 بن جاتے ہیں، اس لیے ان پٹ میں حساب نہ ڈالیں۔

عام سوالات

کیا یہ APP_ جیسا prefix لگاتا ہے؟

نہیں۔ بعد میں اپنے ایڈیٹر میں لگائیں، یا ان پٹ ہی میں app-listen-port کی صورت میں شامل کر دیں۔

http2-enabled جیسی keys کا کیا؟

یہ صاف طور پر HTTP2_ENABLED میں بدل جاتی ہیں، کیونکہ ہندسہ پہلے حصے کا ہی حصہ ہے۔