Behaviour-driven development (BDD) extends the Test-Driven Development (TDD) approach by the ‘desired behaviour’ of a software. It is designed to ensure a collaboration between business analysts and developers with explicitly written down scenarios.
- Check out the Tutorial (english) / Tutorial (german)
Seed-Test is a website user interface testing tool, which uses approaches of behaviour-driven development and the notation of Gherkin to enable developers and business users to execute automated tests for their website. It can be tested on the official website.
We are greateful for any testing and feedback, so please help us by filling out this feedback form
Please contact us via mail seed-test@adesso.de
It is necessary to install NodeJS.
Seed-Test uses Google Chrome ba default for executing selenium. Download the version of Chromedriver that matches your version of Google Chrome. Extract the "chromedriver.exe" and set a path to it.
To install and use the application localy, clone or download the repository as a zip.
Open up two consoles and navigate with one of the consoles to the backend and with the other to the frontend folder via this commands:
cd backend
cd frontend
Then install all necessary node modules once in the backend and in the frontend folder:
npm install
Create an .env
file in the backend folder with following variables:
REPORT_DELETION_TIME=5
PORT=8080
FRONTEND_URL=http://localhost:4200
Unassigned_AVATAR_URL= https://cdn.pixabay.com/photo/2016/08/08/09/17/avatar-1577909_960_720.png
DATABASE_URI
GITHUB_CLIENT_SECRET
GITHUB_CLIENT_ID
JIRA_SECRET
SESSION_SECRET
First you need a DATABASE_URI provided by your MongoDB (local or cloud). For the GITHUB_CLIENT_SECRET and GITHUB_CLIENT_ID check out GitHub´s Guide on Autorizing OAuth Apps. The JIRA_SECRET and SESSION_SECRET are values used for the encryption of sensible data. Choose a strong Secret like for example generated by RandomKeygen.
Create an .env
file in the frontend folder with following variables:
API_SERVER=http://localhost:8080/api
GITHUB_CLIENT_ID
To run the frontend server switch to the frontend folder and use this command:
cd frontend
npm start
To run the backend server switch to the backend folder and use this command:
cd backend
npm start
Once everything is running, you can access the website by typing this into a browser window:
http://localhost:4200/login
Seed-Test uses a MongoDB. You can either create your own locally or in the cloud. For installation details check out our Check out the Database Tutorial
Once you set up the database, insert the uri into the .env file in the backend folder. Save it!
Then you can set up the database through this command:
npm run database
This command creates the collections 'Stories' and 'stepTypes' and inserts the current stepTypes into the collection. The Stories collection can stay empty. It will be automatically filled while accessing the web-app.
Copyright (c) 2018 Adesso AG Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.