abstract class PHP_CodeCoverage_Report_Node

abstract class PHP_CodeCoverage_Report_Node implements Countable {

  /**
   * @var string
   */
  protected $name;

  /**
   * @var string
   */
  protected $path;

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

  /**
   * @var PHP_CodeCoverage_Report_Node
   */
  protected $parent;

  /**
   * @var string
   */
  protected $id;

  /**
   * Constructor.
   *
   * @param string                       $name
   * @param PHP_CodeCoverage_Report_Node $parent
   */
  public function __construct($name, PHP_CodeCoverage_Report_Node $parent = NULL) {
    if (substr($name, -1) == '/') {
      $name = substr($name, 0, -1);
    }
    $this->name = $name;
    $this->parent = $parent;
  }

  /**
   * @return string
   */
  public function getName() {
    return $this->name;
  }

  /**
   * @return string
   */
  public function getId() {
    if ($this->id === NULL) {
      $parent = $this
        ->getParent();
      if ($parent === NULL) {
        $this->id = 'index';
      }
      else {
        $parentId = $parent
          ->getId();
        if ($parentId == 'index') {
          $this->id = str_replace(':', '_', $this->name);
        }
        else {
          $this->id = $parentId . '_' . $this->name;
        }
      }
    }
    return $this->id;
  }

  /**
   * @return string
   */
  public function getPath() {
    if ($this->path === NULL) {
      if ($this->parent === NULL) {
        $this->path = $this->name;
      }
      else {
        $this->path = $this->parent
          ->getPath() . '/' . $this->name;
      }
    }
    return $this->path;
  }

  /**
   * @return array
   */
  public function getPathAsArray() {
    if ($this->pathArray === NULL) {
      if ($this->parent === NULL) {
        $this->pathArray = array();
      }
      else {
        $this->pathArray = $this->parent
          ->getPathAsArray();
      }
      $this->pathArray[] = $this;
    }
    return $this->pathArray;
  }

  /**
   * @return PHP_CodeCoverage_Report_Node
   */
  public function getParent() {
    return $this->parent;
  }

  /**
   * Returns the percentage of classes that has been tested.
   *
   * @param  boolean $asString
   * @return integer
   */
  public function getTestedClassesPercent($asString = TRUE) {
    return PHP_CodeCoverage_Util::percent($this
      ->getNumTestedClasses(), $this
      ->getNumClasses(), $asString);
  }

  /**
   * Returns the percentage of traits that has been tested.
   *
   * @param  boolean $asString
   * @return integer
   */
  public function getTestedTraitsPercent($asString = TRUE) {
    return PHP_CodeCoverage_Util::percent($this
      ->getNumTestedTraits(), $this
      ->getNumTraits(), $asString);
  }

  /**
   * Returns the percentage of traits that has been tested.
   *
   * @param  boolean $asString
   * @return integer
   * @since  Method available since Release 1.2.0
   */
  public function getTestedClassesAndTraitsPercent($asString = TRUE) {
    return PHP_CodeCoverage_Util::percent($this
      ->getNumTestedClassesAndTraits(), $this
      ->getNumClassesAndTraits(), $asString);
  }

  /**
   * Returns the percentage of methods that has been tested.
   *
   * @param  boolean $asString
   * @return integer
   */
  public function getTestedMethodsPercent($asString = TRUE) {
    return PHP_CodeCoverage_Util::percent($this
      ->getNumTestedMethods(), $this
      ->getNumMethods(), $asString);
  }

  /**
   * Returns the percentage of executed lines.
   *
   * @param  boolean $asString
   * @return integer
   */
  public function getLineExecutedPercent($asString = TRUE) {
    return PHP_CodeCoverage_Util::percent($this
      ->getNumExecutedLines(), $this
      ->getNumExecutableLines(), $asString);
  }

  /**
   * Returns the number of classes and traits.
   *
   * @return integer
   * @since  Method available since Release 1.2.0
   */
  public function getNumClassesAndTraits() {
    return $this
      ->getNumClasses() + $this
      ->getNumTraits();
  }

  /**
   * Returns the number of tested classes and traits.
   *
   * @return integer
   * @since  Method available since Release 1.2.0
   */
  public function getNumTestedClassesAndTraits() {
    return $this
      ->getNumTestedClasses() + $this
      ->getNumTestedTraits();
  }

  /**
   * Returns the classes and traits of this node.
   *
   * @return array
   * @since  Method available since Release 1.2.0
   */
  public function getClassesAndTraits() {
    return array_merge($this
      ->getClasses(), $this
      ->getTraits());
  }

  /**
   * Returns the classes of this node.
   *
   * @return array
   */
  public abstract function getClasses();

  /**
   * Returns the traits of this node.
   *
   * @return array
   */
  public abstract function getTraits();

  /**
   * Returns the functions of this node.
   *
   * @return array
   */
  public abstract function getFunctions();

  /**
   * Returns the LOC/CLOC/NCLOC of this node.
   *
   * @return array
   */
  public abstract function getLinesOfCode();

  /**
   * Returns the number of executable lines.
   *
   * @return integer
   */
  public abstract function getNumExecutableLines();

  /**
   * Returns the number of executed lines.
   *
   * @return integer
   */
  public abstract function getNumExecutedLines();

  /**
   * Returns the number of classes.
   *
   * @return integer
   */
  public abstract function getNumClasses();

  /**
   * Returns the number of tested classes.
   *
   * @return integer
   */
  public abstract function getNumTestedClasses();

  /**
   * Returns the number of traits.
   *
   * @return integer
   */
  public abstract function getNumTraits();

  /**
   * Returns the number of tested traits.
   *
   * @return integer
   */
  public abstract function getNumTestedTraits();

  /**
   * Returns the number of methods.
   *
   * @return integer
   */
  public abstract function getNumMethods();

  /**
   * Returns the number of tested methods.
   *
   * @return integer
   */
  public abstract function getNumTestedMethods();

  /**
   * Returns the number of functions.
   *
   * @return integer
   */
  public abstract function getNumFunctions();

  /**
   * Returns the number of tested functions.
   *
   * @return integer
   */
  public abstract function getNumTestedFunctions();

}