dev: Add a script to auto fix all lint violations#19560
dev: Add a script to auto fix all lint violations#195602010YOUY01 merged 5 commits intoapache:mainfrom
Conversation
|
|
||
| SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" | ||
| SCRIPT_NAME="$(basename "${BASH_SOURCE[0]}")" | ||
| PRETTIER_VERSION="2.7.1" |
There was a problem hiding this comment.
Is there a reason to keep using this old version ?
Latest is https://www.npmjs.com/package/prettier/v/3.7.4
There was a problem hiding this comment.
No, I think it's supposed to get updated manually.
We can do so separately since it might have a large code diff.
| else | ||
| echo "[${SCRIPT_NAME}] \`cargo fmt --all -- --check\`" | ||
| cargo fmt --all -- --check | ||
| fi No newline at end of file |
There was a problem hiding this comment.
nit: It seems there is no newline (\n) at the end here (non POSIX complaint).
It is recommended to have it otherwise "it may break some old tools".
Even Github UI marks it as a warning.
There was a problem hiding this comment.
Good point, updated.
Perhaps we should introduce some lint tools to check the existing bash scripts, to prevent similar issues in the future 🤔
|
@martin-g Thank you for the review, all comments are addressed in ae7fc70 After the change, I have tested again the following step, and it's working as expected.
|
## Which issue does this PR close? <!-- We generally require a GitHub issue to be filed for all bug fixes and enhancements and this helps us generate change logs for our releases. You can link an issue to this PR using the GitHub syntax. For example `Closes apache#123` indicates that this PR will close issue apache#123. --> Part of apache#19227 ## Rationale for this change <!-- Why are you proposing this change? If this is already explained clearly in the issue then this section is not needed. Explaining clearly why changes are proposed helps reviewers understand your changes and offer better suggestions for fixes. --> See issue for details. The existing script `./dev/rust_lint.sh` do checks for all non-functional tests include formater/clippy checks. Some check tools support auto fix options, so this PR add an option to the lint scripts to perform auto-fixes. Now `./dev/rust_lint.sh --write --allow-dirty` can perform auto-fixes for all linter etc. violations ``` yongting@Yongtings-MacBook-Pro-2 ~/C/datafusion (auto-fix)> ./dev/rust_lint.sh --help Usage: ./dev/rust_lint.sh [--write] [--allow-dirty] Runs the local Rust lint suite similar to CI. --write Run formatters, clippy and other non-functional checks in best-effort write/fix mode (requires a clean git worktree, no uncommitted changes; some checks are test-only and ignore this flag). --allow-dirty Allow `--write` to run even when the git worktree has uncommitted changes. ``` ## What changes are included in this PR? <!-- There is no need to duplicate the description in the issue here but it is sometimes worth providing a summary of the individual changes in this PR. --> - Adds `[--write] [--allow-dirty]` flag to `rust_lint.sh` to support auto fixes - `rust_lint.sh` consists of several sub-scripts like `rust_fmt.sh`, they're all extended with auto-fix feature through `--write` flag, and the `rust_lint.sh` is optionally calling them with an additional flag for auto fixes. - Clean up `rust_lint.sh` ## Are these changes tested? <!-- We typically require tests for all PRs in order to: 1. Prevent the code from being accidentally broken by subsequent changes 2. Serve as another way to document the expected behavior of the code If tests are not included in your PR, please explain why (for example, are they covered by existing tests)? --> Yes, commit 8c99417 intentionally introduced one violation for each available lint check, and the auto-fix command is able to fix all of them. The test may not be comprehensive, but it provides a reasonable starting point. We can begin using this script now and iterate on it if we discover cases where the auto-fix does not behave correctly. ## Are there any user-facing changes? No <!-- If there are user-facing changes then we may require documentation to be updated before approving the PR. --> <!-- If there are any breaking changes to public APIs, please add the `api change` label. -->
Which issue does this PR close?
Part of #19227
Rationale for this change
See issue for details.
The existing script
./dev/rust_lint.shdo checks for all non-functional tests include formater/clippy checks.Some check tools support auto fix options, so this PR add an option to the lint scripts to perform auto-fixes.
Now
./dev/rust_lint.sh --write --allow-dirtycan perform auto-fixes for all linter etc. violationsWhat changes are included in this PR?
[--write] [--allow-dirty]flag torust_lint.shto support auto fixesrust_lint.shconsists of several sub-scripts likerust_fmt.sh, they're all extended with auto-fix feature through--writeflag, and therust_lint.shis optionally calling them with an additional flag for auto fixes.rust_lint.shAre these changes tested?
Yes, commit 8c99417 intentionally introduced one violation for each available lint check, and the auto-fix command is able to fix all of them.
The test may not be comprehensive, but it provides a reasonable starting point. We can begin using this script now and iterate on it if we discover cases where the auto-fix does not behave correctly.
Are there any user-facing changes?
No