You are here

class PHP_CodeCoverage_Report_Node_File in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 vendor/phpunit/php-code-coverage/src/CodeCoverage/Report/Node/File.php \PHP_CodeCoverage_Report_Node_File

Represents a file in the code coverage information tree.

@since Class available since Release 1.1.0

Hierarchy

Expanded class hierarchy of PHP_CodeCoverage_Report_Node_File

File

vendor/phpunit/php-code-coverage/src/CodeCoverage/Report/Node/File.php, line 16

View source
class PHP_CodeCoverage_Report_Node_File extends PHP_CodeCoverage_Report_Node {

  /**
   * @var array
   */
  protected $coverageData;

  /**
   * @var array
   */
  protected $testData;

  /**
   * @var int
   */
  protected $numExecutableLines = 0;

  /**
   * @var int
   */
  protected $numExecutedLines = 0;

  /**
   * @var array
   */
  protected $classes = array();

  /**
   * @var array
   */
  protected $traits = array();

  /**
   * @var array
   */
  protected $functions = array();

  /**
   * @var array
   */
  protected $linesOfCode = array();

  /**
   * @var int
   */
  protected $numTestedTraits = 0;

  /**
   * @var int
   */
  protected $numTestedClasses = 0;

  /**
   * @var int
   */
  protected $numMethods = null;

  /**
   * @var int
   */
  protected $numTestedMethods = null;

  /**
   * @var int
   */
  protected $numTestedFunctions = null;

  /**
   * @var array
   */
  protected $startLines = array();

  /**
   * @var array
   */
  protected $endLines = array();

  /**
   * @var bool
   */
  protected $cacheTokens;

  /**
   * Constructor.
   *
   * @param  string                       $name
   * @param  PHP_CodeCoverage_Report_Node $parent
   * @param  array                        $coverageData
   * @param  array                        $testData
   * @param  bool                         $cacheTokens
   * @throws PHP_CodeCoverage_Exception
   */
  public function __construct($name, PHP_CodeCoverage_Report_Node $parent, array $coverageData, array $testData, $cacheTokens) {
    if (!is_bool($cacheTokens)) {
      throw PHP_CodeCoverage_Util_InvalidArgumentHelper::factory(1, 'boolean');
    }
    parent::__construct($name, $parent);
    $this->coverageData = $coverageData;
    $this->testData = $testData;
    $this->cacheTokens = $cacheTokens;
    $this
      ->calculateStatistics();
  }

  /**
   * Returns the number of files in/under this node.
   *
   * @return int
   */
  public function count() {
    return 1;
  }

  /**
   * Returns the code coverage data of this node.
   *
   * @return array
   */
  public function getCoverageData() {
    return $this->coverageData;
  }

  /**
   * Returns the test data of this node.
   *
   * @return array
   */
  public function getTestData() {
    return $this->testData;
  }

  /**
   * Returns the classes of this node.
   *
   * @return array
   */
  public function getClasses() {
    return $this->classes;
  }

  /**
   * Returns the traits of this node.
   *
   * @return array
   */
  public function getTraits() {
    return $this->traits;
  }

  /**
   * Returns the functions of this node.
   *
   * @return array
   */
  public function getFunctions() {
    return $this->functions;
  }

  /**
   * Returns the LOC/CLOC/NCLOC of this node.
   *
   * @return array
   */
  public function getLinesOfCode() {
    return $this->linesOfCode;
  }

  /**
   * Returns the number of executable lines.
   *
   * @return int
   */
  public function getNumExecutableLines() {
    return $this->numExecutableLines;
  }

  /**
   * Returns the number of executed lines.
   *
   * @return int
   */
  public function getNumExecutedLines() {
    return $this->numExecutedLines;
  }

  /**
   * Returns the number of classes.
   *
   * @return int
   */
  public function getNumClasses() {
    return count($this->classes);
  }

  /**
   * Returns the number of tested classes.
   *
   * @return int
   */
  public function getNumTestedClasses() {
    return $this->numTestedClasses;
  }

  /**
   * Returns the number of traits.
   *
   * @return int
   */
  public function getNumTraits() {
    return count($this->traits);
  }

  /**
   * Returns the number of tested traits.
   *
   * @return int
   */
  public function getNumTestedTraits() {
    return $this->numTestedTraits;
  }

  /**
   * Returns the number of methods.
   *
   * @return int
   */
  public function getNumMethods() {
    if ($this->numMethods === null) {
      $this->numMethods = 0;
      foreach ($this->classes as $class) {
        foreach ($class['methods'] as $method) {
          if ($method['executableLines'] > 0) {
            $this->numMethods++;
          }
        }
      }
      foreach ($this->traits as $trait) {
        foreach ($trait['methods'] as $method) {
          if ($method['executableLines'] > 0) {
            $this->numMethods++;
          }
        }
      }
    }
    return $this->numMethods;
  }

  /**
   * Returns the number of tested methods.
   *
   * @return int
   */
  public function getNumTestedMethods() {
    if ($this->numTestedMethods === null) {
      $this->numTestedMethods = 0;
      foreach ($this->classes as $class) {
        foreach ($class['methods'] as $method) {
          if ($method['executableLines'] > 0 && $method['coverage'] == 100) {
            $this->numTestedMethods++;
          }
        }
      }
      foreach ($this->traits as $trait) {
        foreach ($trait['methods'] as $method) {
          if ($method['executableLines'] > 0 && $method['coverage'] == 100) {
            $this->numTestedMethods++;
          }
        }
      }
    }
    return $this->numTestedMethods;
  }

  /**
   * Returns the number of functions.
   *
   * @return int
   */
  public function getNumFunctions() {
    return count($this->functions);
  }

  /**
   * Returns the number of tested functions.
   *
   * @return int
   */
  public function getNumTestedFunctions() {
    if ($this->numTestedFunctions === null) {
      $this->numTestedFunctions = 0;
      foreach ($this->functions as $function) {
        if ($function['executableLines'] > 0 && $function['coverage'] == 100) {
          $this->numTestedFunctions++;
        }
      }
    }
    return $this->numTestedFunctions;
  }

  /**
   * Calculates coverage statistics for the file.
   */
  protected function calculateStatistics() {
    $classStack = $functionStack = array();
    if ($this->cacheTokens) {
      $tokens = PHP_Token_Stream_CachingFactory::get($this
        ->getPath());
    }
    else {
      $tokens = new PHP_Token_Stream($this
        ->getPath());
    }
    $this
      ->processClasses($tokens);
    $this
      ->processTraits($tokens);
    $this
      ->processFunctions($tokens);
    $this->linesOfCode = $tokens
      ->getLinesOfCode();
    unset($tokens);
    for ($lineNumber = 1; $lineNumber <= $this->linesOfCode['loc']; $lineNumber++) {
      if (isset($this->startLines[$lineNumber])) {

        // Start line of a class.
        if (isset($this->startLines[$lineNumber]['className'])) {
          if (isset($currentClass)) {
            $classStack[] =& $currentClass;
          }
          $currentClass =& $this->startLines[$lineNumber];
        }
        elseif (isset($this->startLines[$lineNumber]['traitName'])) {
          $currentTrait =& $this->startLines[$lineNumber];
        }
        elseif (isset($this->startLines[$lineNumber]['methodName'])) {
          $currentMethod =& $this->startLines[$lineNumber];
        }
        elseif (isset($this->startLines[$lineNumber]['functionName'])) {
          if (isset($currentFunction)) {
            $functionStack[] =& $currentFunction;
          }
          $currentFunction =& $this->startLines[$lineNumber];
        }
      }
      if (isset($this->coverageData[$lineNumber])) {
        if (isset($currentClass)) {
          $currentClass['executableLines']++;
        }
        if (isset($currentTrait)) {
          $currentTrait['executableLines']++;
        }
        if (isset($currentMethod)) {
          $currentMethod['executableLines']++;
        }
        if (isset($currentFunction)) {
          $currentFunction['executableLines']++;
        }
        $this->numExecutableLines++;
        if (count($this->coverageData[$lineNumber]) > 0) {
          if (isset($currentClass)) {
            $currentClass['executedLines']++;
          }
          if (isset($currentTrait)) {
            $currentTrait['executedLines']++;
          }
          if (isset($currentMethod)) {
            $currentMethod['executedLines']++;
          }
          if (isset($currentFunction)) {
            $currentFunction['executedLines']++;
          }
          $this->numExecutedLines++;
        }
      }
      if (isset($this->endLines[$lineNumber])) {

        // End line of a class.
        if (isset($this->endLines[$lineNumber]['className'])) {
          unset($currentClass);
          if ($classStack) {
            end($classStack);
            $key = key($classStack);
            $currentClass =& $classStack[$key];
            unset($classStack[$key]);
          }
        }
        elseif (isset($this->endLines[$lineNumber]['traitName'])) {
          unset($currentTrait);
        }
        elseif (isset($this->endLines[$lineNumber]['methodName'])) {
          unset($currentMethod);
        }
        elseif (isset($this->endLines[$lineNumber]['functionName'])) {
          unset($currentFunction);
          if ($functionStack) {
            end($functionStack);
            $key = key($functionStack);
            $currentFunction =& $functionStack[$key];
            unset($functionStack[$key]);
          }
        }
      }
    }
    foreach ($this->traits as &$trait) {
      foreach ($trait['methods'] as &$method) {
        if ($method['executableLines'] > 0) {
          $method['coverage'] = $method['executedLines'] / $method['executableLines'] * 100;
        }
        else {
          $method['coverage'] = 100;
        }
        $method['crap'] = $this
          ->crap($method['ccn'], $method['coverage']);
        $trait['ccn'] += $method['ccn'];
      }
      if ($trait['executableLines'] > 0) {
        $trait['coverage'] = $trait['executedLines'] / $trait['executableLines'] * 100;
      }
      else {
        $trait['coverage'] = 100;
      }
      if ($trait['coverage'] == 100) {
        $this->numTestedClasses++;
      }
      $trait['crap'] = $this
        ->crap($trait['ccn'], $trait['coverage']);
    }
    foreach ($this->classes as &$class) {
      foreach ($class['methods'] as &$method) {
        if ($method['executableLines'] > 0) {
          $method['coverage'] = $method['executedLines'] / $method['executableLines'] * 100;
        }
        else {
          $method['coverage'] = 100;
        }
        $method['crap'] = $this
          ->crap($method['ccn'], $method['coverage']);
        $class['ccn'] += $method['ccn'];
      }
      if ($class['executableLines'] > 0) {
        $class['coverage'] = $class['executedLines'] / $class['executableLines'] * 100;
      }
      else {
        $class['coverage'] = 100;
      }
      if ($class['coverage'] == 100) {
        $this->numTestedClasses++;
      }
      $class['crap'] = $this
        ->crap($class['ccn'], $class['coverage']);
    }
  }

  /**
   * @param PHP_Token_Stream $tokens
   */
  protected function processClasses(PHP_Token_Stream $tokens) {
    $classes = $tokens
      ->getClasses();
    unset($tokens);
    $link = $this
      ->getId() . '.html#';
    foreach ($classes as $className => $class) {
      $this->classes[$className] = array(
        'className' => $className,
        'methods' => array(),
        'startLine' => $class['startLine'],
        'executableLines' => 0,
        'executedLines' => 0,
        'ccn' => 0,
        'coverage' => 0,
        'crap' => 0,
        'package' => $class['package'],
        'link' => $link . $class['startLine'],
      );
      $this->startLines[$class['startLine']] =& $this->classes[$className];
      $this->endLines[$class['endLine']] =& $this->classes[$className];
      foreach ($class['methods'] as $methodName => $method) {
        $this->classes[$className]['methods'][$methodName] = array(
          'methodName' => $methodName,
          'signature' => $method['signature'],
          'startLine' => $method['startLine'],
          'endLine' => $method['endLine'],
          'executableLines' => 0,
          'executedLines' => 0,
          'ccn' => $method['ccn'],
          'coverage' => 0,
          'crap' => 0,
          'link' => $link . $method['startLine'],
        );
        $this->startLines[$method['startLine']] =& $this->classes[$className]['methods'][$methodName];
        $this->endLines[$method['endLine']] =& $this->classes[$className]['methods'][$methodName];
      }
    }
  }

  /**
   * @param PHP_Token_Stream $tokens
   */
  protected function processTraits(PHP_Token_Stream $tokens) {
    $traits = $tokens
      ->getTraits();
    unset($tokens);
    $link = $this
      ->getId() . '.html#';
    foreach ($traits as $traitName => $trait) {
      $this->traits[$traitName] = array(
        'traitName' => $traitName,
        'methods' => array(),
        'startLine' => $trait['startLine'],
        'executableLines' => 0,
        'executedLines' => 0,
        'ccn' => 0,
        'coverage' => 0,
        'crap' => 0,
        'package' => $trait['package'],
        'link' => $link . $trait['startLine'],
      );
      $this->startLines[$trait['startLine']] =& $this->traits[$traitName];
      $this->endLines[$trait['endLine']] =& $this->traits[$traitName];
      foreach ($trait['methods'] as $methodName => $method) {
        $this->traits[$traitName]['methods'][$methodName] = array(
          'methodName' => $methodName,
          'signature' => $method['signature'],
          'startLine' => $method['startLine'],
          'endLine' => $method['endLine'],
          'executableLines' => 0,
          'executedLines' => 0,
          'ccn' => $method['ccn'],
          'coverage' => 0,
          'crap' => 0,
          'link' => $link . $method['startLine'],
        );
        $this->startLines[$method['startLine']] =& $this->traits[$traitName]['methods'][$methodName];
        $this->endLines[$method['endLine']] =& $this->traits[$traitName]['methods'][$methodName];
      }
    }
  }

  /**
   * @param PHP_Token_Stream $tokens
   */
  protected function processFunctions(PHP_Token_Stream $tokens) {
    $functions = $tokens
      ->getFunctions();
    unset($tokens);
    $link = $this
      ->getId() . '.html#';
    foreach ($functions as $functionName => $function) {
      $this->functions[$functionName] = array(
        'functionName' => $functionName,
        'signature' => $function['signature'],
        'startLine' => $function['startLine'],
        'executableLines' => 0,
        'executedLines' => 0,
        'ccn' => $function['ccn'],
        'coverage' => 0,
        'crap' => 0,
        'link' => $link . $function['startLine'],
      );
      $this->startLines[$function['startLine']] =& $this->functions[$functionName];
      $this->endLines[$function['endLine']] =& $this->functions[$functionName];
    }
  }

  /**
   * Calculates the Change Risk Anti-Patterns (CRAP) index for a unit of code
   * based on its cyclomatic complexity and percentage of code coverage.
   *
   * @param  int    $ccn
   * @param  float  $coverage
   * @return string
   * @since  Method available since Release 1.2.0
   */
  protected function crap($ccn, $coverage) {
    if ($coverage == 0) {
      return (string) (pow($ccn, 2) + $ccn);
    }
    if ($coverage >= 95) {
      return (string) $ccn;
    }
    return sprintf('%01.2F', pow($ccn, 2) * pow(1 - $coverage / 100, 3) + $ccn);
  }

}

Members

Namesort descending Modifiers Type Description Overrides
PHP_CodeCoverage_Report_Node::$id protected property
PHP_CodeCoverage_Report_Node::$name protected property
PHP_CodeCoverage_Report_Node::$parent protected property
PHP_CodeCoverage_Report_Node::$path protected property
PHP_CodeCoverage_Report_Node::$pathArray protected property
PHP_CodeCoverage_Report_Node::getClassesAndTraits public function Returns the classes and traits of this node.
PHP_CodeCoverage_Report_Node::getId public function
PHP_CodeCoverage_Report_Node::getLineExecutedPercent public function Returns the percentage of executed lines.
PHP_CodeCoverage_Report_Node::getName public function
PHP_CodeCoverage_Report_Node::getNumClassesAndTraits public function Returns the number of classes and traits.
PHP_CodeCoverage_Report_Node::getNumTestedClassesAndTraits public function Returns the number of tested classes and traits.
PHP_CodeCoverage_Report_Node::getParent public function
PHP_CodeCoverage_Report_Node::getPath public function
PHP_CodeCoverage_Report_Node::getPathAsArray public function
PHP_CodeCoverage_Report_Node::getTestedClassesAndTraitsPercent public function Returns the percentage of traits that has been tested.
PHP_CodeCoverage_Report_Node::getTestedClassesPercent public function Returns the percentage of classes that has been tested.
PHP_CodeCoverage_Report_Node::getTestedMethodsPercent public function Returns the percentage of methods that has been tested.
PHP_CodeCoverage_Report_Node::getTestedTraitsPercent public function Returns the percentage of traits that has been tested.
PHP_CodeCoverage_Report_Node_File::$cacheTokens protected property
PHP_CodeCoverage_Report_Node_File::$classes protected property
PHP_CodeCoverage_Report_Node_File::$coverageData protected property
PHP_CodeCoverage_Report_Node_File::$endLines protected property
PHP_CodeCoverage_Report_Node_File::$functions protected property
PHP_CodeCoverage_Report_Node_File::$linesOfCode protected property
PHP_CodeCoverage_Report_Node_File::$numExecutableLines protected property
PHP_CodeCoverage_Report_Node_File::$numExecutedLines protected property
PHP_CodeCoverage_Report_Node_File::$numMethods protected property
PHP_CodeCoverage_Report_Node_File::$numTestedClasses protected property
PHP_CodeCoverage_Report_Node_File::$numTestedFunctions protected property
PHP_CodeCoverage_Report_Node_File::$numTestedMethods protected property
PHP_CodeCoverage_Report_Node_File::$numTestedTraits protected property
PHP_CodeCoverage_Report_Node_File::$startLines protected property
PHP_CodeCoverage_Report_Node_File::$testData protected property
PHP_CodeCoverage_Report_Node_File::$traits protected property
PHP_CodeCoverage_Report_Node_File::calculateStatistics protected function Calculates coverage statistics for the file.
PHP_CodeCoverage_Report_Node_File::count public function Returns the number of files in/under this node.
PHP_CodeCoverage_Report_Node_File::crap protected function Calculates the Change Risk Anti-Patterns (CRAP) index for a unit of code based on its cyclomatic complexity and percentage of code coverage.
PHP_CodeCoverage_Report_Node_File::getClasses public function Returns the classes of this node. Overrides PHP_CodeCoverage_Report_Node::getClasses
PHP_CodeCoverage_Report_Node_File::getCoverageData public function Returns the code coverage data of this node.
PHP_CodeCoverage_Report_Node_File::getFunctions public function Returns the functions of this node. Overrides PHP_CodeCoverage_Report_Node::getFunctions
PHP_CodeCoverage_Report_Node_File::getLinesOfCode public function Returns the LOC/CLOC/NCLOC of this node. Overrides PHP_CodeCoverage_Report_Node::getLinesOfCode
PHP_CodeCoverage_Report_Node_File::getNumClasses public function Returns the number of classes. Overrides PHP_CodeCoverage_Report_Node::getNumClasses
PHP_CodeCoverage_Report_Node_File::getNumExecutableLines public function Returns the number of executable lines. Overrides PHP_CodeCoverage_Report_Node::getNumExecutableLines
PHP_CodeCoverage_Report_Node_File::getNumExecutedLines public function Returns the number of executed lines. Overrides PHP_CodeCoverage_Report_Node::getNumExecutedLines
PHP_CodeCoverage_Report_Node_File::getNumFunctions public function Returns the number of functions. Overrides PHP_CodeCoverage_Report_Node::getNumFunctions
PHP_CodeCoverage_Report_Node_File::getNumMethods public function Returns the number of methods. Overrides PHP_CodeCoverage_Report_Node::getNumMethods
PHP_CodeCoverage_Report_Node_File::getNumTestedClasses public function Returns the number of tested classes. Overrides PHP_CodeCoverage_Report_Node::getNumTestedClasses
PHP_CodeCoverage_Report_Node_File::getNumTestedFunctions public function Returns the number of tested functions. Overrides PHP_CodeCoverage_Report_Node::getNumTestedFunctions
PHP_CodeCoverage_Report_Node_File::getNumTestedMethods public function Returns the number of tested methods. Overrides PHP_CodeCoverage_Report_Node::getNumTestedMethods
PHP_CodeCoverage_Report_Node_File::getNumTestedTraits public function Returns the number of tested traits. Overrides PHP_CodeCoverage_Report_Node::getNumTestedTraits
PHP_CodeCoverage_Report_Node_File::getNumTraits public function Returns the number of traits. Overrides PHP_CodeCoverage_Report_Node::getNumTraits
PHP_CodeCoverage_Report_Node_File::getTestData public function Returns the test data of this node.
PHP_CodeCoverage_Report_Node_File::getTraits public function Returns the traits of this node. Overrides PHP_CodeCoverage_Report_Node::getTraits
PHP_CodeCoverage_Report_Node_File::processClasses protected function
PHP_CodeCoverage_Report_Node_File::processFunctions protected function
PHP_CodeCoverage_Report_Node_File::processTraits protected function
PHP_CodeCoverage_Report_Node_File::__construct public function Constructor. Overrides PHP_CodeCoverage_Report_Node::__construct