コードスタイルガイド

このガイドには、BeeWare のコードを書くための情報とガイドラインが含まれています。

コードスタイル

BeeWareのコードベースではPEP 8に準拠していますが、行長は79文字から88文字に拡張されています。 可能な限りRuffを使用してPEP 8の規約を強制します。コードをコミットする際、pre-commitがRuffを含むチェックを実行します。可能な場合、これによりコードが自動整形され、当社のフォーマットおよびスタイル基準を満たすことが保証されます。一部のIDEでは保存時にRuffを自動実行するよう設定でき、このプロセスを支援できます。

PEP 8で最も重要な部分はセクション0: 愚かな一貫性は小物の悪霊であるであることを心に留めておいてください。PEP 8との一貫性を保つことが意味をなさない状況も存在し、適用可能な場合には、記載された規則に沿わないコードを書くことが許容され、時には望ましい場合もあることを理解することが重要です。 それらのルールにいつ不整合を許容すべきかを知ることは、ほとんどの状況で一貫性を保つことと同じくらい重要です。

APIの命名規則、変数名などについては米国式スペルを採用します。

避けるべきこと

可能な限りutilsモジュールは避けるように努めていますが、場合によっては避けられないこともあると認識しています。望ましい代替策は、utilsモジュールを使用する代わりに、ソースコード内の別の場所でその機能を実現できる箇所を見つけることです。

一般的なルールとして、アプリの起動を高速化するため、高コストな初期化コードは回避または遅延させるよう努めています。例えば、toga-coreパッケージのモジュールは「遅延読み込み」されており、最初から全て読み込まれるのではなく、要求された時点で初めてインポートされます。これにより起動が高速化され、アプリが実際に使用している部分のみに時間を費やすことができます。