socket-harness 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6698d5896ed656d1c8795d508072133ba69cd479
+  data.tar.gz: 2acecd223f73a33c45f9a470eccd1bbd9d6d7f70
+SHA512:
+  metadata.gz: fa1eb4a12bafe6d65cb47c65c0f58d3c74805f90813a5210a4c7790413fa198b7dd6708a19dc91c7242223c23405a450226bf1efe5e61a668abcf31e5e48cceb
+  data.tar.gz: d952429a1048a4bb9d6dcb78ddfbdb1d6618989c4b4aab95bc81ca6e2515cc0ae6b51135616ca0a3b0a5e816422bb1b77021085434e0eba71ed4e7755fb929b3

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 wpc
+
+MIT License
+
+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,39 @@
+# SocketHarness
+
+SocketHarness is a test utilities that helps implement Test Harness pattern from the book "Release it!".  It seats between application and integration server to simulate odd network/server behaviors.
+
+Current Feature:
+* delay: help for simulating slow network or server to test timeout failure mode.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'socket_harness'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install socket_harness
+
+## Usage
+
+```
+Usage: bin/socket_harness [options] remotehost remoteport
+    -p, --port PORT                  local port to bind
+    -b, --bind ADDRESS               local address to bind
+        --block-size NUMBER          chunck out large data reads. by default 1024 byte
+    -d, --delay NUMBER               delay for client response: 12 will deplay 12ms for package sending back to the client.
+```
+
+
+## Contributing
+
+1. Fork it ( http://github.com/<my-github-username>/socket_harness/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/socket_harness

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+git_path = File.join(File.expand_path('../..', __FILE__), '.git')
+
+if File.exists?(git_path)
+  lib_path = File.expand_path('../../lib', __FILE__)
+  $:.unshift(lib_path)
+end
+
+require 'socket_harness'
+SocketHarness.cli

data/lib/socket_harness.rb

@@ -0,0 +1,42 @@
+require "socket_harness/version"
+require "socket_harness/proxy"
+require 'socket'
+require 'optparse'
+
+module SocketHarness
+
+  def self.cli
+    options = {}
+    parser = OptionParser.new do |opts|
+      opts.banner = "Usage: #{$0} [options] remotehost remoteport"
+      opts.version = SocketHarness::VERSION
+
+      opts.on("-p", "--port PORT", "local port to bind") do |v|
+        options[:local_port] = v
+      end
+
+      opts.on("-b", "--bind ADDRESS", "local address to bind") do |v|
+        options[:local_host] = v
+      end
+
+      opts.on("--block-size NUMBER", "chunck out large data reads. by default 1024 byte") do |v|
+        options[:local_host] = v
+      end
+
+
+      opts.on("-d", "--delay NUMBER", "delay for client response: 12 will deplay 12ms for package sending back to the client.") do |v|
+        options[:delay] = v
+      end
+    end
+    parser.parse!
+    remote_host = ARGV.shift
+    remote_port = ARGV.shift
+
+    if remote_host.to_s.empty? || remote_port.to_s.empty?
+      puts parser
+      exit 1
+    end
+
+    Proxy.new(remote_host, remote_port, options).run
+  end
+end

data/lib/socket_harness/proxy.rb

@@ -0,0 +1,87 @@
+module SocketHarness
+  class Proxy
+    BLOCK_SIZE = 1024
+
+    def self.default_options
+      {
+        :local_port => 13012,
+        :block_size => 1024,
+        :delay => 0,
+      }
+    end
+
+    def initialize(remote_host, remote_port, options={})
+      @remote_host = remote_host
+      @remote_port = remote_port
+      @options = self.class.default_options.merge(options)
+    end
+
+    def run
+      puts "*** target #{@remote_host}:#{@remote_port}"
+      server = TCPServer.open(@options[:local_host], @options[:local_port].to_i)
+
+      port = server.addr[1]
+      addrs = server.addr[2..-1].uniq
+
+      puts "*** listening on #{addrs.collect{|a|"#{a}:#{port}"}.join(' ')}"
+
+      # abort on exceptions, otherwise threads will be silently killed in case
+      # of unhandled exceptions
+      Thread.abort_on_exception = true
+
+      # have a thread just to process Ctrl-C events on Windows
+      # (although Ctrl-Break always works)
+      Thread.new { loop { sleep 1 } }
+      loop do
+        # whenever server.accept returns a new connection, start
+        # a handler thread for that connection
+        Thread.start(server.accept) { |local| conn_thread(local) }
+      end
+    end
+
+    private
+
+    def conn_thread(local)
+      port, name = local.peeraddr[1..2]
+      puts "*** receiving from #{name}:#{port}"
+
+      # open connection to remote server
+      remote = TCPSocket.new(@remote_host, @remote_port)
+
+      # start reading from both ends
+      loop do
+        ready = select([local, remote], nil, nil)
+        if ready[0].include? local
+          # local -> remote
+          data = local.recv(@options[:block_size])
+          if data.empty?
+            puts "local end closed connection"
+            break
+          end
+          puts "#{name}:#{port} -{}-> #{@remote_host}:#{@remote_port} #{data.size} byte ..."
+          remote.write(data)
+        end
+        if ready[0].include? remote
+          # remote -> local
+          data = remote.recv(@options[:block_size])
+          if data.empty?
+            puts "remote end closed connection"
+            break
+          end
+          puts "#{@remote_host}:#{@remote_port} -{#{delay}ms}-> #{name}:#{port}  #{data.size} byte ..."
+          sleep delay * 1.0 / 1000.0
+          local.write(data)
+        end
+      end
+
+      local.close
+      remote.close
+
+      puts "*** done with #{name}:#{port}"
+    end
+
+    def delay
+      @options[:delay].to_i
+    end
+  end
+end

data/lib/socket_harness/version.rb

@@ -0,0 +1,3 @@
+module SocketHarness
+  VERSION = "0.0.1"
+end

data/socket_harness.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'socket_harness/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "socket-harness"
+  spec.version       = SocketHarness::VERSION
+  spec.authors       = ["wpc"]
+  spec.email         = ["alex.hal9000@gmail.com"]
+  spec.summary       = %q{Proxy for socket test harness.}
+  spec.description   = %q{SocketHarness is a test utilities that helps implement Test Harness pattern from the book "Release it!". It seats between application and integration server to simulate odd network/application behaviors, e.g. slow network.}
+  spec.homepage      = "https://github.com/wpc/socket-harness"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification
+name: socket-harness
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- wpc
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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: SocketHarness is a test utilities that helps implement Test Harness pattern
+  from the book "Release it!". It seats between application and integration server
+  to simulate odd network/application behaviors, e.g. slow network.
+email:
+- alex.hal9000@gmail.com
+executables:
+- socket_harness
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/socket_harness
+- lib/socket_harness.rb
+- lib/socket_harness/proxy.rb
+- lib/socket_harness/version.rb
+- socket_harness.gemspec
+homepage: https://github.com/wpc/socket-harness
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0
+signing_key: 
+specification_version: 4
+summary: Proxy for socket test harness.
+test_files: []