aruba 0.14.14 → 1.0.0

data/README.md

@@ -1,225 +1,102 @@
+[![MIT license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/cucumber/aruba/master/LICENSE)
+[![Docs](https://img.shields.io/badge/cucumber.pro-aruba-3d10af.svg)](https://app.cucumber.pro/projects/aruba)
 [![Gem Version](https://badge.fury.io/rb/aruba.svg)](http://badge.fury.io/rb/aruba)
 [![Code Climate](https://codeclimate.com/github/cucumber/aruba.svg)](https://codeclimate.com/github/cucumber/aruba)
-[![Join the chat at https://gitter.im/cucumber/aruba](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/cucumber/aruba?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Support](https://img.shields.io/badge/cucumber-support-orange.svg)](https://cucumber.io/support)
 
-Build status:
-
-Linux / OS X  | Windows
-------------- | -------------
-[![Build Status](https://travis-ci.org/cucumber/aruba.svg?branch=master)](https://travis-ci.org/cucumber/aruba) | [![Build status](https://ci.appveyor.com/api/projects/status/jfo2tkqhnrqqcivl?svg=true)](https://ci.appveyor.com/project/cucumberbdd/aruba/branch/master)
-
-`aruba` is an extension for popular TDD and BDD frameworks like "Cucumber", "RSpec" and "Minitest" to make testing of commandline applications meaningful, easy and fun.
-
-Features at a glance:
-
-* Test any command line application, implemented in any [programming
-  language](features/getting_started/supported_programming_languages.feature) -
-  e.g. Bash, Python, Ruby, Java, ...
-* Manipulate the file system and the process environment
-* Automatically reset state of file system and process environment between tests
+[![Travis CI build status](https://travis-ci.org/cucumber/aruba.svg)](https://travis-ci.org/cucumber/aruba) 
+[![Appveyor build status](https://ci.appveyor.com/api/projects/status/jfo2tkqhnrqqcivl?svg=true)](https://ci.appveyor.com/project/cucumberbdd/aruba)
 
 ## Install
 
 Add this line to your application's `Gemfile`:
 
-    gem 'aruba'
+```ruby
+gem 'aruba'
+```
 
 And then execute:
 
-    $ bundle
+```bash
+bundle
+```
 
 Or install it yourself as:
 
-    $ gem install aruba
-
-### Release Policy
-
-We try to be compliant to [Semantic Versioning 2.0.0](http://semver.org/spec/v2.0.0.html).
-
-### Supported ruby versions
-
-For an up to date list of all supported ruby versions, please see our [`.travis.yml`](https://github.com/cucumber/aruba/blob/master/.travis.yml). We only test against the latest version of a version branch - most times.
+```bash
+gem install aruba
+```
 
 ## Usage
 
-Please also see this
-[feature test](https://github.com/cucumber/aruba/blob/master/features/getting_started/supported_testing_frameworks.feature)
-for the most up to date documentation.
-
-### Initialize your project with "aruba"
-
-There's an initializer to make it easier for you to getting started. If you
-prefer to setup `aruba` yourself, please move on to the next section.
-
-1. Go to your project's directory
-
-2. Make sure, it's under version control and all changes are committed to your
-   version control repository
-
-3. Run one of the following commands depending on the tools you use to test your project.
-
-   This assumes, that you use either `rspec`, `cucumber-ruby` or `minitest` to
-   write the tests for your project. Besides that, your tool can be implemented
-   in any programming language you like.
-
-   ~~~bash
-   aruba init --test-framework rspec
-   aruba init --test-framework cucumber
-   aruba init --test-framework minitest
-   ~~~
-
-### Cucumber
-
-1. Create a file named "features/support/env.rb" with:
-
-   ~~~ruby
-   require 'aruba/cucumber'
-   ~~~
+### As a user getting started with Aruba
 
-2. Create a file named "features/use_aruba_with_cucumber.feature" with:
+Our most current documentation to get started with Aruba as a user can be
+found on [Cucumber Jam](https://app.cucumber.pro/projects/aruba).
+It is generated from our feature files describing the use of Aruba.
 
-   ~~~ruby
-   Feature: Cucumber
-     Scenario: First Run
-       Given a file named "file.txt" with:
-       """
-       Hello World
-       """
-       Then the file "file.txt" should contain:
-       """
-       Hello World
-       """
-   ~~~
+### As a user getting started with a ruby testing framework
 
-3. Run `cucumber`
+* **Cucumber**:
 
-### RSpec
+    If you're new to the Cucumber ecosystem, it's worth to visit
+[the project's documentation site](https://cucumber.io/docs). This also includes
+information about how to write feature files in Gherkin.
 
-1. Create a file named "spec/support/aruba.rb" with:
+* **RSpec**:
 
-   ~~~ruby
-   require 'aruba/rspec'
-   ~~~
+    If you want to use Aruba with RSpec and you need some information about how to use RSpec, please visit [their website](http://rspec.info/documentation/).
 
-2. Create a file named "spec/spec_helper.rb" with:
+* **minitest**:
 
-   ~~~ruby
-   $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+    The documentation for minitest can be found [here](http://docs.seattlerb.org/minitest/).
 
-   if RUBY_VERSION < '1.9.3'
-     ::Dir.glob(::File.expand_path('../support/**/*.rb', __FILE__)).each { |f| require File.join(File.dirname(f), File.basename(f, '.rb')) }
-   else
-     ::Dir.glob(::File.expand_path('../support/**/*.rb', __FILE__)).each { |f| require_relative f }
-   end
-   ~~~
+### As a developer getting started with Aruba
 
-3. Create a file named named "spec/use_aruba_with_rspec_spec.rb" with:
+A full documentation of the API for developers can be found on
+[RubyDoc](http://www.rubydoc.info/gems/aruba).
 
-   ~~~ruby
-   require 'spec_helper'
+## Support
 
-   RSpec.describe 'First Run', :type => :aruba do
-     let(:file) { 'file.txt' }
-     let(:content) { 'Hello World' }
+### Channels
 
-     before(:each) { write_file file, content }
+For support, please have a look at the [support website](https://cucumber.io/support)
+of Cucumber. You have different options to reach out for help: Recommended for
+Aruba are using the Slack channels &mdash; e.g. `committers-aruba` or `help-cucumber-ruby`
+&mdash; ([register account](https://cucumberbdd-slack-invite.herokuapp.com/)), and the
+[Issues page on GitHub](https://github.com/cucumber/aruba/issues).
 
-     it { expect(read(file)).to eq [content] }
-   end
-   ~~~
+### Maintainers
 
-4. Run `rspec`
+Currently, this gem is mainly maintained by this group of people:
 
-### Minitest
+* [@mvz](https://github.com/mvz)
 
-1. Add a file named "test/support/aruba.rb" with:
+## Release Policy
 
-   ~~~ ruby
-   require 'aruba/api'
-   ~~~
+We try to comply with [Semantic Versioning 2.0.0](http://semver.org/spec/v2.0.0.html).
 
-2. Add a file named "test/test_helper.rb" with:
+## Supported Ruby versions
 
-   ~~~ruby
-   $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+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.
 
-   if RUBY_VERSION < '1.9.3'
-     ::Dir.glob(::File.expand_path('../support/**/*.rb', __FILE__)).each { |f| require File.join(File.dirname(f), File.basename(f, '.rb')) }
-   else
-     ::Dir.glob(::File.expand_path('../support/**/*.rb', __FILE__)).each { |f| require_relative f }
-   end
-   ~~~
+## Supported operating systems
 
-3. Add a file named "test/use_aruba_with_minitest.rb" with:
-
-   ~~~ruby
-   $LOAD_PATH.unshift File.expand_path('../test', __FILE__)
-
-   require 'test_helper'
-   require 'minitest/autorun'
-
-   class FirstRun < Minitest::Test
-     include Aruba::Api
-
-     def setup
-       aruba_setup
-     end
-
-     def getting_started_with_aruba
-       file = 'file.txt'
-       content = 'Hello World' 
-
-       write_file file, content
-       read(file).must_equal [content]
-     end
-   end
-   ~~~
-
-4. Run your tests
-
-   `ruby -Ilib:test test/use_aruba_with_minitest.rb`
-
-## Documentation
-
-### User Documentation
-
-If you're interested in our steps and API, please browse our [feature
-files](https://github.com/cucumber/aruba/tree/master/features). You can find a
-lot of examples there. A good starting point are [Getting
-Started](https://github.com/cucumber/aruba/tree/master/features/getting_started)
-and [Step
-Overview](https://github.com/cucumber/aruba/blob/master/features/steps/overview.feature).
-A more or less full list of our steps can be found
-[here](https://github.com/cucumber/aruba/tree/master/features/steps). Our API
-is documentated
-[here](https://github.com/cucumber/aruba/tree/master/features/api) and some
-more information about how to configure `aruba`, can be found
-[here](https://github.com/cucumber/aruba/tree/master/features/configuration).
-The "RSpec" matchers provided by `aruba`, are documented
-[here](https://github.com/cucumber/aruba/tree/master/features/matchers).
-
-You can find our documentation on
-[Relish](http://www.relishapp.com/cucumber/aruba/docs) as well. Unfortunately
-"Relish" does not like the way we structered our feature tests. So this
-documentation found there may be not complete.
-
-### Developer Documentation
-
-`aruba` provides a wonderful API to be used in your tests:
-
-* Creating files/directories
-* Deleting files/directories
-* Checking file size
-* Checking file existence/absence
-* ...
-
-A full documentation of the API can be found
-[here](http://www.rubydoc.info/github/cucumber/aruba/master/frames).
+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.
 
 ## Contributing
 
 Please see the [CONTRIBUTING](CONTRIBUTING.md) file.
 
-## Copyright
+## Code branches
+
+Development takes place in the `master` 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.
+
+## License
 
-Copyright (c) 2010-2016 Aslak Hellesøy et al. See [MIT License](LICENSE) for details.
+See the file [LICENSE](LICENSE).

data/Rakefile

@@ -1,49 +1,80 @@
-# encoding: utf-8
-require 'rubygems'
+$LOAD_PATH << File.expand_path(__dir__)
+
+require 'aruba/tasks/docker_helpers'
+require 'aruba/platform'
+
 require 'bundler'
 Bundler.setup
-Bundler::GemHelper.install_tasks
+
+task default: %w(spec cucumber cucumber:wip lint)
+
+desc 'Run all linters.'
+task lint: %w(lint:coding_guidelines lint:licenses)
+
+desc 'Run the whole test suite.'
+task test: %w(spec cucumber cucumber:wip)
 
 require 'cucumber/rake/task'
+require 'rspec/core/rake_task'
 
 Cucumber::Rake::Task.new do |t|
-  t.cucumber_opts = ""
-  t.cucumber_opts << "--format progress"
+  t.cucumber_opts = %w{--format progress}
 end
 
-Cucumber::Rake::Task.new(:cucumber_wip) do |t|
-  t.cucumber_opts = "-p wip"
+Cucumber::Rake::Task.new('cucumber:wip', 'Run Cucumber features '\
+                         'which are "WORK IN PROGRESS" and '\
+                         'are allowed to fail') do |t|
+  t.cucumber_opts = %w{--format progress}
+  t.profile = 'wip'
 end
 
-require 'rspec/core/rake_task'
-desc "Run RSpec"
-RSpec::Core::RakeTask.new do |spec|
-  spec.rspec_opts = ['--color', '--format progress', '--warnings']
-end
+RSpec::Core::RakeTask.new
 
-namespace :travis do
-  desc 'Lint travis.yml'
-  task :lint do
-    begin
-      require 'travis/yaml'
-
-      puts 'Linting .travis.yml ... No output is good!'
-      Travis::Yaml.parse! File.read('.travis.yml')
-    rescue LoadError
-      $stderr.puts 'Your ruby is not supported for linting the .travis.yml file'
-    end
+namespace :lint do
+  desc 'Lint our code with "rubocop"'
+  task :coding_guidelines do
+    sh 'bundle exec rubocop'
   end
-end
 
-task :rubocop do
-  if RUBY_VERSION >= '2'
-    sh 'bundle exec rubocop --fail-level E'
-  else
-    warn 'Your ruby version is not supported for code linting'
+  desc 'Check for relevant licenses in project'
+  task :licenses do
+    sh 'bundle exec license_finder'
   end
+
+  require 'yard-junk/rake'
+  YardJunk::Rake.define_task
 end
 
-desc "Run tests, both RSpec and Cucumber"
-task :test => [ 'travis:lint', :rubocop, :spec, :cucumber, :cucumber_wip]
+Bundler::GemHelper.install_tasks
+
+namespace :docker do
+  desc 'Build docker image'
+  task :build, :cache, :version do |_, args|
+    args.with_defaults(version: 'latest')
+    args.with_defaults(cache: true)
+
+    docker_compose_file = Aruba::DockerComposeFile.new(File.expand_path('docker-compose.yml', __dir__))
+    docker_run_instance = Aruba::DockerRunInstance.new(docker_compose_file, :base)
+
+    builder = Aruba::DockerBuildCommandLineBuilder.new(
+      docker_run_instance,
+      cache: args[:cache],
+      version: args[:version]
+    )
+
+    sh builder.to_cli
+  end
+
+  desc 'Run docker container'
+  task :run, :command do |_, args|
+    docker_compose_file = Aruba::DockerComposeFile.new(File.expand_path('docker-compose.yml', __dir__))
+    docker_run_instance = Aruba::DockerRunInstance.new(docker_compose_file, :base)
+
+    builder = Aruba::DockerRunCommandLineBuilder.new(
+      docker_run_instance,
+      command: args[:command] || docker_run_instance.command
+    )
 
-task :default => :test
+    sh builder.to_cli
+  end
+end

data/appveyor.yml

@@ -1,11 +1,12 @@
 version: "{build}"
 
-# This will build all PRs targetting matching branches.
+# This will build all PRs targeting matching branches.
 # Without this, each PR builds twice -- once for the PR branch HEAD,
-# and once for the merge commit that github creates for each mergable PR.
+# and once for the merge commit that github creates for each mergeable PR.
 branches:
   only:
     - master
+    - still
 
 # Disable normal Windows builds in favor of our test script.
 build: off
@@ -14,19 +15,15 @@ install:
   - SET PATH=C:\Ruby%ruby_version%\bin;%PATH%
   - ruby --version
   - gem --version
-  - gem install bundler
   - bundler --version
   - bundle install
-  - cinst ansicon
 
 test_script:
-  - bundle exec rake test --trace
+  - bundle exec rake spec --trace
 
 environment:
   matrix:
-    - ruby_version: '18'
-    - ruby_version: '19'
-    - ruby_version: '20'
-    - ruby_version: '21'
-    - ruby_version: '22'
-
+    - ruby_version: '24'
+    - ruby_version: '25'
+    - ruby_version: '26'
+    # Note: ruby version 2.7 is not available as of 2019-12-31

data/aruba.gemspec

@@ -1,48 +1,54 @@
-# -*- encoding: utf-8 -*-
 lib = ::File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'aruba/version'
 
-Gem::Specification.new do |s|
-  s.name        = 'aruba'
-  s.version     = Aruba::VERSION
-  s.authors     = ["Aslak Hellesøy", "David Chelimsky", "Mike Sassak", "Matt Wynne", "Jarl Friis", "Dennis Günnewig"]
-  s.description = 'Extension for popular TDD and BDD frameworks like "Cucumber", "RSpec" and "Minitest" to make testing commandline applications meaningful, easy and fun.'
-  s.summary     = "aruba-#{s.version}"
-  s.license     = 'MIT'
-  s.email       = 'cukes@googlegroups.com'
-  s.homepage    = 'http://github.com/cucumber/aruba'
-
-  s.add_runtime_dependency 'cucumber', '>= 1.3.19'
-  s.add_runtime_dependency 'childprocess', ['>= 0.6.3', '< 4.0.0']
-  s.add_runtime_dependency 'ffi', '~> 1.9'
-  s.add_runtime_dependency 'rspec-expectations', '>= 2.99'
-  s.add_runtime_dependency 'contracts', '~> 0.9'
-  s.add_runtime_dependency 'thor', ['>= 0.19', '< 2.0']
-
-  s.add_development_dependency 'bundler', ['>= 1.7', '< 3.0']
-
-  s.rubygems_version = ">= 1.6.1"
-
-  if Aruba::VERSION >= '1'
-    s.required_ruby_version = '>= 1.9.3'
-  else
-    s.required_ruby_version = '>= 1.8.7'
-
-    s.post_install_message = <<-EOS
-Use on ruby 1.8.7
-* Make sure you add something like that to your `Gemfile`. Otherwise you will
-  get cucumber > 2 and this will fail on ruby 1.8.7
-
-  gem 'cucumber', '~> 1.3.20'
-
-With aruba >= 1.0 there will be breaking changes. Make sure to read https://github.com/cucumber/aruba/blob/master/History.md for 1.0.0
-EOS
+Gem::Specification.new do |spec|
+  spec.name        = 'aruba'
+  spec.version     = Aruba::VERSION
+  spec.author      = 'Aslak Hellesøy, Matt Wynne and other Aruba Contributors'
+  spec.description = 'Extension for popular TDD and BDD frameworks like "Cucumber", "RSpec" and "Minitest",
+to make testing commandline applications meaningful, easy and fun.'
+  spec.summary     = "aruba-#{spec.version}"
+  spec.license     = 'MIT'
+  spec.email       = 'cukes@googlegroups.com'
+  spec.homepage    = 'https://github.com/cucumber/aruba'
+
+  spec.metadata    = {
+    'bug_tracker_uri' => 'https://github.com/cucumber/aruba/issues',
+    'changelog_uri' => 'https://www.rubydoc.info/gems/aruba/file/CHANGELOG.md',
+    'documentation_uri' => 'https://www.rubydoc.info/gems/aruba',
+    'homepage_uri' => spec.homepage,
+    'source_code_uri' => 'https://github.com/cucumber/aruba'
+  }
+
+  spec.add_runtime_dependency 'childprocess', '~> 3.0'
+  spec.add_runtime_dependency 'contracts', '~> 0.16.0'
+  spec.add_runtime_dependency 'cucumber', ['>= 2.4', '< 4.0']
+  spec.add_runtime_dependency 'ffi', '~> 1.9'
+  spec.add_runtime_dependency 'rspec-expectations', '~> 3.4'
+  spec.add_runtime_dependency 'thor', '~> 1.0'
+
+  spec.add_development_dependency 'json', '~> 2.1'
+  spec.add_development_dependency 'license_finder', '~> 6.0'
+  spec.add_development_dependency 'minitest', '~> 5.10'
+  spec.add_development_dependency 'pry-doc', '~> 1.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.6'
+  spec.add_development_dependency 'rubocop', '~> 0.79.0'
+  spec.add_development_dependency 'rubocop-performance', '~> 1.5'
+  spec.add_development_dependency 'simplecov', '~> 0.18.0'
+  spec.add_development_dependency 'yard-junk', '~> 0.0.7'
+
+  spec.rubygems_version = '>= 1.6.1'
+  spec.required_ruby_version = '>= 2.4'
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
   end
 
-  s.files            = `git ls-files`.split("\n")
-  s.test_files       = `git ls-files -- {spec,features}/*`.split("\n")
-  s.executables      = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  s.rdoc_options     = ["--charset=UTF-8"]
-  s.require_path     = "lib"
+  spec.executables      = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.rdoc_options     = ['--charset', 'UTF-8', '--main', 'README.md']
+  spec.extra_rdoc_files = ['CHANGELOG.md', 'CONTRIBUTING.md', 'README.md', 'LICENSE']
+  spec.bindir           = 'exe'
+  spec.require_paths    = ['lib']
 end

data/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.expand_path('../lib', __dir__)
+
+require 'aruba/console'
+
+Aruba::Console.new.start

data/bin/test

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+
+: ${RUN_IN_DOCKER:='0'}
+
+if [ "$RUN_IN_DOCKER" == '1' ]; then
+  bundle exec rake "docker:run[$*]"
+else
+  bundle exec rake test $*
+fi

data/cucumber.yml

@@ -1,26 +1,6 @@
 <%
-$LOAD_PATH << ::File.expand_path('../lib', __FILE__)
-require 'aruba/version'
-require 'ffi'
-
-java_version = (RUBY_DESCRIPTION.match(/.*?on.*?(1\.[\d]\..*? )/))[1] if defined?(JRUBY_VERSION)
-
-std_opts          = "--color --exclude features/fixtures --require features --tags ~@unsupported-on"
-java_default_opts = "--tags ~@wip-jruby-java-1.6" if defined?(JRUBY_VERSION) && (java_version < '1.7.0')
-java_wip_opts     = "--tags @wip-jruby-java-1.6:3" if defined?(JRUBY_VERSION) && (java_version < '1.7.0')
-
-ignore_opts = []
-ignore_opts <<  '--tags ~@ignore'
-ignore_opts <<  '--tags ~@unsupported-on-platform-java'    if RUBY_PLATFORM.include? 'java'
-ignore_opts <<  '--tags ~@unsupported-on-platform-mri'     if !RUBY_PLATFORM.include? 'java'
-ignore_opts <<  '--tags ~@unsupported-on-platform-windows' if FFI::Platform.windows?
-ignore_opts <<  '--tags ~@unsupported-on-platform-unix'    if FFI::Platform.unix?
-ignore_opts <<  '--tags ~@unsupported-on-platform-mac'     if FFI::Platform.mac?
-ignore_opts <<  '--tags ~@unsupported-on-ruby-older-2'     if RUBY_VERSION < '2'
-ignore_opts <<  '--tags ~@unsupported-on-ruby-older-193'   if RUBY_VERSION < '1.9.3'
-ignore_opts <<  '--tags ~@unsupported-on-ruby-older-19'    if RUBY_VERSION < '1.9'
-ignore_opts <<  '--tags ~@requires-aruba-version-1'        if Aruba::VERSION < '1'
-ignore_opts = ignore_opts.join(' ')
+std_opts = "--format pretty --color --exclude features/fixtures --require features --tags 'not @unsupported-on'"
+ignore_opts = "--tags 'not @ignore'"
 %>
-default: <%= std_opts %> --tags ~@wip <%= java_default_opts %> <%= ignore_opts %>
-wip: <%= std_opts %> --wip --tags @wip:3 <%= java_wip_opts %> <%= ignore_opts %>
+default: <%= std_opts %> --tags 'not @wip' <%= ignore_opts %>
+wip: <%= std_opts %> --wip --tags @wip:3 <%= ignore_opts %>

data/doc/dependency_decisions.yml

@@ -1,5 +1,10 @@
 ---
-- - :whitelist
+- - :approve
+  - win32console
+  - :who: 
+    :why: 
+    :when: 2016-05-09 14:57:58.000000000 Z
+- - :permit
   - MIT
   - :who: 
     :why: 
@@ -9,26 +14,43 @@
   - :who: 
     :why: 
     :when: 2015-04-28 13:39:28.340867782 Z
-- - :whitelist
+- - :permit
   - BSD
   - :who: 
     :why: 
     :when: 2015-04-28 13:39:40.984464786 Z
-- - :whitelist
-  - Simplified BSD
+- - :ignore_group
+  - development
   - :who: 
     :why: 
-    :versions: []
-    :when: 2019-09-25 17:32:18.724363167 Z
-- - :whitelist
-  - New BSD
+    :when: 2016-04-19 21:35:58.945568982 Z
+- - :ignore_group
+  - test
+  - :who: 
+    :why: 
+    :when: 2016-04-19 21:36:02.006089986 Z
+- - :approve
+  - contracts
   - :who: 
     :why: 
-    :versions: []
-    :when: 2019-09-25 17:33:18.991343731 Z
-- - :whitelist
+    :when: 2016-04-19 21:38:58.571635580 Z
+- - :permit
   - ruby
   - :who: 
     :why: 
-    :versions: []
-    :when: 2019-09-25 17:35:47.177302643 Z
+    :when: 2016-04-19 21:40:01.747535503 Z
+- - :permit
+  - New BSD
+  - :who: 
+    :why: 
+    :when: 2016-12-07 14:54:49.587491547 Z
+- - :permit
+  - Simplified BSD
+  - :who: 
+    :why: 
+    :when: 2017-06-30 06:37:18.031292275 Z
+- - :ignore_group
+  - debug
+  - :who: 
+    :why: 
+    :when: 2017-06-09 14:29:19.742116140 Z