-
Notifications
You must be signed in to change notification settings - Fork 1.1k
New issue
Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? # to your account
Remove error messages for removed CLI aliases #12833
Conversation
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We could keep the error messages around a little longer. It's not a lot of code but I would also expect that most users have migrated at this time (unless they skip 0.5)
I'd lean towards keeping these for another minor release, but I don't feel strongly
Like until 0.7.0? |
yes |
Are you sure you won't feel the same. IMO, we should either not remove the messages until like 1.0 or go ahead with it. |
Yeah, pretty sure :P With a one-month period, I feel like folks who aren't super speedy in updating their dependencies could easily just bump their Ruff pin from 0.4 to 0.6 and never see the nice error message we're giving them right now. Doubling the period to two months doesn't get rid of that risk (nothing can), but I feel like there'll be substantially fewer people falling into that bucket. Again, though, I don't feel strongly. They've been deprecated for ages and this abides by our versioning scheme. |
This isn't that much code to keep around for another cycle 🤷♀️ |
I don't really agree with this. I don't think we should special-case 1.0. |
That's not my concern. My concern is that we keep spending time debating the same. That's why I rather postpone the removal indefinitely because the win of removing is very minimal (with the exception of |
Sounds like Alex and I have loosely held opinions, maybe make the decision based on code maintenance? I agree we shouldn't discuss it every cycle: we should set a future milestone and stick to it unless we're getting clear feedback from the community that it is incorrect. We can also always revert (restore the helpful error) if we get reports from confused users. Regardless, I think you should do what you think is best here. |
Just stumbling upon this PR... as a more long-term solution, it might be nice if there were a general mechanism that checks whether an unknown flag matches a subcommand, and then to suggest that subcommand in the error message. Could even be checking if there is a match with a small edit distance. |
b6baabe
to
b244215
Compare
Summary
This PR removes the following CLI aliases:
ruff <path>
toruff check <path>
ruff --explain
toruff rule
ruff --clean
toruff clean
ruff --generate-shell-completion
toruff generate-shell-completion
The aliases are deprecated since Ruff 0.3 and using them became a hard error in 0.5.
Closes #10171
Test Plan
I tested that using any of the aliases becomes a hard error.
Alternatives
We could keep the error messages around a little longer. It's not a lot of code but I would also expect that most users have migrated at this time (unless they skip 0.5)