自作して理解するxUnit / self-made-xunit

自作して理解するxUnit / self-made-xunit

PHPカンファレンス北海道2019で発表したxUnitを自作することで理解するというトークです

88964b936e864ca7d326272eaa70fa9a?s=128

Kazuki Higashiguchi

September 21, 2019
Tweet

Transcript

  1. © - BASE, Inc. X ⾃作して理解するxUnit . . PHP Conference

    Hokkaido - @hgsgtk
  2. © - BASE, Inc. : @hgsgtk Who am I? 東⼝

    和暉 ( Higashiguchi Kazuki ) Back-end Engineer (Go, PHP, Python ) BASE BANK, Inc. (BASE, Inc.) / Dev Division / Tech Lead
  3. © - BASE, Inc. 毎⽇仲良しテストコード

  4. © - BASE, Inc. ⾃分がPHPUnitの気持ちを知れば

  5. © - BASE, Inc. もっと仲良くなれる

  6. © - BASE, Inc. ⾃作して理解しよう

  7. © - BASE, Inc. ところでPHPUnitとは https://phpunit.de/

  8. © - BASE, Inc. xUnitとは テスティングフレームワークの総称 Kent Beck⽒が作成したSmalltalk製の SUnitが親となり、Java‧PHP .etcへ

    https://en.wikipedia.org/wiki/XUnit
  9. © - BASE, Inc. xUnitファミリーが持っている機能 • Test Method • Assertion

    Method • Test Suites • Run tests, Get report 参考書籍:Meszaros, Gerard. xUnit Test Patterns: Refactoring Test Code』
  10. © - BASE, Inc. 今⽇⾃作するもの • Test Method • Assertion

    Method • Test Suites • Run tests, Get report 参考書籍:Meszaros, Gerard. xUnit Test Patterns: Refactoring Test Code』
  11. © - BASE, Inc. いざ

  12. © - BASE, Inc. hgsgtk/mpunit https://github.com/hgsgtk/mpunit

  13. © - BASE, Inc. こんな感じのテストを実⾏したい

  14. © - BASE, Inc. xUnitファミリーが持っている機能 • Test Method • Assertion

    Method • Test Suites • Run tests, Get report 参考書籍:Meszaros, Gerard. xUnit Test Patterns: Refactoring Test Code』
  15. © - BASE, Inc. まずは実⾏可能コマンドを作成 /bin/mpunit

  16. © - BASE, Inc. Test Methodsをつくったら実⾏されるように .テストファイルを探す .テストクラスを探す .テストメソッドを探す .テストメソッドを実⾏する

  17. © - BASE, Inc. 1. テストファイルを探す /src/Command.php *Test.php のファイルを集める

  18. © - BASE, Inc. 2. テストクラスを探す /src/Command.php 定義済みクラスから、ユーザー定義型で MPUnit\TestCaseを 継承しているを探し出す

  19. © - BASE, Inc. (補⾜)クラスを集める • get_declared_classes() • 定義済みのクラスの名前を配列として返す •

    ReflectionClass::isUserDefined() • 内部クラスかどうかを検査 • ReflectionClass::getParentClass() • 親クラスの情報を取得 https://www.php.net/manual/ja/reflectionclass.isuserdefined.php https://www.php.net/manual/ja/function.get-declared-classes.php https://www.php.net/manual/ja/reflectionclass.getparentclass.php
  20. © - BASE, Inc. 3. テストメソッドを探す /src/Command.php テストクラスのPUBLICメソッドから、先頭が test で始まるメ

    ソッドを探す
  21. © - BASE, Inc. (補⾜)関数を集める • ReflectionClass::getMethods • クラスのメソッド名を取得 •

    ReflectionMethod::IS_PUBLIC etc https://www.php.net/manual/ja/reflectionclass.getmethods.php
  22. © - BASE, Inc. 4. テストメソッドを実⾏する /src/Command.php 実⾏、AssertionErrorがなければ成功(.)、あれば失敗(F)

  23. © - BASE, Inc. hgsgtk/mpunit https://github.com/hgsgtk/mpunit ⼀旦デモ 

  24. © - BASE, Inc. xUnitを知る • Test Methodの⾒つけ⽅の⼤きく2つ • Test

    Discovery‧Test Enumeration • 多くのxUnitファミリーは前者、フレー ムワークがテストメソッドを⾒つける、 ユーザーが⼿動で登録しなくていい
  25. © - BASE, Inc. 今⽇⾃作するもの • Test Method • Assertion

    Method • Test Suites • Run tests, Get report 参考書籍:Meszaros, Gerard. xUnit Test Patterns: Refactoring Test Code』
  26. © - BASE, Inc. なにでアサーションするか • assert function(PHP) • (Minimumにやりたかったので)

    • beberlei/assert • webmozart/assert • hamcrest/hamcrest-php etc
  27. © - BASE, Inc. assert関連の設定をする /bin/mpunit

  28. © - BASE, Inc. (補⾜)assert⽤の設定ディレクティブ • zend.assertions (default: ) •

    assert()を⽣成するか‧実⾏するか • 1 の場合、コードは⽣成され実⾏される • assert.exception (default: ) • アサーション失敗に指定したオブジェクトをス ロー • 指定なしだとAssertionError https://www.php.net/manual/ja/function.assert.php https://www.php.net/manual/ja/class.assertionerror.php
  29. © - BASE, Inc. (補⾜)assert⽤のオプション • 様々なassertフラグを設定できる • ASSERT_ACTIVE •

    ASSERT_WARNING • ASSERT_BAIL • ASSERT_QUIET_EVAL • ASSERT_CALLBACK https://www.php.net/manual/ja/function.assert-options.php
  30. © - BASE, Inc. assertion assert関数を実⾏

  31. © - BASE, Inc. こんな感じのテストを実⾏したい TestCaseを継承したクラスから assertSame が使えるように

  32. © - BASE, Inc. 実⾏結果

  33. © - BASE, Inc. まとめ • ⾃作すると、xUnitがどういうことをし てくれているか分かる(ex. Test Discovery)

    • テスティングフレームワークの提供者の 気持ちに近づき、ユーザーの僕らのテス トリテラシーも上がるのかもしれない
  34. © - BASE, Inc. hours 制作時間

  35. © - BASE, Inc. Special Thanks: 参考資料 • PHPでテスティングフレームワークを実装する前 に知っておきたい勘所

    / @tadsan • https://www.youtube.com/ watch?v=o YY JnAOwU • sebastianbergmann/phpunit • https://github.com/sebastianbergmann/ phpunit
  36. © - BASE, Inc. X みなさんもぜひ