Awesome Open Source
Awesome Open Source

MIT license Docs Gem Version Code Climate Support

Travis CI build status Appveyor build status


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 in ./features/.

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. committers-aruba or help-cucumber-ruby — (register account), and the Issues page on GitHub.


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

Aruba is supported on Ruby 2.4 and up, and tested against CRuby 2.4, 2.5, 2.6 and 2.7, and JRuby 9.2.

Supported operating systems

Aruba is fully tested in CI on Linux and MacOS. On Windows, only RSpec tests are run, so YMMV. Full Windows support is a work in progress.


Please see the CONTRIBUTING file.

Code branches

Development takes place in the main branch and currently targets the 1.x releases. If necessary, maintenance of the old 0.14.x releases takes place in the 0-14-stable branch. Stable branches will not be created until absolutely necessary.


See the file LICENSE.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
ruby (12,891
shell (10,398
cli (1,800
framework (1,116
documentation (594
command-line (539
test (206
tdd (155
bdd (81
command (63
rspec (62
cucumber (50
test-driven-development (47
testing-framework (37
minitest (18