Test command-line applications with Cucumber-Ruby, RSpec or Minitest. The most up to date documentation can be found on Cucumber.Pro (https://app.cucumber.pro/projects/aruba)
Clone or download
Latest commit 3efd188 Jan 9, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Fix typo in PR template Mar 6, 2018
bin Re-implement bin/console using Aruba::Console Sep 14, 2017
config Moved configuration of rubocop to a central place May 18, 2015
doc Ignore 'debug' group Jul 8, 2017
exe Move script to match set path and Bundler's default Jul 8, 2017
features Restore Bundler disabling functionality Apr 28, 2018
fixtures Ensure aruba is always loaded first in spec fixture Jul 8, 2017
lib Merge pull request #560 from cucumber/issue-526-restore-disable-bundl… May 26, 2018
spec add require time to avoid test failure Oct 13, 2018
.cucumberproignore Refactor README Jun 28, 2017
.document Initial commit to aruba. Feb 12, 2010
.gitignore Improve developer experience Mar 22, 2016
.rspec Move flags from Rakefile for rspec Apr 17, 2016
.rubocop.yml Configure PercentLiteralDelimiters cop to match used style Feb 11, 2018
.rubocop_todo.yml Configure PercentLiteralDelimiters cop to match used style Feb 11, 2018
.simplecov Ignore specs and features in simplecov Jul 6, 2015
.travis.yml Bump CRuby point releases and JRuby Jan 8, 2019
.yardopts YARD: avoid yard warnings Sep 5, 2017
CHANGELOG.md Update CHANGELOG.md Oct 13, 2018
CONTRIBUTING.md Improve contribution guidelines Mar 6, 2018
Dockerfile Run tests by default on docker run Apr 27, 2016
Gemfile Only install license_finder on modern Rubies Jan 8, 2019
LICENSE Update year in license Jan 2, 2016
README.md Merge pull request #523 from cucumber/update-readme Feb 2, 2018
Rakefile Only install license_finder on modern Rubies Jan 8, 2019
TODO.md Added some more methods Mar 8, 2016
appveyor.yml Use pre-installed bundler on AppVeyor Nov 29, 2017
aruba.gemspec Allow development with Bundler 2.0 Jan 8, 2019
cucumber.yml Clean up and unify tags Mar 6, 2018
docker-compose.yml Fix command in docker-compose.yml Apr 28, 2016


GitHub license Docs Gem Version Dependency Status Code Climate Support

Build Status for "master" on Linux/Mac OS Build status for "master" on Windows

This is the latest version of our README.md (Branch: "master"). There is also the README of the latest released version of "aruba" (Branch: "still").


Add this line to your application's Gemfile:

gem 'aruba'

And then execute:


Or install it yourself as:

gem install aruba


As a user getting started with "aruba"

Our most current documentation to get started with aruba as a user can be found on See our documentation on Cucumber Pro. It is generated from our feature files describing the use of aruba.

As a user getting started with a ruby testing framework

  • Cucumber:

    If you're new to the "Cucumber" ecosystem, it's worth to visit the project's documentation site. This also includes information about how to write feature files in "Gherkin".

  • RSpec:

    If you want to use "aruba" with "RSpec" and you need some information about how to use "RSpec", please visit their website.

  • minitest:

    The documentation for "minitest" can be found here.

As a developer getting started with "aruba"

A full documentation of the API for developers can be found on RubyDoc.



For support, please have a look at the "support website" of "Cucumber". You have different options to reach out for help: Recommended for aruba are using the "Slack" channels - e.g. "aruba-devs" or "general" (Register account) and the "Issues" page on GitHub. Addressing one of the maintainers directly would be helpful.


Currently, this gem is mainly maintained by this group of people:

Release Policy

We try to comply with Semantic Versioning 2.0.0.

Supported Ruby versions

For an up-to-date list of all supported Ruby versions, please see our .travis.yml. We only test against the latest version of a version branch - most times.


Please see the CONTRIBUTING file.

Code branches

We use two branches for development: "master" and "still". The "master" branch contains the code of the current major version. The "still" branch is used for the old major version. New features are only added to "master". The "still" branch is still maintained, but only get fixes for major bugs. The "still" branch should be considered as experimental, as we need to find out how much work it is to maintain two branches of code.

Build Status

Version Linux / OS X Windows
master Build Status Build status
still Build Status Build status