webtrap 0.0.0 → 0.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e32a4e898ff867cc637d3d172aac40ded927bc32
-  data.tar.gz: 32235a98f61b4479aa6e3d1d96bfa481e1ecfe8e
+  metadata.gz: 6588474ffa8dde283728eb5f92c5eff22fe4dcba
+  data.tar.gz: 6bbd81d456fb3a44a72c95a570c2b24dfb5df1a1
 SHA512:
-  metadata.gz: 741d50fb982ea969bc9630abae14ba8ddc7269b300ca82c4fdae8e1c7d1f9ea86e0622e0fde45617e7c6a7f56415d49b6687cc9cae1286567697c27363aee99a
-  data.tar.gz: 42b5e1a259c7904857dbf27b35f268f7cd962dc882f7bdb0852b98d875110a6f35dfb670084b09f7cc2d9fa533fba0bc7902811c52e4e5af6d7674f794a6d5af
+  metadata.gz: de34495dfafe249c736524599a365bd9ad3e5dce325fa1421dadd04d65e5f248a8b20ec0f5e664d7d25b74ce73fc5f55165742ee8fe18accecd11d2b7dd2032a
+  data.tar.gz: 98a88a5212a5769ce493862ae11db94f4a54f7b273c0f2880dc081a6cb84dc300b092f52a6d5ecd63970b845dd11437905da019b964b770578fb8a67795ee81a

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+.yardoc/
+doc/

data/.rubocop.yml

@@ -0,0 +1,60 @@
+AllCops:
+  Include:
+    - "**/Rakefile"
+    - "**/config.ru"
+  Exclude:
+    - "db/**/*"
+    - "config/**/*"
+    - "script/**/*"
+    - "bin/**/*"
+    - "vendor/**/*"
+    - "node_modules/**/*"
+    - "spec/factories.rb"
+  TargetRubyVersion: 2.3
+
+Metrics/LineLength:
+  Enabled: false
+
+Style/AlignParameters:
+  EnforcedStyle: with_fixed_indentation
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/DotPosition:
+  EnforcedStyle: trailing
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/PredicateName:
+  NamePrefixBlacklist:
+    - is_
+    - have_
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/NumericLiterals:
+  Enabled: false
+
+Style/SingleLineBlockParams:
+  Enabled: false
+
+Style/MultilineOperationIndentation:
+  EnforcedStyle: indented
+
+Style/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+Style/TrailingCommaInArguments:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInLiteral:
+  EnforcedStyleForMultiline: comma
+
+Style/FrozenStringLiteralComment:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,16 @@
+language: ruby
+sudo: false
+cache:
+  directories:
+    - ../bundle
+bundler_args: "--standalone --path ../bundle"
+rvm:
+  - 2.0.0
+  - 2.1
+  - 2.2.5
+  - 2.3.3
+  - 2.4.0
+  - ruby-head
+before_install: gem install bundler -v 1.13.6
+script:
+  - bundle exec cucumber

data/CONTRIBUTING.md

@@ -0,0 +1,45 @@
+Contributing
+============
+
+We welcome all kinds of contributions whether it is a bug, a new feature,
+documentation, etc.
+
+Please follow these guidelines when contributing to this project.
+
+
+## Bug Reporting
+
+If anything feels like a bug, it is probably a bug. But if it isn't, we're happy
+to let you know why :smile:. When submitting your issue, follow these tips:
+
+* Include an thorough environment description:
+  - Operating System;
+  - Ruby version;
+  - Gem versions (include your `Gemfile.lock` when not sure);
+* Describe the bug as well as possible so that we can reproduce it;
+* If possible, provide a code sample that showcases the issue.
+
+
+## Pull Requests
+
+Pull requests are **always** welcome. After that we'll review it and get back to
+you on it. To increase the chance of your PR being accepted, follow these tips:
+
+* Your changes **must** pass in the [CI][ci];
+* If your changes include code, it **must** be tested (if not sure how, we're
+  here to help);
+* **Avoid** breaking the conventions set by existing code unless you have a very
+  good reason for it (just because there isn't a linter to catch it, doesn't
+  mean it's ok);
+* After your changes get approved, you **must** squash all your commits to the
+  minimal logical set (which is _one_, unless instructed otherwise);
+* **It's ok to ask for help**: if you're struggling to finish implementing your
+  idea, reach out to us and we'll try to point you in the right direction.
+
+
+## Thank you
+
+Thank you for even considering helping out. You're awesome! :heart:
+
+
+[ci]: https://travis-ci.org/pfac/webtrap

data/Gemfile

@@ -1,3 +1,9 @@
+# frozen_string_literal: true
+
 source "http://rubygems.org"
 
 gemspec
+
+group :documentation do
+  gem "yard", "~> 0.9.8"
+end

data/Gemfile.lock

@@ -12,6 +12,7 @@ GEM
   specs:
     addressable (2.5.0)
       public_suffix (~> 2.0, >= 2.0.2)
+    ast (2.3.0)
     builder (3.2.3)
     crack (0.4.3)
       safe_yaml (~> 1.0.0)
@@ -36,10 +37,14 @@ GEM
     multi_test (0.1.2)
     nokogiri (1.6.8.1)
       mini_portile2 (~> 2.1.0)
+    parser (2.4.0.0)
+      ast (~> 2.2)
+    powerpack (0.1.1)
     public_suffix (2.0.5)
     rack (1.6.5)
     rack-protection (1.5.3)
       rack
+    rainbow (2.2.1)
     rake (10.4.2)
     rspec (3.5.0)
       rspec-core (~> 3.5.0)
@@ -54,16 +59,25 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.5.0)
     rspec-support (3.5.0)
+    rubocop (0.47.1)
+      parser (>= 2.3.3.1, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.0, >= 1.0.1)
+    ruby-progressbar (1.8.1)
     safe_yaml (1.0.4)
     sinatra (1.4.8)
       rack (~> 1.5)
       rack-protection (~> 1.4)
       tilt (>= 1.3, < 3)
     tilt (2.0.6)
+    unicode-display_width (1.1.3)
     webmock (2.3.2)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
       hashdiff
+    yard (0.9.8)
 
 PLATFORMS
   ruby
@@ -72,7 +86,9 @@ DEPENDENCIES
   bundler (~> 1.13)
   cucumber (~> 2.0)
   rake (~> 10.0)
+  rubocop (~> 0.47.1)
   webtrap!
+  yard (~> 0.9.8)
 
 BUNDLED WITH
    1.13.6

data/README.md

@@ -1,4 +1,194 @@
-Send Request
-============
+WebTrap
+=======
 
-Not the best name for this.
+[![Gem Version](https://badge.fury.io/rb/webtrap.svg)](https://badge.fury.io/rb/webtrap)
+[![Build Status](https://travis-ci.org/pfac/webtrap.svg?branch=master)](https://travis-ci.org/pfac/webtrap)
+[![Dependency Status](https://gemnasium.com/badges/github.com/pfac/webtrap.svg)](https://gemnasium.com/github.com/pfac/webtrap)
+[![Code Climate](https://codeclimate.com/github/pfac/webtrap/badges/gpa.svg)](https://codeclimate.com/github/pfac/webtrap)
+[![Inch CI](https://inch-ci.org/github/pfac/webtrap.svg?branch=master)](https://inch-ci.org/github/pfac/webtrap)
+
+WebTrap allows you to write tests that assert on outgoing requests. This allows
+you to verify that such requests match the documentation of external services
+without actually having to hit them.
+
+## Install
+
+To install this library, just run the following command on your shell:
+
+```sh
+#!/bin/sh
+gem install webtrap
+```
+
+Or, if you're using [Bundler][bundler], add the following to your project's
+`Gemfile`:
+
+```ruby
+# Gemfile
+gem "webtrap", group: :test
+```
+
+
+## Usage
+
+WebTrap consists on a set of matchers that given a block where an HTTP request
+is sent provide the ability to assert over on the outgoing request.
+
+
+### Configuration
+
+In order to use WebTrap matchers, make sure you require the correct file into
+your configuration:
+
+
+#### RSpec
+
+```ruby
+require "webtrap/rspec"
+```
+
+Include this line in the specs where you wish to use these matchers. If you
+prefer to make WebTrap matchers available to all specs add this line to
+`specs/spec_helper.rb`, or, if you are using `rspec-rails`, add it to
+`specs/support/webtrap.rb`.
+
+
+### Examples
+
+* Verify that a request is sent anywhere:
+  ```ruby
+  expect do
+    # ...
+  end.to send_request
+  ```
+
+* Verify that a request is send with a specific XML body (or [equivalent][equivalent-xml]):
+  ```ruby
+  expect do
+    # ...
+  end.to send_request.with_xml(xml)
+  ```
+
+
+## Contributing
+
+If you find a problem, have an idea or a suggestion, but don't know how to
+implement it, or if you simply have a question regarding this project,
+[please create an issue on GitHub][github-issue]. Your issue will be reviewed by
+one of the main contributors and taken into consideration in the development of
+the project.
+
+On the other hand, if you are able to take action on the issue
+[please submit a pull request][github-pull-request] instead. Development will go
+a lot faster with contributions from the community, be it in code, documentation
+or any other form.
+
+Any contribution is more than welcome.
+
+### Setup
+
+Start by cloning the project into your system and running the bootstrapping
+script included to set up your development environment:
+
+```sh
+#!/bin/sh
+git clone https://github.com/pfac/webtrap.git
+cd webtrap
+./bin/setup
+```
+
+Here's what the script does:
+
+1. Checks the existence of a compatible Ruby environment (MRI 2.0+);
+2. Checks the presence of [Bundler][bundler], and installs it if missing;
+3. Installs all dependencies.
+
+Feel free to check the script before running it. To check if everything is
+correctly set up run:
+
+```sh
+#!/bin/sh
+bundle exec rake
+```
+
+That will run the linters and acceptance tests. If the tests fail please check
+the [build status][travis-ci] for the branch you checked out. Unless the build
+status is already failing, please investigate the issue on your environment. If
+you found a defect in the bootstraping script, please file an issue to let us
+know (be as detailed as possible).
+
+
+### Development
+
+In this project we use BDD with Cucumber. Ideally you should start with a
+successful build, which you can check by running:
+
+```sh
+#!/bin/sh
+bundle exec rake
+```
+
+It may happen that the branch where you started (usually `master`) is already
+broken on [the CI][travis-ci]. If that is the case try to focus only on the scenarios you
+are working on, by running instead:
+
+```sh
+#!/bin/sh
+cucumber features/<path-to-file>
+```
+
+Start by describing your idea in either a new scenario or a whole new feature
+file. If you are not sure which one to go for, create a new feature file and
+someone will point you in the right direction during code revision. Make sure
+your scenario fails before proceeding.
+
+After that, implement the necessary code required to make your scenario pass. If
+you find yourself in trouble feel free to [create an issue][github-issue]
+pointing to your changes and someone will try to help you.
+
+Once your scenario passes, refactor as required. Make sure your code gets
+properly checked by the linters. When you feel your changes are ready,
+[submit a pull request][github-pull-request]. We'll review it in the nicest way
+possible. :smile:
+
+For a short-list to follow before submitting your pull request, see
+[CONTRIBUTING](./CONTRIBUTING.md).
+
+
+### Deployment
+
+Any main contributor can deploy a new version. To do so, update the version
+number as appropriate according to [Semantic Versioning][semver] and run the
+deployment script:
+
+```sh
+#!/bin/sh
+./bin/deploy
+```
+
+On the other hand, if you are not a main contributor with deployment
+permissions your idea will have to wait for a new version release to become
+available in [RubyGems][rubygems] once it gets accepted.
+
+At the moment there is no need for a release schedule, so new versions will be
+released at the discretion of the main contributors team. Should you require
+a pending feature to be released, feel free to mention it in your pull request
+once it gets merged, or to open a new issue. We'll try to honor such requests
+as much as possible when reasonable.
+
+
+## About
+
+WebTrap was originally designed by and is currently maintained by
+[Pedro Costa][pfac]. All artifacts in this project are released under the
+[MIT license](./LICENSE.txt).
+
+
+[bundler]: http://bundler.io/
+[equivalent-xml]: https://github.com/mbklein/equivalent-xml
+[github-issue]: https://github.com/pfac/webtrap/issues/new
+[github-pull-request]: https://github.com/pfac/webtrap/pull/new
+[pfac]: https://github.com/pfac
+[rubygems]: https://rubygems.org/gems/webtrap
+[semver]: http://semver.org/
+[travis-ci]: https://travis-ci.org/pfac/webtrap

data/Rakefile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+namespace :lint do
+  require "rubocop/rake_task"
+  RuboCop::RakeTask.new(:ruby)
+end
+task lint: %i(lint:ruby)
+
+namespace :test do
+  require "cucumber/rake/task"
+  Cucumber::Rake::Task.new(:acceptance)
+end
+task test: %i(test:acceptance)
+
+task default: %i(lint test)

data/bin/deploy

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+set -e
+
+_webtrap_has_gem () {
+  type gem > /dev/null 2>&1
+}
+
+_webtrap_deploy () {
+  if ! _webtrap_has_gem; then
+    echo '* Compatible Ruby environment not found' >&2
+    echo 'WebTrap Setup error: this project requires a compatible Ruby environment.' >&2
+    exit 1
+  fi
+
+  gem push "$(gem build webtrap.gemspec | grep "File:" | cut -d\  -f4)"
+}
+
+_webtrap_deploy "$@"

data/bin/setup

@@ -0,0 +1,40 @@
+#!/usr/bin/env sh
+
+_webtrap_has_compatible_ruby () {
+  if ! type ruby > /dev/null 2>&1; then
+    return 1
+  fi
+
+  local major_version=`ruby --version | cut -d\  -f2 | cut -dp -f1 | cut -d. -f1`
+
+  [ "$major_version" -ge "2" ]
+}
+
+_webtrap_has_gem () {
+  type gem > /dev/null 2>&1
+}
+
+_webtrap_has_bundler () {
+  type bundler > /dev/null 2>&1
+}
+
+_webtrap_setup () {
+  if ! _webtrap_has_compatible_ruby || ! _webtrap_has_gem; then
+    echo '* Compatible Ruby environment not found' >&2
+    echo 'WebTrap Setup error: this project requires MRI 2.0+ to be available.' >&2
+    exit 1
+  fi
+
+  if ! _webtrap_has_bundler; then
+    echo '* Bundler not found.'
+    echo 'WebTrap Setup error: this project requires Bundler to be available.' >&2
+    exit 2
+  fi
+
+  echo '* Checking dependencies'
+  (bundle check || bundle install) > /dev/null
+
+  echo '* All done'
+}
+
+_webtrap_setup "$@"

data/cucumber.yml

@@ -0,0 +1 @@
+default: --format progress

data/lib/webtrap/rspec/matchers/send_request.rb

@@ -1,26 +1,56 @@
+# frozen_string_literal: true
+
 require "webmock/rspec"
 
 module WebTrap
   module RSpec
     module Matchers
+      # @api private
+      # Provides the implementation for `send_request`.
+      # Not intended to be instantiated directly.
       class SendRequest
+        # @api public
+        # Specifies the XML payload of the request.
+        #
+        # The expectation will pass only if a request is sent with a payload
+        # that is considered equivalent to the reference. For further details
+        # see the {https://github.com/mbklein/equivalent-xml equivalent-xml}
+        # gem.
+        #
+        # @param xml [] The reference XML payload.
+        # @return [SendRequestWithXml]
+        #   The matcher to verify that a request is with a payload equivalent
+        #   to the reference.
+        def with_xml(xml)
+          SendRequestWithXml.new(xml)
+        end
+
+        # @api private
+        # Checks if the provided Proc sends an HTTP request.
+        # @param transmission_proc [Proc]
+        #   The proc that should send an HTTP request.
+        # @return
+        #   Whether an HTTP request was sent.
+        # @see {RSpec::Matchers::MatcherProtocol#matches?}
         def matches?(transmission_proc)
           perform_transmission(transmission_proc)
           request_sent?
         end
 
+        # @api private
+        # Message to be shown if the expectation fails to pass.
+        # @return [String]
         def failure_message
           "expected block to send an HTTP request, but nothing was sent out"
         end
 
+        # @api private
+        # Allows the matcher to be used with block expectations.
+        # @return [TrueClass]
         def supports_block_expectations?
           true
         end
 
-        def with_xml(xml)
-          SendRequestWithXml.new(xml)
-        end
-
         private
 
         def perform_transmission(transmission_proc)

data/lib/webtrap/rspec/matchers/send_request_with_xml.rb

@@ -1,27 +1,51 @@
+# frozen_string_literal: true
+
 require "equivalent-xml"
 require "webmock/rspec"
 
 module WebTrap
   module RSpec
     module Matchers
+      # @api private
+      # Used to specify the XML payload of the request.
       class SendRequestWithXml < SendRequest
+        # Reference to be compared with the payload of outgoing XML requests.
         attr_reader :expected_payload
 
+        # Allows the parameterization of the matcher with the reference payload.
+        # @param expected_payload []
+        #   Reference to be compared with the payload of outgoing XML requests.
         def initialize(expected_payload)
           @expected_payload = expected_payload
         end
 
+        # @api private
+        # Checks if the provided Proc sends a request with an XML payload
+        # equivalent to the expected reference.
+        # @param transmission_proc [Proc]
+        #   The proc that should send a valid request.
+        # @return
+        #   Whether a request was sent with an equivalent XML payload.
+        # @see {RSpec::Matchers::MatcherProtocol#matches?}
         def matches?(transmission_proc)
           perform_transmission(transmission_proc)
           request_sent? && valid_payload?
         end
 
+        # @api private
+        # Message to be shown if the expectation fails to pass.
+        # @return [String]
+        # @see {RSpec::Matchers::MatcherProtocol#failure_message}
         def failure_message
           return super unless request_sent?
 
           "expected block to send an HTTP request with XML body, but payload was not equivalent"
         end
 
+        # @api private
+        # Allows the matcher to be used with block expectations.
+        # @return [TrueClass]
+        # @see {RSpec::Matchers::MatcherProtocol#supports_block_expectations?}
         def supports_block_expectations?
           true
         end

data/lib/webtrap/rspec/matchers.rb

@@ -1,9 +1,17 @@
+# frozen_string_literal: true
+
 require "webtrap/rspec/matchers/send_request"
 require "webtrap/rspec/matchers/send_request_with_xml"
 
 module WebTrap
   module RSpec
+    # WebTrap::RSpec::Matchers provides the set of matchers available to define
+    # expections about outgoing requests.
     module Matchers
+      # Passes if the block sends any HTTP request.
+      #
+      # @return [SendRequest]
+      #   The matcher to verify that the request is sent.
       def send_request
         SendRequest.new
       end

data/lib/webtrap/rspec.rb

@@ -1,3 +1,14 @@
+# frozen_string_literal: true
+
 require "webtrap/server"
 
 require "webtrap/rspec/matchers"
+
+module WebTrap
+  # Implementation of the WebTrap features for the RSpec testing tool.
+  #
+  # @example
+  #   require "webtrap/rspec"
+  module RSpec
+  end
+end

data/lib/webtrap/server.rb

@@ -1,24 +1,39 @@
+# frozen_string_literal: true
+
 require "sinatra"
 
 module WebTrap
+  # Base class for creating fake web application to capture outgoing web
+  # requests and assert on them.
+  #
+  # Descendants of this class are in charge of setting the required rules to
+  # correctly intercept the target requests.
+  #
+  # Currently it is only used by SendRequestWithXml.
   class Server < Sinatra::Base
     @payload_was_valid = false
     @request_received = false
 
-    def self.payload_was_valid?
-      @payload_was_valid
+    class << self
+      # Set whether the payload met the matcher constraints.
+      # @param value [Boolean]
+      attr_writer :payload_was_valid
+
+      # Set whether a request was received at all.
+      # @param value [Boolean]
+      attr_writer :request_received
     end
 
-    def self.payload_was_valid=(payload_was_valid)
-      @payload_was_valid = payload_was_valid
+    # Whether the payload met the matcher constraints.
+    # @return [Boolean] `false` by default.
+    def self.payload_was_valid?
+      @payload_was_valid
     end
 
+    # Whether a request was received at all.
+    # @return [Boolean] `false` by default.
     def self.request_received?
       @request_received
     end
-
-    def self.request_received=(request_received)
-      @request_received = request_received
-    end
   end
 end

data/lib/webtrap/version.rb

@@ -1,3 +1,6 @@
+# frozen_string_literal: true
+
 module WebTrap
-  VERSION = "0.0.0"
+  # Current version of the WebTrap gem.
+  VERSION = "0.0.1"
 end

data/lib/webtrap.rb

@@ -0,0 +1,6 @@
+# WebTrap's top level namespace.
+#
+# This module should not be required directly. Instead, require the specific
+# submodule for the testing tool being used.
+module WebTrap
+end

data/webtrap.gemspec

@@ -41,7 +41,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "webmock", "~> 2.0"
 
   spec.add_development_dependency "bundler", "~> 1.13"
-  spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "cucumber", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rubocop", "~> 0.47.1"
 end
-

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: webtrap
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.0.1
 platform: ruby
 authors:
 - Pedro Costa
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-02-05 00:00:00.000000000 Z
+date: 2017-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: equivalent-xml
@@ -80,6 +80,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -95,19 +109,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '10.0'
 - !ruby/object:Gem::Dependency
-  name: cucumber
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 0.47.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 0.47.1
 description: |2
       WebTrap allows you to write tests that assert on outgoing requests. This
       allows you to verify that such requests match the documentation of external
@@ -118,11 +132,20 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitignore"
+- ".rubocop.yml"
 - ".ruby-version"
+- ".travis.yml"
+- CONTRIBUTING.md
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
 - README.md
+- Rakefile
+- bin/deploy
+- bin/setup
+- cucumber.yml
+- lib/webtrap.rb
 - lib/webtrap/rspec.rb
 - lib/webtrap/rspec/matchers.rb
 - lib/webtrap/rspec/matchers/send_request.rb