تحويل snake_case إلى kebab-case!

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

تحويل snake_case إلى kebab-case!

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

يستبدل الشرطات السفلية في أسماء snake_case بشرطات: output_dir → output-dir. الأسماء الصغيرة الموصولة بشرطات هي القاعدة في خيارات سطر الأوامر الطويلة ومسارات الروابط وأسماء موارد Kubernetes وأسماء حزم npm وأصناف CSS، ولا يستخدم أيٌّ منها الشرطات السفلية عرفًا.

من الحالات الشائعة سكربت Python كُتبت خيارات argparse أو مفاتيح إعداداته بشرطات سفلية ويحتاج الآن إلى الصيغة المعتادة --flag-name، أو معرّفات قاعدة بيانات يجب أن تظهر في الروابط.

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

  1. اضبط الزوج على snake_case → kebab-case.
  2. الصق الخيارات أو المفاتيح أو مقاطع المسارات في نص السلسلة، واحدًا في كل سطر أو ضمن السطر.
  3. انسخ نص النتيجة.

مثال

المدخلات (snake_case)
--dry_run
--output_dir dist
--max_workers 4
المخرجات (kebab-case)
--dry-run
--output-dir dist
--max-workers 4

يحصل كل اسم خيار على شرطات، ويُحتفظ بـ -- في البداية وبالقيمتين dist و4. في argparse يُقرأ --dry-run على أنه args.dry_run، فلا يتغير شيء على جانب Python.

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

  • كل شرطة سفلية داخل الاسم تصبح شرطة: max_workers → max-workers، address_line_2 → address-line-2.
  • يُحفظ النص المحيط بالاسم، مثل -- أو / أو ?page=.
  • تُحذف شرطة سفلية واحدة في البداية: _internal_id → internal-id.

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

ترتيب خيارات CLI

يقبل argparse وclick الخيار --output_dir، لكن المستخدمين يتوقعون --output-dir. تحويل قائمة الخيارات وتحديث استدعاءات add_argument يُبقي أسماء السمات (output_dir) كما هي.

slugs للروابط من مفاتيح قاعدة البيانات

رموز التصنيفات مثل gift_cards أو order_history المخزنة في جدول يمكن تحويلها إلى المسارين /gift-cards و/order-history، وهو الأسلوب الأكثر شيوعًا للروابط العامة.

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

  • الأسماء التي تبدأ بشرطتين سفليتين، مثل __version__، لا تُطابَق وتحتفظ بشرطاتها السفلية.
  • عند لصق أسطر Python كاملة، تُحوَّل أيضًا أسماء الدوال مثل add_argument والكلمات المفتاحية مثل store_true، ما يُفسد الكود. الصق الأسماء فقط.

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

هل الأسماء الموصولة بشرطات معرّفات صالحة في Python؟

لا. kebab-case مخصص للسلاسل النصية مثل الخيارات والروابط وأسماء الملفات وأسماء الموارد؛ أبقِ متغيرات Python بصيغة snake_case.

هل يقبل Kubernetes النتيجة اسمًا لمورد؟

تسمح أسماء Kubernetes بالأحرف الصغيرة والأرقام والشرطات، وهذا بالضبط ما تنتجه الأداة من مدخلات snake_case العادية، بما فيها المقاطع الرقمية.