We are finally ready to show you the Codeception 2.1. Since RC we stabilized its codebase, and we encourage you to start all your new projects with Codeception 2.1. As well as migrate old ones. Codeception 2.1 is aimed for consistency and provide you the better experience for testing your web applications. This new release makes tests even more simple to read, write, and maintain.
If you didn’t track for the changes in master we will list all the new features here:
- We added Recorder extension, which is probably the most fancy feature you may try. Using it you can record test execution history by saving a screenshot of each step. This is handy for running tests on CI, debugging tests executed via PhantomJS or showing nice reports to your boss.
- Updated to Guzzle 6. Codeception can now work both with Guzzle v5 and Guzzle v6. PhpBrowser chooses right connector depending on Guzzle version installed.
- PSR-4: all support classes moved to
tests/_supportby default. Actors, Helpers, PageObjects, StepObjects, GroupObjects to follow PSR-4 naming style. New
UnitTesterclasses are expected to be extended with methods of common behaviors there. For instance, it is a good idea to place
loginmethod into the actor class:
- Dependency Injection: support classes can be injected into tests. Support classes can be injected into each other too.
- Module config simplified: Modules can be configured in
enabledsection of suite config. Take a look of this sample declaration of Api suite, there is no
configsection inside modules.
modules: enabled: - WebDriver: url: https://codeception.com browser: firefox - \Helper\Acceptance
- Dependencies: module can explicitly define dependencies and expect their injection. REST, SOAP and Doctrine2 modules rely on another module which should be explicitly set via
class_name: ApiTester modules: enabled: - REST: url: https://api.github.com/ depends: PhpBrowser - \Helper\Api
As you can see, you don’t need to specify
enabled section, you can set it only via
Conflicts: module can define conflicts with each other. Modules that share similar interfaces like
PhpBrowser, and framework modules won’t run together. You should avoid enabling more than one of those modules in suite config to avoid confusion. If you enable
$I->amOnPage('/')you can’t be sure how this command is exected - will it open a browser window using WebDriver protocol, or it will be handled by Laravel framework directly.
Current modules, environment, and test name can be received in scenario.
- Environment Matrix: You can run tests combining several environments by separating their names by comma:
codecept run --env dev,phantom --env dev,chrome --env dev,firefox
Environments can now be stored in separate configuration files in
tests/_envs dir created with
tests/_envs |── chrome.yml |── phantom.yml |── firefox.yml |── dev.yml
- Cept files should avoid setting their metadata via
$scenariomethods. Instead of calling
$scenario->group('firefox'), etc, it is recommended to set scenario settings with annotations
// @group firefox. However, you can use
$scenario->skipwhenever you need to do it on some condition, like
Improved HTML reports
Modules can be partially loaded. If you need only some actions to be included into tester objects. For instance, you want to have REST API tests with Laravel5 module. In this case you probably don’t want methods from Laravel module like
seeto be included into the
ApiTesteras they interact with HTML pages, which we are not supposed to use. But you still need Laravel ORM methods like
seeRecordto verify that changes were saved to database. In this case you can enable only ORM methods of Laravel5 module.
modules: enabled: - Laravel5: part: ORM - REST: part: Json depends: Laravel5
As for REST module you can load methods only for API format you are using. You can choose either XML or Json, so only methods for Json or XML will be loaded.
- Whenever you have steps grouped inside actor class, pageobject, or stepobject, you can the step executed with its substeps in console or HTML report.
- RunFailed extension is enabled by default for all new projects. It means that you can rerun your failed tests by executing
codecept run -g failedwhen this extension is enabled. 1
And lots of other notable improvements which you can see in changelog.
Starting from Codeception 2.1 we recommend using Cest as a default format for all scenario-driven acceptance and functional, or api tests. Guides were rewritten to reflect new improved approaches to testing that you should practice by using Codeception.
- It is pretty easy to upgrade from 2.0. The only thing you should start with is to rebuild your actor classes by running
codecept buildcommand. The old actor classes (
*Guy) in suite directories should be deleted manually.
- REST, SOAP, Doctrine2 module will need to be configured to use a dependent module as it was shown above. You will get a detailed exception with configuration example once you execute tests with those modules.
- Helpers, PageObjects, StepObjects are expected to follow PSR-4 standard and use namespaces. It is recommended to rename classes to replace suffixes with namespaces, like
Page\User. However, those changes are not required, so you can keep your support objects without changes.
If you are using 2.0 and you won’t plan to upgrade in nearest future, you can still use releases from 2.0 branch. Minor fixes and improvements will still be accepted there. Also the site will contain documentation for 2.0 and 2.1 versions.
Try Codeception 2.1 today by installing it via Composer:
composer require "codeception/codeception:*" --dev
or by downloading it as Phar archive
And provide a feedback!