initial commit

tests/README.md

@@ -0,0 +1,58 @@
+This directory contains various tests for the advanced applications.
+
+Tests in `codeception` directory are developed with [Codeception PHP Testing Framework](http://codeception.com/).
+
+After creating and setting up the advanced application, follow these steps to prepare for the tests:
+
+1. Install Codeception if it's not yet installed:
+
+   ```
+   composer global require "codeception/codeception=2.0.*" "codeception/specify=*" "codeception/verify=*"
+   ```
+
+   If you've never used Composer for global packages run `composer global status`. It should output:
+
+   ```
+   Changed current directory to <directory>
+   ```
+
+   Then add `<directory>/vendor/bin` to you `PATH` environment variable. Now you're able to use `codecept` from command
+   line globally.
+
+2. Install faker extension by running the following from template root directory where `composer.json` is:
+
+   ```
+   composer require --dev yiisoft/yii2-faker:*
+   ```
+
+3. Create `yii2_advanced_tests` database then update it by applying migrations:
+
+   ```
+   codeception/bin/yii migrate
+   ```
+
+4. In order to be able to run acceptance tests you need to start a webserver. The simplest way is to use PHP built in
+   webserver. In the root directory where `common`, `frontend` etc. are execute the following:
+
+   ```
+   php -S localhost:8080
+   ```
+
+5. Now you can run the tests with the following commands, assuming you are in the `tests/codeception` directory:
+
+   ```
+   # frontend tests
+   cd frontend
+   codecept build
+   codecept run
+   
+   # backend tests
+   
+   cd backend
+   codecept build
+   codecept run
+    
+   # etc.
+   ```
+
+  If you already have run `codecept build` for each application, you can skip that step and run all tests by a single `codecept run`.