Google опубликовал своё Руководство по стилю Rust — документ, определяющий, как пишется Rust в кодовых базах Google, включая google3, Android, Chrome OS, Fuchsia и Chrome. Руководство охватывает не только форматирование, но и проектирование API и реализации. Заявленная цель — добиться единообразия использования Rust внутри этих кодовых баз и между ними, а также установить стандарт качества.
Сфера действия руководства различается в зависимости от проекта. Android, Chromium и другие кодовые базы были привлечены к консультациям при его разработке и намерены начать его применение, однако каждая из них может сама определить, насколько строго оно будет соблюдаться. Информация о внедрении ожидается по мере того, как эти кодовые базы будут его принимать.
Цели руководства во многом повторяют цели руководства Google по стилю C++. Большинство его правил восходит к одной или нескольким из этих целей, при этом читаемость и сопровождаемость имеют приоритет над удобством написания. Авторы отмечают, что код предполагается использовать в течение долгого времени, поэтому небольшие дополнительные усилия при его написании считаются оправданными.
Документ разделён на разделы, охватывающие организацию кода, форматирование, владение и заимствование, входные и выходные данные функций, типы, трейты, обобщённые типы, конкурентность, именование, документацию, небезопасный код и вопросы реализации. Рекомендации включают предпочтение небольших крейтов, избегание glob-импортов, избегание Rc и Arc, а также использование перечислений вместо булевых значений в API.
Источник: Hacker News · Сводку подготовил HeadlinesBriefing