mdoel / cucumber_examples

Examples of how to use cucumber in several languages and contexts

Cucumber Examples

Cucumber is a tool that is useful for those who practice Behavior Driven Development.

The behavior is specified as a set of features, which are implemented as step definitions. The step definitions then exercise and inspect the system under test.

This repository is useful for someone looking to learn a bit of cucumber by example:

• The ruby directory has an example that is the result of following the 10 minute tutorial on the Cucumber site, with the production code and test code put into separate files.
• The java directory is a similar example, but with step definitions written in Java and features executed with Maven.
• The google example shows how you can use WebDriver and its API to do a very simple test against a Google search.
• The sinatra example demonstrates a minimal ruby web app being exercised with the Rack::Test driver and Capybara gem.
• The dadjoke example is a more complete sinatra example that includes several features. It also shows how the VCR gem can be used to isolate running the test from the icanhazdadjoke API used for content.
• The full example is an extension of dadjoke.

Setup

In order to get these examples working, you may need to install some things onto your local machine.

The java example presumes you have Java Standard Edition as well as the Maven build tool. Within the hellocucumber directory of the java sample, running mvnw test from the command line will execute the cucumber features.

The other examples use Ruby and Bundler as a foundation. Inside each directory, you'll first want to run bundle install to ensure any ruby gems are installed. From there rake features will run the execute the acceptance tests.

Finally, a few of the examples make use of Selenium WebDriver for automating your browser. In the full example, the automation exercises Chrome via ChromeDriver. In the google example, Safari is used via the Apple provided version of SafariDriver. Depending on your local environment, you may want or need to change the driver instance used.