Display optional project name instead of absolute root in HTML renderer. Fixes sebastianbergmann#235 in sebastianbergmann/php-code-coverage

Indent with space

phpdoc

Conflicts:
	src/CodeCoverage/Report/HTML.php
	src/CodeCoverage/Report/HTML/Renderer.php
	src/CodeCoverage/Report/HTML/Renderer/Dashboard.php
	src/CodeCoverage/Report/HTML/Renderer/File.php

Author: Gabriel Zerbib

src/CodeCoverage/Report/HTML.php

@@ -35,18 +35,31 @@ class PHP_CodeCoverage_Report_HTML
      */
     private $highLowerBound;
 
+    /**
+     * @var string
+     */
+    private $absoluteRoot;
+    /**
+     * @var string
+     */
+    private $projectPrefix;
+    
     /**
      * Constructor.
      *
      * @param int    $lowUpperBound
      * @param int    $highLowerBound
      * @param string $generator
+     * @param string  $absoluteRoot Optional: root path of the sources under analysis
+     * @param string  $projectPrefix Optional: name of project, to display as replacement for absoluteRoot
      */
-    public function __construct($lowUpperBound = 50, $highLowerBound = 90, $generator = '')
+    public function __construct($lowUpperBound = 50, $highLowerBound = 90, $generator = '', $absoluteRoot = null, $projectPrefix = null)
     {
         $this->generator      = $generator;
         $this->highLowerBound = $highLowerBound;
         $this->lowUpperBound  = $lowUpperBound;
+        $this->absoluteRoot   = $absoluteRoot;
+        $this->projectPrefix  = $projectPrefix;
 
         $this->templatePath = sprintf(
             '%s%sHTML%sRenderer%sTemplate%s',
@@ -79,23 +92,29 @@ public function process(PHP_CodeCoverage $coverage, $target)
             $this->generator,
             $date,
             $this->lowUpperBound,
-            $this->highLowerBound
+            $this->highLowerBound,
+            $this->absoluteRoot,
+            $this->projectPrefix
         );
 
         $directory = new PHP_CodeCoverage_Report_HTML_Renderer_Directory(
             $this->templatePath,
             $this->generator,
             $date,
             $this->lowUpperBound,
-            $this->highLowerBound
+            $this->highLowerBound,
+            $this->absoluteRoot,
+            $this->projectPrefix
         );
 
         $file = new PHP_CodeCoverage_Report_HTML_Renderer_File(
             $this->templatePath,
             $this->generator,
             $date,
             $this->lowUpperBound,
-            $this->highLowerBound
+            $this->highLowerBound,
+            $this->absoluteRoot,
+            $this->projectPrefix
         );
 
         $directory->render($report, $target . 'index.html');

src/CodeCoverage/Report/HTML/Renderer.php

@@ -47,6 +47,16 @@ abstract class PHP_CodeCoverage_Report_HTML_Renderer
      */
     protected $version;
 
+    /**
+     * @var string
+     */
+    protected $absoluteRoot;
+
+    /**
+     * @var string
+     */
+    protected $projectPrefix;
+
     /**
      * Constructor.
      *
@@ -55,8 +65,10 @@ abstract class PHP_CodeCoverage_Report_HTML_Renderer
      * @param string $date
      * @param int    $lowUpperBound
      * @param int    $highLowerBound
+     * @param string  $absoluteRoot Optional: root path of the sources under analysis
+     * @param string  $projectPrefix Optional: name of project, to display as replacement for absoluteRoot
      */
-    public function __construct($templatePath, $generator, $date, $lowUpperBound, $highLowerBound)
+    public function __construct($templatePath, $generator, $date, $lowUpperBound, $highLowerBound, $absoluteRoot = null, $projectPrefix = null)
     {
         $version = new SebastianBergmann\Version('2.2.2', dirname(dirname(dirname(dirname(__DIR__)))));
 
@@ -66,6 +78,8 @@ public function __construct($templatePath, $generator, $date, $lowUpperBound, $h
         $this->lowUpperBound  = $lowUpperBound;
         $this->highLowerBound = $highLowerBound;
         $this->version        = $version->getVersion();
+        $this->absoluteRoot   = $absoluteRoot;
+        $this->projectPrefix  = $projectPrefix;
     }
 
     /**
@@ -203,7 +217,7 @@ protected function getActiveBreadcrumb(PHP_CodeCoverage_Report_Node $node)
     {
         $buffer = sprintf(
             '        <li class="active">%s</li>' . "\n",
-            $node->getName()
+            $this->stripProjectPrefixFromNodeName($node)
         );
 
         if ($node instanceof PHP_CodeCoverage_Report_Node_Directory) {
@@ -213,6 +227,31 @@ protected function getActiveBreadcrumb(PHP_CodeCoverage_Report_Node $node)
         return $buffer;
     }
 
+    /**
+     * An evolved version of PHP_CodeCoverage_Report_Node::getName(), which replaces
+     *  the optional absoluteRoot prefix in the node's full path, with specified
+     * project name.
+     * @param  PHP_CodeCoverage_Report_Node $node
+     * @return string
+     */
+    protected function stripProjectPrefixFromNodeName(PHP_CodeCoverage_Report_Node $node)
+    {
+        if ($this->absoluteRoot) {
+            return preg_replace(
+                '#^' . $this->absoluteRoot . '#', 
+                $this->projectPrefix, 
+                $node->getName());
+        }
+        else 
+            return $node->getName();
+    }
+
+
+    /**
+     * @param  PHP_CodeCoverage_Report_Node $node
+     * @param  $pathToRoot
+     * @return string
+     */
     protected function getInactiveBreadcrumb(PHP_CodeCoverage_Report_Node $node, $pathToRoot)
     {
         return sprintf(

src/CodeCoverage/Report/HTML/Renderer/Dashboard.php

@@ -289,7 +289,9 @@ protected function getActiveBreadcrumb(PHP_CodeCoverage_Report_Node $node)
         return sprintf(
             '        <li><a href="index.html">%s</a></li>' . "\n" .
             '        <li class="active">(Dashboard)</li>' . "\n",
-            $node->getName()
+            //Do not always print the full absolute path of $node here:
+            //optionally replace prefix
+            $this->stripProjectPrefixFromNodeName($node)
         );
     }
 }

src/CodeCoverage/Report/HTML/Renderer/File.php

@@ -50,15 +50,19 @@ class PHP_CodeCoverage_Report_HTML_Renderer_File extends PHP_CodeCoverage_Report
      * @param string $date
      * @param int    $lowUpperBound
      * @param int    $highLowerBound
+     * @param string  $absoluteRoot Optional: see parent
+     * @param string  $projectPrefix Optional: see parent
      */
-    public function __construct($templatePath, $generator, $date, $lowUpperBound, $highLowerBound)
+    public function __construct($templatePath, $generator, $date, $lowUpperBound, $highLowerBound, $absoluteRoot = null, $projectPrefix = null)
     {
         parent::__construct(
             $templatePath,
             $generator,
             $date,
             $lowUpperBound,
-            $highLowerBound
+            $highLowerBound,
+            $absoluteRoot,
+            $projectPrefix
         );
 
         $this->htmlspecialcharsFlags = ENT_COMPAT;