SCREAMING_SNAKE_CASE کو kebab-case میں تبدیل کریں!

متنی سٹرنگ
نتیجہ

SCREAMING_SNAKE_CASE کو kebab-case میں تبدیل کریں!

کیا آپ کے کوڈ کے متغیر نام دوسرے جگہ سے کاپی کیے گئے ہیں اور آپ کے کوڈ سے ہم آہنگ نہیں ہیں؟ فکر نہ کریں! متغیر کو مطلوبہ فارمیٹ میں تبدیل کریں!

environment variable انداز کے ناموں کو kebab-case میں بدلتا ہے: LOG_LEVEL → log-level، WORKER_COUNT → worker-count۔ یہ دونوں انداز اکثر ایک ہی setting کو مختلف جگہوں پر بیان کرتے ہیں: ایک طرف env var، دوسری طرف --log-level command-line flag، Helm value یا Kubernetes ConfigMap key۔

.env فائل یا variables کی فہرست پیسٹ کریں اور وہ hyphen والے چھوٹے حروف کے نام حاصل کریں جو CLIs اور بہت سے YAML پر مبنی ٹولز استعمال کرتے ہیں۔

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

  1. SCREAMING_SNAKE_CASE → kebab-case چنیں۔
  2. variables کو ان کی values کے ساتھ یا بغیر متنی سٹرنگ میں پیسٹ کریں۔
  3. نتیجہ کاپی کریں؛ flag syntax چاہیے تو آگے -- لگا دیں۔

مثال

ان پٹ (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

= سے پہلے والے نام تبدیل ہوتے ہیں؛ path /tmp/app-cache پہلے ہی hyphens اور چھوٹے حروف استعمال کرتا ہے، اس لیے اسے SCREAMING_SNAKE_CASE نہیں پہچانا جاتا اور وہ نہیں بدلتا۔

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

  • نام کو چھوٹا کر کے حصوں کے درمیان ہر underscore کو hyphen سے بدل دیتا ہے: CACHE_DIR → cache-dir۔
  • اسی لائن کی values اور paths کو نہیں چھیڑا جاتا۔
  • private انداز کے نام کا شروع والا underscore ہٹا دیا جاتا ہے: _INTERNAL_FLAG → internal-flag۔

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

env settings کو CLI flags کے طور پر دینا

بہت سے ٹولز ایک ہی option کو MYAPP_LOG_LEVEL یا --log-level دونوں صورتوں میں قبول کرتے ہیں۔ env vars کی فہرست تبدیل کرنا flag definitions اور help ٹیکسٹ لکھنے میں مدد دیتا ہے۔

Helm اور Kubernetes config keys

Helm charts اور ConfigMaps اکثر hyphen والی یا camelCase keys استعمال کرتے ہیں جبکہ containers SCREAMING_SNAKE_CASE variables پڑھتے ہیں۔ تبدیلی سے اس mapping کی chart والی طرف کے key نام مل جاتے ہیں۔

نوٹس اور حدود

  • نمبر والے حصوں کو بھی باقیوں کی طرح hyphens ملتے ہیں: HTTP_2_ENABLED → http-2-enabled۔
  • PORT جیسے ایک لفظی variables تبدیل نہیں ہوتے۔

عام سوالات

کیا میں نتیجے کو environment variable ناموں کے طور پر استعمال کر سکتا ہوں؟

ہر جگہ نہیں۔ زیادہ تر shells variable ناموں میں hyphens کی اجازت نہیں دیتے، اس لیے خود variables کے لیے SCREAMING_SNAKE_CASE رکھیں اور flags اور config keys کے لیے kebab-case استعمال کریں۔

کیا یہ -- prefix لگاتا ہے؟

نہیں۔ صرف نام بدلتا ہے۔ اگر ان پٹ میں پہلے سے -- ہو تو وہ برقرار رہتا ہے۔