From 02a5624c9fc036d5f53a23e8bffec241ecf01b3a Mon Sep 17 00:00:00 2001 From: Nobuo Kihara Date: Tue, 24 Feb 2015 22:46:13 +0900 Subject: [PATCH] docs/guide-ja/test reviewed [ci skip] --- docs/guide-ja/helper-html.md | 2 +- docs/guide-ja/test-environment-setup.md | 2 +- docs/guide-ja/test-overview.md | 21 ++++++++++---------- docs/guide-ja/test-unit.md | 26 ++++++++++++------------- 4 files changed, 26 insertions(+), 25 deletions(-) diff --git a/docs/guide-ja/helper-html.md b/docs/guide-ja/helper-html.md index 9eb3c5dba2..f7090df5dc 100644 --- a/docs/guide-ja/helper-html.md +++ b/docs/guide-ja/helper-html.md @@ -80,7 +80,7 @@ echo Html::tag('div', 'Pwede na', $options); $options = ['style' => ['width' => '100px', 'height' => '100px']]; // style="width: 100px; height: 200px; position: absolute;" となる -Html::addCssStyle($options, 'height: 200px; positon: absolute;'); +Html::addCssStyle($options, 'height: 200px; position: absolute;'); // style="position: absolute;" となる Html::removeCssStyle($options, ['width', 'height']); diff --git a/docs/guide-ja/test-environment-setup.md b/docs/guide-ja/test-environment-setup.md index 7c0652764c..2dbf28ca9e 100644 --- a/docs/guide-ja/test-environment-setup.md +++ b/docs/guide-ja/test-environment-setup.md @@ -5,7 +5,7 @@ Yii2 は [`Codeception`](https://github.com/Codeception/Codeception) テストフレームワークとの統合を公式にサポートしており、次のタイプのテストを作成することを可能にしています。 -- [ユニットテスト](test-unit.md) - 一つのコードユニットが期待通りに動くことを検証する。 +- [単体テスト](test-unit.md) - 一かたまりのコードが期待通りに動くことを検証する。 - [機能テスト](test-functional.md) - ブラウザのエミュレーションによって、ユーザの視点からシナリオを検証する。 - [承認テスト](test-acceptance.md) - ブラウザの中で、ユーザの視点からシナリオを検証する。 diff --git a/docs/guide-ja/test-overview.md b/docs/guide-ja/test-overview.md index f328011224..0880505e28 100644 --- a/docs/guide-ja/test-overview.md +++ b/docs/guide-ja/test-overview.md @@ -3,10 +3,11 @@ テストはソフトウェア開発の重要な部分です。 気付いているか否かにかかわらず、私たちは継続的にテストをしています。 -例えば、PHP でクラスを書くとき、私たちはステップごとにデバッグしたり、または単純に echo 文や die 文を使ったりして、実装が最初の計画通りに動作することを確認します。 +例えば、PHP でクラスを書くとき、私たちはステップごとにデバッグしたり、または単純に echo 文や die 文を使ったりして、実装が最初の計画通りに動作することを検証します。 ウェブアプリケーションの場合は、何らかのテストデータをフォームに入力して、ページがユーザと期待通りの相互作用をすることを確認します。 -テストを実行するプロセスを自動化して、何かを確認する必要があるときは、いつでも、それを代行してくれるコードを呼び出す必要があるだけにすることが出来ます。 -結果が計画したものと合致することを確認するコードがテストと呼ばれ、それを作成して更に実行するプロセスがテスト自動化として知られています。 + +テストを実行するプロセスを自動化して、何かを検証する必要があるときは、いつでも、それを代行してくれるコードを呼び出すだけでよいようにすることが出来ます。 +結果が計画したものと合致することを検証するコードがテストと呼ばれ、それを作成して更に実行するプロセスがテスト自動化として知られています。 このテストの章の主題は、このテストの自動化です。 @@ -14,7 +15,7 @@ ---------------------- テスト駆動開発 (TDD) とビヘイビア駆動開発 (BDD) のソフトウェア開発手法においては、実際のコードを書く前に、コードの断片または全体の機能の振る舞いを一連のシナリオまたはテストとして記述します。 -そして、その後で初めて、意図された振る舞いが達成されていることを確認するテストに合格する実装を作成します。 +そして、その後で初めて、テストに合格するように実装を作成して、意図された振る舞いが達成されていることを検証します。 一つの機能を開発するプロセスは以下のようになります。 @@ -47,7 +48,7 @@ ------------------------------ 上記で説明したテストファーストの手法は長期間にわたる比較的複雑なプロジェクトには合理的なものですが、簡単なプロジェクトでは、やりすぎとなるおそれもあります。 -この手法が適切であることを示す兆候は、いくつかあります。 +この手法が適切であることを示す指標がいくつかあります。 - プロジェクトは既に大きくて複雑である。 - プロジェクトの要求仕様が複雑になってきている。プロジェクトが継続的に大きくなっている。 @@ -56,17 +57,17 @@ 既存の実装の振る舞いをカバーするテストを作成することは、何も悪いことではありません。 -- プロジェクトはレガシーなもので、段階的な刷新が予定されている。 +- プロジェクトはレガシーなものであるが、段階的に刷新される予定である。 - 従事すべきプロジェクトを得たが、それにはテストがなかった。 -どんな形式の自動化テストもやりすぎになる、という場合もあり得ます。 +どんな形式の自動化テストもやりすぎになる、という場合もあるでしょう。 - プロジェクトは単純で、この先も、複雑になる心配はない。 -- これ以上かかわることはない一時的なプロジェクトである。 +- これ以上かかわることはない一度限りのプロジェクトである。 -このような場合であっても、時間に余裕があれば、テストを自動化することは良いことです。 +ただ、このような場合であっても、時間に余裕があれば、テストを自動化することは良いことです。 -参照 +参考 ---- - Test Driven Development: By Example / Kent Beck. ISBN: 0321146530. diff --git a/docs/guide-ja/test-unit.md b/docs/guide-ja/test-unit.md index 920c21b1ad..975182098d 100644 --- a/docs/guide-ja/test-unit.md +++ b/docs/guide-ja/test-unit.md @@ -1,26 +1,26 @@ -ユニットテスト -============== +単体テスト +========== > Note|注意: この節はまだ執筆中です。 -ユニットテストは、一ユニットのコードが期待通りに動作することを検証するものです。 -オブジェクト指向プログラミングでは、最も基本的なコードのユニットはクラスです。 -ユニットテストで主として必要となることは、従って、クラスの全てのインタフェイスメソッドが正しく動作することを検証することです。 -すなわち、さまざまな入力パラメータに対して、テストはメソッドが期待通りの結果を返すかどうかを検証します。 -ユニットテストは、通常は、テストされるクラスを書く人によって開発されます。 +単体テストは、一かたまりのコードが期待通りに動作することを検証するものです。 +オブジェクト指向プログラミングでは、最も基本的なコードのかたまりはクラスです。 +単体テストで主として必要となることは、従って、クラスの全てのインタフェイスメソッドが正しく動作することを検証することです。 +つまり、テストは、さまざまな入力パラメータに対してメソッドが期待通りの結果を返すかどうかを検証します。 +単体テストは、通常は、テストされるクラスを書く人によって開発されます。 -Yii におけるユニットテストは、PHPUnit と Codeception (こちらはオプションです) の上に構築されます。 +Yii における単体テストは、PHPUnit と Codeception (こちらはオプションです) の上に構築されます。 従って、それらのドキュメントを通読することが推奨されます。 - [PHPUnit のドキュメントの第2章以降](http://phpunit.de/manual/current/en/writing-tests-for-phpunit.html). - [Codeception Unit Tests](http://codeception.com/docs/06-UnitTests). -アプリケーションテンプレートのユニットテストを走らせる ------------------------------------------------------- +アプリケーションテンプレートの単体テストを走らせる +-------------------------------------------------- `apps/advanced/tests/README.md` および `apps/basic/tests/README.md` で提供されている説明を参照してください。 -フレームワークのユニットテスト ------------------------------- +フレームワークの単体テスト +-------------------------- -Yii フレームワーク自体に対するユニットテストを走らせたい場合は、"[Yii2 の開発を始めよう](https://github.com/yiisoft/yii2/blob/master/docs/internals-ja/getting-started.md)" に従ってください。 +Yii フレームワーク自体に対する単体テストを走らせたい場合は、"[Yii2 の開発を始めよう](https://github.com/yiisoft/yii2/blob/master/docs/internals-ja/getting-started.md)" の説明に従ってください。