Заменяет подчёркивания в именах snake_case дефисами: output_dir → output-dir. Имена в нижнем регистре через дефис — норма для длинных опций командной строки, путей URL, имён ресурсов Kubernetes, имён npm-пакетов и CSS-классов; подчёркивания там по соглашению не используются.
Частый случай — Python-скрипт, у которого опции argparse или ключи конфигурации записаны через подчёркивание, а теперь нужна привычная форма --flag-name, или идентификаторы из базы данных, которые должны появиться в URL.
Строка текста — по одному на строку или в строку.Результат.--dry_run
--output_dir dist
--max_workers 4--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.argparse и click принимают --output_dir, но пользователи ожидают --output-dir. Если преобразовать список опций и обновить вызовы add_argument, имена атрибутов (output_dir) останутся прежними.
Коды категорий вроде gift_cards или order_history, хранящиеся в таблице, можно превратить в пути /gift-cards и /order-history — более распространённый стиль для публичных URL.
__version__, не распознаются и сохраняют подчёркивания.add_argument и ключевые слова вроде store_true тоже преобразуются, и код ломается. Вставляйте только имена.Нет. kebab-case предназначен для строк — опций, URL, имён файлов и ресурсов; переменные Python оставляйте в snake_case.
Имена в Kubernetes допускают строчные буквы, цифры и дефисы — ровно это и получается из обычного ввода в snake_case, включая цифровые сегменты.