]> git.lizzy.rs Git - rust.git/commitdiff
start a clippy-dev readme and some rough info on how to use lintcheck
authorMatthias Krüger <matthias.krueger@famsik.de>
Tue, 9 Feb 2021 15:58:39 +0000 (16:58 +0100)
committerMatthias Krüger <matthias.krueger@famsik.de>
Thu, 11 Feb 2021 09:41:31 +0000 (10:41 +0100)
clippy_dev/README.md [new file with mode: 0644]

diff --git a/clippy_dev/README.md b/clippy_dev/README.md
new file mode 100644 (file)
index 0000000..6ab8ecb
--- /dev/null
@@ -0,0 +1,26 @@
+## Clippy-dev is a tool to ease clippys development, similar to `rustc`s `x.py`.
+
+Functionalities (incomplete):
+
+# lintcheck
+Runs clippy on a fixed set of crates read from `clippy_dev/lintcheck_crates.toml`
+and saves logs of the lint warnings into the repo.
+We can then check the diff and spot new or disappearing warnings.
+
+From the repo root, run:
+````
+cargo run --target-dir clippy_dev/target --package clippy_dev \
+--bin clippy_dev --manifest-path clippy_dev/Cargo.toml --features lintcheck -- lintcheck
+````
+or
+````
+cargo dev-lintcheck
+````
+
+By default the logs will be saved into `lintcheck-logs/lintcheck_crates_logs.txt`.
+
+You can set a custom sources.toml by adding `--crates-toml custom.toml`
+where `custom.toml` must be a relative path from the repo root.
+
+The results will then be saved to `lintcheck-logs/custom_logs.toml`.
+