uat-matchers 0.0.1.pre

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    Nzc3NWIwOTM4NjhhMGQwY2M1YzZkYzBmY2FkMzFjZGJlOGIzZWZlYQ==
+  data.tar.gz: !binary |-
+    OWZjOTZjOTI0MzQ2M2NjOTA2YWMwMDJkYzk0ZWVhZjBkZjQ3MTZhYQ==
+SHA512:
+  metadata.gz: !binary |-
+    YzFkMjkwMmEwMzQwZDBiMWFmOWU5YWQyYjYxNzIwMWE5Yjc5ZjcyNDcyY2Zm
+    NTJmMGE2ZTgzMjM4OWJlYzcwODM3MjE1NmRiZDkxYzE1YzkxNDdkMjEwMTQ4
+    ZjgyYjcwZTlhYmZiMWJkYjY4ODkwZTBkZDcxNjk0ZTc1MzBiMTM=
+  data.tar.gz: !binary |-
+    NzY4MTk2NTM5ZmI2ODMzMmE1OGE2Nzc2OGI3Mjc5MzA5MzRhNzE1ZWE3NDZj
+    YjViOTBmMTExMDI3Y2JlODkyNmUwZWI2NjdlNWMyMDlkNWI4ZTMzZDg3ZjA0
+    M2IxNGY0OWRhZTNlOWVmYzZlZjk3NTQ1N2Q5YzUwNzA3ZjNjNTc=

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper --format documentation --color true

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in uat-matchers.gemspec
+gemspec

data/README.md

@@ -0,0 +1,52 @@
+# UAT::Matchers
+
+A gem providing matchers to aid in testing
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'uat-matchers'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install uat-matchers
+
+## Usage
+
+# uat
+
+User Acceptance Test tooling
+
+    ```
+    UAT::Matchers::RPCHelper
+       UAT::Matchers::RPCHelper#setup!(url)
+         sets the url used by instances that include this module
+       #make_rpc(rpc_class, method, request, response_class, &optional_block)
+         when the request is successful
+           performs an rspec expectation that the class of the response matches "response_class"
+           behaves like an rpc call
+             creates an instance of rpc_class using the "client" class method, passing a hash with the url parts
+             calls the "method" on the resulting rpc_client, passing in the request
+             registers a callback for success
+             registers a callback for failure
+           and if the rspec expectation fails
+             raises an exception
+           and if the rspec expectation passes
+             and a block is passed
+               calls the block, passing in the response
+         when the request is a failure
+           raises an exception
+           which is the result of calling inspect on the parameter in the on_error handler block (PENDING: Temporarily skipped with xit)
+           behaves like an rpc call
+             creates an instance of rpc_class using the "client" class method, passing a hash with the url parts
+             calls the "method" on the resulting rpc_client, passing in the request
+             registers a callback for success
+             registers a callback for failure
+    ```

data/Rakefile

@@ -0,0 +1,3 @@
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new
+task :default => [ :spec ]

data/lib/uat/matchers.rb

@@ -0,0 +1 @@
+Dir["#{File.dirname(__FILE__)}/matchers/**/*.rb"].each { |f| require(f) }

data/lib/uat/matchers/api.rb

@@ -0,0 +1,15 @@
+module UAT
+  module Matchers
+    class API
+      # @param configuration [UAT::Matchers::Configuration]
+      def initialize(configuration)
+        @configuration = configuration
+      end
+
+      # @return [UAT::Matchers::RPCHelper]
+      def rpc_helper
+        RPCHelper.new(@configuration.rpc_service_url, @configuration.rspec_example)
+      end
+    end
+  end
+end

data/lib/uat/matchers/configuration.rb

@@ -0,0 +1,11 @@
+module UAT
+  module Matchers
+    class Configuration
+      # @attr [String]
+      attr_accessor :rpc_service_url
+
+      # @attr [RSpec::Example] a reference to the current example to be used in the matcher
+      attr_accessor :rspec_example
+    end
+  end
+end

data/lib/uat/matchers/rpc_helper.rb

@@ -0,0 +1,32 @@
+module UAT
+  module Matchers
+    # DRY up protobuf RPC call expectations with RPCHelper
+    class RPCHelper
+      # @param rpc_service_url [URI::Generic]
+      def initialize(rpc_service_url, rspec_example)
+        @rpc_service_url = rpc_service_url
+        @rspec_example = rspec_example
+      end
+
+      # @param rpc_class [#client] an rpc class with a client class method
+      # @param method [Symbol] a symbol containing the method name to call
+      # @param request [Protobuf::Message] the request object
+      # @param response_class [Class<Protobuf::Message>] the expected response class
+      # @yield block_that_receives_vetted_response an optional block which will be passed the response as long as it is an instance of the expected response_class
+      # @yieldparam response [Protobuf::Message]
+      # @yieldreturn is not used
+      def make_rpc(rpc_class, method, request, response_class, &block_that_receives_vetted_response)
+        opts = {:host => @rpc_service_url.host,
+                :port => @rpc_service_url.port,
+                :base => @rpc_service_url.path}
+        rpc_class.client(opts).send(method, request) do |rpc_response_handler|
+          rpc_response_handler.on_success do |response|
+            @rspec_example.expect(response.class).to @rspec_example.be response_class
+            block_that_receives_vetted_response.call(response) unless block_that_receives_vetted_response.nil?
+          end
+          rpc_response_handler.on_failure {|err| raise err.inspect }
+        end
+      end
+    end
+  end
+end

data/lib/uat/matchers/version.rb

@@ -0,0 +1,5 @@
+module UAT
+  module Matchers
+    VERSION = "0.0.1.pre"
+  end
+end

data/uat-matchers.gemspec

@@ -0,0 +1,21 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'uat/matchers/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "uat-matchers"
+  spec.version       = UAT::Matchers::VERSION
+  spec.authors       = ["Tommy Sullivan", "Blaine Schanfeldt"]
+  spec.email         = ["thomas.sullivan@lookout.com", "blaine.schanfeldt@lookout.com"]
+
+  spec.summary       = "A gem providing matchers that aid user acceptance testing"
+  spec.homepage      = "https://github.com/lookout/uat"
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.2.0"
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: uat-matchers
+version: !ruby/object:Gem::Version
+  version: 0.0.1.pre
+platform: ruby
+authors:
+- Tommy Sullivan
+- Blaine Schanfeldt
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-17 00:00:00.000000000 Z
+dependencies:
+- !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.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+description: 
+email:
+- thomas.sullivan@lookout.com
+- blaine.schanfeldt@lookout.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- README.md
+- Rakefile
+- lib/uat/matchers.rb
+- lib/uat/matchers/api.rb
+- lib/uat/matchers/configuration.rb
+- lib/uat/matchers/rpc_helper.rb
+- lib/uat/matchers/version.rb
+- uat-matchers.gemspec
+homepage: https://github.com/lookout/uat
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+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: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: A gem providing matchers that aid user acceptance testing
+test_files: []
+has_rdoc: