Merge pull request #661 from Codeception/update-directories-in-docs

Use new directory structure in documentation

Author: Naktibalda

docs/06-ReusingTestCode.md

@@ -100,7 +100,7 @@ php vendor/bin/codecept generate:pageobject acceptance Login
 
 > It is recommended to use page objects for acceptance testing only
 
-This will create a `Login` class in `tests/_support/Page/Acceptance`.
+This will create a `Login` class in `tests/Support/Page/Acceptance`.
 The basic PageObject is nothing more than an empty class with a few stubs.
 
 It is expected that you will populate it with the UI locators of a page it represents. Locators can be added as public properties:
@@ -210,7 +210,7 @@ Add action to StepObject class (ENTER to exit):
 StepObject was created in /tests/acceptance/_support/Step/Acceptance/Admin.php
 ```
 
-This will generate a class in `/tests/_support/Step/Acceptance/Admin.php` similar to this:
+This will generate a class in `/tests/Support/Step/Acceptance/Admin.php` similar to this:
 
 ```php
 <?php

docs/07-BDD.md

@@ -443,8 +443,8 @@ Text values inside a scenarios can be set inside a `"""` block:
 paths:
     tests: tests
     log: tests/_output
-    data: tests/_data
-    helpers: tests/_support
+    data: tests/Support/Data
+    helpers: tests/Support
     envs: tests/_envs
 """
 ```

docs/08-Customization.md

@@ -189,7 +189,7 @@ Extensions have some basic methods you can use:
 ### Enabling Extension
 
 Once you've implemented a simple extension class, you can require it in `tests/_bootstrap.php`,
-load it with Composer's autoloader defined in `composer.json`, or store the class inside `tests/_support`dir.
+load it with Composer's autoloader defined in `composer.json`, or store the class inside `tests/Support`dir.
 
 You can then enable it in `codeception.yml`
 
@@ -320,7 +320,7 @@ For instance, for `nocleanup` group we prevent Doctrine2 module from wrapping te
 ```
 
 A group class can be created with `php vendor/bin/codecept generate:group groupname` command.
-Group classes will be stored in the `tests/_support/Group` directory.
+Group classes will be stored in the `tests/Support/Group` directory.
 
 A group class can be enabled just like you enable an extension class. In the file `codeception.yml`:
 
@@ -413,7 +413,7 @@ A group file can be included by its relative filename:
 ```yaml
 groups:
   # requiring a group file
-  slow: tests/_data/slow.txt
+  slow: tests/Support/Data/slow.txt
 
 ```
 
@@ -424,11 +424,11 @@ You can even specify patterns for loading multiple group files with a single def
 
 ```yaml
 groups:
-  p*: tests/_data/p*
+  p*: tests/Support/Data/p*
 
 ```
 
-This will load all found `p*` files in `tests/_data` as groups. Group names will be as follows p1,p2,...,pN.
+This will load all found `p*` files in `tests/Support/Data` as groups. Group names will be as follows p1,p2,...,pN.
 
 ## Formats
 

docs/09-Data.md

@@ -48,7 +48,7 @@ modules:
             dsn: 'PDO DSN HERE'
             user: 'root'
             password:
-            dump: tests/_data/your-dump-name.sql
+            dump: tests/Support/Data/your-dump-name.sql
             cleanup: true # reload dump between tests
             populate: true # load dump before all tests
 
@@ -66,7 +66,7 @@ modules:
           password: ''
           cleanup: true # run populator before each test
           populate: true # run populator before all test
-          populator: 'mysql -u $user $dbname < tests/_data/dump.sql'
+          populator: 'mysql -u $user $dbname < tests/Support/Data/dump.sql'
 ```
 
 See the [Db module reference](https://codeception.com/docs/modules/Db#SQL-data-dump) for more examples.
@@ -319,7 +319,7 @@ public function testCategoriesAreTheSame(AcceptanceTester $I, \Tests\Snapshot\Ca
 }
 ```
 
-On the first run, data will be obtained via `fetchData` method and saved to `tests/_data` directory in json format.
+On the first run, data will be obtained via `fetchData` method and saved to `tests/Support/Data` directory in json format.
 On next execution the obtained data will be compared with previously saved snapshot.
 
 > To update a snapshot with new data, run tests in `--debug` mode.

docs/12-ParallelExecution.md

@@ -160,15 +160,15 @@ public function parallelSplitTests()
     $this->taskSplitTestFilesByGroups(5)
         ->projectRoot('.')
         ->testsFrom('tests/acceptance')
-        ->groupsTo('tests/_data/paracept_')
+        ->groupsTo('tests/Support/Data/paracept_')
         ->run();
 
     /*
     // Split your tests by single tests (alternatively)
     $this->taskSplitTestsByGroups(5)
         ->projectRoot('.')
         ->testsFrom('tests/acceptance')
-        ->groupsTo('tests/_data/paracept_')
+        ->groupsTo('tests/Support/Data/paracept_')
         ->run();
     */
 }
@@ -188,19 +188,19 @@ The output should be similar to this:
 
 ```
  [Codeception\Task\SplitTestFilesByGroupsTask] Processing 33 files
- [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/_data/paracept_1
- [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/_data/paracept_2
- [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/_data/paracept_3
- [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/_data/paracept_4
- [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/_data/paracept_5
+ [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/Support/Data/paracept_1
+ [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/Support/Data/paracept_2
+ [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/Support/Data/paracept_3
+ [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/Support/Data/paracept_4
+ [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/Support/Data/paracept_5
 
 ```
 
 Now we have group files. We should update `codeception.yml` to load generated group files. In our case we have groups: *paracept_1*, *paracept_2*, *paracept_3*, *paracept_4*, *paracept_5*.
 
 ```yaml
 groups:
-    paracept_*: tests/_data/paracept_*
+    paracept_*: tests/Support/Data/paracept_*
 ```
 
 Let's try to execute tests from the second group:

docs/BDD.md

@@ -443,8 +443,8 @@ Text values inside a scenarios can be set inside a `"""` block:
 paths:
     tests: tests
     log: tests/_output
-    data: tests/_data
-    helpers: tests/_support
+    data: tests/Support/Data
+    helpers: tests/Support
     envs: tests/_envs
 """
 ```

docs/Customization.md

@@ -189,7 +189,7 @@ Extensions have some basic methods you can use:
 ### Enabling Extension
 
 Once you've implemented a simple extension class, you can require it in `tests/_bootstrap.php`,
-load it with Composer's autoloader defined in `composer.json`, or store the class inside `tests/_support`dir.
+load it with Composer's autoloader defined in `composer.json`, or store the class inside `tests/Support`dir.
 
 You can then enable it in `codeception.yml`
 
@@ -320,7 +320,7 @@ For instance, for `nocleanup` group we prevent Doctrine2 module from wrapping te
 ```
 
 A group class can be created with `php vendor/bin/codecept generate:group groupname` command.
-Group classes will be stored in the `tests/_support/Group` directory.
+Group classes will be stored in the `tests/Support/Group` directory.
 
 A group class can be enabled just like you enable an extension class. In the file `codeception.yml`:
 
@@ -413,7 +413,7 @@ A group file can be included by its relative filename:
 ```yaml
 groups:
   # requiring a group file
-  slow: tests/_data/slow.txt
+  slow: tests/Support/Data/slow.txt
 
 ```
 
@@ -424,11 +424,11 @@ You can even specify patterns for loading multiple group files with a single def
 
 ```yaml
 groups:
-  p*: tests/_data/p*
+  p*: tests/Support/Data/p*
 
 ```
 
-This will load all found `p*` files in `tests/_data` as groups. Group names will be as follows p1,p2,...,pN.
+This will load all found `p*` files in `tests/Support/Data` as groups. Group names will be as follows p1,p2,...,pN.
 
 ## Formats
 

docs/Data.md

@@ -48,7 +48,7 @@ modules:
             dsn: 'PDO DSN HERE'
             user: 'root'
             password:
-            dump: tests/_data/your-dump-name.sql
+            dump: tests/Support/Data/your-dump-name.sql
             cleanup: true # reload dump between tests
             populate: true # load dump before all tests
 
@@ -66,7 +66,7 @@ modules:
           password: ''
           cleanup: true # run populator before each test
           populate: true # run populator before all test
-          populator: 'mysql -u $user $dbname < tests/_data/dump.sql'
+          populator: 'mysql -u $user $dbname < tests/Support/Data/dump.sql'
 ```
 
 See the [Db module reference](https://codeception.com/docs/modules/Db#SQL-data-dump) for more examples.
@@ -319,7 +319,7 @@ public function testCategoriesAreTheSame(AcceptanceTester $I, \Tests\Snapshot\Ca
 }
 ```
 
-On the first run, data will be obtained via `fetchData` method and saved to `tests/_data` directory in json format.
+On the first run, data will be obtained via `fetchData` method and saved to `tests/Support/Data` directory in json format.
 On next execution the obtained data will be compared with previously saved snapshot.
 
 > To update a snapshot with new data, run tests in `--debug` mode.

docs/ParallelExecution.md

@@ -160,15 +160,15 @@ public function parallelSplitTests()
     $this->taskSplitTestFilesByGroups(5)
         ->projectRoot('.')
         ->testsFrom('tests/acceptance')
-        ->groupsTo('tests/_data/paracept_')
+        ->groupsTo('tests/Support/Data/paracept_')
         ->run();
 
     /*
     // Split your tests by single tests (alternatively)
     $this->taskSplitTestsByGroups(5)
         ->projectRoot('.')
         ->testsFrom('tests/acceptance')
-        ->groupsTo('tests/_data/paracept_')
+        ->groupsTo('tests/Support/Data/paracept_')
         ->run();
     */
 }
@@ -188,19 +188,19 @@ The output should be similar to this:
 
 ```
  [Codeception\Task\SplitTestFilesByGroupsTask] Processing 33 files
- [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/_data/paracept_1
- [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/_data/paracept_2
- [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/_data/paracept_3
- [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/_data/paracept_4
- [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/_data/paracept_5
+ [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/Support/Data/paracept_1
+ [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/Support/Data/paracept_2
+ [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/Support/Data/paracept_3
+ [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/Support/Data/paracept_4
+ [Codeception\Task\SplitTestFilesByGroupsTask] Writing tests/Support/Data/paracept_5
 
 ```
 
 Now we have group files. We should update `codeception.yml` to load generated group files. In our case we have groups: *paracept_1*, *paracept_2*, *paracept_3*, *paracept_4*, *paracept_5*.
 
 ```yaml
 groups:
-    paracept_*: tests/_data/paracept_*
+    paracept_*: tests/Support/Data/paracept_*
 ```
 
 Let's try to execute tests from the second group:

docs/ReusingTestCode.md

@@ -100,7 +100,7 @@ php vendor/bin/codecept generate:pageobject acceptance Login
 
 > It is recommended to use page objects for acceptance testing only
 
-This will create a `Login` class in `tests/_support/Page/Acceptance`.
+This will create a `Login` class in `tests/Support/Page/Acceptance`.
 The basic PageObject is nothing more than an empty class with a few stubs.
 
 It is expected that you will populate it with the UI locators of a page it represents. Locators can be added as public properties:
@@ -210,7 +210,7 @@ Add action to StepObject class (ENTER to exit):
 StepObject was created in /tests/acceptance/_support/Step/Acceptance/Admin.php
 ```
 
-This will generate a class in `/tests/_support/Step/Acceptance/Admin.php` similar to this:
+This will generate a class in `/tests/Support/Step/Acceptance/Admin.php` similar to this:
 
 ```php
 <?php