{ "componentChunkName": "component---src-templates-blog-post-jsx", "path": "/post/how-to-parse-of-coverage-report-with-phpunit/", "result": {"data":{"site":{"siteMetadata":{"title":"WEB EGG","author":"Leko - CTO at Yuimedi"}},"markdownRemark":{"id":"9b587a68-6e13-5278-ac1a-70405af60857","excerpt":"こんにちは。 仕事の方でテストカバレッジをGUIなしに集計する必要が出たので、 メソッド単位のカバレッジを集計したい クラス単位でのカバレッジを集計したい ファイル単位でのカバレッジを集計したい ディレクトリ単位でのカバレッジを集計したい の集計をするために、PHPUnitが出力するClover形式のXML…","html":"

こんにちは。
\n仕事の方でテストカバレッジをGUIなしに集計する必要が出たので、

\n\n

の集計をするために、PHPUnitが出力するClover形式のXMLと格闘して得られた、XMLの構造と扱い方についてまとめてみました

\n\n

はじめに

\n

レガシーなPHPと戦っており、PHPUnitのバージョンは3.4です
\n最高につらい

\n

なので出力されるXMLの構造や属性名に差異があるかもしれません
\nまた、カバレッジレポートの出力方法はこちらのドキュメントを参照して下さい

\n

なお、PHPUnitのカバレッジレポート単体ではC0のカバレッジしか計測できませんでした
\n後述するlineタグのnum属性とcount属性の値を使って対象プログラムの静的解析かければ、解析できなくはないかもしれませんが、
\nカバレッジレポート単体ではC0のレポートしか出ません。

\n

カバレッジXMLの書式

\n

この当時のPHPUnitには--coverage-cloverというオプションがあります
\nこれがXML形式のカバレッジレポートを出力してくれるオプションです

\n

カバレッジレポート(XML)の基本的な構造

\n

XMLはざっくり、こんな感じになりました

\n
<coverage>\n  <project>\n    <file name=\"ファイルパス\">\n      <class\n        name=\"クラス名\"\n        namespace=\"名前空間\"\n      >\n        <!-- クラス単位でのメトリクス -->\n        <metrics\n          methods=\"クラス内のメソッド数\"\n          coveredmethods=\"カバレッジ100%のメソッド数\"\n          statements=\"クラス内の有効行数\"\n          coveredstatements=\"クラス内の行カバーしている有効行数\"\n        />\n      </class>\n\n<!-- ファイル内に定義されているクラスの分だけ上記繰り返し -->\n      <line\n        num=\"左記メソッドの定義開始行\"\n        type=\"method\"\n        name=\"メソッド名\"\n        count=\"テストでこの行を通過した回数\"\n      />\n      <line\n        num=\"行番号\"\n        type=\"stmt\"\n        count=\"テストでこの行を通過した回数\"\n      />\n\n<!-- メソッド定義のたびに type=\"method\" name=\"...\"が出現。それ以外は type=\"stmt\" -->\n\n<!-- ファイル単位でのメトリクス -->\n      <metrics\n        loc=\"ファイル内の有効行数\"\n        ncloc=\"カバーされていない有効行数\"\n        classes=\"ファイル内のクラス数\"\n        methods=\"ファイル内のメソッド数\"\n        coveredmethods=\"ファイル内の100%カバーされているメソッド数\"\n        statements=\"ファイル内の定義行を除いた有効行数\"\n        coveredstatements=\"行カバーされているファイル内の定義行を除いた有効行数\"\n      />\n    </file>  \n\n<!-- 対象カバレッジのメトリクス総まとめ -->\n    <metrics\n      files=\"カバレッジ集計対象のファイル数\"\n      loc=\"カバレッジ集計対象の有効行数\"\n      ncloc=\"カバレッジ集計対象のうちカバーされていない行数\"\n      classes=\"カバレッジ集計対象のクラス数\"\n      methods=\"カバレッジ集計対象のメソッド数\"\n      coveredmethods=\"カバレッジ集計対象のうち100%カバーされているメソッド数\"\n      statements=\"カバレッジ集計対象の有効行数（定義行を除く）\"\n      coveredstatements=\"カバレッジ集計対象のカバーされている有効行数（定義行を除く）\"\n    />\n  </project>\n</coverage>
\n

有効行数は、空白行やコメントアウトなどを除いた、PHPのコードとして評価される行数を指しています。

\n

クラス単位で行カバレッジを取る

\n

jsで書くと、

\n
const el = document.querySelector('class[name=\"クラス名\"][namespace=\"名前空間\"]>metrics')\nconsole.log(el.coveredstatements / el.statements)
\n

に相当します

\n

classタグ1つにつきmetricsタグが1つはいっているので、
\n目的のクラスの中にあるmetricsタグを抽出し、有効行数とカバーしている有効行数で比較できます。

\n

namespaceを入れないと衝突する恐れがあります。
\nもしその辺考慮しなくていいならnamespace属性は無視できます。

\n

ファイル単位で行カバレッジを取る

\n

ファイルも同じ要領で、fileタグ1つの直下にmetricsタグが1つ入っているので、それを比較します。

\n
const el = document.querySelector('file[name=\"ファイルパス\"]>metrics')\nconsole.log(el.coveredstatements / el.statements)
\n

ファイル名（basepath相当）ではなく、フルパスな点に注意です。
\nテストを実行（カバレッジ集計）した環境によって変わるのでご注意下さい。

\n

ディレクトリ単位でカバレッジを取る

\n

カバレッジレポートはfileタグ単位で纏まっているので、ディレクトリごとのカバレッジを完璧に取ることは困難です。
\nもしソースの実体があれば ディレクトリの中身を漁って有効行数を出すことが可能ですが、
\nソースの実体を持たない限り、カバレッジレポートに記載されているファイルしか計測対象になりません。

\n

その不完全な状態であれば、

\n
const metricses = document.querySelectorAll('file[name^=\"ディレクトリまでのパス\"]>metrics')\nconst dirMetrics = metricses.reduce((acc, metrics) => ({\n  statements: acc.statements + metrics.statements,\n  coveredstatements: acc.coveredstatements + metrics.coveredstatements,\n}), { coveredstatements: 0, statements: 0 })\n\nconsole.log(dirMetrics.coveredstatements / dirMetrics.statements)
\n

相当で取得可能です。
\nディレクトリ内部のファイルのメトリクスをかき集めて、最後に合算すれば算出可能です

\n

メソッド単位でカバレッジを取る

\n

※前置きでも話しましたが、バージョンアップによって改善されている可能性もあります。あくまで古いPHPUnitについて言及します。

\n

メソッド単位も、完全な情報は出せません
\nいや、正確にはメソッドに関するレポートなら出せます。が、関数に関するレポートが出せません しかも不完全な情報の収集ですら地味に面倒でした

\n

lineタグのtype属性はstmtかmethodにしかならず、関数の定義開始行はtype=stmtになってしまいます
\n関数対して判別可能な値が何もありません。計測不可能です

\n

これもソースの実体があれば静的解析と絡めてレポート可能だとは思いますが、レポート単体では計測不可能でした
\nなので関数のレポートは出ないという前提で良ければ、

\n
const classes = document.querySelectorAll('file[name=\"探したいファイル\"]>class[]')\nconst statementCounts = classes.map(cls => parseInt(cls.querySelector('metrics').statements, 10))\nconst lines = Array.from(document.querySelectorAll('file[name=\"探したいファイル\"]>line'))\nlet currentClass = classes[0].name\nlet currentMethod = null\nlet currentStatements = 0\nlet metrics = {}\nlines.forEach(line => {\n  if (line.type === 'method') {\n    currentMethod = line.name\n  } else if (line.type === 'stmt') {\n    if (!metrics[currentClass]) {\n      metrics[currentClass] = {}\n    }\n    if (!metrics[currentClass][currentMethod]) {\n      metrics[currentClass][currentMethod] = { statements: 0, coveredStatements: 0 }\n    }\n    if (parseInt(line.count, 10) > 0) {\n      metrics[currentClass][currentMethod].coveredStatements += 1\n    }\n    metrics[currentClass][currentMethod].statements += 1\n    currentStatements += 1\n  } else {\n    throw new Error('知らないタイプ:' + line.type)\n  }\n\n  if (currentStatements === parseInt(classes[0].statements)) {\n    classes.shift()\n    currentClass = classes[0].name\n    currentStatements = 0\n  }\n})\n\nconst methodMetrics = metrics[集計したいクラス][集計したいメソッド]\nconsole.log(methodMetrics.coveredStatements / methodMetrics.statements)
\n

ただし、これは不完全です
\n例えばクラスに属さない関数がファイルに含まれている場合に対応できません
\n完全なカバレッジを得るためにはソースコードと静的解析が必要です。

\n

PHPUnitの設定ファイルにてカバレッジ集計対象の設定をして、
\nテストに登場しなかったファイルもカバレッジ集計対象に加えることは可能ですが、結局のところ関数には対応できません

\n

まとめ

\n\n

結果的な感想としては「ツラい」のただ一言でした。

","timeToRead":8,"frontmatter":{"title":"PHPUnitのカバレッジレポート(XML)を使ってカバレッジの計算してみた","tags":["PHP","PHPUnit"],"date":"May 09, 2017","featuredImage":null}}},"pageContext":{"slug":"/how-to-parse-of-coverage-report-with-phpunit/","previous":{"fields":{"slug":"/how-to-fix-access-denied-in-aws-athena/"},"frontmatter":{"title":"AWS Athenaでテーブルを作る時にAccess Deniedと怒られたら試すこと","tags":["AWS","AWS Athena"]}},"next":{"fields":{"slug":"/knowhow-of-circleci-1/"},"frontmatter":{"title":"CircleCI 1.0でDockerやdocker-composeを使用する際の制限と気をつけること","tags":["CI","CircleCI","Docker","Docker compose"]}}}}, "staticQueryHashes": ["2585454260","2954598359"]}