SCREAMING_SNAKE_CASE کو snake_case میں تبدیل کریں!

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

SCREAMING_SNAKE_CASE کو snake_case میں تبدیل کریں!

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

SCREAMING_SNAKE_CASE ناموں کو چھوٹا کرتا ہے اور underscores برقرار رکھتا ہے: SESSION_COOKIE_AGE → session_cookie_age۔ وہی الفاظ، وہی separators، صرف case بدلتا ہے۔

یہ سمت تب سامنے آتی ہے جب constants یا environment variables کو عام variables، dictionary keys، ڈیٹا بیس کالمز یا YAML/TOML settings بننا ہو، مثلاً Django انداز کی settings کو pydantic ماڈل میں منتقل کرنا یا env vars کی فہرست کو config فائل کی keys میں بدلنا۔

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

  1. بائیں جانب SCREAMING_SNAKE_CASE اور دائیں جانب snake_case استعمال کریں۔
  2. constants، settings یا env var نام متنی سٹرنگ میں پیسٹ کریں۔
  3. نتیجہ سے کاپی کریں۔

مثال

ان پٹ (SCREAMING_SNAKE_CASE)
SESSION_COOKIE_AGE = 1209600
EMAIL_HOST_USER = "noreply@example.com"
_INTERNAL_TOKEN_TTL = 60
آؤٹ پٹ (snake_case)
session_cookie_age = 1209600
email_host_user = "noreply@example.com"
_internal_token_ttl = 60

تینوں setting نام چھوٹے حروف میں ہو جاتے ہیں؛ ای میل والی value اور نمبر نہیں بدلتے، اور _INTERNAL_TOKEN_TTL اپنا شروع والا underscore رکھ کر _internal_token_ttl بنتا ہے۔

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

  • حروف کو چھوٹا کرتا ہے اور ہر underscore برقرار رکھتا ہے، ہندسوں سے پہلے والے بھی: HTTP_2_ENABLED → http_2_enabled۔
  • شروع کا ایک underscore محفوظ رہتا ہے۔
  • بغیر underscores کے بڑے حروف والے الفاظ (DEBUG، True) match نہیں ہوتے۔

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

Django settings سے pydantic ماڈل تک

EMAIL_HOST_USER جیسی settings BaseSettings کلاس پر email_host_user نامی فیلڈز بن جاتی ہیں، اور pydantic پھر بھی بڑے حروف والا environment variable پڑھ لیتا ہے کیونکہ matching بطور ڈیفالٹ case-insensitive ہے۔

env vars کو YAML config میں

جب کوئی سروس بہت سے environment variables سے ایک config.yaml پر منتقل ہوتی ہے تو چھوٹے حروف والے نام ہی اس فائل کی عام keys ہوتے ہیں۔

نوٹس اور حدود

  • چونکہ دونوں انداز ایک جیسے separators استعمال کرتے ہیں، یہ تبدیلی بغیر کسی نقصان کے ہے اور بالکل ٹھیک الٹی کی جا سکتی ہے۔
  • پیسٹ میں ہر بڑے حروف والا underscore لفظ متاثر ہوتا ہے، CURRENT_TIMESTAMP جیسے SQL constants سمیت اگر وہ ٹیکسٹ میں ہوں۔

عام سوالات

میں اپنے ایڈیٹر کی lowercase کمانڈ ہی کیوں نہ استعمال کروں؟

وہ سب کچھ چھوٹا کر دیتی ہے، values، string کے مواد اور True جیسے keywords سمیت۔ یہ صفحہ صرف SCREAMING_SNAKE_CASE identifiers بدلتا ہے۔

کیا DEBUG تبدیل ہوتا ہے؟

نہیں، match ہونے کے لیے نام میں کم از کم ایک underscore ہونا ضروری ہے۔ اسے خود چھوٹا کریں۔