HtmlCoverageReport.php 6.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207
  1. <?php
  2. /**
  3. * Generates code coverage reports in HTML from data obtained from PHPUnit
  4. *
  5. * PHP5
  6. *
  7. * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
  8. * Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
  9. *
  10. * Licensed under The MIT License
  11. * Redistributions of files must retain the above copyright notice.
  12. *
  13. * @copyright Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
  14. * @link http://cakephp.org CakePHP(tm) Project
  15. * @package Cake.TestSuite.Coverage
  16. * @since CakePHP(tm) v 2.0
  17. * @license MIT License (http://www.opensource.org/licenses/mit-license.php)
  18. */
  19. App::uses('BaseCoverageReport', 'TestSuite/Coverage');
  20. /**
  21. * Generates code coverage reports in HTML from data obtained from PHPUnit
  22. *
  23. * @package Cake.TestSuite.Coverage
  24. */
  25. class HtmlCoverageReport extends BaseCoverageReport {
  26. /**
  27. * Generates report html to display.
  28. *
  29. * @return string compiled html report.
  30. */
  31. public function report() {
  32. $pathFilter = $this->getPathFilter();
  33. $coverageData = $this->filterCoverageDataByPath($pathFilter);
  34. if (empty($coverageData)) {
  35. return '<h3>No files to generate coverage for</h3>';
  36. }
  37. $output = $this->coverageScript();
  38. $output .= <<<HTML
  39. <h3>Code coverage results
  40. <a href="#" onclick="coverage_toggle_all()" class="coverage-toggle">Toggle all files</a>
  41. </h3>
  42. HTML;
  43. foreach ($coverageData as $file => $coverageData) {
  44. $fileData = file($file);
  45. $output .= $this->generateDiff($file, $fileData, $coverageData);
  46. }
  47. return $output;
  48. }
  49. /**
  50. * Generates an HTML diff for $file based on $coverageData.
  51. *
  52. * Handles both PHPUnit3.5 and 3.6 formats.
  53. *
  54. * 3.5 uses -1 for uncovered, and -2 for dead.
  55. * 3.6 uses array() for uncovered and null for dead.
  56. *
  57. * @param string $filename Name of the file having coverage generated
  58. * @param array $fileLines File data as an array. See file() for how to get one of these.
  59. * @param array $coverageData Array of coverage data to use to generate HTML diffs with
  60. * @return string HTML diff.
  61. */
  62. public function generateDiff($filename, $fileLines, $coverageData) {
  63. $output = '';
  64. $diff = array();
  65. list($covered, $total) = $this->_calculateCoveredLines($fileLines, $coverageData);
  66. //shift line numbers forward one;
  67. array_unshift($fileLines, ' ');
  68. unset($fileLines[0]);
  69. foreach ($fileLines as $lineno => $line) {
  70. $class = 'ignored';
  71. $coveringTests = array();
  72. if (!empty($coverageData[$lineno]) && is_array($coverageData[$lineno])) {
  73. $coveringTests = array();
  74. foreach ($coverageData[$lineno] as $test) {
  75. $class = (is_array($test) && isset($test['id'])) ? $test['id'] : $test;
  76. $testReflection = new ReflectionClass(current(explode('::', $class)));
  77. $this->_testNames[] = $this->_guessSubjectName($testReflection);
  78. $coveringTests[] = $class;
  79. }
  80. $class = 'covered';
  81. } elseif (isset($coverageData[$lineno]) && ($coverageData[$lineno] === -1 || $coverageData[$lineno] === array())) {
  82. $class = 'uncovered';
  83. } elseif (array_key_exists($lineno, $coverageData) && ($coverageData[$lineno] === -2 || $coverageData[$lineno] === null)) {
  84. $class .= ' dead';
  85. }
  86. $diff[] = $this->_paintLine($line, $lineno, $class, $coveringTests);
  87. }
  88. $percentCovered = 100;
  89. if ($total > 0) {
  90. $percentCovered = round(100 * $covered / $total, 2);
  91. }
  92. $output .= $this->coverageHeader($filename, $percentCovered);
  93. $output .= implode("", $diff);
  94. $output .= $this->coverageFooter();
  95. return $output;
  96. }
  97. /**
  98. * Guess the classname the test was for based on the test case filename.
  99. *
  100. * @param ReflectionClass $testReflection.
  101. * @return string Possible test subject name.
  102. */
  103. protected function _guessSubjectName($testReflection) {
  104. $basename = basename($testReflection->getFilename());
  105. if (strpos($basename, '.test') !== false) {
  106. list($subject, ) = explode('.', $basename, 2);
  107. return $subject;
  108. }
  109. $subject = str_replace('Test.php', '', $basename);
  110. return $subject;
  111. }
  112. /**
  113. * Renders the html for a single line in the html diff.
  114. *
  115. * @param string $line
  116. * @param integer $linenumber
  117. * @param string $class
  118. * @param array $coveringTests
  119. * @return void
  120. */
  121. protected function _paintLine($line, $linenumber, $class, $coveringTests) {
  122. $coveredBy = '';
  123. if (!empty($coveringTests)) {
  124. $coveredBy = "Covered by:\n";
  125. foreach ($coveringTests as $test) {
  126. $coveredBy .= $test . "\n";
  127. }
  128. }
  129. return sprintf(
  130. '<div class="code-line %s" title="%s"><span class="line-num">%s</span><span class="content">%s</span></div>',
  131. $class,
  132. $coveredBy,
  133. $linenumber,
  134. htmlspecialchars($line)
  135. );
  136. }
  137. /**
  138. * generate some javascript for the coverage report.
  139. *
  140. * @return void
  141. */
  142. public function coverageScript() {
  143. return <<<HTML
  144. <script type="text/javascript">
  145. function coverage_show_hide(selector) {
  146. var element = document.getElementById(selector);
  147. element.style.display = (element.style.display == 'none') ? '' : 'none';
  148. }
  149. function coverage_toggle_all() {
  150. var divs = document.querySelectorAll('div.coverage-container');
  151. var i = divs.length;
  152. while (i--) {
  153. if (divs[i] && divs[i].className.indexOf('primary') == -1) {
  154. divs[i].style.display = (divs[i].style.display == 'none') ? '' : 'none';
  155. }
  156. }
  157. }
  158. </script>
  159. HTML;
  160. }
  161. /**
  162. * Generate an HTML snippet for coverage headers
  163. *
  164. * @param string $filename
  165. * @param string $percent
  166. * @return void
  167. */
  168. public function coverageHeader($filename, $percent) {
  169. $filename = basename($filename);
  170. list($file, $ext) = explode('.', $filename);
  171. $display = in_array($file, $this->_testNames) ? 'block' : 'none';
  172. $primary = $display == 'block' ? 'primary' : '';
  173. return <<<HTML
  174. <div class="coverage-container $primary" style="display:$display;">
  175. <h4>
  176. <a href="#coverage-$filename" onclick="coverage_show_hide('coverage-$filename');">
  177. $filename Code coverage: $percent%
  178. </a>
  179. </h4>
  180. <div class="code-coverage-results" id="coverage-$filename" style="display:none;">
  181. <pre>
  182. HTML;
  183. }
  184. /**
  185. * Generate an HTML snippet for coverage footers
  186. *
  187. * @return void
  188. */
  189. public function coverageFooter() {
  190. return "</pre></div></div>";
  191. }
  192. }