Google a publié son Guide de style Rust, un document qui régit la manière d'écrire Rust dans les bases de code de Google, notamment google3, Android, Chrome OS, Fuchsia et Chrome. Le guide ne se limite pas au formatage : il s'étend à la conception des API et de l'implémentation. Son objectif déclaré est d'assurer la cohérence de l'usage de Rust au sein de ces bases de code et entre elles, tout en établissant une norme de qualité.
Le champ d'application du guide varie selon les projets. Android, Chromium et d'autres bases de code ont été consultés lors de son élaboration et comptent commencer à l'appliquer, même si chacune peut décider du degré de rigueur avec lequel le guide est appliqué. Des informations sur cette adoption devraient être publiées au fur et à mesure que ces bases de code le mettront en œuvre.
Les objectifs du guide reprennent en grande partie ceux du guide de style C++ de Google. La plupart de ses règles découlent d'un ou de plusieurs de ces objectifs, la lisibilité et la maintenabilité étant privilégiées par rapport à la facilité d'écriture. Les auteurs soulignent que le code est censé rester en service pendant de longues périodes, si bien qu'un petit effort supplémentaire lors de son écriture est jugé utile.
Le document est structuré en sections couvrant l'organisation du code, le formatage, la propriété et l'emprunt, les entrées et sorties des fonctions, les types, les traits, les génériques, la concurrence, le nommage, la documentation, le code unsafe et les questions d'implémentation. Parmi les recommandations figurent la préférence pour de petits crates, l'évitement des imports glob, l'évitement de Rc et Arc, et la préférence pour les enums plutôt que les bools dans les API.
Source: Hacker News · Résumé par HeadlinesBriefing