Ruleset: hard deprecate $supportedTokenizers set to CSS/JS only #894
Conversation
src/Ruleset.php
Outdated
| @@ -1470,13 +1472,30 @@ public function populateTokenListeners() | |||
|
|
|||
| $tokenizers = []; | |||
| $vars = get_class_vars($sniffClass); | |||
| if (isset($vars['supportedTokenizers']) === true) { | |||
| if (empty($vars['supportedTokenizers']) === false) { | |||
There was a problem hiding this comment.
As this is a deprecation not a feature removal, we shouldn't be changing the behaviour. With the isset() check, it looks like an empty array would mean that a sniff would never run, whereas now that we're checking for empty(), that empty array value gets rewritten to PHP (in the else clause here).
There was a problem hiding this comment.
Good point - I made the change to avoid a deprecation notice being thrown for the property being set to an empty array - which is not terribly useful, but not something problematic either. This is tested via the ListensForEmptySniff test case.
But you're right, this does change the behaviour, so maybe the deprecation notice should be wrapped in its own conditions, independently of the conditions registering the tokenizers for the sniff.
What do you think ?
There was a problem hiding this comment.
I've update the PR with the above. Let me know what you think.
jrfnl
force-pushed
the
feature/188-deprecate-all-sniffs-removed-in-4.0
branch
from
0304898 to
dd7257e
Compare
Support for the JS and CSS Tokenizers will be removed in PHPCS 4.0. This was announced in squizlabs/PHP_CodeSniffer 2448 and has been formalized via a soft deprecation (documentation and changelog only) in the PHPCS 3.9.0 release (see 276). This commit implements a deprecation notice to alert sniff maintainers and ruleset maintainers to sniffs which are exclusively aimed at CSS and/or JS files. This deprecation notice will not be shown if the sniff is formally deprecated via an implementation of the `DeprecatedSniff` interface (to prevent duplicate notifications). Refs: * https://github.com/PHPCSStandards/PHP_CodeSniffer/releases/tag/3.3.0 Fixes 740 Includes an update to two tests in the `PopulateTokenListenersTest` to make these use one of the newly introduced fixtures to make these tests less dependent on the actual sniffs in PHPCS.
jrfnl
force-pushed
the
feature/740-ruleset-show-deprecation-sniffs-scanning-js-css-files
branch
from
ba8ae35 to
bf6c4b2
Compare
|
Rebased without changes before merging. |
jrfnl
deleted the
feature/740-ruleset-show-deprecation-sniffs-scanning-js-css-files
branch
Description
Support for the JS and CSS Tokenizers will be removed in PHPCS 4.0.
This was announced in squizlabs/PHP_CodeSniffer#2448 and has been formalized via a soft deprecation (documentation and changelog only) in the PHPCS 3.9.0 release (see #276).
This commit implements a deprecation notice to alert sniff maintainers and ruleset maintainers to sniffs which are exclusively aimed at CSS and/or JS files.
This deprecation notice will not be shown if the sniff is formally deprecated via an implementation of the
DeprecatedSniffinterface (to prevent duplicate notifications).Refs:
Includes an update to two tests in the
PopulateTokenListenersTestto make these use one of the newly introduced fixtures to make these tests less dependent on the actual sniffs in PHPCS.Suggested changelog entry
Added deprecation notices (hard deprecation) for:
Related issues/external references
Fixes #740