Skip to content

Commit

Permalink
Update docs for E711, E712 (#4560) (#11859)
Browse files Browse the repository at this point in the history
  • Loading branch information
psychedelicious committed Jun 18, 2024
1 parent 1e0642f commit 104608b
Showing 1 changed file with 17 additions and 1 deletion.
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ impl EqCmpOp {
///
/// ## Why is this bad?
/// According to [PEP 8], "Comparisons to singletons like None should always be done with
/// is or is not, never the equality operators."
/// `is` or `is not`, never the equality operators."
///
/// ## Example
/// ```python
Expand All @@ -48,7 +48,15 @@ impl EqCmpOp {
/// pass
/// ```
///
/// ## Fix safety
///
/// This rule's fix is marked as unsafe, as it may alter runtime behavior when
/// used with libraries that override the `==`/`__eq__` or `!=`/`__ne__` operators.
/// In these cases, `is`/`is not` may not be equivalent to `==`/`!=`. For more
/// information, see [this issue].
///
/// [PEP 8]: https://peps.python.org/pep-0008/#programming-recommendations
/// [this issue]: https://github.com/astral-sh/ruff/issues/4560
#[violation]
pub struct NoneComparison(EqCmpOp);

Expand Down Expand Up @@ -101,7 +109,15 @@ impl AlwaysFixableViolation for NoneComparison {
/// ...
/// ```
///
/// ## Fix safety
///
/// This rule's fix is marked as unsafe, as it may alter runtime behavior when
/// used with libraries that override the `==`/`__eq__` or `!=`/`__ne__` operators.
/// In these cases, `is`/`is not` may not be equivalent to `==`/`!=`. For more
/// information, see [this issue].
///
/// [PEP 8]: https://peps.python.org/pep-0008/#programming-recommendations
/// [this issue]: https://github.com/astral-sh/ruff/issues/4560
#[violation]
pub struct TrueFalseComparison {
value: bool,
Expand Down

0 comments on commit 104608b

Please sign in to comment.