HeadlinesBriefing HeadlinesBriefing.com

Googleのrustスタイルガイド:一貫したコードのためのルール

Hacker News •
×

Googleは、google3、Android、Chrome OS、Fuchsia、Chromeを含む同社のコードベース全体でRustをどのように記述するかを定めた文書、「Rustスタイルガイド」を公開しました。このガイドはフォーマットにとどまらず、API設計や実装設計にも及びます。掲げられた目的は、これらのコードベースの内外でRustの使い方の一貫性を確保するとともに、品質の基準を確立することです。

ガイドの適用範囲はプロジェクトによって異なります。Android、Chromium、その他のコードベースは策定過程で意見を求められており、適用を開始する予定ですが、ガイドをどの程度厳格に強制するかは各プロジェクトが決定できます。採用に関する情報は、それぞれのコードベースが採用するのに合わせて公表される見込みです。

このガイドの目標は、GoogleのC++スタイルガイドの目標とほぼ同じです。ガイドのルールの多くは、これらの目標の一つ以上に由来しており、記述のしやすさよりも可読性と保守性が優先されています。著者らは、コードは長期間使用されることが想定されるため、記述時にわずかに余分な労力をかけることには価値があると指摘しています。

文書は、コードの構成、フォーマット、所有権と借用、関数の入力と出力、型、trait、ジェネリクス、並行性、命名、ドキュメント、unsafeコード、実装上の問題などのセクションに分かれています。指針には、小さなcrateを優先すること、glob importを避けること、RcとArcを避けること、APIではboolよりenumを優先することなどが含まれています。

出典: Hacker News · 要約:HeadlinesBriefing