[flake8-todos] Allow words starting with todo
#13640
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
| code | total | + violation | - violation | + fix | - fix |
|---|---|---|---|---|---|
| COM812 | 228 | 0 | 228 | 0 | 0 |
| S101 | 212 | 0 | 212 | 0 | 0 |
| ERA001 | 173 | 0 | 173 | 0 | 0 |
| D102 | 126 | 0 | 126 | 0 | 0 |
| E501 | 90 | 0 | 90 | 0 | 0 |
| D103 | 80 | 0 | 80 | 0 | 0 |
| D101 | 61 | 0 | 61 | 0 | 0 |
| FBT001 | 44 | 0 | 44 | 0 | 0 |
| TRY003 | 43 | 0 | 43 | 0 | 0 |
| D300 | 32 | 0 | 32 | 0 | 0 |
| PLR2004 | 31 | 0 | 31 | 0 | 0 |
| D210 | 31 | 0 | 31 | 0 | 0 |
| ANN001 | 29 | 0 | 29 | 0 | 0 |
| Q002 | 29 | 0 | 29 | 0 | 0 |
| D107 | 28 | 0 | 28 | 0 | 0 |
| FBT002 | 27 | 0 | 27 | 0 | 0 |
| EM101 | 27 | 0 | 27 | 0 | 0 |
| EM102 | 19 | 0 | 19 | 0 | 0 |
| RET505 | 18 | 0 | 18 | 0 | 0 |
| C901 | 18 | 0 | 18 | 0 | 0 |
| FIX002 | 17 | 0 | 17 | 0 | 0 |
| TD002 | 17 | 0 | 17 | 0 | 0 |
| TD003 | 17 | 0 | 17 | 0 | 0 |
| D205 | 15 | 0 | 15 | 0 | 0 |
| D212 | 14 | 0 | 14 | 0 | 0 |
| RET504 | 13 | 0 | 13 | 0 | 0 |
| PLR0912 | 13 | 0 | 13 | 0 | 0 |
| ANN201 | 11 | 0 | 11 | 0 | 0 |
| N806 | 11 | 0 | 11 | 0 | 0 |
| ARG001 | 10 | 0 | 10 | 0 | 0 |
| D400 | 10 | 0 | 10 | 0 | 0 |
| D415 | 10 | 0 | 10 | 0 | 0 |
| B904 | 10 | 0 | 10 | 0 | 0 |
| PLR0913 | 9 | 0 | 9 | 0 | 0 |
| PLR0915 | 9 | 0 | 9 | 0 | 0 |
| FIX004 | 9 | 0 | 9 | 0 | 0 |
| RUF012 | 8 | 0 | 8 | 0 | 0 |
| E402 | 7 | 0 | 7 | 0 | 0 |
| SIM103 | 6 | 0 | 6 | 0 | 0 |
| FBT003 | 6 | 0 | 6 | 0 | 0 |
| PT018 | 6 | 0 | 6 | 0 | 0 |
| A001 | 6 | 0 | 6 | 0 | 0 |
| PTH118 | 5 | 0 | 5 | 0 | 0 |
| S105 | 5 | 0 | 5 | 0 | 0 |
| TCH002 | 5 | 0 | 5 | 0 | 0 |
| D200 | 5 | 0 | 5 | 0 | 0 |
| PLR0911 | 5 | 0 | 5 | 0 | 0 |
| B008 | 5 | 0 | 5 | 0 | 0 |
| D401 | 5 | 0 | 5 | 0 | 0 |
| D202 | 5 | 0 | 5 | 0 | 0 |
| BLE001 | 4 | 0 | 4 | 0 | 0 |
| TID252 | 4 | 0 | 4 | 0 | 0 |
| SIM114 | 4 | 0 | 4 | 0 | 0 |
| N802 | 3 | 0 | 3 | 0 | 0 |
| ANN401 | 3 | 0 | 3 | 0 | 0 |
| TCH001 | 3 | 0 | 3 | 0 | 0 |
| E741 | 3 | 0 | 3 | 0 | 0 |
| SIM108 | 3 | 0 | 3 | 0 | 0 |
| RET506 | 3 | 0 | 3 | 0 | 0 |
| D209 | 3 | 0 | 3 | 0 | 0 |
| B007 | 3 | 0 | 3 | 0 | 0 |
| PLW0603 | 3 | 0 | 3 | 0 | 0 |
| PT006 | 2 | 0 | 2 | 0 | 0 |
| PTH123 | 2 | 0 | 2 | 0 | 0 |
| Q000 | 2 | 0 | 2 | 0 | 0 |
| ARG002 | 2 | 0 | 2 | 0 | 0 |
| TRY301 | 2 | 0 | 2 | 0 | 0 |
| D100 | 2 | 0 | 2 | 0 | 0 |
| TRY300 | 2 | 0 | 2 | 0 | 0 |
| DTZ001 | 1 | 0 | 1 | 0 | 0 |
| ANN202 | 1 | 0 | 1 | 0 | 0 |
| RUF100 | 1 | 0 | 1 | 0 | 0 |
| TCH003 | 1 | 0 | 1 | 0 | 0 |
| UP035 | 1 | 0 | 1 | 0 | 0 |
| ARG005 | 1 | 0 | 1 | 0 | 0 |
| PTH111 | 1 | 0 | 1 | 0 | 0 |
| D105 | 1 | 0 | 1 | 0 | 0 |
| TRY201 | 1 | 0 | 1 | 0 | 0 |
| SLF001 | 1 | 0 | 1 | 0 | 0 |
| RUF001 | 1 | 0 | 1 | 0 | 0 |
| PT017 | 1 | 0 | 1 | 0 | 0 |
| TRY400 | 1 | 0 | 1 | 0 | 0 |
| TD004 | 1 | 0 | 1 | 0 | 0 |
| PLR5501 | 1 | 0 | 1 | 0 | 0 |
| D413 | 1 | 0 | 1 | 0 | 0 |
| PLW2901 | 1 | 0 | 1 | 0 | 0 |
| D104 | 1 | 0 | 1 | 0 | 0 |
| D404 | 1 | 0 | 1 | 0 | 0 |
| RET508 | 1 | 0 | 1 | 0 | 0 |
Linter (preview)
ℹ️ ecosystem check detected linter changes. (+0 -1857 violations, +0 -0 fixes in 4 projects; 50 projects unchanged)
apache/airflow (+0 -95 violations, +0 -0 fixes)
ruff check --no-cache --exit-zero --ignore RUF9 --output-format concise --preview --select ALL
- providers/tests/system/google/cloud/cloud_sql/example_cloud_sql.py:114:6: COM812 [*] Trailing comma missing - providers/tests/system/google/cloud/cloud_sql/example_cloud_sql.py:122:6: COM812 [*] Trailing comma missing - providers/tests/system/google/cloud/cloud_sql/example_cloud_sql.py:138:16: DTZ001 `datetime.datetime()` called without a `tzinfo` argument - providers/tests/system/google/cloud/cloud_sql/example_cloud_sql.py:143:107: COM812 [*] Trailing comma missing - providers/tests/system/google/cloud/cloud_sql/example_cloud_sql.py:152:78: COM812 [*] Trailing comma missing - providers/tests/system/google/cloud/cloud_sql/example_cloud_sql.py:162:83: COM812 [*] Trailing comma missing - providers/tests/system/google/cloud/cloud_sql/example_cloud_sql.py:168:82: COM812 [*] Trailing comma missing ... 10 additional changes omitted for rule COM812 - providers/tests/system/google/cloud/cloud_sql/example_cloud_sql.py:1:1: CPY001 Missing copyright notice at top of file - tests/www/views/test_views_dataset.py:103:40: PLR2004 Magic value used in comparison, consider replacing `400` with a constant variable - tests/www/views/test_views_dataset.py:108:40: PLR2004 Magic value used in comparison, consider replacing `400` with a constant variable ... 85 additional changes omitted for project
apache/superset (+0 -250 violations, +0 -0 fixes)
ruff check --no-cache --exit-zero --ignore RUF9 --output-format concise --preview --select ALL
- superset/config.py:1004:21: RUF012 Mutable class attributes should be annotated with `typing.ClassVar` - superset/config.py:1015:9: ERA001 Found commented-out code - superset/config.py:1016:9: ERA001 Found commented-out code - superset/config.py:1017:9: ERA001 Found commented-out code - superset/config.py:1018:9: ERA001 Found commented-out code - superset/config.py:1026:1: ERA001 Found commented-out code - superset/config.py:105:1: ERA001 Found commented-out code ... 167 additional changes omitted for rule ERA001 - superset/config.py:1068:89: E501 Line too long (90 > 88) - superset/config.py:1089:64: COM812 [*] Trailing comma missing - superset/config.py:1139:5: D103 Missing docstring in public function ... 240 additional changes omitted for project
bokeh/bokeh (+0 -180 violations, +0 -0 fixes)
ruff check --no-cache --exit-zero --ignore RUF9 --output-format concise --preview --select ALL
- src/bokeh/colors/color.py:116:9: D210 [*] No whitespaces allowed surrounding docstring text - src/bokeh/colors/color.py:116:9: D300 [*] Use triple double quotes `"""` - src/bokeh/colors/color.py:116:9: Q002 [*] Single quote docstring found but double quotes preferred - src/bokeh/colors/color.py:11:1: E265 [*] Block comment should start with `# ` - src/bokeh/colors/color.py:133:9: D210 [*] No whitespaces allowed surrounding docstring text - src/bokeh/colors/color.py:133:9: D300 [*] Use triple double quotes `"""` - src/bokeh/colors/color.py:133:9: Q002 [*] Single quote docstring found but double quotes preferred - src/bokeh/colors/color.py:13:1: E265 [*] Block comment should start with `# ` - src/bokeh/colors/color.py:148:9: D210 [*] No whitespaces allowed surrounding docstring text - src/bokeh/colors/color.py:148:9: D300 [*] Use triple double quotes `"""` ... 170 additional changes omitted for project
zulip/zulip (+0 -1332 violations, +0 -0 fixes)
ruff check --no-cache --exit-zero --ignore RUF9 --output-format concise --preview --select ALL
- corporate/lib/stripe.py:1000:57: COM812 [*] Trailing comma missing - corporate/lib/stripe.py:1005:9: D102 Missing docstring in public method - corporate/lib/stripe.py:1009:9: D102 Missing docstring in public method - corporate/lib/stripe.py:1013:9: D102 Missing docstring in public method - corporate/lib/stripe.py:1017:9: D102 Missing docstring in public method - corporate/lib/stripe.py:1021:9: D102 Missing docstring in public method - corporate/lib/stripe.py:1037:9: D102 Missing docstring in public method ... 120 additional changes omitted for rule D102 - corporate/lib/stripe.py:1038:9: SIM103 Return the condition directly - corporate/lib/stripe.py:1042:9: PLR6301 Method `get_remote_server_legacy_plan` could be a function, class method, or static method - corporate/lib/stripe.py:1043:75: COM812 [*] Trailing comma missing - corporate/lib/stripe.py:1046:101: E501 Line too long (116 > 100) - corporate/lib/stripe.py:1057:75: COM812 [*] Trailing comma missing - corporate/lib/stripe.py:1063:9: S101 Use of `assert` detected - corporate/lib/stripe.py:1068:64: COM812 [*] Trailing comma missing - corporate/lib/stripe.py:1074:9: S101 Use of `assert` detected - corporate/lib/stripe.py:1099:16: RET504 Unnecessary assignment to `customer` before `return` statement - corporate/lib/stripe.py:1103:61: FBT001 Boolean-typed positional argument in function definition - corporate/lib/stripe.py:1103:61: FBT002 Boolean default positional argument in function definition - corporate/lib/stripe.py:1103:87: COM812 [*] Trailing comma missing - corporate/lib/stripe.py:1106:92: COM812 [*] Trailing comma missing ... 197 additional changes omitted for rule COM812 - corporate/lib/stripe.py:111:5: D103 Missing docstring in public function - corporate/lib/stripe.py:1128:101: E501 Line too long (104 > 100) - corporate/lib/stripe.py:1130:13: S101 Use of `assert` detected - corporate/lib/stripe.py:1137:86: FBT003 Boolean positional value in function call - corporate/lib/stripe.py:1144:9: D205 1 blank line required between summary line and description - corporate/lib/stripe.py:1144:9: D212 [*] Multi-line docstring summary should start at the first line - corporate/lib/stripe.py:1145:101: E501 Line too long (101 > 100) - corporate/lib/stripe.py:114:5: SIM108 Use ternary operator `precision = 0 if cents % 100 == 0 else 2` instead of `if`-`else`-block - corporate/lib/stripe.py:1150:9: PT018 Assertion should be broken down into multiple parts - corporate/lib/stripe.py:1150:9: S101 Use of `assert` detected - corporate/lib/stripe.py:1157:19: DOC501 Raised exception `BillingError` missing from docstring - corporate/lib/stripe.py:1157:19: TRY003 Avoid specifying long messages outside the exception class - corporate/lib/stripe.py:1158:17: EM101 Exception must not use a string literal, assign to variable first - corporate/lib/stripe.py:1163:13: S101 Use of `assert` detected - corporate/lib/stripe.py:1164:13: S101 Use of `assert` detected ... 207 additional changes omitted for rule S101 ... 1297 additional changes omitted for project
Changes by rule (112 rules affected)
| code | total | + violation | - violation | + fix | - fix |
|---|---|---|---|---|---|
| COM812 | 228 | 0 | 228 | 0 | 0 |
| S101 | 212 | 0 | 212 | 0 | 0 |
| ERA001 | 173 | 0 | 173 | 0 | 0 |
| D102 | 126 | 0 | 126 | 0 | 0 |
| E501 | 90 | 0 | 90 | 0 | 0 |
| D103 | 80 | 0 | 80 | 0 | 0 |
| D101 | 61 | 0 | 61 | 0 | 0 |
| FBT001 | 44 | 0 | 44 | 0 | 0 |
| TRY003 | 43 | 0 | 43 | 0 | 0 |
| D300 | 32 | 0 | 32 | 0 | 0 |
| PLR2004 | 31 | 0 | 31 | 0 | 0 |
| D210 | 31 | 0 | 31 | 0 | 0 |
| ANN001 | 29 | 0 | 29 | 0 | 0 |
| Q002 | 29 | 0 | 29 | 0 | 0 |
| D107 | 28 | 0 | 28 | 0 | 0 |
| FBT002 | 27 | 0 | 27 | 0 | 0 |
| EM101 | 27 | 0 | 27 | 0 | 0 |
| PLR6301 | 26 | 0 | 26 | 0 | 0 |
| E226 | 24 | 0 | 24 | 0 | 0 |
| EM102 | 19 | 0 | 19 | 0 | 0 |
| PLR6201 | 19 | 0 | 19 | 0 | 0 |
| RET505 | 18 | 0 | 18 | 0 | 0 |
| C901 | 18 | 0 | 18 | 0 | 0 |
| FIX002 | 17 | 0 | 17 | 0 | 0 |
| TD002 | 17 | 0 | 17 | 0 | 0 |
| TD003 | 17 | 0 | 17 | 0 | 0 |
| E265 | 16 | 0 | 16 | 0 | 0 |
| D205 | 15 | 0 | 15 | 0 | 0 |
| D212 | 14 | 0 | 14 | 0 | 0 |
| RET504 | 13 | 0 | 13 | 0 | 0 |
| PLR0912 | 13 | 0 | 13 | 0 | 0 |
| DOC201 | 12 | 0 | 12 | 0 | 0 |
| ANN201 | 11 | 0 | 11 | 0 | 0 |
| N806 | 11 | 0 | 11 | 0 | 0 |
| ARG001 | 10 | 0 | 10 | 0 | 0 |
| D400 | 10 | 0 | 10 | 0 | 0 |
| D415 | 10 | 0 | 10 | 0 | 0 |
| B904 | 10 | 0 | 10 | 0 | 0 |
| PLR0914 | 10 | 0 | 10 | 0 | 0 |
| PLR0913 | 9 | 0 | 9 | 0 | 0 |
| PLR0917 | 9 | 0 | 9 | 0 | 0 |
| PLR0915 | 9 | 0 | 9 | 0 | 0 |
| FIX004 | 9 | 0 | 9 | 0 | 0 |
| PLC1901 | 9 | 0 | 9 | 0 | 0 |
| RUF012 | 8 | 0 | 8 | 0 | 0 |
| E402 | 7 | 0 | 7 | 0 | 0 |
| CPY001 | 6 | 0 | 6 | 0 | 0 |
| SIM103 | 6 | 0 | 6 | 0 | 0 |
| FBT003 | 6 | 0 | 6 | 0 | 0 |
| PT018 | 6 | 0 | 6 | 0 | 0 |
| F841 | 6 | 0 | 6 | 0 | 0 |
| A001 | 6 | 0 | 6 | 0 | 0 |
| PTH118 | 5 | 0 | 5 | 0 | 0 |
| S105 | 5 | 0 | 5 | 0 | 0 |
| TCH002 | 5 | 0 | 5 | 0 | 0 |
| D200 | 5 | 0 | 5 | 0 | 0 |
| PLR0911 | 5 | 0 | 5 | 0 | 0 |
| PLC0415 | 5 | 0 | 5 | 0 | 0 |
| B008 | 5 | 0 | 5 | 0 | 0 |
| PLR0904 | 5 | 0 | 5 | 0 | 0 |
| D401 | 5 | 0 | 5 | 0 | 0 |
| D202 | 5 | 0 | 5 | 0 | 0 |
| BLE001 | 4 | 0 | 4 | 0 | 0 |
| DOC501 | 4 | 0 | 4 | 0 | 0 |
| TID252 | 4 | 0 | 4 | 0 | 0 |
| SIM114 | 4 | 0 | 4 | 0 | 0 |
| N802 | 3 | 0 | 3 | 0 | 0 |
| ANN401 | 3 | 0 | 3 | 0 | 0 |
| TCH001 | 3 | 0 | 3 | 0 | 0 |
| E741 | 3 | 0 | 3 | 0 | 0 |
| E302 | 3 | 0 | 3 | 0 | 0 |
| SIM108 | 3 | 0 | 3 | 0 | 0 |
| RET506 | 3 | 0 | 3 | 0 | 0 |
| D209 | 3 | 0 | 3 | 0 | 0 |
| B007 | 3 | 0 | 3 | 0 | 0 |
| PLW0603 | 3 | 0 | 3 | 0 | 0 |
| PT006 | 2 | 0 | 2 | 0 | 0 |
| PLW1514 | 2 | 0 | 2 | 0 | 0 |
| PTH123 | 2 | 0 | 2 | 0 | 0 |
| Q000 | 2 | 0 | 2 | 0 | 0 |
| ARG002 | 2 | 0 | 2 | 0 | 0 |
| TRY301 | 2 | 0 | 2 | 0 | 0 |
| D100 | 2 | 0 | 2 | 0 | 0 |
| TRY300 | 2 | 0 | 2 | 0 | 0 |
| DTZ001 | 1 | 0 | 1 | 0 | 0 |
| ANN202 | 1 | 0 | 1 | 0 | 0 |
| RUF100 | 1 | 0 | 1 | 0 | 0 |
| TCH003 | 1 | 0 | 1 | 0 | 0 |
| UP035 | 1 | 0 | 1 | 0 | 0 |
| PLC2701 | 1 | 0 | 1 | 0 | 0 |
| ARG005 | 1 | 0 | 1 | 0 | 0 |
| PTH111 | 1 | 0 | 1 | 0 | 0 |
| E261 | 1 | 0 | 1 | 0 | 0 |
| FURB180 | 1 | 0 | 1 | 0 | 0 |
| D105 | 1 | 0 | 1 | 0 | 0 |
| TRY201 | 1 | 0 | 1 | 0 | 0 |
| SLF001 | 1 | 0 | 1 | 0 | 0 |
| RUF001 | 1 | 0 | 1 | 0 | 0 |
| PT017 | 1 | 0 | 1 | 0 | 0 |
| TRY400 | 1 | 0 | 1 | 0 | 0 |
| TD004 | 1 | 0 | 1 | 0 | 0 |
| PLR5501 | 1 | 0 | 1 | 0 | 0 |
| D413 | 1 | 0 | 1 | 0 | 0 |
| PLW2901 | 1 | 0 | 1 | 0 | 0 |
| FURB145 | 1 | 0 | 1 | 0 | 0 |
| S405 | 1 | 0 | 1 | 0 | 0 |
| PLR0916 | 1 | 0 | 1 | 0 | 0 |
| D104 | 1 | 0 | 1 | 0 | 0 |
| D404 | 1 | 0 | 1 | 0 | 0 |
| PLR1702 | 1 | 0 | 1 | 0 | 0 |
| RET508 | 1 | 0 | 1 | 0 | 0 |
| FURB118 | 1 | 0 | 1 | 0 | 0 |
|
The ecosystem changes have a mix of new false negatives: and fixed false positives: |
|
Hmm, the question is if "Hacky" is used as a tag, or just being a word. In that regard |
MichaReiser
requested changes
Oct 7, 2024
There was a problem hiding this comment.
The change makes sense to me. Although our settings aren't very explicit about what "starting" means:
Comments starting with these tags will be ignored by commented-out code detection (ERA), and skipped by line-length rules (E501) if ignore-overlong-task-comments is set to true.
https://docs.astral.sh/ruff/settings/#lint_task-tags
What surprised me is that this not only changes the behavior of flake8-todos but also flake8-fixme
Flake8-fixme only tests for the use of task tags at word boundaries.
https://github.com/tommilligan/flake8-fixme/blob/master/flake8_fixme/__init__.py
I think we can simplify the implementation, see my inline comment.
crates/ruff_linter/src/directives.rs
Outdated
| for length in [3, 4, 5] { | ||
| let Some(substr) = s.get(..length) else { | ||
| break; | ||
| }; | ||
|
|
||
| if s.len() > length { |
There was a problem hiding this comment.
Nit: I would change the from_str implementation to do a direct match on the string (instead of selecting the substring) and instead split by word boundaries here:
ruff/crates/ruff_linter/src/directives.rs
Line 302 in 8f40928
That should simplify the implementation
There was a problem hiding this comment.
I don't quite understand, sorry (Maybe my Rust knowledge is not good enough)
There was a problem hiding this comment.
I'm proposing a small rewrite because I think it will simplify the overall code now that we make the change here.
What I propose is that FromStr does a full match (matching the entire string and not just a prefix). So from_str becomes something like this:
match s.to_lowercase().as_str() {
"fixme" => {
Ok(TodoDirectiveKind::Fixme)
}
"hack" => {
Ok(TodoDirectiveKind::Hack)
}
"todo" => {
Ok(TodoDirectiveKind::Todo)
}
"xxx" => {
Ok(TodoDirectiveKind::Xxx)
}
_ =>Err(()),
}This does require that we change the one call site to implement the: split by word boundaries (whitespace) and we only pass the first word to FromStr
There was a problem hiding this comment.
I have applied your suggestion.
# for free
to join this conversation on GitHub.
Already have an account?
# to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Allow words which start with "todo" or other todo-directives
Fixes #13638
Test Plan
Updated snapshots