This is a module that can be used together with Codeception to test Snapshots with dynamic data.
Using composer:
composer require "fkupper/module-dynamic-snapshots"On your codeception.yml file, add:
extensions:
commands:
- Fkupper\Command\GenerateDynamicSnapshotNew snapshots cna be created using codeception client with the custom command in this package. Eg:
php ./vendor/bin/codecept generate:dynamicsnapshot Acceptance ProductsSimilar to vanilla Codeception snapshots, the DynamicSnapshots classes will fetch data using the method fetchDynamicData. So, in your snapshots you will have to implement this method:
class FooSnapshot extends DynamicSnapshot
{
/**
* @var Tester
*/
protected $tester;
public function fetchDynamicData()
{
// fetch snapshot from a helper method or snomething and return
return $this->tester->fetchDataFromSomewhere();
}
}This is the main feature of this package. When dealing with variable data in snapshots, they can be replaced with placeholders and replaced back in runtime everytime the snapshot tests are executed.
For example, if you want to test a XML API response containing static data and variable data:
<xml>
<appVersion value="v8.8.9" />
<someOtherNonDynamicData value="foo" />
<bar value="baz" />
</xml>The property "appVersion" can change anytime and to avoid updating it every time, use setSubstitutions method to replace it with a string (or a value that can be casted to string) of your choice:
class FooSnapshot extends DynamicSnapshot
{
/**
* @var Tester
*/
protected $tester;
public function fetchDynamicData()
{
$this->setSubstitutions(
// $this->tester->getAppVersion() returns "v8.8.9"
'app_version' => $this->tester->getAppVersion()
);
// fetch snapshot from a helper method or snomething and return
return $this->tester->fetchDataFromXml();
}
}The first time the dynamic snapshot test is executed, a snapshot data file will be created like:
<xml>
<appVersion value="[snapshot_app_version]" />
<someOtherNonDynamicData value="foo" />
<bar value="baz" />
</xml>Note that placeholders are wrapped in [ ], and from now on, whenever the app version changes, the snapshot will not break or require an update.
Please refer to Codepcetion's standard Snapshot documentation.
By default, placeholders are wrapped in brackets [ ], but it is possible to change what character or sequence of charaters it should use.
For example, if brackets are sensible part of your snapshot data, you can change it to something else using setWrappers:
class FooSnapshot extends DynamicSnapshot
{
protected $tester;
public function __constructor(Tester $I)
{
$this->tester = $I;
$this->setWrappers('{', '}');
// $this->setWrappers('(', ')');
// $this->setWrappers('<', '>');
}
}If your snapshot have variable data that cannot be tested or that you just want to igore, it is possible to provide a list of regular expression patterns that will be removed from the data when asserting.
For example, in the snapshot data below, the current timestamp in the favicon href property have to be ignored:
<html>
<head>
<!-- the favicon will always have the current timestamp suffix -->
<link rel="shortcut icon" href="/favicon.ico?v=1588930951">
</head>
</html>So you can ignore this line by calling setIgnoredLinesPatterns from your snapshot object:
$this->setIgnoredLinesPatterns(['/^.*favicon.*$/m']);Sometimes your snapshot data can have variable amounts of space characters in sequence that change out of your control.
To toggle your snapshot behavior to ignore these spaces or not, use shouldAllowSpaceSequences(true|false). Setting it to true will compact these space sequences to a single space character.
Note that the default is true, so these sequences will never be reduced to one space if you do not specify them to.
If you want to clear every line of your snapshot data of trailing spaces, use shouldAllowTrailingSpaces(false).
Note that the default is true, so trailing spaces in your snapshot data will never be removed.