Pimcore Codeception Framework

This Packages allows you to create fast and simple testing environments. It's also used by all pimcore Bundles created by DACHCOM.DIGITAL.

Configuration

All test files needs to be stored in /tests.

Environment Variables

Name	Example	Required	Description
TEST_BUNDLE_NAME	ToolboxBundle	yes	--
TEST_BUNDLE_INSTALLER_CLASS	ToolboxBundle\\Tool\\Install	yes	Set to false if you don't have any installer class
TEST_BUNDLE_TEST_DIR	${{ github.workspace }}/tests	yes	--
TEST_PROJECT_ROOT_DIR	${{ github.workspace }}	yes	This variable is required to setup test structure before any system is running
PIMCORE_CODECEPTION_FRAMEWORK	${{ github.workspace }}/pimcore-codeception-framework	yes	--
PIMCORE_CODECEPTION_VERSION	master, ^1.0	yes	--

Bootstrap

Creat a file called _bootstrap.php in tests/_bootstrap.php

<?php

$frameworkPath = getenv('PIMCORE_CODECEPTION_FRAMEWORK');
$bundleTestPath = getenv('TEST_BUNDLE_TEST_DIR');

$bootstrap = sprintf('%s/src/_bootstrap.php', $frameworkPath);

include_once $bootstrap;

Setup File

Create a file called config.yml in tests/_etc/config.yml.

! Files in setup_files node needs to stored in /tests/_etc/config.

setup_files:
    - { path: app/config.yml, dest: ./app/config/config.yml }
    - { path: app/system.yml, dest: ./var/config/system.yml }
    - { path: app/controller/DefaultController.php, dest: ./src/AppBundle/Controller/DefaultController.php }
    - { path: app/views/default.html.twig, dest: ./app/Resources/views/Default/default.html.twig }
    - { path: app/views/snippet.html.twig, dest: ./app/Resources/views/Default/snippet.html.twig }

Bundle Configuration Files

This Framework allows you to use multiple (bundle) configuration setups.

TBD

Classes

If you want to provide some classes to install, all the definitions needs to stored at /tests/_etc/classes.

---

Actors

[MODULE] PimcoreAdminCsv

Name	Description
seeResponseCsvHeaderHasValues(array $headerValues)
seeResponseCsvRowValues(int $index, array $values)
seeResponseCsvLength(int $length)
seeResponseIsCsv()

[MODULE] PimcoreAdminJson

Name	Description
seeResponseContainsJson(array $json = [])
seeResponseIsJson()

[MODULE] PimcoreBackend

Name	Description
haveAPageDocument($key = 'bundle-page-test', array $params = [], $locale = null)
haveASubPageDocument(Document $parent, $key = 'bundle-sub-page-test', array $params = [], $locale = null)
haveASnippet($key = 'bundle-snippet-test', $params = [], $locale = null)
haveAEmail($key = 'bundle-email-test', array $params = [], $locale = null)
haveALink(Document\Page $source, $key = 'bundle-link-test', array $params = [], $locale = null)
haveASubLink(Document $parent, Document\Page $source, $key = 'bundle-sub-link-test', array $params = [], $locale = null)
haveAHardLink(Document\Page $source, $key = 'bundle-hardlink-test', array $params = [], $locale = null)
haveASubHardLink(Document $parent, Document\Page $source, $key = 'bundle-sub-hardlink-test', array $params = [], $locale = null)
haveAPimcoreObject(string $objectType, $key = 'bundle-object-test', array $params = [])
haveAPimcoreAsset($key = 'bundle-asset-test', array $params = [])
haveADummyFile($fileName, $fileSizeInMb = 1)
haveASite($siteKey, array $params = [], $locale = null, $add3w = false, $additionalDomains = [])
haveAPageDocumentForSite(Site $site, $key = 'document-test', array $params = [], $locale = null)
haveAHardlinkForSite(Site $site, Document\Page $document, $key = 'hardlink-test', array $params = [], $locale = null)
seeDownload($fileName)
seeEditablesPlacedOnDocument(Document $document, array $editables)
seeAnAreaElementPlacedOnDocument(Document $document, string $areaName, array $editables = [])
haveTwoConnectedDocuments(Document\Page $sourceDocument, Document\Page $targetDocument)
haveAUnPublishedDocument(Document $document)
seeEmailIsSent(Document\Email $email)
seeEmailIsNotSent(Document\Email $email)
seePropertiesInEmail(Document\Email $mail, array $properties)
seePropertyKeysInEmail(Document\Email $mail, array $properties)
cantSeePropertyKeysInEmail(Document\Email $mail, array $properties)
seeInRenderedEmailBody(Document\Email $mail, string $string)
seeKeyInFrontendTranslations(string $key)
haveAFrontendTranslatedKey(string $key, string $translation, string $language)
haveAStaticRoute(string $name = 'test_route', array $params = [])
haveAPimcoreRedirect(array $data)
haveAPimcoreClass(string $name = 'TestClass')
submitDocumentToXliffExporter(Document $document)

[MODULE] PimcoreBundleCore

Name	Description
This module installs a bundle if run_installer option is set to true

[MODULE] PimcoreCore

Name	Description
haveABootedSymfonyConfiguration(string $configuration)

[MODULE] PimcoreRest

Name	Description
--

[MODULE] PimcoreUser

Name	Description
haveAUser($username)
haveAUserWithAdminRights($username)

[MODULE] Unit

Name	Description
--

API

TBD