Ploughman
Ploughman is Swift implementation of Cucumber, a test runner for the Gherkin language.
Cucumber is a tool for running automated tests written in plain language. Because they're written in plain language, they can be read by anyone on your team. Because they can be read by anyone, you can use them to help improve communication, collaboration and trust on your team.
Example
You can write tests in Gherkin, here's an example:
Feature: An array
Scenario: Appending to an array
Given I have an empty array
When I add 1 to the array
Then I should have 1 item in the array
Scenario: Filtering an array
Given I have an array with the numbers 1 through 5
When I filter the array for even numbers
Then I should have 2 items in the arrayYou can then write implementations of these rules in Swift:
var array: [Int] = []
given("^I have an empty array$") { match in
array = []
}
given("^I have an array with the numbers (\\d) through (\\d)$") { match in
let start = match.groups[1]
let end = match.groups[2]
array = Array(Int(start)! ..< Int(end)!)
}
when("^I add (\\d) to the array$") { match in
let number = Int(match.groups[1])!
array.append(number)
}
when("^I filter the array for even numbers$") { match in
array = array.filter { $0 % 2 == 0 }
}
then("^I should have (\\d) items? in the array$") { match in
let count = Int(match.groups[1])!
try expect(array.count) == count
}Then you can run your rules agains your feature files as follows:
Usage
To use Ploughman, you will need to build a command line tool that adds the
rules required for your implementation and then calls ploughman.run() to
start the runner.
You will need to make the Ploughman dependency available for your command line tool.
import Ploughman
var array: [Int] = []
given("^I have an empty array$") { match in
array = []
}
when("^I add (\\d) to the array$") { match in
let number = Int(match.groups[1])!
array.append(number)
}
then("^I should have (\\d) items? in the array$") { match in
let count = Int(match.groups[1])!
if array.count != count {
throw /* some error indicating the failure */
}
}
ploughman.run()At any step, you can raise and an error to indicate a failure.
