تحويل snake_case إلى camelCase!

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

تحويل snake_case إلى camelCase!

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

يعيد كتابة أسماء snake_case مثل order_id وcreated_at بصيغة camelCase (orderId، createdAt). الصفوف القادمة من قواعد بيانات SQL وقواميس Python وكثير من واجهات REST (Rails وDjango وGitHub) تستخدم snake_case، بينما يُقرأ كود JavaScript وTypeScript وJava وKotlin بشكل أطبع بصيغة camelCase.

الصق نتيجة استعلام أو قاموسًا حرفيًا أو قائمة أعمدة أو استجابة JSON فتُحوَّل كلمات snake_case في مكانها، لترى أسماء الحقول على جانب الواجهة الأمامية قبل كتابة mapper أو نوع TypeScript.

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

  1. تأكد من أن القائمة المنسدلة اليسرى على snake_case واليمنى على camelCase.
  2. ضع قائمة أعمدة SQL أو قاموس Python أو JSON في نص السلسلة.
  3. خذ النص المحوَّل من النتيجة؛ المعرّفات التي أُعيدت تسميتها مميّزة لتلاحظ أي شيء ما كان يجب أن يتغير.

مثال

المدخلات (snake_case)
row = {
  "order_id": 1001,
  "customer_name": "Kim",
  "total_price": 25000,
  "created_at": "2024-05-01",
}
المخرجات (camelCase)
row = {
  "orderId": 1001,
  "customerName": "Kim",
  "totalPrice": 25000,
  "createdAt": "2024-05-01",
}

أُعيدت تسمية المفاتيح المقتبسة في قاموس Python، وتُركت القيمة "Kim" والتاريخ كما هما لأنهما لا يحويان كلمات مفصولة بشرطات سفلية.

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

  • يُكبَّر الحرف الذي يلي كل شرطة سفلية وتُحذف الشرطة: total_price → totalPrice.
  • تُحفظ شرطة سفلية واحدة في البداية، كما تتوقع الحقول ذات الأسلوب الخاص في JavaScript: _private_var → _privateVar.
  • يجب أن يحوي الاسم شرطة سفلية واحدة على الأقل ليُتعرّف عليه، لذا لا تُمس الكلمات العادية مثل row أو name أبدًا.
  • تُعالَج المفاتيح بين علامات الاقتباس والأسماء المستعارة في SQL ومفاتيح YAML كلها لأن النص يُفحص بأكمله.

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

كتابة أنواع TypeScript لاستجابة REST بصيغة snake_case

الصق استجابة نموذجية من API مبني بـ Django أو Rails لترى أسماء خصائص camelCase التي سيستخدمها نموذجك على جانب العميل بعد خطوة تحويل المفاتيح (مثلًا عبر axios interceptors أو humps).

ربط صفوف SQL بالكائنات

عندما تحوّل طبقة الـ repository الاستعلام SELECT user_id, last_login_at ... إلى كائنات، فإن تحويل قائمة الأعمدة يعطيك أسماء الخصائص للـ mapper أو الـ DTO.

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

  • المقاطع المكوّنة من أرقام تُلصق بالكلمة السابقة: address_line_2 يصبح addressLine2 وuser_2fa_code يصبح user2faCode.
  • الأسماء ذات الشرطتين السفليتين مثل __init__ أو __tablename__ لا تُطابَق وتبقى كما كُتبت.

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

هل يغيّر هذا قيم JSON أيضًا؟

فقط القيم التي هي نفسها كلمات snake_case، مثل سلسلة enum بقيمة "in_progress". أما الأرقام والتواريخ والنصوص العادية والروابط الخالية من الشرطات السفلية فتبقى كما هي.

هل أحوّل مفاتيح الـ API على الخادم أم على العميل؟

يعتمد ذلك على تقنياتك؛ هذه الصفحة تبيّن فقط كيف ستبدو الأسماء. وهي مفيدة لكتابة تعريفات الأنواع أو للتحقق من مخرجات camelCase لأداة التسلسل (serializer).