Deprecate ruff <path> ruff --explain, ruff --clean and ruff --generate-shell-completion

[MichaReiser]

Summary

Deprecate ruff <path> ruff --explain, ruff --clean and ruff --generate-shell-completion in favor of ruff check <path>, ruff rule, ruff clean and ruff generate-shell-completion.

Closes #9692

Test Plan

--clean

./target/debug/ruff --clean
warning: `ruff --clean` is deprecated. Use `ruff clean` instead.
Removing cache at: .ruff_cache

❯ ./target/debug/ruff clean

--generate-shell-completion

❯ ./target/debug/ruff --generate-shell-completion fish > /dev/null
warning: `ruff --generate-shell-completion <SHELL>` is deprecated. Use `ruff generate-shell-completion <SHELL>` instead.


❯ ./target/debug/ruff generate-shell-completion fish > /dev/null

ruff --explain

❯ ./target/debug/ruff --explain RUF001
warning: `ruff --explain <RULE>` is deprecated. Use `ruff rule <RULE>` instead.
# ambiguous-unicode-character-string (RUF001)

Derived from the **Ruff-specific rules** linter.

...

❯ ./target/debug/ruff rule RUF001
# ambiguous-unicode-character-string (RUF001)

ruff

❯ ./target/debug/ruff .
warning: `ruff <path>` is deprecated. Use `ruff check <path>` instead.
warning: Detected debug build without --no-cache.
warning: The top-level linter settings are deprecated in favour of their counterparts in the `lint` section. Please update the following options in `crates/ruff/resources/test/fixtures/include-test/nested-project/pyproject.toml`:
  - 'select' -> 'lint.select'

❯ ./target/debug/ruff check  .
warning: Detected debug build without --no-cache.
warning: The top-level linter settings are deprecated in favour of their counterparts in the `lint` section. Please update the following options in `crates/ruff/resources/test/fixtures/include-test/nested-project/pyproject.toml`:
  - 'select' -> 'lint.select'

[github-actions]

ruff-ecosystem results

Linter (stable)

✅ ecosystem check detected no linter changes.

Linter (preview)

✅ ecosystem check detected no linter changes.

[charliermarsh]

I’ll check, but this one might be used in our Homebrew formula. (Which is ok.)

[MichaReiser]

Looks good https://github.com/Homebrew/homebrew-core/blob/cfad11e82cc27ed035268a13082278a576bcdb8a/Formula/r/ruff.rb#L23