test_spec 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9de1b9a5b2ae221963420313565d64da5e982138
+  data.tar.gz: c3164a1dc1fedb62934d63a811beca414403bf1c
+SHA512:
+  metadata.gz: 18702682dfd0d5ac8e69b35d7ebf65fdf86095fee1a1f80ce12608e119df6a01649745ed93fea92266365ffd92c99d71e039ab01d2eb548c9bfd3e23b63d0a33
+  data.tar.gz: f569b3d2d807ccd70f3fab61c486bb9dafab14674c2cedb275a9a7579f11e23001dee93f61a29a2864f7e09df5ce6529de4ad4d3854495ffcfa9ac6826b41514

data/.gitignore

@@ -0,0 +1,46 @@
+# Ruby Generated
+
+/Gemfile.lock
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/spec/coverage/
+/tmp/
+
+# Rspec Failure Tracking
+
+.rspec_status
+
+# IDE Files
+
+.idea/
+*.iml
+*.iws
+*.ipr
+.vscode/
+.settings/
+.metadata
+.classpath
+.loadpath
+.buildpath
+.project
+
+# OS Files
+
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+$RECYCLE.BIN/
+Desktop.ini
+*.tmp
+*.bak
+*.swp
+*~.nib

data/.hound.yml

@@ -0,0 +1,69 @@
+AllCops:
+  Exclude:
+    - test_spec.gemspec
+    - spec/**/*
+
+# Removing need for frozen string literal comment.
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+# Removing the preference for string single quotes.
+Style/StringLiterals:
+  Enabled: false
+
+# Missing top-level module documentation comment.
+Style/Documentation:
+  Enabled: false
+
+# Prefer reduce over inject.
+Style/CollectionMethods:
+  PreferredMethods:
+    reduce: 'inject'
+
+# Use each_with_object instead of inject.
+Style/EachWithObject:
+  Enabled: false
+
+# Prefer fail over raise.
+Style/SignalException:
+  Enabled: false
+
+# This never works for validations.
+Layout/AlignHash:
+  EnforcedLastArgumentHashStyle: ignore_implicit
+
+# Align multi-line params with previous line.
+Layout/AlignParameters:
+  EnforcedStyle: with_fixed_indentation
+
+# Indent `when` clause one step from `case`.
+Layout/CaseIndentation:
+  IndentOneStep: true
+
+# Don't force bad var names for reduce/inject loops.
+Style/SingleLineBlockParams:
+  Enabled: false
+
+# For method chains, keep the dot with the method name.
+Layout/DotPosition:
+  EnforcedStyle: leading
+
+# Stop nesting so hard.
+Metrics/BlockNesting:
+  Max: 2
+
+# Encourage short methods.
+Metrics/MethodLength:
+  Max: 15
+
+# Encourage short (as possible) modules.
+Metrics/ModuleLength:
+  Max: 100
+
+# Encourage fewer parameters.
+Metrics/ParameterLists:
+  Max: 4
+
+# Remove execute permissions check.
+Lint/ScriptPermission:
+  Enabled: false

data/.rspec

@@ -0,0 +1,3 @@
+--format RSpec::TestSpec::Formatter
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,2 @@
+inherit_from:
+  - .hound.yml

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at jeff.nyman@yello.co. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+
+gem "coveralls", require: false
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+gemspec

data/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Jeff Nyman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,227 @@
+# TestSpec
+
+[![Gem Version](https://badge.fury.io/rb/test_spec.svg)](http://badge.fury.io/rb/test_spec)
+[![License](http://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/jeffnyman/test_spec/blob/master/LICENSE.md)
+
+> **The height of sophistication is simplicity.**<br>
+> &nbsp;&nbsp;&nbsp;&nbsp;*Clare Boothe Brokaw*
+
+---
+
+TestSpec is a tool for leveraging RSpec to create an expressive DSL for test and data conditions.
+
+TestSpec provides an internal DSL, similar to the [RSpec Story Runner](https://github.com/dchelimsky/rspec-stories). This was the predecessor of the [Cucumber](http://cukes.info/) external DSL provided by [Gherkin](http://cukes.info/gherkin.html).
+
+Behavior Driven Development, or even just good Test Driven Development, practices put emphasis on communication. Tools like Cucumber focus on allowing communication via a test description language, structured by Gherkin keywords. However, while the ideas of Gherkin are nice, tools like Cucumber abstract away the nuts and bolts of your tests.
+
+Abstraction can be a good thing but Cucumber gives you no choice in the matter. It hides code blocks behind a "call by regular expression" invocation mechanism instead of making those code blocks readily available in the test description.
+
+TestSpec lets you write as much logic beside your specifications as you want by leveraging the RSpec ecosystem with the addition of a Gherkin-like syntax as well as additions to that syntax.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'test_spec'
+```
+
+To get the latest code:
+
+```ruby
+gem 'test_spec', git: 'https://github.com/jeffnyman/test_spec'
+```
+
+After doing one of the above, execute the following command:
+
+```
+$ bundle
+```
+
+You can also install TestSpec just as you would any other gem:
+
+```
+$ gem install test_spec
+```
+
+## Usage
+
+To use TestSpec you simply have to require it within your `spec_helper` file:
+
+```ruby
+require 'test_spec'
+```
+
+Then you simply run your `rspec` command as normal against your test suite.
+
+Because TestSpec uses a custom formatter, you should have an `.rspec` file with the following line in it:
+
+```ruby
+--format RSpec::TestSpec::Formatter
+```
+
+You can use RSpec constructs within Specify constructs although there are some things to be aware of. Here is an example:
+
+```ruby
+Feature 'Bank Accounts' do
+  let(:valid_account_number) { '1234567890' }
+  subject { Account.new(valid_account_number) }
+
+  Scenario 'starting a new account' do
+    Test 'will have a starting balance of 0' do
+      expect(subject.balance).to eq(0)
+    end
+
+    it 'will not allow an invalid account name' do
+      expect { Account.new('thx1138') }.to raise_error(InvalidAccountNumberError)
+    end
+  end
+end
+```
+
+You can see that within the Feature construct I have let and subject elements. Within the Scenario you can see I use a Specify method (Test) and an RSpec method (it).
+
+## Documentation
+
+TestSpec provides an internal DSL that allows you to use a Gherkin-like structural syntax within traditional RSpec test suites.
+
+Note that while TestSpec does provide a Gherkin-like syntax, there is no parsing of an actual Gherkin feature file. This means there are no regular expression matchers that exist as part of step definitions.
+
+Here's a typical (if simplified) example of a traditional RSpec test:
+
+```ruby
+describe 'The Nature of Truth' do
+  context 'logic tests are applied' do
+    it 'will realize that true is almost certainly not false' do
+      expect(true).to_not be false
+    end
+
+    it 'will realize that true is pretty definitely true' do
+      expect(true).to be true
+    end
+  end
+end
+```
+
+The following examples will show how the above example can be utilized in the context of TestSpec's DSL.
+
+As with Gherkin, you can provide a high-level **Feature** keyword to describe the overall set of tests. Here is one example of what you can do:
+
+```ruby
+Feature 'The Nature of Truth' do
+  tests 'logic tests are applied' do
+    test 'true is almost certainly not false' do
+      expect(true).to_not be false
+    end
+
+    test 'true is pretty definitely true' do
+      expect(true).to be true
+    end
+  end
+end
+```
+
+Notice here the **tests** keyword. This is an alias for elements like RSpec's `context`. Further notice that a **Test** keyword can be used. Some people think of tests in terms of steps and TestSpec can accommodate that as follows:
+
+```ruby
+Feature 'The Nature of Truth' do
+  steps 'logic tests are applied' do
+    step 'true is almost certainly not false' do
+      expect(true).to_not be false
+    end
+
+    step 'true is pretty definitely true' do
+      expect(true).to be true
+    end
+  end
+end
+```
+
+This is similar to the previous example, with the changes being the use of the **steps** and **Step** keywords.
+
+Do note that unlike Gherkin feature files, you can have multiple **Feature** blocks within the test file. So you could have both of the above blocks co-existing and running together.
+
+If you want to adhere even more strictly to Gherkin syntax, TestSpec does allow that:
+
+```ruby
+Feature 'The Nature of Truth' do
+  Scenario 'simple logic tests are applied' do
+    Then 'true is almost certainly not false' do
+      expect(true).to_not be false
+    end
+
+    Then 'true is pretty definitely true' do
+      expect(true).to be true
+    end
+  end
+end
+```
+
+Here you can see the use of the **Scenario** keyword, which is encapsulating two Then test steps.
+
+Gherkin structures allow you to use the word "Ability" as an alias for "Feature". However TestSpec takes the viewpoint that a feature could be speaking to a high-level viewpoint, within which there are multiple abilities. Thus you can use both descriptors simultaneously:
+
+```ruby
+Feature 'The Nature of Truth' do
+  Ability 'logic tests can be applied' do
+    Scenario 'true is not false' do
+      Then 'true is almost certainly not false' do
+        expect(true).to_not be false
+      end
+    end
+
+    Scenario 'true is true' do
+      Then 'true is pretty definitely true' do
+        expect(true).to be true
+      end
+    end
+  end
+end
+```
+
+You can also see here that multiple **Scenario** blocks can be included within a Feature or Ability.
+
+This should give a rough idea of how TestSpec provides an internal DSL.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake spec:all` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To experiment with the code, run `bin/console` for an interactive prompt. If you want to make changes and see how they work as a gem installed on your local machine, run `bundle exec rake install`.
+
+The default `rake` command will run all tests as well as a Rubocop analysis.
+
+If you have rights to deploy a new version, make sure to update the version number in `version.rb`, and then run `bundle exec rake release`. This will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at [https://github.com/jeffnyman/test_spec](https://github.com/jeffnyman/test_spec). The testing ecosystem of Ruby is very large and this project is intended to be a welcoming arena for collaboration on yet another test-supporting tool. As such, contributors are very much welcome but are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) which is provided as a [code of conduct](https://github.com/jeffnyman/test_spec/blob/master/CODE_OF_CONDUCT.md).
+
+The TestSpec gems follows [semantic versioning](http://semver.org).
+
+To contribute to TestSpec:
+
+1. [Fork the project](http://gun.io/blog/how-to-github-fork-branch-and-pull-request/).
+2. Create your feature branch. (`git checkout -b my-new-feature`)
+3. Commit your changes. (`git commit -am 'new feature'`)
+4. Push the branch. (`git push origin my-new-feature`)
+5. Create a new [pull request](https://help.github.com/articles/using-pull-requests).
+
+## Author
+
+* [Jeff Nyman](http://testerstories.com)
+
+## License
+
+TestSpec is distributed under the [MIT](http://www.opensource.org/licenses/MIT) license.
+See the [LICENSE](https://github.com/jeffnyman/test_spec/blob/master/LICENSE.md) file for details.
+
+## Credits
+
+TestSpec has been inspired by the following projects. Each provided me with ideas for what to do and, in some cases, for what not to do. All were invaluable as I better considered how to leverage RSpec's functionality.
+
+* [maniok_bdd](https://github.com/21croissants/maniok_bdd)
+* [rspec-gherkin](https://github.com/sheerun/rspec-gherkin)
+* [rspec example steps](https://github.com/railsware/rspec-example_steps)
+* [XSpec](https://github.com/xaviershay/xspec)
+* [Mouse Melon](https://github.com/wojtha/mouse_melon)

data/Rakefile

@@ -0,0 +1,35 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require "rdoc/task"
+require "rubocop/rake_task"
+require "rspec/core/rake_task"
+
+RuboCop::RakeTask.new
+
+RSpec::Core::RakeTask.new(:spec)
+
+namespace :spec do
+  desc 'Clean all generated reports'
+  task :clean do
+    system('rm -rf spec/reports')
+    system('rm -rf spec/coverage')
+  end
+
+  RSpec::Core::RakeTask.new(all: :clean) do |config|
+    options  = %w[--color]
+    options += %w[--format documentation]
+    options += %w[--format html --out spec/reports/unit-test-report.html]
+
+    config.rspec_opts = options
+  end
+end
+
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.main = 'README.md'
+  rdoc.title = "TestSpec #{TestSpec::VERSION}"
+  rdoc.rdoc_files.include('README*', 'lib/**/*.rb')
+end
+
+task default: ['spec:all', :rubocop]

data/bin/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "test_spec"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "pry"
+Pry.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/test_spec.rb

@@ -0,0 +1,38 @@
+require "rspec/core"
+require "rspec/core/world"
+require "rspec/core/reporter"
+require "rspec/core/formatters"
+require "rspec/core/example_group"
+require "rspec/core/formatters/console_codes"
+require "rspec/core/formatters/documentation_formatter"
+
+require "test_spec/spec"
+require "test_spec/version"
+require "test_spec/rspec/world"
+require "test_spec/rspec/reporter"
+require "test_spec/rspec/formatter"
+require "test_spec/rspec/notification"
+require "test_spec/rspec/example_group"
+
+RSpec::Core::ExampleGroup.send :include, RSpec::TestSpec::ExampleGroup
+RSpec::Core::Reporter.send :include, RSpec::TestSpec::Reporter
+RSpec::Core::World.send :include, RSpec::TestSpec::World
+
+RSpec::Core::ExampleGroup.define_example_method :Scenario, with_steps: true
+RSpec::Core::ExampleGroup.define_example_method :Condition, with_steps: true
+RSpec::Core::ExampleGroup.define_example_method :Behavior, with_steps: true
+
+RSpec::Core::ExampleGroup.define_example_method :Step, with_steps: true
+RSpec::Core::ExampleGroup.define_example_method :Test, with_steps: true
+RSpec::Core::ExampleGroup.define_example_method :Rule, with_steps: true
+RSpec::Core::ExampleGroup.define_example_method :Fact, with_steps: true
+
+RSpec::Core::ExampleGroup.define_example_method :steps, with_steps: true
+RSpec::Core::ExampleGroup.define_example_method :rules, with_steps: true
+RSpec::Core::ExampleGroup.define_example_method :tests, with_steps: true
+RSpec::Core::ExampleGroup.define_example_method :facts, with_steps: true
+
+require "test_spec/rspec/shared_steps"
+# rubocop:disable Style/MixinUsage
+include RSpec::TestSpec::SharedSteps
+# rubocop:enable Style/MixinUsage

data/lib/test_spec/rspec/example_group.rb

@@ -0,0 +1,101 @@
+module RSpec
+  module TestSpec
+    module ExampleGroup
+      # In Rspec, example group bodies are delimited by 'describe' and
+      # 'context' methods. These encapsulate examples, which are delimited
+      # by 'it' methods. Example groups are evaluated in the context of an
+      # ExampleGroup instance. Individual examples are evaluated in the
+      # context of an instance of the ExampleGroup to which they belong.
+      def include_steps(*args)
+        name = args.shift
+
+        shared_block = ::RSpec.world.shared_example_steps[name]
+        shared_block || raise(ArgumentError,
+          "Could not find shared steps #{name.inspect}")
+
+        instance_exec(*args, &shared_block)
+      end
+
+      # rubocop:disable Naming/MethodName
+      def Given(message, options = {}, &block)
+        action :given, message, options, &block
+      end
+
+      def When(message, options = {}, &block)
+        action :when, message, options, &block
+      end
+
+      def Then(message, options = {}, &block)
+        action :then, message, options, &block
+      end
+
+      def And(message, options = {}, &block)
+        action :and, message, options, &block
+      end
+
+      def But(message, options = {}, &block)
+        action :but, message, options, &block
+      end
+      # rubocop:enable Naming/MethodName
+
+      def rule(message, options = {}, &block)
+        action :rule, message, options, &block
+      end
+
+      def fact(message, options = {}, &block)
+        action :fact, message, options, &block
+      end
+
+      def test(message, options = {}, &block)
+        action :test, message, options, &block
+      end
+
+      def step(message, options = {}, &block)
+        action :step, message, options, &block
+      end
+
+      def it(message, options = {}, &block)
+        action :it, message, options, &block
+      end
+
+      def specify(message, options = {}, &block)
+        action :specify, message, options, &block
+      end
+
+      def example(message, options = {}, &block)
+        action :example, message, options, &block
+      end
+
+      private
+
+      # rubocop:disable Metrics/AbcSize
+      # rubocop:disable Metrics/MethodLength
+      def action(type, message, options = {}, &_block)
+        ::RSpec.world.reporter.example_step_started(
+          self, type, message, options
+        )
+        options = { pending: true } if options == :pending
+
+        if block_given? && !options[:pending]
+          begin
+            yield
+          rescue StandardError => e
+            ::RSpec.world.reporter.example_step_failed(
+              self, type, message, options
+            )
+            raise e
+          end
+          ::RSpec.world.reporter.example_step_passed(
+            self, type, message, options
+          )
+        else
+          ::RSpec.world.reporter.example_step_pending(
+            self, type, message, options
+          )
+        end
+      end
+      # rubocop:enable Metrics/AbcSize
+      # rubocop:enable Metrics/MethodLength
+    end
+  end
+end

data/lib/test_spec/rspec/formatter.rb

@@ -0,0 +1,53 @@
+require "rspec/core/formatters/documentation_formatter"
+
+module RSpec
+  module TestSpec
+    class Formatter < ::RSpec::Core::Formatters::DocumentationFormatter
+      ::RSpec::Core::Formatters.register(
+        self,
+        :example_started, :example_passed, :example_step_passed,
+        :example_step_pending, :example_step_failed
+      )
+
+      # rubocop:disable Metrics/LineLength
+      def example_started(notification)
+        return unless notification.example.metadata[:with_steps]
+
+        full_message = "#{current_indentation}#{notification.example.description}"
+        output.puts Core::Formatters::ConsoleCodes.wrap(full_message, :default)
+      end
+
+      def example_passed(notification)
+        super unless notification.example.metadata[:with_steps]
+      end
+
+      def example_step_passed(notification)
+        full_message = "#{current_indentation}  #{notification.type.to_s.capitalize} #{notification.message}"
+        output.puts Core::Formatters::ConsoleCodes.wrap(full_message, :success)
+      end
+
+      # rubocop:disable Metrics/AbcSize
+      # rubocop:disable Style/ConditionalAssignment
+      def example_step_pending(notification)
+        full_message = "#{current_indentation}  #{notification.type.to_s.capitalize} #{notification.message}"
+
+        if notification.options[:pending] &&
+           notification.options[:pending] != true
+          full_message << " (PENDING: #{notification.options[:pending]})"
+        else
+          full_message << " (PENDING)"
+        end
+
+        output.puts Core::Formatters::ConsoleCodes.wrap(full_message, :pending)
+      end
+      # rubocop:enable Metrics/AbcSize
+      # rubocop:enable Style/ConditionalAssignment
+
+      def example_step_failed(notification)
+        full_message = "#{current_indentation}  #{notification.type.to_s.capitalize} #{notification.message} (FAILED)"
+        output.puts Core::Formatters::ConsoleCodes.wrap(full_message, :failure)
+      end
+      # rubocop:enable Metrics/LineLength
+    end
+  end
+end

data/lib/test_spec/rspec/notification.rb

@@ -0,0 +1,12 @@
+module RSpec
+  module TestSpec
+    # In RSpec, notifications are value objects that are passed to formatters
+    # to provide those formatters with information about a particular event.
+
+    Notification = Struct.new(:example, :type, :message, :options)
+
+    # Originally I did this:
+    # class Notification < Struct.new(:example, :type, :message, :options)
+    # end
+  end
+end

data/lib/test_spec/rspec/reporter.rb

@@ -0,0 +1,35 @@
+module RSpec
+  module TestSpec
+    module Reporter
+      # An RSpec reporter sends notifications to listeners. The listeners
+      # are usually formatters for a specific test run.
+      def example_step_started(example, type, message, options)
+        notify :example_step_started,
+          Notification.new(example, type, message, options)
+      end
+
+      def example_step_passed(example, type, message, options)
+        notify :example_step_passed,
+          Notification.new(example, type, message, options)
+      end
+
+      def example_step_failed(example, type, message, options)
+        notify :example_step_failed,
+          Notification.new(example, type, message, options)
+      end
+
+      def example_step_pending(example, type, message, options)
+        notify :example_step_pending,
+          Notification.new(example, type, message, options)
+      end
+
+      def registered_formatters
+        @listeners.values.map(&:to_a).flatten.uniq
+      end
+
+      def find_registered_formatter(cls)
+        registered_formatters.detect { |formatter| formatter.class == cls }
+      end
+    end
+  end
+end

data/lib/test_spec/rspec/shared_steps.rb

@@ -0,0 +1,18 @@
+module RSpec
+  module TestSpec
+    module SharedSteps
+      def shared_steps(name, &block)
+        ensure_shared_example_steps_name_not_taken(name)
+        ::RSpec.world.shared_example_steps[name] = block
+      end
+
+      private
+
+      def ensure_shared_example_steps_name_not_taken(name)
+        return unless ::RSpec.world.shared_example_steps.key?(name)
+
+        raise(ArgumentError, "Shared step '#{name}' already exists")
+      end
+    end
+  end
+end

data/lib/test_spec/rspec/world.rb

@@ -0,0 +1,11 @@
+module RSpec
+  module TestSpec
+    module World
+      # RSpec's 'world' is an internal container that is used for
+      # holding global non-configuration data.
+      def shared_example_steps
+        @shared_example_steps ||= {}
+      end
+    end
+  end
+end

data/lib/test_spec/spec.rb

@@ -0,0 +1,41 @@
+module TestSpec
+  module Spec
+    def self.included(base)
+      base.instance_eval do
+        alias :Feature    :context
+        alias :Ability    :context
+        alias :Story      :context
+        alias :Component  :context
+        alias :Workflow   :context
+
+        alias :Background :before
+        alias :Setup      :before
+        alias :Teardown   :after
+      end
+    end
+  end
+end
+
+# rubocop:disable Naming/MethodName
+def self.Feature(*args, &block)
+  RSpec.describe(*args, &block)
+end
+
+def self.Ability(*args, &block)
+  RSpec.describe(*args, &block)
+end
+
+def self.Story(*args, &block)
+  RSpec.describe(*args, &block)
+end
+
+def self.Component(*args, &block)
+  RSpec.describe(*args, &block)
+end
+
+def self.Workflow(*args, &block)
+  RSpec.describe(*args, &block)
+end
+# rubocop:enable Naming/MethodName
+
+RSpec.configuration.include TestSpec::Spec

data/lib/test_spec/version.rb

@@ -0,0 +1,3 @@
+module TestSpec
+  VERSION = "0.1.0".freeze
+end

data/test_spec.gemspec

@@ -0,0 +1,38 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "test_spec/version"
+require "date"
+
+Gem::Specification.new do |spec|
+  spec.name          = "test_spec"
+  spec.version       = TestSpec::VERSION
+  spec.date          = Date.today.strftime("%Y-%m-%d")
+  spec.authors       = ["Jeff Nyman"]
+  spec.email         = ["jeffnyman@gmail.com"]
+
+  spec.summary       = %q{Test and Data Condition DSL for RSpec}
+  spec.description   = %q{Test and Data Condition DSL for RSpec}
+  spec.homepage      = "https://github.com/jeffnyman/test_spec"
+  spec.license       = "MIT"
+
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.17"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "pry"
+
+  spec.post_install_message = %{
+(::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::)
+  TestSpec #{TestSpec::VERSION} has been installed.
+(::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::)
+  }
+end

metadata

@@ -0,0 +1,151 @@
+--- !ruby/object:Gem::Specification
+name: test_spec
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jeff Nyman
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-11-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Test and Data Condition DSL for RSpec
+email:
+- jeffnyman@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".hound.yml"
+- ".rspec"
+- ".rubocop.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/test_spec.rb
+- lib/test_spec/rspec/example_group.rb
+- lib/test_spec/rspec/formatter.rb
+- lib/test_spec/rspec/notification.rb
+- lib/test_spec/rspec/reporter.rb
+- lib/test_spec/rspec/shared_steps.rb
+- lib/test_spec/rspec/world.rb
+- lib/test_spec/spec.rb
+- lib/test_spec/version.rb
+- test_spec.gemspec
+homepage: https://github.com/jeffnyman/test_spec
+licenses:
+- MIT
+metadata: {}
+post_install_message: "\n(::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::)\n
+  \ TestSpec 0.1.0 has been installed.\n(::) (::) (::) (::) (::) (::) (::) (::) (::)
+  (::) (::) (::)\n  "
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2.2
+signing_key: 
+specification_version: 4
+summary: Test and Data Condition DSL for RSpec
+test_files: []