mocking-server 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c9aef0d56c7fba6c2ed66e05acff6f5a6716a491
+  data.tar.gz: 301532b3ae35c6612493ca2d3b6fcace6e19f8ce
+SHA512:
+  metadata.gz: 1e1a2a93363d10ce1ac039cd5948a11836ddb4654ef9de4b934f1ef9139066786a9ebdef35830231eb1be1538e46245977250881c1b5940e4cdca531584e5f20
+  data.tar.gz: f6a5aa78f6038f343b0df6cf76f99923c3b7f68b4ce70825f892d9f1fbfb48195287b09133060d45788af89a97b6578609a1b6201480c6b1df35ec3a7de3b7bc

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Nicholas Ren
+
+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,77 @@
+# Mockery #
+A quick way of mocking an external web service you want to consume.
+Inspired by [moco](https://github.com/dreamhead/moco), [mock-server](https://github.com/djanowski/mock-server) and [sinatra](http://www.sinatrarb.com/).
+
+# Why #
+Integration, especially based on HTTP, e.g. web service, REST etc, is widlly used in most web development.
+When you write a feature that need to connect to an external web service
+You wonder how to test that. One option is to stub methods in Net::HTTP and equivalents, but by doing that you
+are tying yourself to an implementation detail. The ideal thing is to have a server running locally, Then serve different request for different response.
+
+One thing I want to highlight is, rather than set up a global server which respond to all coming request, With `mockery`, you can set up different server for different `testcase`, `spec` or `scenario`.
+
+## Feature ##
++ Standalone server, test the real interaction.
++ Setup your mock server with sinatra's elegant DSL.
+
+## Get it ##
+(haven't published to rubygems)
+`gem install mockery` or add `gem 'mockery'` in your `Gemfile`
+
+## With rspec ##
+
+```
+  # in rspec helper
+  require 'mockery'
+  RSpec.configure do |config|
+    config.include Mockery::Methods
+  end
+
+  # in spec
+  describe ApiCilent do
+    subject { ApiCilent.new }
+
+    it "should return hello" do
+      server = mock_server do
+        get '/greeting' do
+          status 200
+          body 'hello'
+        end
+      end
+
+      server.run do
+        expect(subject.greeting).to eq('hello')
+      end
+    end
+  end
+```
+
+### With cucumber ##
+
+```
+  #in env.rb
+  require 'mockery'
+  World(Mockery::Methods)
+
+
+  # in steps
+  server = mock_server do
+    get '/greeting' do
+      status 200
+      body 'hello'
+    end
+  end
+
+  server.run do
+    # steps that send request to the local mock sever
+  end
+```
+
+## License ##
+
+MIT.
+
+## Contributor
+
++ Niu Yameng
++ Nicholas Ren

data/lib/mocking_server.rb

@@ -0,0 +1,75 @@
+require "sinatra/base"
+require "logger"
+
+class MockingServer
+  class App < Sinatra::Base
+    use Rack::ShowExceptions
+  end
+
+  def run
+    start
+    yield if block_given?
+  ensure
+    shutdown
+  end
+
+  module Methods
+    def mock_server(*args, &block)
+      app = Class.new(Sinatra::Base)
+      app.class_eval(&block)
+      MockingServer.new(app, *args, &block)
+    end
+  end
+
+protected
+
+  def listening?(host, port)
+    begin
+      socket = TCPSocket.new(host, port)
+      socket.close unless socket.nil?
+      true
+    rescue Errno::ECONNREFUSED,
+      Errno::EBADF,           # Windows
+      Errno::EADDRNOTAVAIL    # Windows
+      false
+    end
+  end
+
+  def wait_for_service(host, port, timeout = 5)
+    start_time = Time.now
+
+    until listening?(host, port)
+      if timeout && (Time.now > (start_time + timeout))
+        raise SocketError.new("Socket did not open within #{timeout} seconds")
+      end
+    end
+    true
+  end
+
+  def initialize(app, port = 4000, &block)
+    @app = app
+    @port = port
+  end
+
+  def start
+    @pid_server = fork do
+
+      server_options = {
+        :app => @app,
+        :server => 'webrick',
+        :environment => :none,
+        :daemonize => false,
+        :Port => @port
+      }
+
+      Rack::Server.start(server_options)
+    end
+    wait_for_service("0.0.0.0", @port)
+    self
+  end
+
+  def shutdown
+    Process.kill(:INT, @pid_server)
+    Process.waitpid(@pid_server)
+  end
+end

data/spec/mocking_server_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+require 'net/http'
+
+
+describe 'mock server' do
+  let( :http ) { Net::HTTP.new('127.0.0.1', 3000) }
+  let( :http2 ) { Net::HTTP.new('127.0.0.1', 4000) }
+
+  it "should work" do
+    server = mock_server(3000) do
+      get '/user' do
+        'hello'
+      end
+    end
+
+    server.run do
+      http.request_get('/user').body.should eq("hello")
+    end
+  end
+
+  it "should work as well" do
+    server = mock_server(3000) do
+      get '/category' do
+        'hello'
+      end
+    end
+
+    server.run do
+      http.request_get('/category').body.should eq("hello")
+    end
+  end
+
+  it "should work as well 2" do
+    server = mock_server(4000) do
+      get '/category' do
+        'hello'
+      end
+    end
+
+    server.run do
+      http2.request_get('/category').body.should eq("hello")
+    end
+  end
+end
+

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: mocking-server
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Nicholas Ren
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ''
+email:
+- nicholas85211@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/mocking_server.rb
+- README.md
+- LICENSE
+- spec/mocking_server_spec.rb
+homepage: http://github.com/nicholasren/mocking-server
+licenses: []
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.5
+signing_key: 
+specification_version: 4
+summary: A quick way of mocking an external web service you want to consume.
+test_files: []