Chris@18: <?php
Chris@18: /**
Chris@18:  * Parses and verifies comment language.
Chris@18:  *
Chris@18:  * @category PHP
Chris@18:  * @package  PHP_CodeSniffer
Chris@18:  * @link     http://pear.php.net/package/PHP_CodeSniffer
Chris@18:  */
Chris@18: 
Chris@18: namespace Drupal\Sniffs\Commenting;
Chris@18: 
Chris@18: use PHP_CodeSniffer\Files\File;
Chris@18: use PHP_CodeSniffer\Sniffs\Sniff;
Chris@18: 
Chris@18: /**
Chris@18:  * Parses and verifies that comments use gender neutral language.
Chris@18:  *
Chris@18:  * @category PHP
Chris@18:  * @package  PHP_CodeSniffer
Chris@18:  * @link     http://pear.php.net/package/PHP_CodeSniffer
Chris@18:  */
Chris@18: class GenderNeutralCommentSniff implements Sniff
Chris@18: {
Chris@18: 
Chris@18: 
Chris@18:     /**
Chris@18:      * Returns an array of tokens this test wants to listen for.
Chris@18:      *
Chris@18:      * @return array
Chris@18:      */
Chris@18:     public function register()
Chris@18:     {
Chris@18:         return array(
Chris@18:                 T_COMMENT,
Chris@18:                 T_DOC_COMMENT_STRING,
Chris@18:                );
Chris@18: 
Chris@18:     }//end register()
Chris@18: 
Chris@18: 
Chris@18:     /**
Chris@18:      * Processes this test, when one of its tokens is encountered.
Chris@18:      *
Chris@18:      * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
Chris@18:      * @param int                         $stackPtr  The position of the current token
Chris@18:      *                                               in the stack passed in $tokens.
Chris@18:      *
Chris@18:      * @return void
Chris@18:      */
Chris@18:     public function process(File $phpcsFile, $stackPtr)
Chris@18:     {
Chris@18:         $tokens = $phpcsFile->getTokens();
Chris@18:         if ((bool) preg_match('/(^|\W)(he|her|hers|him|his|she)($|\W)/i', $tokens[$stackPtr]['content']) === true) {
Chris@18:             $phpcsFile->addError('Unnecessarily gendered language in a comment', $stackPtr, 'GenderNeutral');
Chris@18:         }
Chris@18: 
Chris@18:     }//end process()
Chris@18: 
Chris@18: 
Chris@18: }//end class