تحويل snake_case إلى SCREAMING_SNAKE_CASE!

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

تحويل snake_case إلى SCREAMING_SNAKE_CASE!

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

يكبّر أسماء snake_case مع إبقاء الشرطات السفلية: default_page_size → DEFAULT_PAGE_SIZE. في Python (PEP 8) وRust وC وسكربتات الـ shell تُكتب الثوابت على مستوى الوحدة بهذه الطريقة، بينما تستخدم المتغيرات العادية snake_case بأحرف صغيرة.

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

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

  1. اختر snake_case → SCREAMING_SNAKE_CASE في القائمتين المنسدلتين.
  2. الصق جمل الإسناد أو الأسماء في نص السلسلة.
  3. انسخ النتيجة؛ القيم على الجانب الأيمن من كل إسناد لا تُعدَّل.

مثال

المدخلات (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 بالشرطة السفلية في بدايته، وهي في Python علامة على ثابت خاص بالوحدة.

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

  • يُبقي كل شرطة سفلية ويكبّر الأحرف، فتبقى المقاطع الرقمية سليمة: retry_after_2x → RETRY_AFTER_2X.
  • يحفظ شرطة سفلية واحدة في البداية: _cache_ttl_seconds → _CACHE_TTL_SECONDS.
  • الكلمات المفردة بلا شرطة سفلية (timeout) لا تعدّها هذه الأداة snake_case وتبقى بأحرف صغيرة.

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

استخراج الأرقام السحرية إلى ثوابت

في وحدة Python، يمكن رفع قيم مثل max_upload_mb = 10 المتناثرة داخل الدوال إلى أعلى الملف بالاسم MAX_UPLOAD_MB، الذي تتعرّف عليه أدوات lint والقرّاء كثابت.

أسماء متغيرات البيئة من مفاتيح الإعدادات

إذا كانت إعدادات YAML أو TOML تستخدم database_url وlog_level، فإن تجاوزات البيئة المقابلة تكون عادةً DATABASE_URL وLOG_LEVEL (وهكذا تربطها pydantic-settings مثلًا).

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

  • الأسماء المكوّنة من كلمة واحدة تبقى صغيرة. إن كان يجب أن يكون timeout ثابتًا أيضًا فاكتب TIMEOUT بنفسك.
  • كل كلمة snake_case في النص تُكبَّر، بما فيها أسماء الدوال مثل get_user إن ظهرت في الكود الملصوق.

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

هل يُفقد شيء عند الانتقال من snake_case إلى SCREAMING_SNAKE_CASE؟

لا. الفواصل متطابقة، لذا يمكن عكس التحويل بالكامل عبر الصفحة المقابلة، باستثناء الكلمات التي عدّلتها.

لماذا لا يتغير __all__؟

الأسماء التي تبدأ بشرطتين سفليتين لا يطابقها نمط snake_case، فهو لا يسمح إلا بشرطة سفلية اختيارية واحدة في البداية.