Unikka / neos-ui-testing-distribution

Neos-ui testing distribution

This repository provides a neos-cms distribution for testing the neos-ui. The neos-ui is using testcafe for acceptance testing and needs fixure data for the test cases.

The distribution is used for the CircleCI pipeline and you can also use it for your local environment. The distribution is currently based on neos master because it is a copy of the neos-development-collection and I need to adjust the older branches.

Installation and usage

1. Clone distribution

git clone [e-mail]/Unikka/neos-ui-testing-distribution.git

2. Run composer install with sources:

cd neos-ui-testing-distribution
composer install --prefer-source

3. Create Database and configure Settings.yaml

cp Configuration/Settings.yaml.test-example Configuration/Settings.yaml

And then adjust the database configuration to your needs.

Neos:
    Flow:
        persistence:
          backendOptions:
          driver: pdo_mysql
          dbname: neosuitesting
          user: user
          host: 127.0.0.1
          password: password

4. Run the following commands

./flow flow:cache:flush
./flow flow:cache:warmup
./flow doctrine:migrate
./flow user:create --username=admin --password=password --first-name=John --last-name=Doe --roles=Administrator

5. Checkout Neos-Ui branch

We want so test a particular branch or a PR. So we need to checkout the code we want to test. In the example we just use the 4.0 branch. The 4.0 branch is neos 4.3 compatible and the lowest maintained branch.

cd Packages/Application/Neos.Neos.Ui
git checkout 4.0 && git pull
make clean && make setup

6. Run your first acceptance tests

After all that your instance is able to run the fixtures of the neos-ui. This distribution has only a testing purpose!

make test-e2e

Using saucelabs locally

We are providing command make test-e2e-saucelabs, but this only works when you own a saucelabs account. You need to provide the username and authentication key to use saucelabs.

export SAUCE_USERNAME=your_username
export SAUCE_ACCESS_KEY=fffff-ssss-4aa6-a4f3-xxxxxeb2f59
make test-e2e-saucelabs

Available commands for testing

Command	Description
make lint	Executes make lint-js and make lint-editorconfig.
make lint-js	Runs test in all subpackages via lerna.
make lint-editorconfig	Tests if all files respect the .editorconfig.
make test	Executes the test on all source files.
make test-e2e	Executes integration tests.
make test-e2e-saucelabs	Executes integration tests against saucelabs.