Weblate のソースコード¶
Weblateは GitHub 上で開発しています。コードをフォークしてプルリクエストを開くことができます。他の形式のパッチも歓迎します。
参考
Weblate の内部構造 を確認して、Weblate の内部構造がどうなっているか調べてください。
コーディングのガイドライン¶
Weblate のコードはすべて、 セキュリティ設計原則 を念頭に記述してください。
すべてのコードには、動作を説明するドキュメントが付属しています。メソッド、複雑なコードブロック、またはユーザーに表示される機能は文書化することを忘れないでください。
新しいコードでは、PEP 484 型のヒントを使用してください。既存のコードにはまだ含まれていないため、CI ではまだ検査できていません。
コーディング規約と低品質コードの検出¶
コードは PEP-8 コーディング規約に従い、ruff コード整形ツールを使用してフォーマットしてください。
コードの品質を検査するには、ruff を使用できます。その設定は pyproject.toml
に保存されています。
The easiest approach to enforce all this is to install pre-commit. The
repository contains configuration for it to verify the committed files are sane.
After installing it (it is already included in the
pyproject.toml
) turn it on by running pre-commit install
in
Weblate checkout. This way all your changes will be automatically checked.
手動で検査を実行し、すべてのファイルを検査する方法:
pre-commit run --all