تحويل PascalCase إلى SCREAMING_SNAKE_CASE!

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

تحويل PascalCase إلى SCREAMING_SNAKE_CASE!

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

يحوّل أسماء PascalCase إلى SCREAMING_SNAKE_CASE: UserLoggedIn → USER_LOGGED_IN. أصناف الأحداث وأنواع الرسائل وأعضاء enum في TypeScript تكون غالبًا بصيغة PascalCase، بينما تُكتب سلاسل أنواع الـ actions وثوابت enum في Java وقيم enum في قواعد البيانات تقليديًا بأحرف كبيرة وشرطات سفلية.

الصق union من أسماء الأحداث أو enum أو قائمة أسماء أصناف لتحصل على رموز بنمط الثوابت تُرسَل عبر الشبكة أو تُكتب في ملف ثوابت.

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

  1. اختر PascalCase على اليسار وSCREAMING_SNAKE_CASE على اليمين.
  2. الصق الـ union أو أعضاء الـ enum أو أسماء الأحداث في نص السلسلة.
  3. انسخ أسماء الثوابت من النتيجة.

مثال

المدخلات (PascalCase)
type Action =
  | { type: "UserLoggedIn" }
  | { type: "CartItemAdded" }
  | { type: "CheckoutFailed" };
المخرجات (SCREAMING_SNAKE_CASE)
type Action =
  | { type: "USER_LOGGED_IN" }
  | { type: "CART_ITEM_ADDED" }
  | { type: "CHECKOUT_FAILED" };

تصبح أنواع الـ actions الثلاثة ثوابت على طريقة Redux. أما Action فكلمة واحدة، لذا لا يتغير اسم النوع نفسه.

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

  • يفصل الكلمات عند كل حرف كبير ويكبّرها: CartItemAdded → CART_ITEM_ADDED.
  • يحوّل الأسماء داخل السلاسل الحرفية، وهو المكان الذي توجد فيه عادةً أنواع الـ actions ورموز الرسائل.
  • تبقى الأرقام ضمن كلمتها: Oauth2TokenIssued → OAUTH2_TOKEN_ISSUED.

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

أنواع actions في Redux أو ناقل الأحداث

أسماء الأحداث المصممة بصيغة CheckoutFailed يمكن تحويلها إلى ثوابت CHECKOUT_FAILED للـ reducers أو أحداث التحليلات أو وسيط رسائل يتوقع رموزًا بأحرف كبيرة.

قيم enum في قاعدة البيانات لـ enum في C# أو TypeScript

حين يجب تخزين enum بصيغة PascalCase في enum ضمن PostgreSQL أو في عمود VARCHAR بقيم بأحرف كبيرة، حوّل الأعضاء لتحصل على القيم المخزنة.

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

  • الاختصارات في البداية تبقى مقطعًا واحدًا: HTTPRequestFailed → HTTP_REQUEST_FAILED، APIKeyRevoked → API_KEY_REVOKED.
  • الأسماء المكوّنة من كلمة واحدة مثل Paid لا تُطابَق؛ كبّرها بنفسك.

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

لماذا حُوّلت أعضاء الـ enum عندي ما عدا Paid؟

يتطلب التعرّف حرفين كبيرين على الأقل، لذا تُتخطى الأعضاء المكوّنة من كلمة واحدة تجنبًا لتغيير الكلمات العادية المكتوبة بحرف أول كبير.

هل يمكنني العودة إلى PascalCase لاحقًا؟

نعم، عبر صفحة SCREAMING_SNAKE_CASE → PascalCase. الأسماء الخالية من الاختصارات تعود تمامًا كما كانت؛ أما الاختصار فيعود بحرف أول كبير فقط، فيعود HTTP_REQUEST_FAILED على شكل HttpRequestFailed.