読者です 読者をやめる 読者になる 読者になる

絶品ゆどうふのタレ

ふと気づいたことを綴るだけのメモ

DocTestがあちこちで流行ってる?

今日まで全然気づかなかったけど、いつの間にかPEARにDocTestパッケージが追加されていました。

Testing_DocTest allows the developer to write unit tests directly in the <code></code> blocs of your functions, classes and class methods doc comments.

It comes with a default runner (phpdt) that will parse all your <code></code> blocs and will run the extracted tests.
Running tests is as simple as:

$ phpdt /path/to/your/code

There are several advantages in using Testing_DocTest:
it makes unit tests writing funnier, easier and quicker (there's no infrastructure to setup, you just install the package, write your code examples tests and you're done !);
it ensures that doc comments are up-to-date by verifying that all examples work as documented;
it enforces writing of tutorial documentation, liberally illustrated with input-output examples.

Testing_DocTest

DocTestが流行り出している感じがしますねー。
コメントに書いておけばいいという手軽さは魅力ですよね。心の負担が軽くなります。