Mallet Linter Guide
Malletは、スタイルの強制ではなく実際の間違いを捉えることに特化したCommon Lispリンターです。
基本コマンド
# ファイル/ディレクトリをリント
mallet src/
# 全ルール有効化
mallet -a src/
mallet --all src/
# 自動修正（ドライラン）
mallet --fix-dry-run src/
# 自動修正実行
mallet --fix src/
# 出力形式指定
mallet --format json src/
mallet --format line src/ # GCC形式
重大度レベル
| レベル | 説明 | 例 |
|---|
| error | 確実に間違い | wrong-otherwise
|
| warning | バグの可能性 | unused-variables
, missing-otherwise
|
| convention | イディオム推奨 | if-without-else
, special-variable-naming
|
| format | フォーマット | trailing-whitespace
, no-tabs
|
| info | スタイル選択 | line-length
, constant-naming
|
| metrics | 品質測定 | cyclomatic-complexity
, function-length
|
主要ルール
Error（エラー）
| ルール | 説明 |
|---|
wrong-otherwise
| ecase/etypecaseでotherwise/tを使用 |
Warning（警告）
| ルール | 説明 |
|---|
unused-variables
| 未使用変数 |
unused-local-functions
| 未使用ローカル関数 |
missing-otherwise
| case/typecaseにotherwise句がない |
mixed-optional-and-key
| &optionalと&keyの混在 |
Convention（慣例）
| ルール | 説明 |
|---|
if-without-else
| else節なしのif → when/unless推奨 |
bare-progn-in-if
| ifでprogn → cond推奨 |
interned-package-symbol
| パッケージで#:形式推奨 |
special-variable-naming
| 特殊変数はname形式 |
asdf-component-strings
| ASDFコンポーネントに文字列使用 |
Format（フォーマット）
| ルール | 説明 |
|---|
no-tabs
| タブ禁止 |
trailing-whitespace
| 行末空白 |
final-newline
| ファイル末尾改行 |
Info（情報）
| ルール | 説明 | デフォルト |
|---|
line-length
| 最大行長 | 100 |
consecutive-blank-lines
| 連続空行 | 2 |
unused-local-nicknames
| 未使用ニックネーム | - |
unused-imported-symbols
| 未使用インポート | - |
constant-naming
| 定数は+name+形式 | - |
needless-let*
| 不要なlet* | - |
Metrics（メトリクス）
| ルール | 説明 | デフォルト |
|---|
cyclomatic-complexity
| 循環複雑度 | 20 |
function-length
| 関数行数 | 50 |
設定ファイル (.mallet.lisp)
(:mallet-config
;; ベース設定
(:extends :default) ; :default, :all, :none
;; 無視パス
(:ignore "vendor/**/*.lisp"
"**/generated/*.lisp"
"examples/**/*.lisp")
;; ルール有効化（オプション付き）
(:enable :line-length :max 100)
(:enable :cyclomatic-complexity :max 15)
(:enable :function-length :max 40)
(:enable :consecutive-blank-lines :max 2)
(:enable :constant-naming)
;; ルール無効化
(:disable :if-without-else)
;; パス固有設定
(:for-paths ("tests")
(:enable :line-length :max 120)
(:disable :unused-variables))
(:for-paths ("scripts" "examples")
(:disable :line-length)
(:disable :trailing-whitespace)))
CLIオプション
# プリセット
--preset default # 推奨ルールのみ
--preset all # 全ルール
--preset none # ルールなし
# ルール制御
--enable rule-name
--enable rule-name:opt=value
--disable rule-name
--enable-group metrics
--disable-group info
# 出力
--format text # デフォルト
--format line # GCC形式（エディタ統合用）
--format json # プログラム処理用
# 修正
--fix # 自動修正
--fix-dry-run # 修正プレビュー
# その他
--config path # 設定ファイル指定
--debug # デバッグモード
自動修正可能なルール
以下のルールは
--fix
で自動修正可能:
trailing-whitespace
- 行末空白を削除final-newline
- ファイル末尾に改行追加consecutive-blank-lines
- 過度な空行を削除unused-local-nicknames
- 未使用ニックネームを削除unused-imported-symbols
- 未使用インポートを削除
ソースコード内での抑制
;; 次のフォームを抑制
#+mallet
(declaim (mallet:suppress-next :if-without-else))
(defun foo () (if x (print "yes")))
;; 領域を抑制
#+mallet
(declaim (mallet:disable :line-length))
;; ... 長い行のコード ...
#+mallet
(declaim (mallet:enable :line-length))
;; スコープ内で抑制
(defun foo ()
#+mallet
(declare (mallet:suppress :unused-variables))
(let ((unused 1))
(do-something)))
;; 全ルール抑制
#+mallet
(declaim (mallet:suppress-next :all))
(defun generated-code () ...)
終了コード
| コード | 意味 |
|---|
| 0 | 問題なし |
| 1 | 警告あり |
| 2 | エラーあり |
| 3 | 実行エラー |
推奨ワークフロー
開発中
# デフォルトルールでチェック
mallet src/
# 問題を確認して修正
mallet --fix-dry-run src/
mallet --fix src/
PR前
# 全ルールでチェック
mallet -a src/
# メトリクス確認
mallet --enable-group metrics src/
CI/CD
# 厳格チェック（エラーで失敗）
mallet --format line src/ && echo "Lint passed"
