Serenity BDD - from executable specifications to living documentation

@wakaleo

The evolution of automated testing practicesTake me on a journey

@wakaleo

@wakaleo

John Ferguson

Smart

Introductions

“I help teams of smart people learn to work together more efficiently,

to deliver better software faster”

Alex Soto Bueno

Introductions

“I like helping open source projects, Java EE advocate and father of 2 girls”

@wakaleo

Test AutomationDo it well, or don’t do it at all

@wakaleo

Narrative Coding Style

Open-Closed Principle

Single Responsibility Principle

Separation of Concerns

Software Engineering Principles can help you write more maintainable tests

@wakaleo

Separation of Concerns - Layers

Goals

Tasks

Actions

What are you trying to achieve?

What do you need to do to achieve this goal?

What interactions with the system do you need for each

task?

@wakaleo


Scenario: Add a new todo entry on the todo home page Given I am on the Todo application home page When I enter 'Buy some milk' into the New Todo field And I press ENTER Then the todo list box should contain 'Buy some milk'

@wakaleo


Scenario: Record a new todo action for future use Given I need to buy some milk When I add the todo action 'Buy some milk' Then 'Buy some milk' should be recorded in my todo list

@wakaleo

Feature documentationDetailed feedbackHigh level feedback

Communication and documentation

@wakaleo

Serenity BDD

“Because life is too short to h a v e t o m a i n t a i n u g l y automated test suites”

@wakaleo

Living documentation

Strong Selenium WebDriver support

JUnit, Cucumber or JBehave

A layered approach

Serenity BDD

@wakaleo

The Serenity layered architecture

Goals

Tasks

Interactions

Tests or scenarios

“Steps”

Page Objects or other technical components

@wakaleo

The Serenity layered architectureFeature: Add new todos James needs to be able to jot down actions he needs to do as he thinks of them Scenario: Record a new todo action for future use Given James needs to buy some milk When James adds the todo action 'Buy some milk' Then 'Buy some milk' should be recorded in his todo list

@wakaleo


A goal

@wakaleo


A goal

A task

@wakaleo


A goal

A task

@Steps ATodoUser james; @When(“^(?:.*) (?:adds|has added) the todo action '(.*)'$") public void i_add_the_todo_action(String actionName) { james.adds_an_action_called(actionName);}

@wakaleo


A goal

A task

@Steps ATodoUser james; @When(“^(?:.*) (?:adds|has added) the todo action '(.*)'$") public void i_add_the_todo_action(String actionName) { james.adds_an_action_called(actionName);} The task definition

@wakaleo


A goal

A task


TodoPage onTheTodoHomePage; @Steppublic void adds_an_action_called(String actionName) { onTheTodoHomePage.addAnActionCalled(actionName);}

@wakaleo


A goal

A task


TodoPage onTheTodoHomePage; @Steppublic void adds_an_action_called(String actionName) { onTheTodoHomePage.addAnActionCalled(actionName);}

An interaction

@wakaleo

Serenity for Living DocumentationFeature: Add new todos I need to be able to jot down actions I need to do as fast as I think of them Scenario: Record a new todo action for future use Given I need to buy some milk When I add the todo action 'Buy some milk' Then 'Buy some milk' should be recorded in my todo list

@wakaleo

Coding demo

@wakaleo

Hard to apply to Single Page Apps

Need modifications to extend

Multiple Responsibilities

Bloat

Page Objects considered harmful

@wakaleo

Introducing the Journey Pattern

@wakaleo

Highly readable style

Encourages reuse and maintainable code

Small, reusable interaction components

User-centric

The Journey Pattern

@wakaleo

The Journey Pattern - A User-Centric model

Actors have goals I’d like to be able to recall all the things I need to do

Meet James

@wakaleo


Actors have abilities I can browse the web with my browser

I can also query REST services

@wakaleo

I’d like to be able to recall all the things I need to do


Actors perform tasks

I’ll add ‘Buy some milk’ to my todo list

@wakaleo



Actors may interact with the system to perform these tasks

I’ll add ‘Buy some milk’ to my todo list

Type ‘Buy the milk’Press ‘ENTER’

@wakaleo

The Journey Pattern in Serenity

Actors have goals I’d like to be able to recall all the things I need to do

@wakaleo

The Journey Pattern in Serenity

Actors have goals

Feature: Add new todos James would like to be able to recall all the things he needs to do Scenario: Record a new todo action for future use Given James needs to buy some milk When James adds the todo action 'Buy some milk' Then 'Buy some milk' should be recorded in his todo list


@wakaleo

A User-Centric model

Actors have abilities I can browse the web with my browser

Actor james = Actor.named(“James");

@ManagedWebDriver hisBrowser; … james.can(BrowseTheWeb.with(hisBrowser));

@wakaleo


Actors perform tasks I’ll add ‘Buy some milk’ to my todo list

@StepsAddItem addATodoItem; … james.attemptsTo(addATodoItem.called("Buy some milk"));

@wakaleo


Actors perform tasks I’ll add ‘Buy some milk’ to my todo list

@StepsAddItem addATodoItem; … james.attemptsTo(addATodoItem.called("Buy some milk"));

actor.attemptsTo( Enter.theValue(thingToDo).into(ToDoList.NEW_TODO_FIELD), Hit.the(RETURN).keyIn(ToDoList.NEW_TODO_FIELD) );

@wakaleo

Coding demo

@wakaleo

References• http://www.serenity-bdd.info• https://github.com/serenity-bdd/serenity-journey-demo• http://bit.ly/rg-journey

Alex Soto Bueno

[email protected]@alexsotob

[email protected] wakaleo

http://www.wakaleo.com http://www.serenity-bdd.info

mailto:[email protected]?subject=

@wakaleo

Questions?John Ferguson Smart

[email protected]

http://www.wakaleo.comhttp://www.serenity-bdd.info

Serenity BDD - from executable specifications to living documentation

Technology

Transcript of Serenity BDD - from executable specifications to living documentation