Модули ржавчины для кебаб-кейса

Если вы действительно хотите, вы можете разместить код модулей в произвольных именах файлов:

#[path = "distinct-powers.rs"]
mod distinct_powers;

Но, пожалуйста, не надо — одна из замечательных особенностей Rust заключается в том, что существует единый стандарт для макета проекта, который позволяет легко погрузиться в чужой код. Каждая настройка мешает кому-то найти код, который он ищет.

Есть пара мест, где разрешены дефисы, то есть в пакете Rust можно использовать имя kebab-case. Все они связаны с Cargo, системой сборки, а не с самим языком Rust.

• Имя самого пакета (как указано в Cargo.toml) может быть kebab-case. Если пакет является библиотекой, Cargo автоматически преобразует это в snake_case для имени ящика библиотеки (именно так вы ссылаетесь на него в коде Rust в зависимых файлах). Это довольно часто делается.

  Например, в этом URL-адресе документации, https://docs.rs/ordered-float/latest/ordered_float/, вы можете видеть, что имя пакета ordered-float и имя ящика (которое можно было бы переопределить, но не было) происходит от этого как ordered_float.

• Имя двоичного файла, примера или тестовой цели может содержать дефисы. Это означает, что двоичные файлы, встроенные в target/, могут иметь имена в регистре кебаба — cargo run --bin distinct-powers допустимо.

Все эти имена могут использоваться автообнаружением грузовых целей и, таким образом, не считаются нестандартной компоновкой.

kebab-enthusiast/
  Cargo.toml
  src/
    lib.rs
    snake_module.rs
    bin/
      kebab-binary.rs
  examples/
    kebab-example.rs
  tests/
    kebab-test.rs