https://github.com/xyteam/AutoBDD-example

Cucumber E2E Automation Example
https://github.com/xyteam/AutoBDD-example

autobdd bdd cucumber-js docker-compose e2e-testing robotjs selenium sikulix webdriverio

Last synced: 3 months ago
JSON representation

Cucumber E2E Automation Example

• Host: GitHub
• URL: https://github.com/xyteam/AutoBDD-example
• Owner: xyteam
• Created: 2019-08-09T19:10:51.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-12-02T07:13:44.000Z (about 3 years ago)
• Last Synced: 2024-08-02T15:46:58.320Z (6 months ago)
• Topics: autobdd, bdd, cucumber-js, docker-compose, e2e-testing, robotjs, selenium, sikulix, webdriverio
• Language: Gherkin
• Homepage:
• Size: 2.08 MB
• Stars: 5
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
### TLDR:

```

mkdir -p ~/Projects; cd ~/Projects; \

git clone https://github.com/xyteam/AutoBDD-example.git; \

cd ~/Projects/AutoBDD-example/.docker

docker-compose run --rm test-run "--movie 1 --argstring '--tags @Demo'"

```

Open the HTML BDD test report in ~/Projects/AutoBDD-example/e2e-report/

## AutoBDD-example

**AutoBDD-example** is a BDD style (Cucumber/Gherkin) WEB/E2E test project. It takes full advantage of the open-source **AutoBDD** framework:

**[xyteam/AutoBDD](https://github.com/xyteam/AutoBDD)**

Using pre-canned Cucumber/Gherkin statements and you can automate

* web browser actions

* screen and keyboard/mouse actions

You can turn this example project into your own test project and start automating immediately.

### Prerequisite

The only prerequisite to run this project is a docker supporting host. Tested on Linux, MacOS, Windows.

The test project will download the two AutoBDD docker images automatically, and all framework related tasks are taken cared by these two docker images. All you need to do is to work on your test cases.

* **xyteam/autobdd-run**: For running BDD test in CI mode.

* **xyteam/autobdd-dev**: For developing and debugging your test project with shell and GUI.

### To run example test in 3 simple steps:

To run test you only need a docker supporting headless host somewhere on the network.

#### Step 1: Checkout the AutoBDD-example project:

```

mkdir -p ~/Projects; cd ~/Projects; \

git clone https://github.com/xyteam/AutoBDD-example.git;

```

#### Step 2: Run test:

```

cd AutoBDD-example/.docker; \

# to run test cases with @Demo tag

docker-compose run --rm test-run "--movie 1 --argstring '--tags @Demo'"

```

Options can be appended with quotes to the run command above.

```

"--help"

"--modulelist test-download test-postman --movie 1 --reportbase /some/folder --reportpath someName --argstring '--tags @Demo,@SmokeTest --tags ~@wip'"

```

#### Step 3: Review test report

A folder named **e2e-report** will be created under the test project.

Each run creates a timestamped folder with a HTML report and all the run log as well as screenshots and movie.

### Special Mentions

  * Demo-App application and Precanned Cucumber-JS Steps are taken from **[webdriverio/cucumber-boilerplate](https://github.com/webdriverio/cucumber-boilerplate)**