Mallet Linter Guide

Malletは、スタイルの強制ではなく実際の間違いを捉えることに特化したCommon Lispリンターです。

基本コマンド

bash

# ファイル/ディレクトリをリント
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)

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オプション

bash

# プリセット
--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 - 未使用インポートを削除

ソースコード内での抑制

lisp

;; 次のフォームを抑制
#+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	実行エラー

推奨ワークフロー

開発中

bash

# デフォルトルールでチェック
mallet src/

# 問題を確認して修正
mallet --fix-dry-run src/
mallet --fix src/

PR前

bash

# 全ルールでチェック
mallet -a src/

# メトリクス確認
mallet --enable-group metrics src/

CI/CD

bash

# 厳格チェック（エラーで失敗）
mallet --format line src/ && echo "Lint passed"