ECC/docs/ja-JP/rules/perl/coding-style.md

paths
**/*.pl **/*.pm **/*.t **/*.psgi **/*.cgi

Perl コーディングスタイル

このファイルは common/coding-style.md を Perl 固有のコンテンツで拡張します。

標準

• 常に use v5.36（strict、warnings、say、サブルーチンシグネチャを有効化）
• サブルーチンシグネチャを使用する — @_ を手動で展開しない
• 明示的な改行付きの print よりも say を優先

不変性

• Moo で is => 'ro' と Types::Standard をすべての属性に使用
• blessed ハッシュリファレンスを直接使用しない — 常に Moo/Moose アクセサを使用
• OO オーバーライドノート: builder または default を持つ Moo の has 属性は、計算された読み取り専用値として許容される

フォーマット

以下の設定で perltidy を使用:

-i=4    # 4スペースインデント
-l=100  # 100文字の行長
-ce     # cuddled else
-bar    # 開き波括弧は常に右

リンティング

perlcritic をテーマ core、pbp、security で重大度 3 で使用する。

perlcritic --severity 3 --theme 'core || pbp || security' lib/

リファレンス

スキル: perl-patterns で包括的なモダン Perl のイディオムとベストプラクティスを参照してください。