Remplace les tirets bas des noms en snake_case par des tirets : output_dir → output-dir. Les noms en minuscules à tirets sont la norme pour les options longues en ligne de commande, les chemins d'URL, les noms de ressources Kubernetes, les noms de paquets npm et les classes CSS, qui par convention n'utilisent jamais de tirets bas.
Cas fréquent : un script Python dont les options argparse ou les clés de config ont été écrites avec des tirets bas et doivent maintenant prendre la forme conventionnelle --flag-name, ou des identifiants de base de données qui doivent apparaître dans des URL.
Chaîne de texte, un par ligne ou en ligne.Résultat.--dry_run
--output_dir dist
--max_workers 4--dry-run
--output-dir dist
--max-workers 4Chaque nom d'option reçoit des tirets, et le -- initial ainsi que les valeurs dist et 4 sont conservés. Avec argparse, --dry-run se lit toujours args.dry_run : rien ne change côté Python.
max_workers → max-workers, address_line_2 → address-line-2.--, / ou ?page=, est préservé._internal_id → internal-id.argparse et click acceptent --output_dir, mais les utilisateurs attendent --output-dir. Convertir la liste des options et mettre à jour les appels add_argument laisse les noms d'attributs (output_dir) inchangés.
Des codes de catégorie comme gift_cards ou order_history stockés dans une table peuvent devenir les chemins /gift-cards et /order-history, le style le plus courant pour les URL publiques.
__version__, ne sont pas détectés et gardent leurs tirets bas.add_argument et les mots-clés comme store_true sont aussi convertis, ce qui casse le code. Ne collez que les noms.Non. Le kebab-case est destiné aux chaînes comme les options, URL, noms de fichiers et noms de ressources ; gardez les variables Python en snake_case.
Les noms Kubernetes autorisent les minuscules, les chiffres et les tirets, et c'est exactement ce que produit cet outil à partir d'une entrée snake_case normale, segments numériques compris.