تحويل PascalCase إلى snake_case!

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

تحويل PascalCase إلى snake_case!

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

يقسّم أسماء PascalCase إلى كلمات صغيرة موصولة بشرطات سفلية: ShippingAddress → shipping_address. أسماء وحدات Python (PEP 8) وأسماء الجداول في Rails وDjango وأعمدة قواعد البيانات تستخدم snake_case، بينما الأصناف التي تُشتق منها هذه الأسماء بصيغة PascalCase.

المدخلات المعتادة هي قائمة أصناف نماذج تحتاج لها إلى أسماء جداول أو ملفات، أو أسماء أنواع من C#/Java يجب أن تصبح معرّفات في Python.

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

  1. اختر PascalCase → snake_case.
  2. الصق أسماء الأصناف أو مسارات الملفات أو تعريفات الأنواع في نص السلسلة.
  3. انسخ أسماء snake_case من النتيجة.

مثال

المدخلات (PascalCase)
models/OrderItem.py
models/ShippingAddress.py
models/PaymentMethod.py
المخرجات (snake_case)
models/order_item.py
models/shipping_address.py
models/payment_method.py

لا تتغير إلا أسماء الملفات؛ ويُحتفظ بالمجلد models/ والامتداد .py، فتحصل على أسماء وحدات بأسلوب PEP 8.

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

  • يقسّم الاسم إلى كلمات ويصغّرها ويصلها بشرطات سفلية: PaymentMethod → payment_method.
  • تبقى الأرقام مع كلمتها: Base64Encoder → base64_encoder.
  • تُحفظ المسارات والامتدادات المحيطة بالاسم.

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

أسماء الجداول لنماذج ORM

يشتق Django وRails أسماء الجداول من أسماء الأصناف بصيغة snake_case. عند إنشاء الجداول يدويًا أو كتابة SQL خام، يعطيك تحويل OrderItem وShippingAddress الاسمين order_item وshipping_address (أضف صيغة الجمع بنفسك إن كان اصطلاحك يستخدمها).

نقل الأصناف إلى وحدات Python منفصلة

عند تقسيم ملف models.py كبير، تحصل كل صنف عادةً على وحدة تحمل اسمه: PaymentMethod يوضع في payment_method.py.

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

  • يبقى الاختصار كلمة واحدة: XMLParser → xml_parser، IOError → io_error. وإذا تلاصق اختصاران، كما في XMLHTTPClient، يندمجان في xmlhttp_client.
  • أسماء الأصناف المكوّنة من كلمة واحدة مثل User لا يُتعرّف عليها (إذ يلزم حرفان كبيران) فتبقى دون تغيير.

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

لماذا لم يُحوَّل User إلى user؟

يجب أن يحوي اسم PascalCase حرفين كبيرين على الأقل في هذه الأداة، وهذا يمنع تغيير الكلمات العادية المكتوبة بحرف أول كبير. صغّر الكلمات المفردة بنفسك.

هل يحوّل أسماء الجداول إلى صيغة الجمع؟

لا. OrderItem يصبح order_item؛ بينما يستخدم Rails الاسم order_items، فأضف s حيث يتوقعها إطار العمل لديك.