يستبدل الشرطات بشرطات سفلية في أسماء kebab-case: order-history → order_history. مسارات الروابط ومعاملات الاستعلام وخيارات CLI وأسماء الملفات تكون غالبًا موصولة بشرطات، بينما لا تسمح متغيرات Python وأعمدة SQL وكثير من مخططات التحليلات أو السجلات إلا بالشرطات السفلية.
الصق المسارات أو مفاتيح الاستعلام أو أسماء الخيارات لتحصل على معرّفات يمكنك استخدامها في كود Python أو أعمدة قاعدة البيانات أو خصائص الأحداث.
نص السلسلة.النتيجة.GET /api/order-history?page-size=20
GET /api/gift-cards/balance-checkGET /api/order_history?page_size=20
GET /api/gift_cards/balance_checkتُحوَّل مقاطع المسار ومفتاح الاستعلام page-size؛ ولا تُمس GET و/api والرقم 20.
balance-check → balance_check.? و= وغيرها من أحرف الروابط حول الأسماء.2024-01-01 كما هي.مسارات Flask وFastAPI مثل /gift-cards/balance-check ترتبط عادةً بدوال باسم balance_check. تحويل قائمة المسارات يعطيك أسماء الدوال التي عليك تنفيذها.
معاملات الاستعلام مثل utm-source أو ref-code التي تصل إلى BigQuery أو Snowflake تُخزَّن عادةً كأعمدة utm_source وref_code.
item-2 يصبح item_2، ما يُبقيه معرّفًا صالحًا في Python.my-shop.com → my_shop.com). أبقِ أسماء المضيفات خارج الإدخال.للأسماء المكوّنة من أحرف وشرطات، نعم. أما إذا بدأ الاسم برقم فلن يقبله Python معرّفًا على أي حال.
لا. يحوّل argparse أصلًا --dry-run إلى args.dry_run. هذه الصفحة لحين تريد كتابة تلك الأسماء في مكان آخر، مثل مفاتيح الإعدادات أو الوثائق.