turd 0.0.1

data/README.md

@@ -0,0 +1,13 @@
+### turd
+
+Turd is a little wrapper around typhoeus which is a wrapper around curb which is a wrapper around libcurl which is a wrapper around tcp which is a wrapper around electrons and shit. You can use turd to test http requests and responses. We use it at GitHub to validate responses from various services and alert us if they do not conform to the expected responses. http integration tests if you will. It can be also used for basic telnet-like plain text request validations. Lastly, it also produces some basic diagnostic data like various timings from libcurl.
+
+It is called "turd" because my cat pooped on the floor while I was writing it.
+
+#### Usage
+
+Check out the examples directory for usage details. The basic idea is you define a request and response. turd performs the request and compares the actual response with the expected response. You can use any data that a typhoeus response object supplies to validate responses (header and body substrings, status codes, etc).
+
+#### License
+
+turd is open source software available under the MIT License

data/lib/turd.rb

@@ -0,0 +1,36 @@
+require 'rubygems'
+
+require 'typhoeus'
+require 'socket'
+require 'timeout'
+
+__DIR__ = File.dirname(__FILE__)
+
+$LOAD_PATH.unshift __DIR__ unless
+  $LOAD_PATH.include?(__DIR__) ||
+  $LOAD_PATH.include?(File.expand_path(__DIR__))
+
+require 'turd/assert'
+require 'turd/http'
+require 'turd/tcp'
+require 'turd/version'
+
+module Turd
+  class << self
+
+    def run(request_definition, response_definition)
+
+      case request_definition[:type]
+      when "http"
+        response = Turd::Http.request(request_definition)
+      when "tcp"
+        response = Turd::Tcp.connect(request_definition)
+      else
+        raise "No request type defined!"
+      end
+
+      Turd::Assert.assert(request_definition, response, response_definition)
+    end
+
+  end
+end

data/lib/turd/assert.rb

@@ -0,0 +1,69 @@
+module Turd
+  class Assert
+
+    def self.assert(request_definition, response, response_definition)
+
+      case request_definition[:type]
+
+      when "tcp"
+        response_definition.each do |option, value|
+          if option == :response
+            value.each do |v|
+              if response[:response].include?(v)
+                return response
+              else
+                raise AssertionFailure.new(response), "#{option} substring failure. expected #{v}, got #{response}"
+              end
+            end
+          elsif option == :total_time
+            if response[:total_time] > value
+              raise AssertionFailure.new(response), "#{option} timing value was greater than allowed. expected #{value}, got #{response[:total_time]}"
+            else
+              return response
+            end
+          end
+        end
+
+      when "http"
+        response_definition.each do |option, value|
+
+          if option == :response_headers || option == :response_body
+            value.each do |v|
+              if response.options[option].include?(v)
+                return return_http_response(response)
+              else
+                raise AssertionFailure.new(return_http_response(response)), "#{option} substring failure. expected #{v}, got #{response.options[option]}"
+              end
+            end
+          elsif option.to_s.include?("_time")
+            if response.options[option] > value
+              raise AssertionFailure.new(return_http_response(response)), "#{option} timing value was greater than allowed. expected #{value}, got #{response.options[option]}"
+            else
+              return return_http_response(response)
+            end
+          else
+            if response.options[option] == value
+              return return_http_response(response)
+            else
+              raise AssertionFailure.new(return_http_response(response)), "#{option} did not match response definition. expected #{value}, got #{response.options[option]}"
+            end
+          end
+        end
+      end
+
+    end
+
+    def self.return_http_response(response)
+      response.options.delete(:debug_info)
+      response.options
+    end
+  end
+
+  class AssertionFailure < RuntimeError
+    attr :response
+
+    def initialize(response)
+      @response = response
+    end
+  end
+end

data/lib/turd/http.rb

@@ -0,0 +1,16 @@
+module Turd
+  class Http
+
+    def self.request(request_definition)
+
+      request = Typhoeus::Request.new(
+        request_definition[:url],
+        request_definition[:options]
+      )
+
+      request.run
+
+    end
+
+  end
+end

data/lib/turd/tcp.rb

@@ -0,0 +1,24 @@
+module Turd
+  class Tcp
+
+    def self.connect(request_definition)
+
+      response = String.new
+      before = Time.now.to_f
+
+      begin
+        TCPSocket.open(request_definition[:options][:host], request_definition[:options][:port]) do |socket|
+          response = socket.gets
+        end
+      rescue Errno::ETIMEDOUT
+        # timeout
+      end
+
+      after = Time.now.to_f
+
+      {:response => response, :total_time => after - before}
+
+    end
+
+  end
+end

data/lib/turd/version.rb

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

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: turd
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- joe williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email: joe@joetify.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- lib/turd/assert.rb
+- lib/turd/http.rb
+- lib/turd/tcp.rb
+- lib/turd/version.rb
+- lib/turd.rb
+- README.md
+homepage: http://github.com/joewilliams/turd
+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'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: a http and tcp testing lib
+test_files: []