holoserve-connector 0.1.0

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2011 Skrill Holdings Ltd
+
+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.rdoc

@@ -0,0 +1,45 @@
+
+= HoloServe Connector - Connector library for HoloServe.
+
+This library provides a client to the control interface of HoloServe and RSpec matchers to integrate HoloServe in a
+test suite. See {holoserve}[https://github.com/skrill/holoserve] for details about the concept of HoloServe.
+
+== Example
+
+  require 'holoserve/connector'
+  require 'transport'
+
+  holoserve = Holoserve::Connector.new :host => "localhost", :port => 8080
+
+  holoserve.layouts.upload_yml "./layouts/test.yml"
+  holoserve.layouts.current = "one"
+
+  Transport::HTTP.request :post, "/test"     # handled in test layout one
+  Transport::HTTP.request :delete, "/test"   # unhandled
+
+  holoserve.history.pair_names
+  # => [ "test_requested" ]
+
+  holoserve.bucket.requsts
+  # => [ { "method" => "DELETE", :path => "/test", :headers => { ... } } ]
+
+== RSpec inetgration example
+
+  require 'rspec/holoserve'
+
+  RSpec::Holoserve.run_server = true
+
+  describe "RSpec matchers" do
+
+    before :all do
+      @client = Holoserve::Bond.new
+      @client.layouts.upload_yml File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "layouts", "test.yml"))
+      @client.layouts.current = "one"
+    end
+
+    it "should test if holoserve received a specified request" do
+      Transport::HTTP.request :post, "http://localhost:8080/test", :expected_status_code => 201
+      @client.should have_received("test_request")
+    end
+
+  end

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'bundler/setup'
+
+begin
+  require 'cucumber'
+  require 'cucumber/rake/task'
+
+  Cucumber::Rake::Task.new(:features) do |task|
+    task.cucumber_opts = "features --format pretty"
+  end
+
+  namespace :features do
+
+    Cucumber::Rake::Task.new(:wip) do |task|
+      task.cucumber_opts = "features --format pretty --tags @wip"
+    end
+
+  end
+rescue LoadError
+end
+
+begin
+  require 'rspec'
+  require 'rspec/core/rake_task'
+
+  desc "Run specs"
+  RSpec::Core::RakeTask.new do |task|
+    task.pattern = "./spec/lib/**/*_spec.rb"
+  end
+rescue LoadError
+end
+
+begin
+  require 'rdoc'
+  require 'rdoc/task'
+
+  Rake::RDocTask.new do |rdoc|
+    rdoc.main = "README.rdoc"
+    rdoc.rdoc_files.include("README.rdoc", "lib/**/*.rb")
+  end
+rescue LoadError
+end
+
+namespace :gem do
+
+  desc "Builds the gem"
+  task :build do
+    system "gem build *.gemspec && mkdir -p pkg/ && mv *.gem pkg/"
+  end
+
+  desc "Builds and installs the gem"
+  task :install => :build do
+    system "gem install pkg/"
+  end
+
+end

data/lib/holoserve/connector/bucket.rb

@@ -0,0 +1,12 @@
+
+class Holoserve::Connector::Bucket
+
+  def initialize(client)
+    @client = client
+  end
+
+  def requests
+    Transport::JSON.request :get, "#{@client.url}/bucket/requests"
+  end
+
+end

data/lib/holoserve/connector/history.rb

@@ -0,0 +1,16 @@
+
+class Holoserve::Connector::History
+
+  def initialize(client)
+    @client = client
+  end
+
+  def clear!
+    Transport::JSON.request :delete, "#{@client.url}/history"
+  end
+
+  def pair_names
+    Transport::JSON.request :get, "#{@client.url}/history "
+  end
+
+end

data/lib/holoserve/connector/layouts.rb

@@ -0,0 +1,54 @@
+require 'transport'
+
+class Holoserve::Connector::Layouts
+
+  def initialize(client)
+    @client = client
+
+    @boundary = "xxx12345xxx"
+  end
+
+  def clear!
+    Transport::JSON.request :delete,
+                            "#{@client.url}/layouts",
+                            :expected_status_code => 200
+  end
+
+  def upload_yml(filename)
+    Transport::HTTP.request :post,
+                            "#{@client.url}/layouts",
+                            :body => upload_yml_file_request_body(filename),
+                            :headers => {
+                              "Content-Type" => "multipart/form-data, boundary=#{@boundary}"
+                            },
+                            :expected_status_code => 200
+    true
+  rescue Transport::UnexpectedStatusCodeError => error
+    raise Holoserve::Connector::Error, error.message
+  end
+
+  def available
+    Transport::JSON.request :get, "#{@client.url}/layouts/ids"
+  end
+
+  def current=(id)
+    Transport::JSON.request :put, "#{@client.url}/layouts/#{id}/current"
+  end
+
+  def current
+    Transport::HTTP.request :get, "#{@client.url}/layouts/current"
+  end
+
+  private
+
+  def upload_yml_file_request_body(filename)
+    "--#{@boundary}\r\n" +
+      "Content-Disposition: form-data; name=\"file\"; filename=\"#{File.basename(filename)}\"\r\n" +
+      "Content-Type: application/x-yaml\r\n" +
+      "\r\n" +
+      File.read(filename) +
+      "\r\n" +
+      "--#{@boundary}--\r\n"
+  end
+
+end

data/lib/holoserve/connector.rb

@@ -0,0 +1,31 @@
+
+class Holoserve::Connector
+
+  autoload :Bucket, File.join(File.dirname(__FILE__), "connector", "bucket")
+  autoload :History, File.join(File.dirname(__FILE__), "connector", "history")
+  autoload :Layouts, File.join(File.dirname(__FILE__), "connector", "layouts")
+
+  class Error < StandardError; end
+
+  attr_reader :host
+  attr_reader :port
+
+  attr_reader :layouts
+  attr_reader :bucket
+  attr_reader :history
+
+  def initialize(options = { })
+    @host, @port = *options.values_at(:host, :port)
+    @host ||= "localhost"
+    @port ||= 4250
+
+    @layouts = Layouts.new self
+    @bucket = Bucket.new self
+    @history = History.new self
+  end
+
+  def url
+    "http://#{@host}:#{@port}/_control"
+  end
+
+end

data/lib/rspec/holoserve.rb

@@ -0,0 +1,36 @@
+require 'rspec'
+require 'rspec/expectations'
+require 'holoserve'
+
+RSpec.configure do |configuration|
+
+  configuration.before :suite do
+    if RSpec::Holoserve.run_server?
+      @server = ::Holoserve::Runner.new
+      @server.start
+    end
+  end
+
+  configuration.after :suite do
+    @server.stop if @server
+  end
+
+end
+
+RSpec::Matchers.define :have_received do |expected|
+  match do |actual|
+    actual.is_a?(Holoserve::Connector) && actual.history.pair_names.include?(expected)
+  end
+end
+
+class RSpec::Holoserve
+
+  def self.run_server=(value)
+    @run_server = value
+  end
+
+  def self.run_server?
+    !!@run_server
+  end
+
+end

data/spec/helper.rb

@@ -0,0 +1,4 @@
+require 'rubygems'
+require 'rspec'
+require 'holoserve'
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "lib", "holoserve", "connector"))

data/spec/layouts/test.yml

@@ -0,0 +1,9 @@
+one:
+  -
+    name: "test_request"
+    request:
+      method: "POST"
+      path: "/test"
+    response:
+      status: 201
+      body: "created"

data/spec/lib/rspec/holoserve_spec.rb

@@ -0,0 +1,19 @@
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "helper"))
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "..", "lib", "rspec", "holoserve"))
+
+RSpec::Holoserve.run_server = true
+
+describe "RSpec matchers" do
+
+  before :all do
+    @client = Holoserve::Connector.new
+    @client.layouts.upload_yml File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "layouts", "test.yml"))
+    @client.layouts.current = "one"
+  end
+
+  it "should test if holoserve received a specified request" do
+    Transport::HTTP.request :post, "http://localhost:8080/test", :expected_status_code => 201
+    @client.should have_received("test_request")
+  end
+
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: holoserve-connector
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Philipp Brüll
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: transport
+  requirement: &70253145056100 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70253145056100
+- !ruby/object:Gem::Dependency
+  name: holoserve
+  requirement: &70253145052760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70253145052760
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: &70253145051660 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70253145051660
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70253145050340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70253145050340
+description: Provides a client for the control interface of holoserve and some RSpec
+  matchers.
+email: philipp.bruell@skrill.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+files:
+- README.rdoc
+- LICENSE
+- Rakefile
+- lib/holoserve/connector/bucket.rb
+- lib/holoserve/connector/history.rb
+- lib/holoserve/connector/layouts.rb
+- lib/holoserve/connector.rb
+- lib/rspec/holoserve.rb
+- spec/helper.rb
+- spec/layouts/test.yml
+- spec/lib/rspec/holoserve_spec.rb
+homepage: http://github.com/skrill/holoserve-connector
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 2293304529508499132
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: holoserve-connector
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Connector library for HoloServe.
+test_files:
+- spec/lib/rspec/holoserve_spec.rb