Add preview note to unnecessary-comprehension-in-call (#12673)

This commit is contained in:
Charlie Marsh 2024-08-04 22:27:00 -04:00 committed by GitHub
parent 25aabec814
commit 3497f5257b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -14,9 +14,9 @@ use crate::rules::flake8_comprehensions::fixes;
/// Checks for unnecessary list comprehensions passed to builtin functions that take an iterable. /// Checks for unnecessary list comprehensions passed to builtin functions that take an iterable.
/// ///
/// ## Why is this bad? /// ## Why is this bad?
/// Many builtin functions (this rule currently covers `any`, `all`, `min`, `max`, and `sum`) take /// Many builtin functions (this rule currently covers `any` and `all` in stable, along with `min`,
/// any iterable, including a generator. Constructing a temporary list via list comprehension is /// `max`, and `sum` in [preview]) accept any iterable, including a generator. Constructing a
/// unnecessary and wastes memory for large iterables. /// temporary list via list comprehension is unnecessary and wastes memory for large iterables.
/// ///
/// `any` and `all` can also short-circuit iteration, saving a lot of time. The unnecessary /// `any` and `all` can also short-circuit iteration, saving a lot of time. The unnecessary
/// comprehension forces a full iteration of the input iterable, giving up the benefits of /// comprehension forces a full iteration of the input iterable, giving up the benefits of
@ -63,6 +63,7 @@ use crate::rules::flake8_comprehensions::fixes;
/// has side effects (due to laziness and short-circuiting). The fix may also drop comments when /// has side effects (due to laziness and short-circuiting). The fix may also drop comments when
/// rewriting some comprehensions. /// rewriting some comprehensions.
/// ///
/// [preview]: https://docs.astral.sh/ruff/preview/
#[violation] #[violation]
pub struct UnnecessaryComprehensionInCall; pub struct UnnecessaryComprehensionInCall;