型チェックしたい(pyright

$ pyright --version
pyright 1.1.383

$ pyright ファイル名 or ディレクトリ名

pyrightはMicrosoftが開発しているPython用の型チェッカーです。

注釈

VS Code拡張Pylanceの内部で使用されています。

インストールしたい(pyright

  • pipxでインストール

$ pipx install pyright
  • poetryでインストール

$ poetry add pyright --dev test
  • uvでインストール

$ uv tool install pyright

設定したい(pyrightconfig.json

{
    "include": ["src"],
    "exclude": ["tests/helpers"],
    "reportMissingImports": true,
    "reportUnusedImports": "warning",
    "typeCheckingMode": "strict"
}

pyrightconfig.jsonで設定を変更できます。 プロジェクトルートに配置します。

注釈

Pylanceの場合は、その他のVS Code拡張と同様にsettings.jsonで設定できます。

{
    // Pylanceを有効にする
    "python.languageServer": "Pylance",

    // 型チェックのモード
    // "off" | "basic" | "strict"
    "python.analysis.typeCheckingMode": "basic",

    // 解析対象のパスを追加
    "python.analysis.extraPaths": [
        "./src",
        "./tests"
    ],

    // 型スタブ(関数の型定義)を配置するパス
    // C拡張モジュールをラップする場合に必要
    "python.analysis.stubPath": "./typings",

    // インポート解決の挙動
    "python.analysis.autoImportCompletions": true,
    "python.analysis.autoSearchPaths": true,

    // 未使用コードの警告
    "python.analysis.diagnosticSeverityOverrides": {
        "reportUnusedImport": "warning",
        "reportUnusedVariable": "information"
    }
}

リファレンス