aruba 0.14.14 → 1.0.0.pre.alpha.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: 3a6dec2d2f4fb77bf7bba1146a84b9b5c95b9d71fce642d712c06e074a6400a6
-  data.tar.gz: bc372d8eefe7a8c408befae6d8967ba3d7caab1ec923ba129e4b8966963620dd
+SHA1:
+  metadata.gz: 8c62f9928322c0f6bf4fd32fd910f094462cff44
+  data.tar.gz: 133388c045d615d2487e6b6fb242ca24484c67a4
 SHA512:
-  metadata.gz: 54e94426e026cb5d69797149f5522a5d425e7b7e0f18b9d7f04a66441c2cc57fae7291ee1405b0d58663355df83ecf8e15d3315a855e7900460d58cb684f013d
-  data.tar.gz: 4a0551631244c384bcb0a3ce4603ef9e4adc402bf188d468d7f0e9fb43bb7d9f34f592e581d2482a401599ac4abbec31d3780ffae7ba1194ccf37775e2df96c8
+  metadata.gz: 558945a1186295b2e4c5a1f4f7ff07d34fb0f8aa90bef9ffb4cd7cfc2c5e0591ca2b2cb1c95c83f0e1b3322a212e90a8f1256d8db9077ab62b9d7d23330135e6
+  data.tar.gz: 55bcf35d60c156b3ecfba2a5ee6dec2fad9d5215789468eed2a798ee574fb3ab5ddcd93588f6bc7ee5079acfefd27b89d74cc9251c798d326e9b6000af1c3099

data/.cucumberproignore

@@ -0,0 +1,3 @@
+/
+!features/
+features/04_aruba_api/command/run_simple.feature

data/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,48 @@
+<!-- These sections are meant as guidance for you, to help you give the kind of information we'll need to help with your issue. If a section  doesn't seem to fit, just skip it.
+
+In general: Please provide as much information as you can to help us solving your problem -->
+
+## Summary
+
+<!--- Provide a general summary description of the issue -->
+
+## Expected Behavior
+
+<!--- If you're describing a bug, tell us what should happen -->
+<!--- If you're suggesting a change/improvement, tell us how it should work -->
+<!--- Feel free to use Given / Then / Then if that helps, but please add some plain-language context too -->
+
+## Current Behavior
+
+<!--- If describing a bug, tell us what happens instead of the expected behavior -->
+<!--- If suggesting a change/improvement, explain the difference from current behavior -->
+
+<!--- If you have got some output place it in the code block below. Otherwise remove it. -->
+~~~
+~~~
+
+## Possible Solution
+
+<!--- Not obligatory, but suggest a fix/reason for the bug, -->
+<!--- or ideas how to implement the addition or change -->
+
+## Steps to Reproduce (for bugs)
+
+<!--- Provide a link to a live example, or an unambiguous set of steps to -->
+<!--- reproduce this bug. Include code to reproduce, if relevant -->
+1.
+2.
+3.
+4.
+
+## Context & Motivation
+
+<!--- How has this issue affected you? What are you trying to accomplish? -->
+<!--- Providing context helps us come up with a solution that is most useful in the real world -->
+
+## Your Environment
+
+<!--- If you're reporting a bug, include as many relevant details about the environment you experienced the bug in -->
+* Version used:
+* Operating System and version:
+* Link to your project:

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,39 @@
+<!-- These sections are meant as guidance for you. If something doesn't fit, you can just skip it. -->
+
+## Summary
+
+<!--- Provide a general summary description of your changes -->
+
+## Details
+
+<!--- Describe your changes in detail -->
+
+## Motivation and Context
+
+<!--- Why is this change required? What problem does it solve? -->
+<!--- If it fixes an open issue, please link to the issue here. -->
+
+## How Has This Been Tested?
+
+<!--- Please add tests for changes to the code, otherwise we probably won't merge it -->
+
+<!--- Please describe in detail how you tested your changes. -->
+<!--- Include details of your testing environment, tests ran to see how -->
+<!--- your change affects other areas of the code, etc. -->
+
+## Screenshots (if appropriate):
+
+## Types of changes
+
+<!--- What types of changes does your code introduce? Put an `x` in all the boxes that apply: -->
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+
+## Checklist:
+
+<!--- Go over all the following points, and put an `x` in all the boxes that apply. -->
+<!--- If you're unsure about any of these, don't hesitate to ask. We're here to help! -->
+- [ ] I've added tests for my code
+- [ ] My change requires a change to the documentation.
+- [ ] I have updated the documentation accordingly.

data/.gitignore

@@ -28,6 +28,7 @@ tmp
 .bundle
 doc
 Gemfile.lock
+Gemfile.local
 cucumber-pro.log
 
 ## Ruby versioniser

data/.rspec

@@ -1,3 +1,4 @@
 --color
 --format Fuubar
 --order random
+--warnings

data/.rubocop.yml

@@ -1,9 +1,7 @@
 AllCops:
   Exclude:
     - tmp/**/*
-    - vendor/bundle/**/*
   DisplayCopNames: true
-
 # Cop supports --auto-correct.
 # Configuration parameters: SupportedStyles.
 Style/HashSyntax:
@@ -41,6 +39,7 @@ Metrics/LineLength:
   Max: 169
   Exclude:
     - lib/aruba/api.rb
+    - lib/aruba/api/deprecated.rb
     - aruba.gemspec
 
 # Configuration parameters: CountComments.
@@ -78,9 +77,6 @@ Style/CollectionMethods:
 Style/Documentation:
   Enabled: false
 
-Style/DotPosition:
-  EnforcedStyle: trailing
-
 # Configuration parameters: MinBodyLength.
 Style/GuardClause:
   Enabled: false

data/.travis.yml

@@ -1,37 +1,45 @@
-# In order to install old Rubies, we need to use old Ubuntu distribution.
-dist: trusty
 sudo: false
 language: ruby
-script: script/test
-bundler_args: --without development debug
-cache: bundler
-
+script: bin/test
+install: bin/bootstrap --without development debug
 rvm:
-  - 1.8.7
-  - 1.9.2
   - 1.9.3
   - 2.0.0
   - 2.1.8
-  - 2.2
-  - 2.3
-  - 2.4
-  - 2.5
-  - 2.6
-  - 2.7
-  - jruby-1.7
-  - jruby-9.0
-  - jruby-9.1
-  - jruby-9.2.6.0
-  - rbx-3
+  - 2.2.4
+  - 2.3.0
+  - 2.4.0
+  - ruby-head
+  - jruby
+  - jruby-20mode
+  - jruby-21mode
 matrix:
   include:
-    - rvm: jruby-1.7
-      env: JRUBY_OPTS='--dev --1.8'
+    - rvm: jruby-9.0.1.0
+      env: JRUBY_OPTS='--dev'
+    - rvm: jruby-9.0.1.0-20mode
+      env: JRUBY_OPTS='--dev'
+    - rvm: jruby-9.0.1.0-21mode
+      env: JRUBY_OPTS='--dev'
   allow_failures:
-  - rvm: rbx-3
-branches:
-  only:
-    - master
-    - still
+  - rvm: ruby-head
+  - rvm: jruby-9.0.1.0
+    env: JRUBY_OPTS='--dev'
+  - rvm: jruby-9.0.1.0-20mode
+    env: JRUBY_OPTS='--dev'
+  - rvm: jruby-9.0.1.0-21mode
+    env: JRUBY_OPTS='--dev'
+  fast_finish: true
+notifications:
+  webhooks:
+    urls:
+      - https://webhooks.gitter.im/e/d4d9080e2a8c4910f609
 env:
-  - JRUBY_OPTS='--dev'
+  global:
+   - secure: l8uznA5K4K9mZ1krmP3lTMD8WcJ32qGxFOR3jubKHcOBSLB4xSzU2aIqjyJdO+rLzebkwamhJc8pGSIWOUDQYvFiX7splK+uEkbBJ5huAhXtLF4Qgl86bCWbEXYzN7rvn0DQfpJAovyFMNRMnfo70XhwqWzFsaYa7Z0YbqYsJE4=
+   - JRUBY_OPTS='--dev'
+cache: apt
+addons:
+  apt:
+    packages:
+    - zsh

data/CONTRIBUTING.md

@@ -1,70 +1,172 @@
-## About to create a new Github Issue?
+# Contributing to the Cucumber Aruba Project
+
+## Introduction
+
+We would love to get help from you as "user" and "contributor".
+
+**Users**
+
+* Tell us how "Aruba" works for you
+* Spread the word if you like our work and please tell us if somethings is (utterly) wrong
+* Encourage people in testing their code and keep communicating their needs
+
+**Contributors**
+
+* Send us bug fixes
+* Add new features to the code
+* Discuss changes
+* Add missing documentation
+* Improve our test coverage
+
+The rest of this document is a guide for those maintaining Aruba, and others who would like to submit patches.
+
+## Contributing to the "aruba" project
+
+It would be great if all people who want to contribute to the "aruba" project – contributors and maintiners – follow the guidelines in this section. There are also "Getting started"-sections both for [contributors](#getting-started-as-a-contributor) and [maintainers]((#getting-started-as-a-maintainer).
+
+### Issues
 
 We appreciate that. But before you do, please learn our basic rules:
 
 * This is not a support forum. If you have a question, please go to [The Cukes Google Group](http://groups.google.com/group/cukes).
 * Do you have an idea for a new feature? Then don't expect it to be implemented unless you or someone else sends a [pull request](https://help.github.com/articles/using-pull-requests). You might be better to start a discussion on [the google group](http://groups.google.com/group/cukes).
-* Reporting a bug? Please tell us:
-  * which version of Aruba you're using
-  * which version of Ruby you're using.
-  * How to reproduce it. Bugs with a failing test in a [pull request](https://help.github.com/articles/using-pull-requests) get fixed much quicker. Some bugs may never be fixed.
-* Want to paste some code or output? Put \`\`\` on a line above and below your code/output. See [GFM](https://help.github.com/articles/github-flavored-markdown)'s *Fenced Code Blocks* for details.
-* We love [pull requests](https://help.github.com/articles/using-pull-requests). But if you don't have a test to go with it we probably won't merge it.
+* Reporting a bug? Just follow our comments in the issue template
+* We love [pull requests](https://help.github.com/articles/using-pull-requests). The same here: Please consider our comments within the template we provide for your pull request(s).
+
 
-# Contributing to Aruba
+### Pull Requests
 
-This document is a guide for those maintaining Aruba, and others who would like to submit patches.
+**Contributors**
 
-## Note on Patches/Pull Requests
+Please...
 
 * Fork the project. Make a branch for your change.
-* Make your feature addition or bug fix.
+* Make your feature addition or bug fix – if you're unsure if your addition will be accepted, open an issue for discussion first
 * Make sure your patch is well covered by tests. We don't accept changes that aren't tested.
 * Please do not change the Rakefile, version, or history.
   (if you want to have your own version, that is fine but
   bump version in a commit by itself so we can ignore when we merge your change)
+* Make sure your pull request complies to our development style
+* Rebase your branch if needed to reduce clutter in our git history
+* Make sure you don't break other people's code – On major changes: First deprecated, than bump major version, than make breaking changes
+* Split up your changes into reviewable "git"-commits which combine all lines/files relevant for a single change
 * Send us a pull request.
 
-## Bootstrap environment
+**Maintainers**
+
+* Use pull requests for larger or controversial changes made by yourself or changes you might expected to break the build
+* Commit smaller changes directly to master, e.g. fixing typos, adding tests or adding documentation
+* Update [History.md](History.md) when a pull request is merged
+* Make sure all tests are green before merging a pull request
+
+### Development style
+
+* We try to follow the recommendations in the [Ruby Community Style Guide](https://github.com/bbatsov/ruby-style-guide) and use [`rubocop`](https://github.com/bbatsov/rubocop) to "enforce" it. Please see [.rubocop.yml](.rubocop.yml) for exceptions.
+* There should be `action`-methods and `getter`-methods in `aruba`. Only the latter should return values. Please expect the first ones to return `nil`.
+* Add documentation (aka acceptance tests) for new features using `aruba`'s steps and place them some where suitable in [here](features/).
+* Add unit tests where needed to cover edge cases which are not (directly) relevant for users
+* Add developer documentation in [`yardoc`](http://yardoc.org/) to all relevant methods added
+* Format your commits messages following those seven rules -- see [this blog post](http://chris.beams.io/posts/git-commit/) for a well written explanation about the why.
+  1. Separate subject from body with a blank line
+  2. Limit the subject line to 50 characters
+  3. Capitalize the subject line
+  4. Do not end the subject line with a period
+  5. Use the imperative mood in the subject line
+  6. Wrap the body at 72 characters
+  7. Use the body to explain what and why vs. how (optional if subject is self-explanatory)
+  8. Use Markdown Markup to style your message (only if required)
+
+
+## Getting started as a "Contributor"
+
+### Bootstrap environment
 
 To get started with `aruba`, you just need to bootstrap the environment by
 running the following command.
 
-    # Bootstrap environment
-    script/bootstrap
+~~~bash
+# Bootstrap environment
+bin/bootstrap
+~~~
 
-## Running tests
+### Running tests
 
-Make sure you bootstrap the environment first.
+Make sure you bootstrap the environment first. Then run the following command
+to run the test suite.
 
-    # Run the test suite
-    script/test
+~~~bash
+# Run the test suite
+bin/test
+~~~
 
-## Release Process
+If you have problems because our assumptions about your local setup are wrong.
+Try this instead. This requires the `docker`-command/project to be installed on
+your local system.
 
-* Bump the version number in `aruba.gemspec`
+~~~bash
+# Build the docker container
+bundle exec rake docker:build
+
+# Run the whole test suite in "docker"-container
+RUN_IN_DOCKER=1 bin/test
+
+# Run only selected scenario
+RUN_IN_DOCKER=1 bin/test cucumber features/steps/command/shell.feature:14
+~~~
+
+## Installing your own gems used for development
+
+A `Gemfile.local`-file can be used to have your own gems installed to support
+your normal development workflow.
+
+Example:
+
+~~~ruby
+gem 'pry'
+gem 'pry-byebug'
+gem 'byebug'
+~~~
+
+## Getting started as a "Maintainer"
+
+### Release Process
+
+* Bump the version number in `lib/aruba/version.rb`
 * Make sure `History.md` is updated with the upcoming version number, and has entries for all fixes.
 * No need to add a `History.md` header at this point - this should be done when a new change is made, later.
+* If a major version is released, update the `still`-branch which points to "old" major version
 
 Now release it
 
-    bundle update
-    bundle exec rake
-    git commit -m "Release X.Y.Z"
-    rake release
+~~~bash
+# update dependencies
+bundle update
+
+# Run test suite
+bin/test
+
+# Release gem
+git commit -m "Version bump"
+bin/release
+
+# If it's a major relase:
+# Merge changes back to have an correct documentation
+git checkout still
+git merge master
+git push
+~~~
 
-Now email cukes@googlegroups.com with details of the new release. Just a copy / paste from the History.md file is normally fine.
+Now send a PR to https://github.com/cucumber/website adding an article about the with details of the new release and merge it - an aruba maintainer should normally allowed to merge PRs on `cucumber/website`. A copy of an old announcement can be used as basis for the new article. After this send an email with the link to the article to cukes@googlegroups.com. 
 
-## Gaining Release Karma
+### Gaining Release Karma
 
 To become a release manager, create a pull request adding your name to the list below, and include your Rubygems email address in the ticket. One of the existing Release managers will then add you.
 
 Current release managers:
-  * Jarl Friis ([@jarl-dk](https://github.com/jarl-dk))
-  * Matt Wynne ([@mattwynne](http://github.com/mattwynne))
   * Aslak Hellesøy ([@aslakhellesoy](http://github.com/aslakhellesoy))
-  * Tom Brand ([@tom025](https://github.com/tom025))
   * Dennis Günnewig ([@maxmeyer](http://github.com/maxmeyer), [@dg-rationdata](http://github.com/dg-rationdata))
+  * Jarl Friis ([@jarl-dk](https://github.com/jarl-dk))
+  * Matt Wynne ([@mattwynne](http://github.com/mattwynne))
 
 To grant release karma, issue the following command:
 

data/Dockerfile

@@ -0,0 +1,67 @@
+FROM ubuntu:14.04
+MAINTAINER Aruba Maintainers <cukes-devs@googlegroups.com>
+
+# Packages needed to install RVM and run Bundler gem commands
+RUN apt-get update -qq \
+  && apt-get -y install ca-certificates curl git-core --no-install-recommends \
+  && rm -rf /var/lib/apt/lists/* /var/cache/apt/archives/*.deb /var/cache/apt/archives/partial/*.deb /var/cache/apt/*.bin
+
+# Create guest user early (before rvm) so uid:gid are 1000:000
+RUN useradd -m -s /bin/bash guest
+
+# Temporarily install RVM as root - just for requirements
+RUN gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 \
+  && curl -L get.rvm.io | bash -s stable \
+  && bash -l -c 'rvm requirements 2.2.1' \
+  && bash -l -c 'echo yes | rvm implode' \
+
+# Fix locale
+ENV DEBIAN_FRONTEND noninteractive
+RUN dpkg-reconfigure locales && locale-gen en_US.UTF-8 && /usr/sbin/update-locale LANG=en_US.UTF-8 \
+   && echo 'en_US.UTF-8 UTF-8' >> /etc/locale.gen && locale-gen
+ENV LC_ALL C.UTF-8
+ENV LANG C.UTF-8
+ENV LANGUAGE C.UTF-8
+
+# Zsh (just for the sake of a handful of Cucumber scenarios)
+RUN apt-get update -qq \
+  && apt-get -y install zsh --no-install-recommends \
+  && rm -rf /var/lib/apt/lists/* /var/cache/apt/archives/*.deb /var/cache/apt/archives/partial/*.deb /var/cache/apt/*.bin
+
+# Python (just for the sake of a handful of Cucumber scenarios)
+RUN apt-get update -qq \
+  && apt-get -y install python --no-install-recommends \
+  && rm -rf /var/lib/apt/lists/* /var/cache/apt/archives/*.deb /var/cache/apt/archives/partial/*.deb /var/cache/apt/*.bin
+
+# Java (for javac - also for just a few Cucumber scenarios)
+RUN apt-get update -qq \
+  && apt-get -y install openjdk-7-jdk --no-install-recommends \
+  && rm -rf /var/lib/apt/lists/* /var/cache/apt/archives/*.deb /var/cache/apt/archives/partial/*.deb /var/cache/apt/*.bin
+
+# Cache needed gems - for faster test reruns
+ADD Gemfile Gemfile.lock aruba.gemspec /home/guest/cache/aruba/
+ADD lib/aruba/version.rb /home/guest/cache/aruba/lib/aruba/version.rb
+RUN chown -R guest:guest /home/guest/cache
+
+USER guest
+ENV HOME /home/guest
+WORKDIR /home/guest
+
+# Install RVM as guest
+RUN gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 \
+  && /bin/bash -l -c "echo 'gem: --no-ri --no-rdoc' > ~/.gemrc" \
+  && curl -L get.rvm.io | bash -s stable \
+  && /bin/bash -l -c "rvm install 2.3.0 && rvm cleanup all" \
+  && /bin/bash -l -c "gem install bundler --no-ri --no-rdoc" \
+  && echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"' >> ~/.bashrc \
+  && echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"' >> ~/.zshrc
+
+# Download and install aruba + dependencies
+WORKDIR /home/guest/cache/aruba
+RUN bash -l -c "bundle install"
+
+# Default working directory
+RUN mkdir -p /home/guest/aruba
+WORKDIR /home/guest/aruba
+
+CMD ["bundle exec rake test"]