Troca os underscores de nomes em snake_case por hífens: output_dir → output-dir. Nomes em minúscula com hífen são a norma para opções longas de linha de comando, paths de URL, nomes de recursos do Kubernetes, nomes de pacotes npm e classes CSS, e nenhum deles usa underscore por convenção.
Um caso comum é um script Python cujas opções do argparse ou chaves de configuração foram escritas com underscore e agora precisam da forma convencional --flag-name, ou identificadores do banco que precisam aparecer em URLs.
Texto, um por linha ou na mesma linha.Resultado.--dry_run
--output_dir dist
--max_workers 4--dry-run
--output-dir dist
--max-workers 4Cada nome de opção ganha hífens, e o -- do início e os valores dist e 4 são mantidos. No argparse, --dry-run continua sendo lido como args.dry_run, então o lado Python não muda.
max_workers → max-workers, address_line_2 → address-line-2.--, / ou ?page=, é preservado._internal_id → internal-id.O argparse e o click aceitam --output_dir, mas os usuários esperam --output-dir. Converter a lista de opções e atualizar as chamadas de add_argument mantém os nomes dos atributos (output_dir) iguais.
Códigos de categoria como gift_cards ou order_history guardados numa tabela podem virar os paths /gift-cards e /order-history, que é o estilo mais comum para URLs públicas.
__version__, não são reconhecidos e mantêm os underscores.add_argument e keywords como store_true também são convertidos, o que quebra o código. Cole só os nomes.Não. kebab-case é para strings como opções, URLs, nomes de arquivo e nomes de recursos; mantenha as variáveis Python em snake_case.
Os nomes no Kubernetes aceitam letras minúsculas, dígitos e hífens, e é exatamente isso que sai de uma entrada snake_case normal, incluindo segmentos de dígitos.