-
Notifications
You must be signed in to change notification settings - Fork 160
#142 : [New Rule] No imports from static tests namespaces #149
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
Merged
lenaorobei
merged 6 commits into
magento:develop
from
konarshankar07:142-import-test-rule
Dec 11, 2019
Merged
Changes from all commits
Commits
Show all changes
6 commits
Select commit
Hold shift + click to select a range
9185a9f
import static test ruleset
konarshankar07 80bfe89
Readme file and feedback changes
konarshankar07 975977d
Sniff added for grouped namespace
konarshankar07 61c5bae
Merge branch 'develop' into 142-import-test-rule
ihor-sviziev 199057a
magento/magento-coding-standard#149 No imports from test namespace
ihor-sviziev 4040cd5
magento/magento-coding-standard#142: [New Rule] No imports from stati…
lenaorobei File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
13 changes: 13 additions & 0 deletions
13
Magento2/Sniffs/Namespaces/ImportsFromTestNamespaceSniff.md
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
# Rule: Do not import from `Test` namespaces | ||
## Background | ||
Sometimes IDE imports the namespace with `Test` automatically for return data type like string, float etc or any other means. | ||
|
||
## Reasoning | ||
Time to time we're getting issue with running tests on PRs in magento/magento2 repository because someone imported `\Magento\Tests\NamingConvention\true\string` by mistake. As result - we have "No build reports available" for "Database Compare build", "Functional Tests build", "Sample Data Tests build" while Static tests are shown as "failing" but in results - we don't really have reason | ||
|
||
## How it works | ||
Any occurrence starts with `Magento\Tests` in import from the namespace will raise the warning. | ||
|
||
## How to fix | ||
|
||
Remove `Magento\Tests` from the imported namespaces |
69 changes: 69 additions & 0 deletions
69
Magento2/Sniffs/Namespaces/ImportsFromTestNamespaceSniff.php
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,69 @@ | ||
<?php | ||
/** | ||
* Copyright © Magento. All rights reserved. | ||
* See COPYING.txt for license details. | ||
*/ | ||
namespace Magento2\Sniffs\Namespaces; | ||
|
||
use PHP_CodeSniffer\Sniffs\Sniff; | ||
use PHP_CodeSniffer\Files\File; | ||
use PHP_CodeSniffer\Util\Tokens; | ||
|
||
/** | ||
* Detects static test namespace. | ||
*/ | ||
class ImportsFromTestNamespaceSniff implements Sniff | ||
{ | ||
/** | ||
* @var string | ||
*/ | ||
private $prohibitNamespace = 'Magento\Tests'; | ||
|
||
/** | ||
* @var string | ||
*/ | ||
protected $warningMessage = 'Application modules should not use classed from test modules.'; | ||
|
||
/** | ||
* @var string | ||
*/ | ||
protected $warningCode = 'WrongImport'; | ||
|
||
/** | ||
* @inheritdoc | ||
*/ | ||
public function register() | ||
{ | ||
return [T_USE]; | ||
} | ||
|
||
/** | ||
* @inheritdoc | ||
*/ | ||
public function process(File $phpcsFile, $stackPtr) | ||
{ | ||
$next = $phpcsFile->findNext([T_COMMA, T_SEMICOLON, T_OPEN_USE_GROUP, T_CLOSE_TAG], ($stackPtr + 1)); | ||
$tokens = $phpcsFile->getTokens(); | ||
$getTokenAsContent = $phpcsFile->getTokensAsString($stackPtr, ($next - $stackPtr)); | ||
if (strpos($getTokenAsContent, $this->prohibitNamespace) !== false) { | ||
$phpcsFile->addWarning($this->warningMessage, $stackPtr, $this->warningCode); | ||
} | ||
if ($next !== false | ||
&& $tokens[$next]['code'] !== T_SEMICOLON | ||
&& $tokens[$next]['code'] !== T_CLOSE_TAG | ||
) { | ||
$baseUse = rtrim($phpcsFile->getTokensAsString($stackPtr, ($next - $stackPtr))); | ||
$baseUse = str_replace('use \\', '', $baseUse); | ||
$closingCurly = $phpcsFile->findNext(T_CLOSE_USE_GROUP, ($next + 1)); | ||
do { | ||
$next = $phpcsFile->findNext(Tokens::$emptyTokens, ($next + 1), $closingCurly, true); | ||
$groupedAsContent = $baseUse. $tokens[$next]['content']; | ||
$next = $phpcsFile->findNext(T_COMMA, ($next + 1), $closingCurly); | ||
if (strpos($groupedAsContent, $this->prohibitNamespace) !== false) { | ||
$phpcsFile->addWarning($this->warningMessage, $stackPtr, $this->warningCode); | ||
return; | ||
} | ||
} while ($next !== false); | ||
} | ||
} | ||
} |
6 changes: 6 additions & 0 deletions
6
Magento2/Tests/Namespaces/ImportsFromTestNamespaceUnitTest.inc
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
<?php | ||
use Magento\Tests; | ||
use Magento\Foo\Tests as FakeTest; | ||
use Magento\Real\Classes; | ||
use \Magento\{Tests\String, Tests\Int}; | ||
use \Magento\{Foo\string, Bar\float}; |
33 changes: 33 additions & 0 deletions
33
Magento2/Tests/Namespaces/ImportsFromTestNamespaceUnitTest.php
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,33 @@ | ||
<?php | ||
/** | ||
* Copyright © Magento. All rights reserved. | ||
* See COPYING.txt for license details. | ||
*/ | ||
namespace Magento2\Tests\Namespaces; | ||
|
||
use PHP_CodeSniffer\Tests\Standards\AbstractSniffUnitTest; | ||
|
||
/** | ||
* Class InterfaceNameUnitTest | ||
*/ | ||
class ImportsFromTestNamespaceUnitTest extends AbstractSniffUnitTest | ||
{ | ||
/** | ||
* @inheritdoc | ||
*/ | ||
public function getErrorList() | ||
{ | ||
return []; | ||
} | ||
|
||
/** | ||
* @inheritdoc | ||
*/ | ||
public function getWarningList() | ||
{ | ||
return [ | ||
2 => 1, | ||
5 => 1 | ||
]; | ||
} | ||
} |
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
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.
Uh oh!
There was an error while loading. Please reload this page.