waltz/band

Waltz.Band is core libraries for Waltz framework

Waltz, a TDD framework

What's Waltz

Waltzは「楽して・楽しく・リズムよく」をコンセプトとしたTDDフレームワークです。PHPUnitをベースにして、PHPでTDDをやり易くする為の色々な機能を提供します。, _(*1)

Installation

Composerを利用しているプロジェクトにWaltzを導入する場合は、以下の設定をcomposer.jsonに追加して、Composerのinstallを実行して下さい。, _(*2)

{
    "require": {
        "waltz/band": "*"
    }
}

Composerを利用していない場合は、上記の設定を記載したcomposer.jsonファイルを作成し、以下のコマンドを実行する事で、Waltzをインストールできます。, _(*3)

$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar install

Getting Started

Waltz.Bandはユニットテストを実行する為のいくつかの方法を提供しています。, _(*4)

Simple band

Simple bandは、既に作成済みのPHPUnitテストファイルを実行する為の機能です。, _(*5)

Waltz.Bandプロダクト内に実行スクリプトが用意されているので、プロジェクトのディレクトリにコピーして実行できます。, _(*6)

$ cd {Project directory}
$ mkdir scripts
$ cp vendor/waltz/band/scripts/simple_test_runner.php scripts/
$ php scripts/simple_test_runner.php {Tests directory}

{Project directory}は、Waltzをインストールしたプロジェクトのディレクトリです。, _(*7)

{Tests direcotry}は、実行対象のPHPUnitテストファイルが置かれているディレクトリです。, _(*8)

DocTest band

DocTest bandは、Docコメントに記載したテストコードを実行する為の機能です。, _(*9)

以下のようにDocコメントに書かれたテストコードを直接実行する事ができます。, _(*10)

<?php
class HelloWorld {
    /**
     * #test 指定された名前に挨拶する
     * <code>
     * $this->assertSame('Hello Waltz!', $this->_target->hello('Waltz'));
     * </code>
     */
    public function hello($name = 'World') {
        return "Hello {$name}!";
    }
}

Simple bandと同じように、Waltz.Bandプロダクト内のスクリプトをプロジェクトのディレクトリにコピーして実行できます。, _(*11)

$ cd {Project directory}
$ vi hello.php
$ mkdir scripts
$ cp vendor/waltz/band/scripts/doctest_runner.php scripts/
$ php scripts/doctest_runner.php hello.php

DocTest bandではテストコードの記法にいくつかのシンタックスシュガーを利用できます。, _(*12)

<?php
class HelloWorld {
    /**
     * #test 指定された名前に挨拶する
     * <code>
     * #eq('Hello Waltz!', #f('Waltz'));
     * #same('Hello Waltz!', #f('Waltz'));
     * #true('Hello Waltz!' === #f('Waltz'));
     * #false('Hello World!' === #f('Waltz'));
     * </code>
     */
    public function hello($name = 'World') {
        return "Hello {$name}!";
    }
}