![C:?Users?ishida?src?phpspec>vendor?bin?phpspec run
Markdown
10 - it is initializable
class Markdown does not exist.
/ skipped: 0% / pending: 0% / passed: 0% / failed: 0% / broken:
100%
/ 1 examples
1 specs
1 example (1 broken)
24ms
Do you want me to create `Markdown` for you?
[Y/n]
Class Markdown created in C:?Users?ishida?src?phpspec?src?Markdown.php.
/ skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0%
/ 1 examples
1 specs
1 example (1 passed)
50ms
スペックを実行すると、スペックの対象である
Markdownクラスが無いので作りますか？と聞
かれます](https://image.slidesharecdn.com/phpspec-150613065856-lva1-app6891/85/phpspec-London-School-TDD-20-320.jpg)
![C:?Users?ishida?src?phpspec>vendor?bin?phpspec run
/ skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0%
Markdown
15 - it converts plain text to paragraph
method Markdown::toHtml not found.
/ skipped: 0% / pending: 0% / passed: 50% / failed: 0% / broken: 50%
/ 2 examples
1 specs
2 examples (1 passed, 1 broken)
32ms
Do you want me to create `Markdown::toHtml()` for you?
[Y/n]
Method Markdown::toHtml() has been created.
/ skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0%
Markdown
15 - it converts plain text to paragraph
expected "<p>Hi, there</p>", but got null.
/ skipped: 0% / pending: 0% / passed: 50% / failed: 50% / broken: 0%
/ 2 examples
1 specs
2 examples (1 passed, 1 failed)
38ms
toHtml()メソッドがないので作りますか？](https://image.slidesharecdn.com/phpspec-150613065856-lva1-app6891/85/phpspec-London-School-TDD-24-320.jpg)
![C:?Users?ishida?src?phpspec>vendor?bin?phpspec run --fake
/ skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0%
Markdown
15 - it converts plain text to paragraph
expected "<p>Hi, there</p>", but got null.
/ skipped: 0% / pending: 0% / passed: 50% / failed: 50% / broken: 0%
/ 2 examples
1 specs
2 examples (1 passed, 1 failed)
67ms
Do you want me to make `Markdown::toHtml()` always return '<p>Hi,
there</p>' for you?
[Y/n]
Method Markdown::toHtml() has been modified.
/ skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0%
/ 2 examples
1 specs
2 examples (2 passed)
27ms
toHtml()メソッドが常に"<p>Hi, there</p>"を返す
ようにしますか？](https://image.slidesharecdn.com/phpspec-150613065856-lva1-app6891/85/phpspec-London-School-TDD-25-320.jpg)
![C:?Users?ishida?src?phpspec>vendor?bin?phpspec run --fake
...
Would you like me to generate an interface `Reader` for you?
[Y/n]
...
Would you like me to generate a method signature
`Reader::getMarkdown()` for you?
[Y/n]
...
Do you want me to create `Markdown::toHtmlFromReader()` for you?
[Y/n]
...
Do you want me to make `Markdown::toHtmlFromReader()` always
return '<p>Hi, there</p>' for you?
[Y/n]
Method Markdown::toHtmlFromReader() has been modified.
/ skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0%
/ 3 examples
1 specs
3 examples (3 passed)
43ms
Reader::getMarkdown()と
Makkdown::toHtmlFromReader()の仮実装の
自動生成](https://image.slidesharecdn.com/phpspec-150613065856-lva1-app6891/85/phpspec-London-School-TDD-32-320.jpg)
![class MarkdownTest extends ?PHPUnit_Framework_TestCase
{
function test_output_converted_text()
{
$writer = $this->getMockBuilder('Writer')
->setMethods(['writeText'])
->getMock();
$writer->expects($this->once())
->method('writeText')
->with($this->equalTo("<p>Hi,
there</p>"));
$markdown = new Markdown();
$markdown->outputHtml("Hi, there", $writer);
}
但しPHPUnit4.5以降では、Prophecyという
phpspecのMockフレームワークを使うこともで
きます
ちなみにPHPUnitで書くと](https://image.slidesharecdn.com/phpspec-150613065856-lva1-app6891/85/phpspec-London-School-TDD-36-320.jpg)
phpspecで学ぶLondon School TDD
- 1. phpspecで学ぶ London School TDD オープンソースカンファレンス2015 HOKKAIDO 2015.6.13
- 5. Motivation PHPの偉い人でもTDDの偉い人でもありません あと特別英語が得意なわけでもありません でもphpspecもLondon School TDDも日本ではあまり情報量が多くな い（海外のPHPコミュニティでは度々話題になっている模様） 本当はこういう話を自分で話すんじゃなく誰かにしてほしい ガチ勢から見ると突っ込みどころあるかもしれませんが出来るだ け自分の言葉で説明したいと思います 最後に沢山参考資料へのリンクを付たよ お客様の中で London PHPコミュ ニティの方はい らっしゃいますか
- 6. London school TDD ロンドンのXPコミュニティが発祥 モックを積極的に使い、状態ではなく振る舞いに注目したTDDの 手法 Growing Object-Oriented Software Guided By Tests(2009) 通称The GOOS Book 実践テスト駆動開発(2012) phpspecの作者「London school TDDを学ぶ上でベストなリソース」 (Full Stack Radio #15) ただし結構難しい本 ? GUIあり、ネットワーク通信あり、マルチスレッドあり ? 難しい問題を解決する手法を解説しようとすると、例も難しくなると いう技術書のジレンマ
- 7. 個人的な体験として The GOOS Bookを読む → 「なるほど（わからん）」 phpspecを知る → 「なるほど（わからん）」 phpspecについて調べる → 「それThe GOOS Bookに書いてあるよ」 The GOOS Bookを読む → 「ホンマや！」 ? phpspecを学ぶこ とでLondon School TDDが理解できた （気がする） phpspecを使えば London School TDD を上手く説明でき るのでは？
- 9. 依存関係 Bが無いとAを作れない CとDが無いとBを作れない どのように単体テストを行うか class A { function __construct(B $b) { } } class B { function __construct(C $c, D $d) { } } class C { } class D { }
- 10. Outside-In/Inside-Out class A { function __construct(B $b) { } } class B { function __construct(C $c, D $d) { } } class C { } class D { } Outside-In ? Bをダミー（Mock, Stub）に置き換え てAをテストする ? AがBに要求しているものが明確にな る Inside-Out ? C,Dを先に実装してからBを実装する ? テストの粒度は次第に大きくなる ? ダミーを実装する手間はかからない ? Bを実装中はAが存在しないので、A がBに何を要求するかわからない
- 13. Spec, Example class MarkdownSpec extends ObjectBehavior { } function it_is_initializable() { $this->shouldHaveType('Markdown'); } function its_xxxxxx() { .... } そのオブジェクト をどのように使う かという例を集め たものがSpecとな る
- 16. { "require-dev": { "phpspec/phpspec": "~2.2" }, "autoload": { "psr-4": { "": "src/" } } } 標準構成ではソースをsrc/、スペックをspec/に 配置します。それ以外の場合や.phpspec.ymlで 設定が必要です PSR-0でも問題ありません composer.json
- 17. Getting Started ?MarkdownをHTMLに変換するMarkdownクラスのSpecを例に説明 します ?といっても"Hi, there"を"<p>Hi, there</p>"に変換するだけ ?公式ドキュメントと同じサンプルですいません
- 18. C:?Users?ishida?src?phpspec>vendor?bin?phpspec desc Markdown Specification for Markdown created in C:?Users?ishida?src?phpspec?spec?MarkdownSpec.php. MarkdownクラスのSpecのひな形を作成します phpspecコマンドを使わずに作ってもよいです
- 19. <?php namespace spec; use PhpSpec?ObjectBehavior; use Prophecy?Argument; class MarkdownSpec extends ObjectBehavior { function it_is_initializable() { $this->shouldHaveType('Markdown'); } } spec/MarkdownSpec.php MarkdownクラスのSpecはMarkdownSpecとなり ます。各exampleメソッドはit_又はits_から始ま ります
- 20. C:?Users?ishida?src?phpspec>vendor?bin?phpspec run Markdown 10 - it is initializable class Markdown does not exist. / skipped: 0% / pending: 0% / passed: 0% / failed: 0% / broken: 100% / 1 examples 1 specs 1 example (1 broken) 24ms Do you want me to create `Markdown` for you? [Y/n] Class Markdown created in C:?Users?ishida?src?phpspec?src?Markdown.php. / skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0% / 1 examples 1 specs 1 example (1 passed) 50ms スペックを実行すると、スペックの対象である Markdownクラスが無いので作りますか？と聞 かれます
- 22. ... class MarkdownSpec extends ObjectBehavior { function it_converts_plain_text_to_paragraph() { // $this->toHtml("Hi, there")が // "<p>Hi, there</p>" を返却すること } } spec/MarkdownSpec.php
- 23. ... class MarkdownSpec extends ObjectBehavior { function it_converts_plain_text_to_paragraph() { $this->toHtml("Hi, there") ->shouldReturn("<p>Hi, there</p>"); } } spec/MarkdownSpec.php shouldBe, shouldBeEqualTo, shouldEqualToとも書 けます
- 24. C:?Users?ishida?src?phpspec>vendor?bin?phpspec run / skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0% Markdown 15 - it converts plain text to paragraph method Markdown::toHtml not found. / skipped: 0% / pending: 0% / passed: 50% / failed: 0% / broken: 50% / 2 examples 1 specs 2 examples (1 passed, 1 broken) 32ms Do you want me to create `Markdown::toHtml()` for you? [Y/n] Method Markdown::toHtml() has been created. / skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0% Markdown 15 - it converts plain text to paragraph expected "<p>Hi, there</p>", but got null. / skipped: 0% / pending: 0% / passed: 50% / failed: 50% / broken: 0% / 2 examples 1 specs 2 examples (1 passed, 1 failed) 38ms toHtml()メソッドがないので作りますか？
- 25. C:?Users?ishida?src?phpspec>vendor?bin?phpspec run --fake / skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0% Markdown 15 - it converts plain text to paragraph expected "<p>Hi, there</p>", but got null. / skipped: 0% / pending: 0% / passed: 50% / failed: 50% / broken: 0% / 2 examples 1 specs 2 examples (1 passed, 1 failed) 67ms Do you want me to make `Markdown::toHtml()` always return '<p>Hi, there</p>' for you? [Y/n] Method Markdown::toHtml() has been modified. / skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0% / 2 examples 1 specs 2 examples (2 passed) 27ms toHtml()メソッドが常に"<p>Hi, there</p>"を返す ようにしますか？
- 26. <?php class Markdown { public function toHtml($argument1) { return '<p>Hi, there</p>'; } } src/Markdown.php 仮実装ができました。
- 29. class MarkdownSpec extends ObjectBehavior { ... function it_convers_text_from_an_external_source() { // $reader->getMarkdown()が"Hi, there"を返すとする $this->toHtmlFromReader($reader) ->shouldReturn("<p>Hi, there</p>"); } spec/MarkdownSpec.php
- 30. class MarkdownSpec extends ObjectBehavior { ... function it_convers_text_from_an_external_source() { $reader->getMarkdown()->willReturn("Hi, there"); $this->toHtmlFromReader($reader) ->shouldReturn("<p>Hi, there</p>"); } spec/MarkdownSpec.php
- 31. use Reader; class MarkdownSpec extends ObjectBehavior { ... function it_convers_text_from_an_external_source(Reader $reader) { $reader->getMarkdown()->willReturn("Hi, there"); $this->toHtmlFromReader($reader) ->shouldReturn("<p>Hi, there</p>"); } spec/MarkdownSpec.php exampleに仮引数を書くとPhpSpecが$readerを渡 してくれる
- 32. C:?Users?ishida?src?phpspec>vendor?bin?phpspec run --fake ... Would you like me to generate an interface `Reader` for you? [Y/n] ... Would you like me to generate a method signature `Reader::getMarkdown()` for you? [Y/n] ... Do you want me to create `Markdown::toHtmlFromReader()` for you? [Y/n] ... Do you want me to make `Markdown::toHtmlFromReader()` always return '<p>Hi, there</p>' for you? [Y/n] Method Markdown::toHtmlFromReader() has been modified. / skipped: 0% / pending: 0% / passed: 100% / failed: 0% / broken: 0% / 3 examples 1 specs 3 examples (3 passed) 43ms Reader::getMarkdown()と Makkdown::toHtmlFromReader()の仮実装の 自動生成
- 34. use Writer; class MarkdownSpec extends ObjectBehavior { ... function it_outputs_converted_text(Writer $writer) { // $writer->writeText("<p>Hi, there</p>") // が呼び出されること $this->outputHtml("Hi, there", $writer); } spec/MarkdownSpec.php
- 35. use Writer; class MarkdownSpec extends ObjectBehavior { ... function it_outputs_converted_text(Writer $writer) { $writer->writeText("<p>Hi, there</p>") ->shouldBeCalled(); $this->outputHtml("Hi, there", $writer); } spec/MarkdownSpec.php できました
- 36. class MarkdownTest extends ?PHPUnit_Framework_TestCase { function test_output_converted_text() { $writer = $this->getMockBuilder('Writer') ->setMethods(['writeText']) ->getMock(); $writer->expects($this->once()) ->method('writeText') ->with($this->equalTo("<p>Hi, there</p>")); $markdown = new Markdown(); $markdown->outputHtml("Hi, there", $writer); } 但しPHPUnit4.5以降では、Prophecyという phpspecのMockフレームワークを使うこともで きます ちなみにPHPUnitで書くと
- 37. コンストラクタ Writerをメソッドの引数ではなくコンストラクタの引数として渡 し $markdown = new Markdown(); $markdown->outputHtml($text, $writer); ではなく $markdown = new Markdown($writer); $markdown->outputHtml($text); にする
- 38. use Writer; class MarkdownSpec extends ObjectBehavior { ... function it_outputs_converted_text(Writer $writer) { $writer->writeText("<p>Hi, there</p>") ->shouldBeCalled(); $this->outputHtml("Hi, there", $writer); } spec/MarkdownSpec.php $writerをoutputHtmlの引数ではなく、 コンストラクタで渡したい
- 39. use Writer; class MarkdownSpec extends ObjectBehavior { ... function let(Writer $writer) { $this->beConstructedWith($writer); } function it_outputs_converted_text($writer) { $writer->writeText("<p>Hi, there</p>") ->shouldBeCalled(); $this->outputHtml("Hi, there"); } spec/MarkdownSpec.php letは各exampleの前に実行される letとexampleの引数には同じ$writerが渡される （変数名が重要）
- 42. なぜinterface? class FileStorage implements Reader, Writer { ... } class Markdown { function toHtmlFromReader(Reader $reader) {...} function toHtmlFromReader(FileStorage $reader) {...} } このメソッドに最 低限必要なものを 表せている
- 47. まとめ ?London school TDDでは、モックを使って、テスト対象と隣接する オブジェクトとのコミュニケーションをテストする ?外から中へアプローチすることで、必要なインターフェースを 導き出す ?phpspecを使うとモックを簡単に作成することができる ?モック出来ないものに対してはアダプタを作成する ?phpspecは、London school TDDの考え方を上手く表現したツール ?phpspecで書かれたThe GOOS Bookみたいな本が出るとうれしい
- 49. 参考資料 phpspec2: SUS and collaborators(2012) (http://everzet.com/post/33178339051/sus-collaborators) phpspec2のalphaリリース時の作者によるコンセプトの解説 Konstantin Kudryashov - Design How Your Objects Talk Through Mocking at Laracon EU 2014 (https://www.youtube.com/watch?v=X6y-OyMPqfw) Laracon EUでの作者によるモックを使った開発手法に関する講演。 phpspec自体は使われていない Does TDD really lead to good design? (http://codurance.com/2015/05/12/does-tdd-lead-to-good-design/) Detroit schoolとLondon Schoolの比較など Laracast (https://laracasts.com/index/phpspec) LaravelやPHPに関するスクリーンキャスト。一部無料