Introduction

This repository demonstrates how to use our Neodymium library to set up a maintainable and well structured test automation project. Please also see the Wiki for the Neodymium library project which shows and explains how to use the vaious features from Neodymium library. There you will also find insights about how we think a test automation project should be structured and what results you should get out of it.

Selenide

Within this example project we demonstrate how to set up and implement a test automation project using Selenide. You can find information about Selenide within our Wiki.

How to try it out

This is a short introduction on how to get it running.

Prerequisites

You will need the following to try it out:

• Git
• Maven 3+
• JDK 8
• IDE of your choice
• Web browsers of your choice and their respective WebDrivers

Get and run Posters

Posters is a web shop for demo purposes built by Xceptance. We use it throughout all our software products to demonstrate their capabilities within a simple and stable environment. The test suite targets the live Posters Demo Store. However, since Posters is an open source application, it can also be run locally by following the steps below.

1. Download latest Posters here.
2. Go to [downloadPathPosters]/posters-demo-store/
3. Start with: mvn clean install followed by mvn ninja:run
4. Go to http://localhost:8080/ to check if it is running.

Get yourself a free copy

Simply clone or fork this project.

IDE way of doing

1. Import the project as Maven project
2. Set up your WebDrivers
3. Go to posters.neodymium.tests.smoke
4. Run HomePageTest.java as JUnit test.

Get into the Console

1. Open a console of your choice
2. Go to the project folder
3. Run mvn clean test

Test out Allure reports

Please check our Wiki to get all the info you need.

Template

If you like our ideas and you would like to start a test automation project using the Neodymium library, we prepared a template that can be used as a "Hello World" tutorial, and as a good starting point for your own project.

Check out Neodymium template.

JUnit 5 vs. JUnit 4

With Version 5.0.0 of Neodymium we introduced JUnit 5 as our standard way of doing things. But since JUnit 4 is still very popular we decided to keep a backwards compability to JUnit 4. Hot to use this can be seen in the branch update-to-neo-5-junit-4

License

MIT