تحويل SCREAMING_SNAKE_CASE إلى camelCase!

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

تحويل SCREAMING_SNAKE_CASE إلى camelCase!

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

يحوّل الأسماء المكتوبة بأحرف كبيرة وشرطات سفلية، مثل DATABASE_URL أو JWT_SECRET، إلى camelCase (databaseUrl، jwtSecret). متغيرات البيئة والثوابت تُكتب بصيغة SCREAMING_SNAKE_CASE، لكن ما إن تُحمَّل في كائن إعدادات ذي أنواع في Node.js أو Spring أو Kotlin حتى تصبح الحقول عادةً بصيغة camelCase.

الصق أسطر ملف .env أو كتلة environment في docker-compose أو قائمة ثوابت لتحصل على أسماء الخصائص التي ستعرّفها في صنف الإعدادات أو المخطط.

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

  1. اختر SCREAMING_SNAKE_CASE مصدرًا وcamelCase هدفًا.
  2. الصق أسطر .env أو أسماء الثوابت في خانة نص السلسلة.
  3. انسخ الأسماء من النتيجة إلى نوع الإعدادات أو مخطط zod أو صنف @ConfigurationProperties.

مثال

المدخلات (SCREAMING_SNAKE_CASE)
DATABASE_URL=postgres://localhost/app
REDIS_HOST=localhost
JWT_SECRET=change-me
المخرجات (camelCase)
databaseUrl=postgres://localhost/app
redisHost=localhost
jwtSecret=change-me

يصبح كل اسم متغير مفتاحًا بصيغة camelCase، بينما تبقى القيم بعد = كما هي؛ وchange-me ليست بأحرف كبيرة، فلا تُمس.

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

  • يصغّر الاسم ويكبّر الحرف الذي يلي كل شرطة سفلية: REDIS_HOST → redisHost.
  • الأرقام التي تأتي بعد حرف في المقطع نفسه تعمل جيدًا: API_V2_URL → apiV2Url.
  • الأسماء المكوّنة من كلمة واحدة بلا شرطة سفلية، مثل PORT أو DEBUG، تُترك كما هي.

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

إعدادات ذات أنواع في Node.js

التحقق من process.env باستخدام zod أو class-validator ينتهي عادةً بكائن مثل { databaseUrl, redisHost }. تحويل مفاتيح .env يعطيك قائمة الخصائص لكتابة المخطط والربط.

خصائص Spring Boot

يربط Spring المتغير MAIL_SMTP_HOST بالخاصية mail.smtp.host ويسندها إلى حقل بصيغة camelCase. تحويل أسماء المتغيرات يساعدك عند كتابة حقول @ConfigurationProperties المقابلة.

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

  • المراجع مثل process.env.DATABASE_URL تُحوَّل أيضًا إن ألصقتها، فتحصل على process.env.databaseUrl الذي لم يعد يشير إلى المتغير الحقيقي. الصق الأسماء أو أسطر .env فقط.
  • المقاطع المكوّنة من أرقام فقط تُوصل دون فاصل: HTTP_2_ENABLED يصبح http2Enabled.

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

لماذا لم يُحوَّل PORT إلى port؟

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

هل تُحفظ الشرطات السفلية في البداية؟

نعم. _INTERNAL_FLAG يصبح _internalFlag، وهي الطريقة المعتادة لتمييز الحقل الخاص في JavaScript وDart. احذف الشرطة السفلية بنفسك إن لم يكن صنف الإعدادات لديك يستخدمها.