-
-
Notifications
You must be signed in to change notification settings - Fork 89
Generic/Todo-Fixme sniffs: improve handling of docblock tags and efficiency fix #53
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
Conversation
This file contains hidden or 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
@github-actions
github-actions
bot
added
Focus: Comments/Docblocks
Standard: Generic
labels
Nov 9, 2023
@jrfnl
jrfnl
force-pushed
the
feature/3769-improve-todo-fixme-sniffs
branch
from
November 11, 2023 03:35
4b9da4f to
120c223
Compare
@jrfnl
jrfnl
force-pushed
the
feature/3769-improve-todo-fixme-sniffs
branch
from
December 7, 2023 16:08
120c223 to
1f2e665
Compare
@jrfnl
jrfnl
force-pushed
the
feature/3769-improve-todo-fixme-sniffs
branch
from
December 8, 2023 05:04
1f2e665 to
8b6cceb
Compare
The sniffs as-they-were, would sniff all comment related tokens, including `T_DOC_COMMENT_STAR`, `T_DOC_COMMENT_WHITESPACE` etc. Sniffing those tokens is redundant and makes the sniffs slower than is needed. Fixed now by making the tokens being registered by the sniffs more selective/targetted.
Until now, the sniff would only examine an individual comment token, while when a `@todo` tag is used in a docblock, the "task description" is normally in the next `T_DOC_COMMENT_STRING` token. This commit fixes this and the sniff will now take docblock `@todo` tags into account. Includes additional unit tests.
Essentially the same fix as applied in the sister-commit for the `Generic.Commenting.Todo` sniff. Until now, the sniff would only examine an individual comment token, while when a `@fixme` tag is used in a docblock, the "task description" is normally in the next `T_DOC_COMMENT_STRING` token. This commit fixes this and the sniff will now take docblock `@fixme` tags into account. Includes additional unit tests.
@jrfnl
jrfnl
force-pushed
the
feature/3769-improve-todo-fixme-sniffs
branch
from
December 26, 2023 01:00
8b6cceb to
0f89212
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in 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.
Description
Recreation of upstream PR squizlabs/PHP_CodeSniffer#3771:
Suggested changelog entry