layout: post

title: "In Threshold of Codeception 2.2. Upcoming Features"

date: 2016-03-05 01:03:50

Codeception 2.2 is going to land in nearest weeks. We planned to release it much earlier, but as we are not bound to specific date, we decided to work more on improvements and include the most tasty ones in next release. In this and following blogposts we will review the most significant of upcoming features. So take a look what we prepared for you.

We don't plan any major breaking changes in this release. However, we will remove deprecations, as you may know we display deprecation warnings in output, so this break should be at least predictable.

Yes, Codeception is finally will unlock it's dependency on PHPUnit 4.8 so you could receive the latest stable versions of PHPUnit. As you may know PHPUnit 5.x has much better support of PHP7, so anyone who develop using the latest version of PHP should use it. But wait, it's not the feature of Codeception 2.2 itself! Codeception 2.1.7 will be released with PHPUnit 5.x support as well.

Finally `@depends` annotation works as you might expected it to. The hardest thing about dependencies is that PHPUnit does nothing to organize dependent tests in a right order:

So their usage in Codeception was useless, especially if you were executing tests in random order with `shuffle: true` configuration. Some test frameworks, like minitest from Ruby run tests in shuffle by default. On the contrary PHPUnit restricts that, test with `@depends` annotation must be be executed after the test it relies on. It actually requires you to declare dependent tests in the same file and use the exact order of test execution.

Codeception takes the exact `@depends` annotation, reorders tests so dependent tests always will executed after the tests they rely on. This will work for Cest and Test formats both. And you can actually declare dependencies for tests in other files. Be sure, they will be taken, executed in the right order, and if a test fails its dependencies will be skipped. This is likely improve acceptance testing. If login test doesn't pass, you shouldn't even try to launch all other tests with authorization required.

Here is the annotation format to use to declare dependencies. It should be {fullClassName}:{testName}

This lines are written just in the same time as corresponding pull request is merged:

Codeception 2.2 will allow you to use parameter in configuration files populated from environment variables, yaml configs or .env files. You can use parametrized vars in suite configs, by wrapping them in `%` placeholder, and adding one or several parameter providers using the `params` key in global config:

params: [env] # get prameters from environment vars

This feature would be useful if you want to share database configuration with application and tests. This will especially be useful if you use some sort of credentials passed via environment vars. For instance, if you use cloud testing services, you can set login and password with params and get the real values from environment:

This is possibly a breaking feature which was announced in Codeception 2.1 but never worked the way it supposed to be. So let's talk about it once again. A friendly reminder, if you use config like this:

But what if you *really* need to use Laravel5 module along with, let's say, WebDriver? Don't worry, partially loaded modules won't get into conflict. The most common use case is using Laravel ORM methods to create-delete data for acceptance test. In this case you don't need to load all actions of Laravel5 module but only those related to ORM:

If you were mixing WebDriver with PhpBrowser in order to use REST API inside acceptance tests, you can still have it. Don't enable PhpBrowser but set it as dependent module for REST: