eventespresso / event-espresso-core

vendor/squizlabs/php_codesniffer/src/Standards/MySource/Sniffs/Debug/FirebugConsoleSniff.php

Indentation +37 added lines, -37 removed lines

@@ -15,50 +15,50 @@
 class FirebugConsoleSniff implements Sniff
 {
 
-    /**
-     * A list of tokenizers this sniff supports.
-     *
-     * @var array
-     */
-    public $supportedTokenizers = ['JS'];
+	/**
+	 * A list of tokenizers this sniff supports.
+	 *
+	 * @var array
+	 */
+	public $supportedTokenizers = ['JS'];
 
 
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @return array
-     */
-    public function register()
-    {
-        return [
-            T_STRING,
-            T_PROPERTY,
-            T_LABEL,
-            T_OBJECT,
-        ];
+	/**
+	 * Returns an array of tokens this test wants to listen for.
+	 *
+	 * @return array
+	 */
+	public function register()
+	{
+		return [
+			T_STRING,
+			T_PROPERTY,
+			T_LABEL,
+			T_OBJECT,
+		];
 
-    }//end register()
+	}//end register()
 
 
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
+	/**
+	 * Processes this test, when one of its tokens is encountered.
+	 *
+	 * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
+	 * @param int                         $stackPtr  The position of the current token
+	 *                                               in the stack passed in $tokens.
+	 *
+	 * @return void
+	 */
+	public function process(File $phpcsFile, $stackPtr)
+	{
+		$tokens = $phpcsFile->getTokens();
 
-        if (strtolower($tokens[$stackPtr]['content']) === 'console') {
-            $error = 'Variables, functions and labels must not be named "console"; name may conflict with Firebug internal variable';
-            $phpcsFile->addError($error, $stackPtr, 'ConflictFound');
-        }
+		if (strtolower($tokens[$stackPtr]['content']) === 'console') {
+			$error = 'Variables, functions and labels must not be named "console"; name may conflict with Firebug internal variable';
+			$phpcsFile->addError($error, $stackPtr, 'ConflictFound');
+		}
 
-    }//end process()
+	}//end process()
 
 
 }//end class

vendor/squizlabs/php_codesniffer/src/Standards/MySource/Sniffs/Channels/UnusedSystemSniff.php

Indentation +120 added lines, -120 removed lines

@@ -16,126 +16,126 @@
 {
 
 
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @return array
-     */
-    public function register()
-    {
-        return [T_DOUBLE_COLON];
-
-    }//end register()
-
-
-    /**
-     * Processes this sniff, when one of its tokens is encountered.
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token in
-     *                                               the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        // Check if this is a call to includeSystem, includeAsset or includeWidget.
-        $methodName = strtolower($tokens[($stackPtr + 1)]['content']);
-        if ($methodName === 'includesystem'
-            || $methodName === 'includeasset'
-            || $methodName === 'includewidget'
-        ) {
-            $systemName = $phpcsFile->findNext(T_WHITESPACE, ($stackPtr + 3), null, true);
-            if ($systemName === false || $tokens[$systemName]['code'] !== T_CONSTANT_ENCAPSED_STRING) {
-                // Must be using a variable instead of a specific system name.
-                // We can't accurately check that.
-                return;
-            }
-
-            $systemName = trim($tokens[$systemName]['content'], " '");
-        } else {
-            return;
-        }
-
-        if ($methodName === 'includeasset') {
-            $systemName .= 'assettype';
-        } else if ($methodName === 'includewidget') {
-            $systemName .= 'widgettype';
-        }
-
-        $systemName = strtolower($systemName);
-
-        // Now check if this system is used anywhere in this scope.
-        $level = $tokens[$stackPtr]['level'];
-        for ($i = ($stackPtr + 1); $i < $phpcsFile->numTokens; $i++) {
-            if ($tokens[$i]['level'] < $level) {
-                // We have gone out of scope.
-                // If the original include was inside an IF statement that
-                // is checking if the system exists, check the outer scope
-                // as well.
-                if ($tokens[$stackPtr]['level'] === $level) {
-                    // We are still in the base level, so this is the first
-                    // time we have got here.
-                    $conditions = array_keys($tokens[$stackPtr]['conditions']);
-                    if (empty($conditions) === false) {
-                        $cond = array_pop($conditions);
-                        if ($tokens[$cond]['code'] === T_IF) {
-                            $i = $tokens[$cond]['scope_closer'];
-                            $level--;
-                            continue;
-                        }
-                    }
-                }
-
-                break;
-            }//end if
-
-            if ($tokens[$i]['code'] !== T_DOUBLE_COLON
-                && $tokens[$i]['code'] !== T_EXTENDS
-                && $tokens[$i]['code'] !== T_IMPLEMENTS
-            ) {
-                continue;
-            }
-
-            switch ($tokens[$i]['code']) {
-            case T_DOUBLE_COLON:
-                $usedName = strtolower($tokens[($i - 1)]['content']);
-                if ($usedName === $systemName) {
-                    // The included system was used, so it is fine.
-                    return;
-                }
-                break;
-            case T_EXTENDS:
-                $classNameToken = $phpcsFile->findNext(T_STRING, ($i + 1));
-                $className      = strtolower($tokens[$classNameToken]['content']);
-                if ($className === $systemName) {
-                    // The included system was used, so it is fine.
-                    return;
-                }
-                break;
-            case T_IMPLEMENTS:
-                $endImplements = $phpcsFile->findNext([T_EXTENDS, T_OPEN_CURLY_BRACKET], ($i + 1));
-                for ($x = ($i + 1); $x < $endImplements; $x++) {
-                    if ($tokens[$x]['code'] === T_STRING) {
-                        $className = strtolower($tokens[$x]['content']);
-                        if ($className === $systemName) {
-                            // The included system was used, so it is fine.
-                            return;
-                        }
-                    }
-                }
-                break;
-            }//end switch
-        }//end for
-
-        // If we get to here, the system was not use.
-        $error = 'Included system "%s" is never used';
-        $data  = [$systemName];
-        $phpcsFile->addError($error, $stackPtr, 'Found', $data);
-
-    }//end process()
+	/**
+	 * Returns an array of tokens this test wants to listen for.
+	 *
+	 * @return array
+	 */
+	public function register()
+	{
+		return [T_DOUBLE_COLON];
+
+	}//end register()
+
+
+	/**
+	 * Processes this sniff, when one of its tokens is encountered.
+	 *
+	 * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
+	 * @param int                         $stackPtr  The position of the current token in
+	 *                                               the stack passed in $tokens.
+	 *
+	 * @return void
+	 */
+	public function process(File $phpcsFile, $stackPtr)
+	{
+		$tokens = $phpcsFile->getTokens();
+
+		// Check if this is a call to includeSystem, includeAsset or includeWidget.
+		$methodName = strtolower($tokens[($stackPtr + 1)]['content']);
+		if ($methodName === 'includesystem'
+			|| $methodName === 'includeasset'
+			|| $methodName === 'includewidget'
+		) {
+			$systemName = $phpcsFile->findNext(T_WHITESPACE, ($stackPtr + 3), null, true);
+			if ($systemName === false || $tokens[$systemName]['code'] !== T_CONSTANT_ENCAPSED_STRING) {
+				// Must be using a variable instead of a specific system name.
+				// We can't accurately check that.
+				return;
+			}
+
+			$systemName = trim($tokens[$systemName]['content'], " '");
+		} else {
+			return;
+		}
+
+		if ($methodName === 'includeasset') {
+			$systemName .= 'assettype';
+		} else if ($methodName === 'includewidget') {
+			$systemName .= 'widgettype';
+		}
+
+		$systemName = strtolower($systemName);
+
+		// Now check if this system is used anywhere in this scope.
+		$level = $tokens[$stackPtr]['level'];
+		for ($i = ($stackPtr + 1); $i < $phpcsFile->numTokens; $i++) {
+			if ($tokens[$i]['level'] < $level) {
+				// We have gone out of scope.
+				// If the original include was inside an IF statement that
+				// is checking if the system exists, check the outer scope
+				// as well.
+				if ($tokens[$stackPtr]['level'] === $level) {
+					// We are still in the base level, so this is the first
+					// time we have got here.
+					$conditions = array_keys($tokens[$stackPtr]['conditions']);
+					if (empty($conditions) === false) {
+						$cond = array_pop($conditions);
+						if ($tokens[$cond]['code'] === T_IF) {
+							$i = $tokens[$cond]['scope_closer'];
+							$level--;
+							continue;
+						}
+					}
+				}
+
+				break;
+			}//end if
+
+			if ($tokens[$i]['code'] !== T_DOUBLE_COLON
+				&& $tokens[$i]['code'] !== T_EXTENDS
+				&& $tokens[$i]['code'] !== T_IMPLEMENTS
+			) {
+				continue;
+			}
+
+			switch ($tokens[$i]['code']) {
+			case T_DOUBLE_COLON:
+				$usedName = strtolower($tokens[($i - 1)]['content']);
+				if ($usedName === $systemName) {
+					// The included system was used, so it is fine.
+					return;
+				}
+				break;
+			case T_EXTENDS:
+				$classNameToken = $phpcsFile->findNext(T_STRING, ($i + 1));
+				$className      = strtolower($tokens[$classNameToken]['content']);
+				if ($className === $systemName) {
+					// The included system was used, so it is fine.
+					return;
+				}
+				break;
+			case T_IMPLEMENTS:
+				$endImplements = $phpcsFile->findNext([T_EXTENDS, T_OPEN_CURLY_BRACKET], ($i + 1));
+				for ($x = ($i + 1); $x < $endImplements; $x++) {
+					if ($tokens[$x]['code'] === T_STRING) {
+						$className = strtolower($tokens[$x]['content']);
+						if ($className === $systemName) {
+							// The included system was used, so it is fine.
+							return;
+						}
+					}
+				}
+				break;
+			}//end switch
+		}//end for
+
+		// If we get to here, the system was not use.
+		$error = 'Included system "%s" is never used';
+		$data  = [$systemName];
+		$phpcsFile->addError($error, $stackPtr, 'Found', $data);
+
+	}//end process()
 
 
 }//end class

Switch Indentation +27 added lines, -27 removed lines

@@ -100,33 +100,33 @@
             }
 
             switch ($tokens[$i]['code']) {
-            case T_DOUBLE_COLON:
-                $usedName = strtolower($tokens[($i - 1)]['content']);
-                if ($usedName === $systemName) {
-                    // The included system was used, so it is fine.
-                    return;
-                }
-                break;
-            case T_EXTENDS:
-                $classNameToken = $phpcsFile->findNext(T_STRING, ($i + 1));
-                $className      = strtolower($tokens[$classNameToken]['content']);
-                if ($className === $systemName) {
-                    // The included system was used, so it is fine.
-                    return;
-                }
-                break;
-            case T_IMPLEMENTS:
-                $endImplements = $phpcsFile->findNext([T_EXTENDS, T_OPEN_CURLY_BRACKET], ($i + 1));
-                for ($x = ($i + 1); $x < $endImplements; $x++) {
-                    if ($tokens[$x]['code'] === T_STRING) {
-                        $className = strtolower($tokens[$x]['content']);
-                        if ($className === $systemName) {
-                            // The included system was used, so it is fine.
-                            return;
-                        }
-                    }
-                }
-                break;
+            	case T_DOUBLE_COLON:
+                	$usedName = strtolower($tokens[($i - 1)]['content']);
+                	if ($usedName === $systemName) {
+                    	// The included system was used, so it is fine.
+                    	return;
+                	}
+                	break;
+            	case T_EXTENDS:
+                	$classNameToken = $phpcsFile->findNext(T_STRING, ($i + 1));
+                	$className      = strtolower($tokens[$classNameToken]['content']);
+                	if ($className === $systemName) {
+                    	// The included system was used, so it is fine.
+                    	return;
+                	}
+                	break;
+            	case T_IMPLEMENTS:
+                	$endImplements = $phpcsFile->findNext([T_EXTENDS, T_OPEN_CURLY_BRACKET], ($i + 1));
+                	for ($x = ($i + 1); $x < $endImplements; $x++) {
+                    	if ($tokens[$x]['code'] === T_STRING) {
+                        	$className = strtolower($tokens[$x]['content']);
+                        	if ($className === $systemName) {
+                            	// The included system was used, so it is fine.
+                            	return;
+                        	}
+                    	}
+                	}
+                	break;
             }//end switch
         }//end for
 

vendor/squizlabs/php_codesniffer/src/Standards/MySource/Sniffs/Channels/IncludeOwnSystemSniff.php

Indentation +77 added lines, -77 removed lines

@@ -16,83 +16,83 @@
 {
 
 
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @return array
-     */
-    public function register()
-    {
-        return [T_DOUBLE_COLON];
-
-    }//end register()
-
-
-    /**
-     * Processes this sniff, when one of its tokens is encountered.
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token in
-     *                                               the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        $fileName = $phpcsFile->getFilename();
-        $matches  = [];
-        if (preg_match('|/systems/(.*)/([^/]+)?actions.inc$|i', $fileName, $matches) === 0) {
-            // Not an actions file.
-            return;
-        }
-
-        $ownClass = $matches[2];
-        $tokens   = $phpcsFile->getTokens();
-
-        $typeName = $phpcsFile->findNext(T_CONSTANT_ENCAPSED_STRING, ($stackPtr + 2), null, false, true);
-        $typeName = trim($tokens[$typeName]['content'], " '");
-        switch (strtolower($tokens[($stackPtr + 1)]['content'])) {
-        case 'includesystem' :
-            $included = strtolower($typeName);
-            break;
-        case 'includeasset' :
-            $included = strtolower($typeName).'assettype';
-            break;
-        case 'includewidget' :
-            $included = strtolower($typeName).'widgettype';
-            break;
-        default:
-            return;
-        }
-
-        if ($included === strtolower($ownClass)) {
-            $error = "You do not need to include \"%s\" from within the system's own actions file";
-            $data  = [$ownClass];
-            $phpcsFile->addError($error, $stackPtr, 'NotRequired', $data);
-        }
-
-    }//end process()
-
-
-    /**
-     * Determines the included class name from given token.
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file where this token was found.
-     * @param array                       $tokens    The array of file tokens.
-     * @param int                         $stackPtr  The position in the tokens array of the
-     *                                               potentially included class.
-     *
-     * @return string
-     */
-    protected function getIncludedClassFromToken(
-        $phpcsFile,
-        array $tokens,
-        $stackPtr
-    ) {
-
-        return false;
-
-    }//end getIncludedClassFromToken()
+	/**
+	 * Returns an array of tokens this test wants to listen for.
+	 *
+	 * @return array
+	 */
+	public function register()
+	{
+		return [T_DOUBLE_COLON];
+
+	}//end register()
+
+
+	/**
+	 * Processes this sniff, when one of its tokens is encountered.
+	 *
+	 * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
+	 * @param int                         $stackPtr  The position of the current token in
+	 *                                               the stack passed in $tokens.
+	 *
+	 * @return void
+	 */
+	public function process(File $phpcsFile, $stackPtr)
+	{
+		$fileName = $phpcsFile->getFilename();
+		$matches  = [];
+		if (preg_match('|/systems/(.*)/([^/]+)?actions.inc$|i', $fileName, $matches) === 0) {
+			// Not an actions file.
+			return;
+		}
+
+		$ownClass = $matches[2];
+		$tokens   = $phpcsFile->getTokens();
+
+		$typeName = $phpcsFile->findNext(T_CONSTANT_ENCAPSED_STRING, ($stackPtr + 2), null, false, true);
+		$typeName = trim($tokens[$typeName]['content'], " '");
+		switch (strtolower($tokens[($stackPtr + 1)]['content'])) {
+		case 'includesystem' :
+			$included = strtolower($typeName);
+			break;
+		case 'includeasset' :
+			$included = strtolower($typeName).'assettype';
+			break;
+		case 'includewidget' :
+			$included = strtolower($typeName).'widgettype';
+			break;
+		default:
+			return;
+		}
+
+		if ($included === strtolower($ownClass)) {
+			$error = "You do not need to include \"%s\" from within the system's own actions file";
+			$data  = [$ownClass];
+			$phpcsFile->addError($error, $stackPtr, 'NotRequired', $data);
+		}
+
+	}//end process()
+
+
+	/**
+	 * Determines the included class name from given token.
+	 *
+	 * @param \PHP_CodeSniffer\Files\File $phpcsFile The file where this token was found.
+	 * @param array                       $tokens    The array of file tokens.
+	 * @param int                         $stackPtr  The position in the tokens array of the
+	 *                                               potentially included class.
+	 *
+	 * @return string
+	 */
+	protected function getIncludedClassFromToken(
+		$phpcsFile,
+		array $tokens,
+		$stackPtr
+	) {
+
+		return false;
+
+	}//end getIncludedClassFromToken()
 
 
 }//end class

Switch Indentation +11 added lines, -11 removed lines

@@ -52,17 +52,17 @@
         $typeName = $phpcsFile->findNext(T_CONSTANT_ENCAPSED_STRING, ($stackPtr + 2), null, false, true);
         $typeName = trim($tokens[$typeName]['content'], " '");
         switch (strtolower($tokens[($stackPtr + 1)]['content'])) {
-        case 'includesystem' :
-            $included = strtolower($typeName);
-            break;
-        case 'includeasset' :
-            $included = strtolower($typeName).'assettype';
-            break;
-        case 'includewidget' :
-            $included = strtolower($typeName).'widgettype';
-            break;
-        default:
-            return;
+        	case 'includesystem' :
+            	$included = strtolower($typeName);
+            	break;
+        	case 'includeasset' :
+            	$included = strtolower($typeName).'assettype';
+            	break;
+        	case 'includewidget' :
+            	$included = strtolower($typeName).'widgettype';
+            	break;
+        	default:
+            	return;
         }
 
         if ($included === strtolower($ownClass)) {

vendor/squizlabs/php_codesniffer/src/Standards/MySource/Sniffs/Objects/AssignThisSniff.php

Indentation +61 added lines, -61 removed lines

@@ -15,67 +15,67 @@
 class AssignThisSniff implements Sniff
 {
 
-    /**
-     * A list of tokenizers this sniff supports.
-     *
-     * @var array
-     */
-    public $supportedTokenizers = ['JS'];
-
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @return array
-     */
-    public function register()
-    {
-        return [T_THIS];
-
-    }//end register()
-
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        // Ignore this.something and other uses of "this" that are not
-        // direct assignments.
-        $next = $phpcsFile->findNext(T_WHITESPACE, ($stackPtr + 1), null, true);
-        if ($tokens[$next]['code'] !== T_SEMICOLON) {
-            if ($tokens[$next]['line'] === $tokens[$stackPtr]['line']) {
-                return;
-            }
-        }
-
-        // Something must be assigned to "this".
-        $prev = $phpcsFile->findPrevious(T_WHITESPACE, ($stackPtr - 1), null, true);
-        if ($tokens[$prev]['code'] !== T_EQUAL) {
-            return;
-        }
-
-        // A variable needs to be assigned to "this".
-        $prev = $phpcsFile->findPrevious(T_WHITESPACE, ($prev - 1), null, true);
-        if ($tokens[$prev]['code'] !== T_STRING) {
-            return;
-        }
-
-        // We can only assign "this" to a var called "self".
-        if ($tokens[$prev]['content'] !== 'self' && $tokens[$prev]['content'] !== '_self') {
-            $error = 'Keyword "this" can only be assigned to a variable called "self" or "_self"';
-            $phpcsFile->addError($error, $prev, 'NotSelf');
-        }
-
-    }//end process()
+	/**
+	 * A list of tokenizers this sniff supports.
+	 *
+	 * @var array
+	 */
+	public $supportedTokenizers = ['JS'];
+
+
+	/**
+	 * Returns an array of tokens this test wants to listen for.
+	 *
+	 * @return array
+	 */
+	public function register()
+	{
+		return [T_THIS];
+
+	}//end register()
+
+
+	/**
+	 * Processes this test, when one of its tokens is encountered.
+	 *
+	 * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
+	 * @param int                         $stackPtr  The position of the current token
+	 *                                               in the stack passed in $tokens.
+	 *
+	 * @return void
+	 */
+	public function process(File $phpcsFile, $stackPtr)
+	{
+		$tokens = $phpcsFile->getTokens();
+
+		// Ignore this.something and other uses of "this" that are not
+		// direct assignments.
+		$next = $phpcsFile->findNext(T_WHITESPACE, ($stackPtr + 1), null, true);
+		if ($tokens[$next]['code'] !== T_SEMICOLON) {
+			if ($tokens[$next]['line'] === $tokens[$stackPtr]['line']) {
+				return;
+			}
+		}
+
+		// Something must be assigned to "this".
+		$prev = $phpcsFile->findPrevious(T_WHITESPACE, ($stackPtr - 1), null, true);
+		if ($tokens[$prev]['code'] !== T_EQUAL) {
+			return;
+		}
+
+		// A variable needs to be assigned to "this".
+		$prev = $phpcsFile->findPrevious(T_WHITESPACE, ($prev - 1), null, true);
+		if ($tokens[$prev]['code'] !== T_STRING) {
+			return;
+		}
+
+		// We can only assign "this" to a var called "self".
+		if ($tokens[$prev]['content'] !== 'self' && $tokens[$prev]['content'] !== '_self') {
+			$error = 'Keyword "this" can only be assigned to a variable called "self" or "_self"';
+			$phpcsFile->addError($error, $prev, 'NotSelf');
+		}
+
+	}//end process()
 
 
 }//end class

vendor/squizlabs/php_codesniffer/src/Standards/MySource/Sniffs/Objects/DisallowNewWidgetSniff.php

Indentation +38 added lines, -38 removed lines

@@ -16,44 +16,44 @@
 {
 
 
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @return array
-     */
-    public function register()
-    {
-        return [T_NEW];
-
-    }//end register()
-
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        $className = $phpcsFile->findNext(T_WHITESPACE, ($stackPtr + 1), null, true);
-        if ($tokens[$className]['code'] !== T_STRING) {
-            return;
-        }
-
-        if (substr(strtolower($tokens[$className]['content']), -10) === 'widgettype') {
-            $widgetType = substr($tokens[$className]['content'], 0, -10);
-            $error      = 'Manual creation of widget objects is banned; use Widget::getWidget(\'%s\'); instead';
-            $data       = [$widgetType];
-            $phpcsFile->addError($error, $stackPtr, 'Found', $data);
-        }
-
-    }//end process()
+	/**
+	 * Returns an array of tokens this test wants to listen for.
+	 *
+	 * @return array
+	 */
+	public function register()
+	{
+		return [T_NEW];
+
+	}//end register()
+
+
+	/**
+	 * Processes this test, when one of its tokens is encountered.
+	 *
+	 * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
+	 * @param int                         $stackPtr  The position of the current token
+	 *                                               in the stack passed in $tokens.
+	 *
+	 * @return void
+	 */
+	public function process(File $phpcsFile, $stackPtr)
+	{
+		$tokens = $phpcsFile->getTokens();
+
+		$className = $phpcsFile->findNext(T_WHITESPACE, ($stackPtr + 1), null, true);
+		if ($tokens[$className]['code'] !== T_STRING) {
+			return;
+		}
+
+		if (substr(strtolower($tokens[$className]['content']), -10) === 'widgettype') {
+			$widgetType = substr($tokens[$className]['content'], 0, -10);
+			$error      = 'Manual creation of widget objects is banned; use Widget::getWidget(\'%s\'); instead';
+			$data       = [$widgetType];
+			$phpcsFile->addError($error, $stackPtr, 'Found', $data);
+		}
+
+	}//end process()
 
 
 }//end class

vendor/squizlabs/php_codesniffer/src/Standards/MySource/Sniffs/Commenting/FunctionCommentSniff.php

Indentation +52 added lines, -52 removed lines

@@ -19,66 +19,66 @@
 {
 
 
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        parent::process($phpcsFile, $stackPtr);
+	/**
+	 * Processes this test, when one of its tokens is encountered.
+	 *
+	 * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
+	 * @param int                         $stackPtr  The position of the current token
+	 *                                               in the stack passed in $tokens.
+	 *
+	 * @return void
+	 */
+	public function process(File $phpcsFile, $stackPtr)
+	{
+		parent::process($phpcsFile, $stackPtr);
 
-        $tokens = $phpcsFile->getTokens();
-        $find   = Tokens::$methodPrefixes;
-        $find[] = T_WHITESPACE;
+		$tokens = $phpcsFile->getTokens();
+		$find   = Tokens::$methodPrefixes;
+		$find[] = T_WHITESPACE;
 
-        $commentEnd = $phpcsFile->findPrevious($find, ($stackPtr - 1), null, true);
-        if ($tokens[$commentEnd]['code'] !== T_DOC_COMMENT_CLOSE_TAG) {
-            return;
-        }
+		$commentEnd = $phpcsFile->findPrevious($find, ($stackPtr - 1), null, true);
+		if ($tokens[$commentEnd]['code'] !== T_DOC_COMMENT_CLOSE_TAG) {
+			return;
+		}
 
-        $commentStart = $tokens[$commentEnd]['comment_opener'];
-        $hasApiTag    = false;
-        foreach ($tokens[$commentStart]['comment_tags'] as $tag) {
-            if ($tokens[$tag]['content'] === '@api') {
-                if ($hasApiTag === true) {
-                    // We've come across an API tag already, which means
-                    // we were not the first tag in the API list.
-                    $error = 'The @api tag must come first in the @api tag list in a function comment';
-                    $phpcsFile->addError($error, $tag, 'ApiNotFirst');
-                }
+		$commentStart = $tokens[$commentEnd]['comment_opener'];
+		$hasApiTag    = false;
+		foreach ($tokens[$commentStart]['comment_tags'] as $tag) {
+			if ($tokens[$tag]['content'] === '@api') {
+				if ($hasApiTag === true) {
+					// We've come across an API tag already, which means
+					// we were not the first tag in the API list.
+					$error = 'The @api tag must come first in the @api tag list in a function comment';
+					$phpcsFile->addError($error, $tag, 'ApiNotFirst');
+				}
 
-                $hasApiTag = true;
+				$hasApiTag = true;
 
-                // There needs to be a blank line before the @api tag.
-                $prev = $phpcsFile->findPrevious([T_DOC_COMMENT_STRING, T_DOC_COMMENT_TAG], ($tag - 1));
-                if ($tokens[$prev]['line'] !== ($tokens[$tag]['line'] - 2)) {
-                    $error = 'There must be one blank line before the @api tag in a function comment';
-                    $phpcsFile->addError($error, $tag, 'ApiSpacing');
-                }
-            } else if (substr($tokens[$tag]['content'], 0, 5) === '@api-') {
-                $hasApiTag = true;
+				// There needs to be a blank line before the @api tag.
+				$prev = $phpcsFile->findPrevious([T_DOC_COMMENT_STRING, T_DOC_COMMENT_TAG], ($tag - 1));
+				if ($tokens[$prev]['line'] !== ($tokens[$tag]['line'] - 2)) {
+					$error = 'There must be one blank line before the @api tag in a function comment';
+					$phpcsFile->addError($error, $tag, 'ApiSpacing');
+				}
+			} else if (substr($tokens[$tag]['content'], 0, 5) === '@api-') {
+				$hasApiTag = true;
 
-                $prev = $phpcsFile->findPrevious([T_DOC_COMMENT_STRING, T_DOC_COMMENT_TAG], ($tag - 1));
-                if ($tokens[$prev]['line'] !== ($tokens[$tag]['line'] - 1)) {
-                    $error = 'There must be no blank line before the @%s tag in a function comment';
-                    $data  = [$tokens[$tag]['content']];
-                    $phpcsFile->addError($error, $tag, 'ApiTagSpacing', $data);
-                }
-            }//end if
-        }//end foreach
+				$prev = $phpcsFile->findPrevious([T_DOC_COMMENT_STRING, T_DOC_COMMENT_TAG], ($tag - 1));
+				if ($tokens[$prev]['line'] !== ($tokens[$tag]['line'] - 1)) {
+					$error = 'There must be no blank line before the @%s tag in a function comment';
+					$data  = [$tokens[$tag]['content']];
+					$phpcsFile->addError($error, $tag, 'ApiTagSpacing', $data);
+				}
+			}//end if
+		}//end foreach
 
-        if ($hasApiTag === true && substr($tokens[$tag]['content'], 0, 4) !== '@api') {
-            // API tags must be the last tags in a function comment.
-            $error = 'The @api tags must be the last tags in a function comment';
-            $phpcsFile->addError($error, $commentEnd, 'ApiNotLast');
-        }
+		if ($hasApiTag === true && substr($tokens[$tag]['content'], 0, 4) !== '@api') {
+			// API tags must be the last tags in a function comment.
+			$error = 'The @api tags must be the last tags in a function comment';
+			$phpcsFile->addError($error, $commentEnd, 'ApiNotLast');
+		}
 
-    }//end process()
+	}//end process()
 
 
 }//end class

vendor/squizlabs/php_codesniffer/src/Files/FileList.php

Spacing +1 added lines, -1 removed lines

@@ -107,7 +107,7 @@
      *
      * @return void
      */
-    public function addFile($path, $file=null)
+    public function addFile($path, $file = null)
     {
         // No filtering is done for STDIN when the filename
         // has not been specified.

Indentation +229 added lines, -229 removed lines

@@ -21,235 +21,235 @@
 class FileList implements \Iterator, \Countable
 {
 
-    /**
-     * A list of file paths that are included in the list.
-     *
-     * @var array
-     */
-    private $files = [];
-
-    /**
-     * The number of files in the list.
-     *
-     * @var integer
-     */
-    private $numFiles = 0;
-
-    /**
-     * The config data for the run.
-     *
-     * @var \PHP_CodeSniffer\Config
-     */
-    public $config = null;
-
-    /**
-     * The ruleset used for the run.
-     *
-     * @var \PHP_CodeSniffer\Ruleset
-     */
-    public $ruleset = null;
-
-    /**
-     * An array of patterns to use for skipping files.
-     *
-     * @var array
-     */
-    protected $ignorePatterns = [];
-
-
-    /**
-     * Constructs a file list and loads in an array of file paths to process.
-     *
-     * @param \PHP_CodeSniffer\Config  $config  The config data for the run.
-     * @param \PHP_CodeSniffer\Ruleset $ruleset The ruleset used for the run.
-     *
-     * @return void
-     */
-    public function __construct(Config $config, Ruleset $ruleset)
-    {
-        $this->ruleset = $ruleset;
-        $this->config  = $config;
-
-        $paths = $config->files;
-        foreach ($paths as $path) {
-            $isPharFile = Util\Common::isPharFile($path);
-            if (is_dir($path) === true || $isPharFile === true) {
-                if ($isPharFile === true) {
-                    $path = 'phar://'.$path;
-                }
-
-                $filterClass = $this->getFilterClass();
-
-                $di       = new \RecursiveDirectoryIterator($path, (\RecursiveDirectoryIterator::SKIP_DOTS | \FilesystemIterator::FOLLOW_SYMLINKS));
-                $filter   = new $filterClass($di, $path, $config, $ruleset);
-                $iterator = new \RecursiveIteratorIterator($filter);
-
-                foreach ($iterator as $file) {
-                    $this->files[$file->getPathname()] = null;
-                    $this->numFiles++;
-                }
-            } else {
-                $this->addFile($path);
-            }//end if
-        }//end foreach
-
-        reset($this->files);
-
-    }//end __construct()
-
-
-    /**
-     * Add a file to the list.
-     *
-     * If a file object has already been created, it can be passed here.
-     * If it is left NULL, it will be created when accessed.
-     *
-     * @param string                      $path The path to the file being added.
-     * @param \PHP_CodeSniffer\Files\File $file The file being added.
-     *
-     * @return void
-     */
-    public function addFile($path, $file=null)
-    {
-        // No filtering is done for STDIN when the filename
-        // has not been specified.
-        if ($path === 'STDIN') {
-            $this->files[$path] = $file;
-            $this->numFiles++;
-            return;
-        }
-
-        $filterClass = $this->getFilterClass();
-
-        $di       = new \RecursiveArrayIterator([$path]);
-        $filter   = new $filterClass($di, $path, $this->config, $this->ruleset);
-        $iterator = new \RecursiveIteratorIterator($filter);
-
-        foreach ($iterator as $path) {
-            $this->files[$path] = $file;
-            $this->numFiles++;
-        }
-
-    }//end addFile()
-
-
-    /**
-     * Get the class name of the filter being used for the run.
-     *
-     * @return string
-     * @throws \PHP_CodeSniffer\Exceptions\DeepExitException If the specified filter could not be found.
-     */
-    private function getFilterClass()
-    {
-        $filterType = $this->config->filter;
-
-        if ($filterType === null) {
-            $filterClass = '\PHP_CodeSniffer\Filters\Filter';
-        } else {
-            if (strpos($filterType, '.') !== false) {
-                // This is a path to a custom filter class.
-                $filename = realpath($filterType);
-                if ($filename === false) {
-                    $error = "ERROR: Custom filter \"$filterType\" not found".PHP_EOL;
-                    throw new DeepExitException($error, 3);
-                }
-
-                $filterClass = Autoload::loadFile($filename);
-            } else {
-                $filterClass = '\PHP_CodeSniffer\Filters\\'.$filterType;
-            }
-        }
-
-        return $filterClass;
-
-    }//end getFilterClass()
-
-
-    /**
-     * Rewind the iterator to the first file.
-     *
-     * @return void
-     */
-    #[ReturnTypeWillChange]
-    public function rewind()
-    {
-        reset($this->files);
-
-    }//end rewind()
-
-
-    /**
-     * Get the file that is currently being processed.
-     *
-     * @return \PHP_CodeSniffer\Files\File
-     */
-    #[ReturnTypeWillChange]
-    public function current()
-    {
-        $path = key($this->files);
-        if (isset($this->files[$path]) === false) {
-            $this->files[$path] = new LocalFile($path, $this->ruleset, $this->config);
-        }
-
-        return $this->files[$path];
-
-    }//end current()
-
-
-    /**
-     * Return the file path of the current file being processed.
-     *
-     * @return void
-     */
-    #[ReturnTypeWillChange]
-    public function key()
-    {
-        return key($this->files);
-
-    }//end key()
-
-
-    /**
-     * Move forward to the next file.
-     *
-     * @return void
-     */
-    #[ReturnTypeWillChange]
-    public function next()
-    {
-        next($this->files);
-
-    }//end next()
-
-
-    /**
-     * Checks if current position is valid.
-     *
-     * @return boolean
-     */
-    #[ReturnTypeWillChange]
-    public function valid()
-    {
-        if (current($this->files) === false) {
-            return false;
-        }
-
-        return true;
-
-    }//end valid()
-
-
-    /**
-     * Return the number of files in the list.
-     *
-     * @return integer
-     */
-    #[ReturnTypeWillChange]
-    public function count()
-    {
-        return $this->numFiles;
-
-    }//end count()
+	/**
+	 * A list of file paths that are included in the list.
+	 *
+	 * @var array
+	 */
+	private $files = [];
+
+	/**
+	 * The number of files in the list.
+	 *
+	 * @var integer
+	 */
+	private $numFiles = 0;
+
+	/**
+	 * The config data for the run.
+	 *
+	 * @var \PHP_CodeSniffer\Config
+	 */
+	public $config = null;
+
+	/**
+	 * The ruleset used for the run.
+	 *
+	 * @var \PHP_CodeSniffer\Ruleset
+	 */
+	public $ruleset = null;
+
+	/**
+	 * An array of patterns to use for skipping files.
+	 *
+	 * @var array
+	 */
+	protected $ignorePatterns = [];
+
+
+	/**
+	 * Constructs a file list and loads in an array of file paths to process.
+	 *
+	 * @param \PHP_CodeSniffer\Config  $config  The config data for the run.
+	 * @param \PHP_CodeSniffer\Ruleset $ruleset The ruleset used for the run.
+	 *
+	 * @return void
+	 */
+	public function __construct(Config $config, Ruleset $ruleset)
+	{
+		$this->ruleset = $ruleset;
+		$this->config  = $config;
+
+		$paths = $config->files;
+		foreach ($paths as $path) {
+			$isPharFile = Util\Common::isPharFile($path);
+			if (is_dir($path) === true || $isPharFile === true) {
+				if ($isPharFile === true) {
+					$path = 'phar://'.$path;
+				}
+
+				$filterClass = $this->getFilterClass();
+
+				$di       = new \RecursiveDirectoryIterator($path, (\RecursiveDirectoryIterator::SKIP_DOTS | \FilesystemIterator::FOLLOW_SYMLINKS));
+				$filter   = new $filterClass($di, $path, $config, $ruleset);
+				$iterator = new \RecursiveIteratorIterator($filter);
+
+				foreach ($iterator as $file) {
+					$this->files[$file->getPathname()] = null;
+					$this->numFiles++;
+				}
+			} else {
+				$this->addFile($path);
+			}//end if
+		}//end foreach
+
+		reset($this->files);
+
+	}//end __construct()
+
+
+	/**
+	 * Add a file to the list.
+	 *
+	 * If a file object has already been created, it can be passed here.
+	 * If it is left NULL, it will be created when accessed.
+	 *
+	 * @param string                      $path The path to the file being added.
+	 * @param \PHP_CodeSniffer\Files\File $file The file being added.
+	 *
+	 * @return void
+	 */
+	public function addFile($path, $file=null)
+	{
+		// No filtering is done for STDIN when the filename
+		// has not been specified.
+		if ($path === 'STDIN') {
+			$this->files[$path] = $file;
+			$this->numFiles++;
+			return;
+		}
+
+		$filterClass = $this->getFilterClass();
+
+		$di       = new \RecursiveArrayIterator([$path]);
+		$filter   = new $filterClass($di, $path, $this->config, $this->ruleset);
+		$iterator = new \RecursiveIteratorIterator($filter);
+
+		foreach ($iterator as $path) {
+			$this->files[$path] = $file;
+			$this->numFiles++;
+		}
+
+	}//end addFile()
+
+
+	/**
+	 * Get the class name of the filter being used for the run.
+	 *
+	 * @return string
+	 * @throws \PHP_CodeSniffer\Exceptions\DeepExitException If the specified filter could not be found.
+	 */
+	private function getFilterClass()
+	{
+		$filterType = $this->config->filter;
+
+		if ($filterType === null) {
+			$filterClass = '\PHP_CodeSniffer\Filters\Filter';
+		} else {
+			if (strpos($filterType, '.') !== false) {
+				// This is a path to a custom filter class.
+				$filename = realpath($filterType);
+				if ($filename === false) {
+					$error = "ERROR: Custom filter \"$filterType\" not found".PHP_EOL;
+					throw new DeepExitException($error, 3);
+				}
+
+				$filterClass = Autoload::loadFile($filename);
+			} else {
+				$filterClass = '\PHP_CodeSniffer\Filters\\'.$filterType;
+			}
+		}
+
+		return $filterClass;
+
+	}//end getFilterClass()
+
+
+	/**
+	 * Rewind the iterator to the first file.
+	 *
+	 * @return void
+	 */
+	#[ReturnTypeWillChange]
+	public function rewind()
+	{
+		reset($this->files);
+
+	}//end rewind()
+
+
+	/**
+	 * Get the file that is currently being processed.
+	 *
+	 * @return \PHP_CodeSniffer\Files\File
+	 */
+	#[ReturnTypeWillChange]
+	public function current()
+	{
+		$path = key($this->files);
+		if (isset($this->files[$path]) === false) {
+			$this->files[$path] = new LocalFile($path, $this->ruleset, $this->config);
+		}
+
+		return $this->files[$path];
+
+	}//end current()
+
+
+	/**
+	 * Return the file path of the current file being processed.
+	 *
+	 * @return void
+	 */
+	#[ReturnTypeWillChange]
+	public function key()
+	{
+		return key($this->files);
+
+	}//end key()
+
+
+	/**
+	 * Move forward to the next file.
+	 *
+	 * @return void
+	 */
+	#[ReturnTypeWillChange]
+	public function next()
+	{
+		next($this->files);
+
+	}//end next()
+
+
+	/**
+	 * Checks if current position is valid.
+	 *
+	 * @return boolean
+	 */
+	#[ReturnTypeWillChange]
+	public function valid()
+	{
+		if (current($this->files) === false) {
+			return false;
+		}
+
+		return true;
+
+	}//end valid()
+
+
+	/**
+	 * Return the number of files in the list.
+	 *
+	 * @return integer
+	 */
+	#[ReturnTypeWillChange]
+	public function count()
+	{
+		return $this->numFiles;
+
+	}//end count()
 
 
 }//end class

vendor/squizlabs/php_codesniffer/src/Filters/GitModified.php

Spacing +1 added lines, -1 removed lines

@@ -50,7 +50,7 @@
             do {
                 $modified[$path] = true;
                 $path            = dirname($path);
-            } while ($path !== $basedir);
+            }while ($path !== $basedir);
         }
 
         return $modified;

Indentation +46 added lines, -46 removed lines

@@ -15,52 +15,52 @@
 {
 
 
-    /**
-     * Get a list of blacklisted file paths.
-     *
-     * @return array
-     */
-    protected function getBlacklist()
-    {
-        return [];
-
-    }//end getBlacklist()
-
-
-    /**
-     * Get a list of whitelisted file paths.
-     *
-     * @return array
-     */
-    protected function getWhitelist()
-    {
-        $modified = [];
-
-        $cmd    = 'git ls-files -o -m --exclude-standard -- '.escapeshellarg($this->basedir);
-        $output = [];
-        exec($cmd, $output);
-
-        $basedir = $this->basedir;
-        if (is_dir($basedir) === false) {
-            $basedir = dirname($basedir);
-        }
-
-        foreach ($output as $path) {
-            $path = Util\Common::realpath($path);
-
-            if ($path === false) {
-                continue;
-            }
-
-            do {
-                $modified[$path] = true;
-                $path            = dirname($path);
-            } while ($path !== $basedir);
-        }
-
-        return $modified;
-
-    }//end getWhitelist()
+	/**
+	 * Get a list of blacklisted file paths.
+	 *
+	 * @return array
+	 */
+	protected function getBlacklist()
+	{
+		return [];
+
+	}//end getBlacklist()
+
+
+	/**
+	 * Get a list of whitelisted file paths.
+	 *
+	 * @return array
+	 */
+	protected function getWhitelist()
+	{
+		$modified = [];
+
+		$cmd    = 'git ls-files -o -m --exclude-standard -- '.escapeshellarg($this->basedir);
+		$output = [];
+		exec($cmd, $output);
+
+		$basedir = $this->basedir;
+		if (is_dir($basedir) === false) {
+			$basedir = dirname($basedir);
+		}
+
+		foreach ($output as $path) {
+			$path = Util\Common::realpath($path);
+
+			if ($path === false) {
+				continue;
+			}
+
+			do {
+				$modified[$path] = true;
+				$path            = dirname($path);
+			} while ($path !== $basedir);
+		}
+
+		return $modified;
+
+	}//end getWhitelist()
 
 
 }//end class

vendor/squizlabs/php_codesniffer/src/Filters/ExactMatch.php

Indentation +87 added lines, -87 removed lines

@@ -16,93 +16,93 @@
 abstract class ExactMatch extends Filter
 {
 
-    /**
-     * A list of files to exclude.
-     *
-     * @var array
-     */
-    private $blacklist = null;
-
-    /**
-     * A list of files to include.
-     *
-     * If the whitelist is empty, only files in the blacklist will be excluded.
-     *
-     * @var array
-     */
-    private $whitelist = null;
-
-
-    /**
-     * Check whether the current element of the iterator is acceptable.
-     *
-     * If a file is both blacklisted and whitelisted, it will be deemed unacceptable.
-     *
-     * @return bool
-     */
-    public function accept()
-    {
-        if (parent::accept() === false) {
-            return false;
-        }
-
-        if ($this->blacklist === null) {
-            $this->blacklist = $this->getblacklist();
-        }
-
-        if ($this->whitelist === null) {
-            $this->whitelist = $this->getwhitelist();
-        }
-
-        $filePath = Util\Common::realpath($this->current());
-
-        // If file is both blacklisted and whitelisted, the blacklist takes precedence.
-        if (isset($this->blacklist[$filePath]) === true) {
-            return false;
-        }
-
-        if (empty($this->whitelist) === true && empty($this->blacklist) === false) {
-            // We are only checking a blacklist, so everything else should be whitelisted.
-            return true;
-        }
-
-        return isset($this->whitelist[$filePath]);
-
-    }//end accept()
-
-
-    /**
-     * Returns an iterator for the current entry.
-     *
-     * Ensures that the blacklist and whitelist are preserved so they don't have
-     * to be generated each time.
-     *
-     * @return \RecursiveIterator
-     */
-    public function getChildren()
-    {
-        $children            = parent::getChildren();
-        $children->blacklist = $this->blacklist;
-        $children->whitelist = $this->whitelist;
-        return $children;
-
-    }//end getChildren()
-
-
-    /**
-     * Get a list of blacklisted file paths.
-     *
-     * @return array
-     */
-    abstract protected function getBlacklist();
-
-
-    /**
-     * Get a list of whitelisted file paths.
-     *
-     * @return array
-     */
-    abstract protected function getWhitelist();
+	/**
+	 * A list of files to exclude.
+	 *
+	 * @var array
+	 */
+	private $blacklist = null;
+
+	/**
+	 * A list of files to include.
+	 *
+	 * If the whitelist is empty, only files in the blacklist will be excluded.
+	 *
+	 * @var array
+	 */
+	private $whitelist = null;
+
+
+	/**
+	 * Check whether the current element of the iterator is acceptable.
+	 *
+	 * If a file is both blacklisted and whitelisted, it will be deemed unacceptable.
+	 *
+	 * @return bool
+	 */
+	public function accept()
+	{
+		if (parent::accept() === false) {
+			return false;
+		}
+
+		if ($this->blacklist === null) {
+			$this->blacklist = $this->getblacklist();
+		}
+
+		if ($this->whitelist === null) {
+			$this->whitelist = $this->getwhitelist();
+		}
+
+		$filePath = Util\Common::realpath($this->current());
+
+		// If file is both blacklisted and whitelisted, the blacklist takes precedence.
+		if (isset($this->blacklist[$filePath]) === true) {
+			return false;
+		}
+
+		if (empty($this->whitelist) === true && empty($this->blacklist) === false) {
+			// We are only checking a blacklist, so everything else should be whitelisted.
+			return true;
+		}
+
+		return isset($this->whitelist[$filePath]);
+
+	}//end accept()
+
+
+	/**
+	 * Returns an iterator for the current entry.
+	 *
+	 * Ensures that the blacklist and whitelist are preserved so they don't have
+	 * to be generated each time.
+	 *
+	 * @return \RecursiveIterator
+	 */
+	public function getChildren()
+	{
+		$children            = parent::getChildren();
+		$children->blacklist = $this->blacklist;
+		$children->whitelist = $this->whitelist;
+		return $children;
+
+	}//end getChildren()
+
+
+	/**
+	 * Get a list of blacklisted file paths.
+	 *
+	 * @return array
+	 */
+	abstract protected function getBlacklist();
+
+
+	/**
+	 * Get a list of whitelisted file paths.
+	 *
+	 * @return array
+	 */
+	abstract protected function getWhitelist();
 
 
 }//end class