تحويل SCREAMING_SNAKE_CASE إلى snake_case!

نص السلسلة
النتيجة

تحويل SCREAMING_SNAKE_CASE إلى snake_case!

هل تسميات متغيرات الكود المنسوخة من مصادر أخرى غير متوافقة مع كودك؟ لا داعي للقلق! قم بتحويل المتغيرات إلى التنسيق المطلوب!

يصغّر أسماء SCREAMING_SNAKE_CASE ويُبقي الشرطات السفلية: SESSION_COOKIE_AGE → session_cookie_age. الكلمات نفسها والفواصل نفسها، ولا يتغير إلا حالة الأحرف.

يظهر هذا الاتجاه عندما يجب أن تصبح الثوابت أو متغيرات البيئة متغيرات عادية أو مفاتيح قواميس أو أعمدة قاعدة بيانات أو إعدادات YAML/TOML، مثل نقل إعدادات على طريقة Django إلى نموذج pydantic أو تحويل قائمة متغيرات بيئة إلى مفاتيح ملف إعدادات.

طريقة الاستخدام

  1. استخدم SCREAMING_SNAKE_CASE على اليسار وsnake_case على اليمين.
  2. الصق الثوابت أو الإعدادات أو أسماء متغيرات البيئة في نص السلسلة.
  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

صُغّرت أسماء الإعدادات الثلاثة؛ ولم تتغير قيمة البريد الإلكتروني والأرقام، واحتفظ _INTERNAL_TOKEN_TTL بالشرطة السفلية في بدايته فأصبح _internal_token_ttl.

الميزات المدعومة

  • يصغّر الأحرف ويُبقي كل شرطة سفلية، بما فيها التي قبل الأرقام: HTTP_2_ENABLED → http_2_enabled.
  • تُحفظ شرطة سفلية واحدة في البداية.
  • الكلمات المكتوبة بأحرف كبيرة دون شرطات سفلية (DEBUG، True) لا تُطابَق.

حالات الاستخدام

من إعدادات Django إلى نموذج pydantic

الإعدادات مثل EMAIL_HOST_USER تصبح حقولًا باسم email_host_user في صنف BaseSettings، ويظل pydantic يقرأ متغير البيئة المكتوب بأحرف كبيرة لأن المطابقة لا تميّز حالة الأحرف افتراضيًا.

من متغيرات البيئة إلى إعدادات YAML

عندما تنتقل خدمة من متغيرات بيئة كثيرة إلى ملف config.yaml واحد، تكون الأسماء المصغّرة هي المفاتيح المعتادة في ذلك الملف.

ملاحظات وقيود

  • بما أن النمطين يستخدمان الفواصل نفسها، فهذا التحويل لا يفقد أي معلومة ويمكن عكسه بدقة.
  • تتأثر كل كلمة بأحرف كبيرة وشرطات سفلية في النص الملصوق، بما فيها ثوابت SQL مثل CURRENT_TIMESTAMP إن ظهرت في النص.

الأسئلة الشائعة

لماذا لا أستخدم أمر التصغير في محرري ببساطة؟

ذلك الأمر يصغّر كل شيء، بما فيه القيم ومحتوى السلاسل النصية والكلمات المفتاحية مثل True. أما هذه الصفحة فلا تغيّر إلا معرّفات SCREAMING_SNAKE_CASE.

هل يُحوَّل DEBUG؟

لا، يحتاج الاسم إلى شرطة سفلية واحدة على الأقل ليُطابَق. صغّره بنفسك.