donaldsiziba / authentication-services-starter

Authentication Services

This documentation is part of this blog post.

Prerequisites

Install the following software in your development environment:

1. Java JDK
2. Maven
3. Git (Optional)

This example uses JBehave and Java, and the project is built using Maven.

Password Validator Kata

This example is based on the Password Validator Kata blog. Go ahead and clone or simply download the project from Github.

git clone https://github.com/donaldsiziba/password-validator

After getting the project on your local environment, go ahead and build the project by executing the command below in projects root directory:

mvn install

The Project Structure

└── src
    ├── main
    │   ├── java
    │   │   └── za
    │   │       └── co
    │   │           └── awesomatic
    │   └── resources
    └── test
        ├── java
        │   └── za
        │       └── co
        │           └── awesomatic
        │               └── authentication
        │                   └── AuthenticationApplicationTestSuite.java             # Acceptance Test Runner                                                                
        └── resources
            └── stories                                                             # Story files folder
                └── ValidatePassword.story              

Acceptance Tests

To run the Acceptance Test Suite, type the following in command line on the project's root directory:

mvn verify

Note: Use mvn clean verify for subsequent builds.

Acceptance Test Reports

After the build has run, the Acceptance Test reports can be found in target/site/serenity. Use a browser to view the index.html file.

Test Results Page

The test results below indicates that all test scenarios are still pending as no code has been implemented yet.