When developing software, a disconnect between what users want and what the software does can occur. We might’ve delivered working, tested code, but does it solve the user’s problem?
Behavior-driven development aims to mitigate that risk, by capturing and testing requirements from the perspective of the external user of the system.
Whether we’re working with a Product Owner, with users, or by ourselves, BDD can help us explore and define the problem in a structured way.
The process is as follows:
This helps us move from a vague description to a very precise, testable specification.
Let’s imagine we want to implement a bookstore. The first User Story could be:
As a customer, I want to select a book and add it to cart so that I can buy it.
Behavior-Driven Development helps us focus on behavior, by using a language that expresses behavior:
In this example, we could write:
This description is more precise than the User Story. It describes what needs to happen, what the user needs to do, and what result the user should see.
At this level, we don’t know anything about the implementation of the bookstore. This description fits any implementation of the bookstore:
The implementation can be changed at any moment, and executing the specification should tell us if the system allows the user to achieve their goal.
Specifications implemented with Behavior-Driven Development are:
Behavior-Driven Development is not about tools. It’s a way of building software. We can implement specifications in any way we want, however, there are tools that can help us. {cucumber} is one of them.
We can practice BDD using base R. Having a set of examples of how the system should work, we need to establish a way of translating examples to code.
We need to represent the business language with code – a set of actions that user of the system can take. We can do it with functions. Those functions will create the interface of the system. Their names can follow closely the natural language description of the action. They will abstract and hide the implementation details of the system. They will allow reuse of the test code.
The specification of the bookstore could look like this:
# tests/acceptance/test-bookstore.R
test_that("Bookstore: Adding a book to cart", {
# Given
bookstore <- Bookstore$new()
# When
bookstore$select("The Hobbit, J.R.R. Tolkien")
bookstore$add_to_cart()
# Then
bookstore$cart_includes("The Hobbit, J.R.R. Tolkien")
})
#> ── Error: Bookstore: Adding a book to cart ─────────────────────────────────────
#> Error in `eval(code, test_env)`: object 'Bookstore' not found
#> Error:
#> ! Test failedThis test fails as the code doesn’t exist yet. We can pause in this step and try out a few versions of the specifications and go with one that expresses the business goal the best.
Once we have an outline of actions, we can implement them. We can use R6 objects to bind the functions together.
# tests/acceptance/setup-bookstore.R
Bookstore <- R6::R6Class(
public = list(
select = function(title) {
},
add_to_cart = function() {
},
cart_includes = function(title) {
}
)
)When we have a skeleton of the implementation, we can start filling it with the actual code.
For example, our implementation of the bookstore might be a package with:
select_book: function that returns a tibble with book details,add_to_cart: function that adds a book with given ID to a storage,get_cart: function that returns a list with details of books in the cart.An implementation that satisfies the specification could be as simple as:
storage <- c()
books <- list(
tibble::tibble(id = 1, title = "The Hobbit, J.R.R. Tolkien"),
tibble::tibble(id = 2, title = "The Lord of the Rings, J.R.R. Tolkien")
)
select_book <- function(title) {
books |>
purrr::keep(\(x) x$title == title) |>
purrr::pluck(1)
}
add_to_cart <- function(id) {
storage <<- c(storage, id)
}
get_cart <- function() {
books |>
purrr::keep(\(x) x$id %in% storage)
}Having this implementation, we can plug it into the test code:
# tests/acceptance/setup-bookstore.R
Bookstore <- R6::R6Class(
private = list(
selected_id = NULL
),
public = list(
select = function(title) {
private$selected_id <- select_book(title)$id
},
add_to_cart = function() {
add_to_cart(private$selected_id)
},
cart_includes = function(title) {
testthat::expect_in(title, purrr::map_chr(get_cart(), "title"))
}
)
)Now, the tests pass.
# tests/acceptance/test-bookstore.R
test_that("Bookstore: Adding a book to cart", {
# Given
bookstore <- Bookstore$new()
# When
bookstore$select("The Hobbit, J.R.R. Tolkien")
bookstore$add_to_cart()
# Then
bookstore$cart_includes("The Hobbit, J.R.R. Tolkien")
})
#> Test passed 🎉With this implementation, we can easily extend tests with checking if we can add multiple books to the cart.
test_that("Bookstore: Adding multiple books to cart", {
# Given
bookstore <- Bookstore$new()
# When
bookstore$select("The Hobbit, J.R.R. Tolkien")
bookstore$add_to_cart()
bookstore$select("The Lord of the Rings, J.R.R. Tolkien")
bookstore$add_to_cart()
# Then
bookstore$cart_includes(c("The Hobbit, J.R.R. Tolkien", "The Lord of the Rings, J.R.R. Tolkien"))
})
#> Test passed 🌈As the system grows, it will be extended with more examples and more actions. Actions already implemented will be reused in different scenarios.
The implementation of the system will evolve, so will specifications, but this approach will ensure that test code is easy to maintain and focused on the business goal.
The steps of BDD with {cucumber} are the same as with base R. The difference in how we express specifications and their implementation.
The readability of specifications is given by them being expressed in Gherkin language. Specifications are no longer expressed in code, but as text. It adds another level of separation between the specification and the implementation.
We start by writing a feature file:
# tests/acceptance/bookstore.feature
Feature: Bookstore
Scenario: Adding a book to cart
Given I am in the bookstore
When I select "The Hobbit, J.R.R. Tolkien"
When I add selected book to the cart
Then I should see "The Hobbit, J.R.R. Tolkien" in the cartWe implement actions with given, when, and then functions:
# tests/acceptance/setup-steps.R
given("I am in the bookstore", function(context) {
})
when("I select {string}", function(title, context) {
context$selected_id <- select_book(title)$id
})
when("I add selected book to the cart", function(context) {
add_to_cart(context$selected_id)
})
then("I should see {string} in the cart", function(title, context) {
expect_in(title, purrr::map_chr(get_cart(), "title"))
})This test does exactly the same as the test with base R.
We can run those tests with:
cucumber::test()
#> Test passedWhat cucumber::test function does is it reads the feature files, finds corresponding actions implementations and runs them in order. To learn more how it works, refer to How it works vignette.
Similar to what we did with base R, we can extend the feature file with a scenario that checks if we can add multiple books to the cart:
# tests/acceptance/bookstore.feature
Feature: Bookstore
Scenario: Adding a book to cart
Given I am in the bookstore
When I select "The Hobbit, J.R.R. Tolkien"
When I add selected book to the cart
Then I should see "The Hobbit, J.R.R. Tolkien" in the cart
Scenario: Adding multiple books to cart
Given I am in the bookstore
When I select "The Hobbit, J.R.R. Tolkien"
When I add selected book to the cart
When I select "The Lord of the Rings, J.R.R. Tolkien"
When I add selected book to the cart
Then I should see "The Hobbit, J.R.R. Tolkien" in the cart
Then I should see "The Lord of the Rings, J.R.R. Tolkien" in the cartRe-running the tests will result in two scenarios passing.
cucumber::test()
#> Test passed
#> Test passed