updated

Author: github-actions[bot]

docs/reference/Commands.md

@@ -5,214 +5,171 @@ title: Commands - Codeception - Documentation
 
 # Console Commands
 
-## ConfigValidate
-
-Validates and prints Codeception config.
-Use it do debug Yaml configs
-
-Check config:
-
-* `codecept config`: check global config
-* `codecept config unit`: check suite config
-
-Load config:
-
-* `codecept config:validate -c path/to/another/config`: from another dir
-* `codecept config:validate -c another_config.yml`: from another config file
-
-Check overriding config values (like in `run` command)
-
-* `codecept config:validate -o "settings: shuffle: true"`: enable shuffle
-* `codecept config:validate -o "settings: lint: false"`: disable linting
-* `codecept config:validate -o "reporters: report: \Custom\Reporter" --report`: use custom reporter
-
-
-
-
-## GenerateCest
-
-Generates Cest (scenario-driven object-oriented test) file:
-
-* `codecept generate:cest suite Login`
-* `codecept g:cest suite subdir/subdir/testnameCest.php`
-* `codecept g:cest suite LoginCest -c path/to/project`
-* `codecept g:cest "App\Login"`
-
-
-
-
-## Build
-
-Generates Actor classes (initially Guy classes) from suite configs.
-Starting from Codeception 2.0 actor classes are auto-generated. Use this command to generate them manually.
-
-* `codecept build`
-* `codecept build path/to/project`
+## GenerateStepObject
 
+Generates StepObject class. You will be asked for steps you want to implement.
 
+* `codecept g:stepobject acceptance AdminSteps`
+* `codecept g:stepobject acceptance UserSteps --silent` - skip action questions
 
 
-## GenerateSnapshot
 
-Generates Snapshot.
-Snapshot can be used to test dynamical data.
-If suite name is provided, an actor class will be included into placeholder
 
-* `codecept g:snapshot UserEmails`
-* `codecept g:snapshot Products`
-* `codecept g:snapshot acceptance UserEmails`
+## GenerateFeature
 
+Generates Feature file (in Gherkin):
 
+* `codecept generate:feature suite Login`
+* `codecept g:feature suite subdir/subdir/login.feature`
+* `codecept g:feature suite login.feature -c path/to/project`
 
-## GenerateHelper
 
-Creates empty Helper class.
 
-* `codecept g:helper MyHelper`
-* `codecept g:helper "My\Helper"`
 
+## Console
 
+Try to execute test commands in run-time. You may try commands before writing the test.
 
+* `codecept console acceptance` - starts acceptance suite environment. If you use WebDriver you can manipulate browser with Codeception commands.
 
-## Bootstrap
 
-Creates default config, tests directory and sample suites for current project.
-Use this command to start building a test suite.
 
-By default it will create 3 suites **acceptance**, **functional**, and **unit**.
+## GeneratePageObject
 
-* `codecept bootstrap` - creates `tests` dir and `codeception.yml` in current dir.
-* `codecept bootstrap --empty` - creates `tests` dir without suites
-* `codecept bootstrap --namespace Frontend` - creates tests, and use `Frontend` namespace for actor classes and helpers.
-* `codecept bootstrap --actor Wizard` - sets actor as Wizard, to have `TestWizard` actor in tests.
-* `codecept bootstrap path/to/the/project` - provide different path to a project, where tests should be placed
+Generates PageObject. Can be generated either globally, or just for one suite.
+If PageObject is generated globally it will act as UIMap, without any logic in it.
 
+* `codecept g:page Login`
+* `codecept g:page Registration`
+* `codecept g:page acceptance Login`
 
 
 
-## GenerateTest
 
-Generates skeleton for Unit Test that extends `Codeception\TestCase\Test`.
+## GherkinSnippets
 
-* `codecept g:test unit User`
-* `codecept g:test unit "App\User"`
+Generates code snippets for matched feature files in a suite.
+Code snippets are expected to be implemented in Actor or PageObjects
 
+Usage:
 
+* `codecept gherkin:snippets acceptance` - snippets from all feature of acceptance tests
+* `codecept gherkin:snippets acceptance/feature/users` - snippets from `feature/users` dir of acceptance tests
+* `codecept gherkin:snippets acceptance user_account.feature` - snippets from a single feature file
+* `codecept gherkin:snippets acceptance/feature/users/user_accout.feature` - snippets from feature file in a dir
 
-## GenerateStepObject
 
-Generates StepObject class. You will be asked for steps you want to implement.
 
-* `codecept g:stepobject acceptance AdminSteps`
-* `codecept g:stepobject acceptance UserSteps --silent` - skip action questions
+## Clean
 
+Recursively cleans `output` directory and generated code.
 
+* `codecept clean`
 
 
-## GenerateFeature
 
-Generates Feature file (in Gherkin):
 
-* `codecept generate:feature suite Login`
-* `codecept g:feature suite subdir/subdir/login.feature`
-* `codecept g:feature suite login.feature -c path/to/project`
+## GenerateGroup
 
+Creates empty GroupObject - extension which handles all group events.
 
+* `codecept g:group Admin`
 
 
-## GenerateSuite
 
-Create new test suite. Requires suite name and actor name
+## DryRun
 
-* ``
-* `codecept g:suite api` -> api + ApiTester
-* `codecept g:suite integration Code` -> integration + CodeTester
-* `codecept g:suite frontend Front` -> frontend + FrontTester
+Shows step by step execution process for scenario driven tests without actually running them.
 
+* `codecept dry-run acceptance`
+* `codecept dry-run acceptance MyCest`
+* `codecept dry-run acceptance checkout.feature`
+* `codecept dry-run tests/acceptance/MyCest.php`
 
 
 
-## SelfUpdate
 
-Auto-updates phar archive from official site: 'https://codeception.com/codecept.phar' .
+## GenerateTest
 
-* `php codecept.phar self-update`
+Generates skeleton for Unit Test that extends `Codeception\TestCase\Test`.
 
-@author Franck Cassedanne <franck@cassedanne.com>
+* `codecept g:test unit User`
+* `codecept g:test unit "App\User"`
 
 
 
-## GenerateEnvironment
+## GenerateSnapshot
 
-Generates empty environment configuration file into envs dir:
+Generates Snapshot.
+Snapshot can be used to test dynamical data.
+If suite name is provided, an actor class will be included into placeholder
 
- * `codecept g:env firefox`
+* `codecept g:snapshot UserEmails`
+* `codecept g:snapshot Products`
+* `codecept g:snapshot acceptance UserEmails`
 
-Required to have `envs` path to be specified in `codeception.yml`
 
 
+## GenerateScenarios
 
-## DryRun
+Generates user-friendly text scenarios from scenario-driven tests (Cest).
 
-Shows step by step execution process for scenario driven tests without actually running them.
+* `codecept g:scenarios acceptance` - for all acceptance tests
+* `codecept g:scenarios acceptance --format html` - in html format
+* `codecept g:scenarios acceptance --path doc` - generate scenarios to `doc` dir
 
-* `codecept dry-run acceptance`
-* `codecept dry-run acceptance MyCest`
-* `codecept dry-run acceptance checkout.feature`
-* `codecept dry-run tests/acceptance/MyCest.php`
 
 
+## GenerateHelper
 
+Creates empty Helper class.
 
-## Init
+* `codecept g:helper MyHelper`
+* `codecept g:helper "My\Helper"`
 
 
 
 
-## GenerateScenarios
+## GenerateCest
 
-Generates user-friendly text scenarios from scenario-driven tests (Cest).
+Generates Cest (scenario-driven object-oriented test) file:
 
-* `codecept g:scenarios acceptance` - for all acceptance tests
-* `codecept g:scenarios acceptance --format html` - in html format
-* `codecept g:scenarios acceptance --path doc` - generate scenarios to `doc` dir
+* `codecept generate:cest suite Login`
+* `codecept g:cest suite subdir/subdir/testnameCest.php`
+* `codecept g:cest suite LoginCest -c path/to/project`
+* `codecept g:cest "App\Login"`
 
 
 
-## CompletionFallback
 
+## Build
 
+Generates Actor classes (initially Guy classes) from suite configs.
+Starting from Codeception 2.0 actor classes are auto-generated. Use this command to generate them manually.
 
-## GeneratePageObject
+* `codecept build`
+* `codecept build path/to/project`
 
-Generates PageObject. Can be generated either globally, or just for one suite.
-If PageObject is generated globally it will act as UIMap, without any logic in it.
 
-* `codecept g:page Login`
-* `codecept g:page Registration`
-* `codecept g:page acceptance Login`
 
 
+## SelfUpdate
 
-## Console
+Auto-updates phar archive from official site: 'https://codeception.com/codecept.phar' .
 
-Try to execute test commands in run-time. You may try commands before writing the test.
+* `php codecept.phar self-update`
 
-* `codecept console acceptance` - starts acceptance suite environment. If you use WebDriver you can manipulate browser with Codeception commands.
+@author Franck Cassedanne <franck@cassedanne.com>
 
 
 
-## GherkinSnippets
+## GenerateEnvironment
 
-Generates code snippets for matched feature files in a suite.
-Code snippets are expected to be implemented in Actor or PageObjects
+Generates empty environment configuration file into envs dir:
 
-Usage:
+ * `codecept g:env firefox`
 
-* `codecept gherkin:snippets acceptance` - snippets from all feature of acceptance tests
-* `codecept gherkin:snippets acceptance/feature/users` - snippets from `feature/users` dir of acceptance tests
-* `codecept gherkin:snippets acceptance user_account.feature` - snippets from a single feature file
-* `codecept gherkin:snippets acceptance/feature/users/user_accout.feature` - snippets from feature file in a dir
+Required to have `envs` path to be specified in `codeception.yml`
 
 
 
@@ -304,20 +261,19 @@ Options:
 
 
 
-## Clean
-
-Recursively cleans `output` directory and generated code.
-
-* `codecept clean`
+## CompletionFallback
 
 
 
+## GenerateSuite
 
-## GenerateGroup
+Create new test suite. Requires suite name and actor name
 
-Creates empty GroupObject - extension which handles all group events.
+* ``
+* `codecept g:suite api` -> api + ApiTester
+* `codecept g:suite integration Code` -> integration + CodeTester
+* `codecept g:suite frontend Front` -> frontend + FrontTester
 
-* `codecept g:group Admin`
 
 
 
@@ -333,3 +289,47 @@ codecept gherkin:steps acceptance
 
 
 
+## Bootstrap
+
+Creates default config, tests directory and sample suites for current project.
+Use this command to start building a test suite.
+
+By default it will create 3 suites **acceptance**, **functional**, and **unit**.
+
+* `codecept bootstrap` - creates `tests` dir and `codeception.yml` in current dir.
+* `codecept bootstrap --empty` - creates `tests` dir without suites
+* `codecept bootstrap --namespace Frontend` - creates tests, and use `Frontend` namespace for actor classes and helpers.
+* `codecept bootstrap --actor Wizard` - sets actor as Wizard, to have `TestWizard` actor in tests.
+* `codecept bootstrap path/to/the/project` - provide different path to a project, where tests should be placed
+
+
+
+
+## Init
+
+
+
+## ConfigValidate
+
+Validates and prints Codeception config.
+Use it do debug Yaml configs
+
+Check config:
+
+* `codecept config`: check global config
+* `codecept config unit`: check suite config
+
+Load config:
+
+* `codecept config:validate -c path/to/another/config`: from another dir
+* `codecept config:validate -c another_config.yml`: from another config file
+
+Check overriding config values (like in `run` command)
+
+* `codecept config:validate -o "settings: shuffle: true"`: enable shuffle
+* `codecept config:validate -o "settings: lint: false"`: disable linting
+* `codecept config:validate -o "reporters: report: \Custom\Reporter" --report`: use custom reporter
+
+
+
+