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

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

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

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

underscores برقرار رکھتے ہوئے snake_case ناموں کو بڑے حروف میں کرتا ہے: default_page_size → DEFAULT_PAGE_SIZE۔ Python (PEP 8)، Rust، C اور shell scripts میں module-level constants اسی طرح لکھے جاتے ہیں، جبکہ عام variables چھوٹے حروف والا snake_case استعمال کرتے ہیں۔

اسے تب استعمال کریں جب local variables یا function arguments کے طور پر شروع ہونے والی values مقررہ settings بن جائیں، یا جب آپ کو موجودہ snake_case config keys سے مطابقت رکھنے والے environment variable نام چاہئیں۔

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

  1. دونوں ڈراپ ڈاؤنز میں snake_case → SCREAMING_SNAKE_CASE چنیں۔
  2. assignments یا نام متنی سٹرنگ میں پیسٹ کریں۔
  3. نتیجہ کاپی کریں؛ ہر assignment کی دائیں طرف والی values میں کوئی تبدیلی نہیں ہوتی۔

مثال

ان پٹ (snake_case)
default_page_size = 20
max_upload_mb = 10
_cache_ttl_seconds = 300
آؤٹ پٹ (SCREAMING_SNAKE_CASE)
DEFAULT_PAGE_SIZE = 20
MAX_UPLOAD_MB = 10
_CACHE_TTL_SECONDS = 300

تینوں نام بڑے حروف میں ہو جاتے ہیں۔ _cache_ttl_seconds اپنا شروع والا underscore رکھتا ہے، جو Python میں module-private constant کی نشانی ہے۔

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

  • ہر underscore برقرار رکھ کر حروف بڑے کرتا ہے، اس لیے ہندسوں والے حصے صاف بچ جاتے ہیں: retry_after_2x → RETRY_AFTER_2X۔
  • شروع کا ایک underscore محفوظ رکھتا ہے: _cache_ttl_seconds → _CACHE_TTL_SECONDS۔
  • بغیر underscore کے ایک لفظ (timeout) اس ٹول کے لیے snake_case نہیں اور چھوٹے حروف میں رہتے ہیں۔

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

magic numbers کو constants میں نکالنا

کسی Python module میں functions کے اندر بکھری max_upload_mb = 10 جیسی values کو فائل کے اوپر MAX_UPLOAD_MB کے طور پر لایا جا سکتا ہے، جنہیں linters اور پڑھنے والے constants کے طور پر پہچانتے ہیں۔

config keys سے env var نام

اگر کوئی YAML یا TOML config database_url اور log_level استعمال کرتا ہے تو مطابقت رکھنے والے environment overrides عموماً DATABASE_URL اور LOG_LEVEL ہوتے ہیں (مثال کے طور پر pydantic-settings انہیں اسی طرح map کرتا ہے)۔

نوٹس اور حدود

  • ایک لفظی نام چھوٹے حروف میں رہتے ہیں۔ اگر timeout کو بھی constant ہونا چاہیے تو TIMEOUT خود لکھیں۔
  • ٹیکسٹ کا ہر snake_case لفظ بڑے حروف میں ہو جاتا ہے، get_user جیسے function ناموں سمیت اگر وہ پیسٹ کیے گئے کوڈ میں ہوں۔

عام سوالات

کیا snake_case سے SCREAMING_SNAKE_CASE میں جاتے ہوئے کچھ ضائع ہوتا ہے؟

نہیں۔ separators ایک جیسے ہیں، اس لیے آپ کے ایڈٹ کیے گئے الفاظ کے علاوہ یہ تبدیلی الٹی سمت والے صفحے سے پوری طرح واپس کی جا سکتی ہے۔

__all__ کیوں نہیں بدلتا؟

دو شروع والے underscores والے نام snake_case pattern سے match نہیں ہوتے، جو صرف ایک اختیاری شروع والے underscore کی اجازت دیتا ہے۔