nixf-diagnose is a CLI wrapper for nixf-tidy with fancy diagnostic output. It provides enhanced error reporting and variable lookup analysis for your source files.
To use nixf-diagnose, you need to provide the path to the input source file. Optionally, you can specify the path to the nixf-tidy executable and enable or disable variable lookup analysis.
nixf-diagnose tries to determine the nixf-tidy path in the following order:
- Path provided via
--nixf-tidy-pathCLI argument - Compile-time constant (embedded during build)
- Runtime discovery via
whichcommand
nixf-diagnose [OPTIONS] [FILES]...Example output:
Error: duplicated attrname `a` ╭─[nixd/test-workspace/redefined.nix:4:5] │ 2 │ a = 1; · ┬ · ╰── previously declared here · 4 │ a = 1; · ┬ · ╰── duplicated attrname `a` ───╯ | Option | Description |
|---|---|
--nixf-tidy-path <NIXF_TIDY_PATH> | Path to the nixf-tidy executable |
--variable-lookup [<VARIABLE_LOOKUP>] | Enable variable lookup analysis [default: true] [possible values: true, false] |
-h, --help | Print help |
-V, --version | Print version |
-i, --ignore <ID> | Ignore diagnostics with specific ids This can be used multiple times |
-o, --only <ID> | Only run a single diagnostic |
--auto-fix | Automatically apply fixes to source files |
This project is licensed under the MIT License.