hippoload 0.0.1

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 hippoload.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Santosh Wadghule
+
+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,57 @@
+# Hippoload
+
+Basic Ruby wrapper/parser for Httperf
+
+Currently it supports 'get' method of httperf.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'hippoload'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install hippoload
+
+## Usage
+``` Ruby
+
+require "hippoload"
+
+# for single connections and rate
+
+conf = {:connections => 100, :rate => 10, :uri => "/api/v1/entities?app_token=ef6baaed0d294f8f54eef80aeb8a4ee1" }
+
+hippo = Hippoload::Hippo.new(conf)
+
+hippo_parser = Hippoload::HippoParser.new
+
+raw_output = hippo.attack # for single connections and rate
+
+hippo_parser.parse(raw_output)
+
+# Parsed data => {:total_conenctions=>"100", :duration=>"9.948", :connections_per_second=>"10.1", :min_ms_per_connection=>"33.8", :avg_ms_per_connection=>"61.5", :max_ms_per_connection=>"164.2", :median_ms_per_connection=>"49.5", :stddev_ms_per_connection=>"22.0", :request_rate_per_second=>"10.1", :min_replies_per_second=>"10.0", :avg_replies_per_second=>"10.0", :max_replies_per_second=>"10.0", :stddev_replies_per_second=>"0.0", :samples=>"1", :client_timeout_errors=>"0", :connections_reset_errors=>"0"}
+
+# for connections and rates list
+
+conf = {:connections_and_rates => [{:connections => 100, :rate => 10}, {:connections => 200, :rate => 20}], :uri => "/api/v1/entities?app_token=ef6baaed0d294f8f54eef
+
+hippo = Hippoload::Hippo.new(conf)
+
+hippo.becomes_crazy
+
+# connections list wise => {"100-10-/api/v1/entities?app_token=ef6baaed0d294f8f54eef80aeb8a4ee1"=>"httperf --client=0/1 --server=localhost --port=3000 --uri=/api/v1/entities?app_token=ef6baaed0d294f8f54eef80aeb8a4ee1 --rate=10 --send-buffer=4096 --recv-buffer=16384 --num-conns=100 --num-calls=1\nMaximum connect burst length: 1\n\nTotal: connections 100 requests 100 replies 100 test-duration 9.951 s\n\nConnection rate: 10.0 conn/s (99.5 ms/conn, <=5 concurrent connections)\nConnection time [ms]: min 34.3 avg 69.5 max 400.1 median 50.5 stddev 57.6\nConnection time [ms]: connect 0.1\nConnection length [replies/conn]: 1.000\n\nRequest rate: 10.0 req/s (99.5 ms/req)\nRequest size [B]: 120.0\n\nReply rate [replies/s]: min 10.0 avg 10.0 max 10.0 stddev 0.0 (1 samples)\nReply time [ms]: response 68.9 transfer 0.5\nReply size [B]: header 642.0 content 4901.0 footer 0.0 (total 5543.0)\nReply status: 1xx=0 2xx=100 3xx=0 4xx=0 5xx=0\n\nCPU time [s]: user 2.14 system 7.81 (user 21.5% system 78.5% total 99.9%)\nNet I/O: 55.6 KB/s (0.5*10^6 bps)\n\nErrors: total 0 client-timo 0 socket-timo 0 connrefused 0 connreset 0\nErrors: fd-unavail 0 addrunavail 0 ftab-full 0 other 0\n", "150-15-/api/v1/entities?app_token=ef6baaed0d294f8f54eef80aeb8a4ee1"=>"httperf --client=0/1 --server=localhost --port=3000 --uri=/api/v1/entities?app_token=ef6baaed0d294f8f54eef80aeb8a4ee1 --rate=15 --send-buffer=4096 --recv-buffer=16384 --num-conns=150 --num-calls=1\nMaximum connect burst length: 1\n\nTotal: connections 150 requests 150 replies 150 test-duration 9.988 s\n\nConnection rate: 15.0 conn/s (66.6 ms/conn, <=7 concurrent connections)\nConnection time [ms]: min 34.3 avg 92.1 max 415.4 median 71.5 stddev 68.8\nConnection time [ms]: connect 0.1\nConnection length [replies/conn]: 1.000\n\nRequest rate: 15.0 req/s (66.6 ms/req)\nRequest size [B]: 120.0\n\nReply rate [replies/s]: min 15.0 avg 15.0 max 15.0 stddev 0.0 (1 samples)\nReply time [ms]: response 91.9 transfer 0.0\nReply size [B]: header 642.0 content 4901.0 footer 0.0 (total 5543.0)\nReply status: 1xx=0 2xx=150 3xx=0 4xx=0 5xx=0\n\nCPU time [s]: user 1.76 system 8.21 (user 17.6% system 82.2% total 99.9%)\nNet I/O: 83.1 KB/s (0.7*10^6 bps)\n\nErrors: total 0 client-timo 0 socket-timo 0 connrefused 0 connreset 0\nErrors: fd-unavail 0 addrunavail 0 ftab-full 0 other 0\n"}
+```
+## Contributing
+
+1. Fork it
+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/hippoload.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hippoload/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "hippoload"
+  gem.version       = Hippoload::VERSION
+  gem.authors       = ["Santosh Wadghule"]
+  gem.email         = ["santosh.wadghule@gmail.com"]
+  gem.description   = %q{Basic Ruby wrapper for httperf}
+  gem.summary       = %q{Ruby wrapper/parser for httperf}
+  gem.homepage      = "https://github.com/mechanicles/hippoload"
+
+  gem.add_development_dependency "rspec"
+  gem.add_dependency "activesupport"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

data/lib/hippoload.rb

@@ -0,0 +1,7 @@
+require "hippoload/version"
+require "hippoload/hippo"
+require "hippoload/hippo_parser"
+
+module Hippoload
+  # Your code goes here...
+end

data/lib/hippoload/hippo.rb

@@ -0,0 +1,71 @@
+module Hippoload
+  class Hippo # Hippo acts as httperf but with hippo style :)
+
+    # Currently Hippoload supports only -----------------------------
+    # 'get' method of Httperf
+    # --num-conns
+    # --rate
+    # --server
+    # --port
+    # --uri
+
+    attr_reader :connections, :rate, :server, :port, :uri, :connections_and_rates
+
+    def initialize(conf)
+      @connections = conf[:connections]
+      @rate = conf[:rate]
+      @server = conf[:server] || 'localhost'
+      @port = conf[:port] || '3000'
+      @uri = conf[:uri]
+      @connections_and_rates = conf[:connections_and_rates] || default_connections_and_rates
+
+      raise_error_if_wrong_conf
+    end
+
+    def attack
+      set_connections if !@connections.nil?
+      set_rate if !@rate.nil?
+      %x(httperf --num-conns=#{@connections} --rate=#{@rate} --server=#{@server} --port=#{@port} --uri="#{@uri}")
+    end
+
+    def becomes_crazy
+      return nil if @connections_and_rates.nil?
+      raw_outputs = {}
+      @connections_and_rates.each do |cr|
+        @connections = cr[:connections]
+        @rate = cr[:rate]
+        raw_outputs["#{@connections}-#{@rate}-#{uri}"] = attack
+      end
+
+      raw_outputs
+    end
+
+    private
+
+    def default_connections_and_rates
+      [
+        { :connections => 100,  :rate =>  10 },
+        { :connections => 200,  :rate =>  20 },
+        { :connections => 300,  :rate =>  30 },
+        { :connections => 500,  :rate =>  50 },
+        { :connections => 700,  :rate =>  70 },
+        { :connections => 1000, :rate => 100 }
+      ] if (!@connections.nil? or !@rate.nil?) && !@connections_and_rates.nil?
+    end
+
+    def set_connections
+      @connections = @connections ||  default_connections_and_rates.first[:connections]
+    end
+
+    def set_rate
+      @rate = @rate ||  default_connections_and_rates.first[:rate]
+    end
+
+    def raise_error_if_wrong_conf
+      if (!@connections.nil? || !@rate.nil?) && !@connections_and_rates.nil?
+        raise "You can not assign (:connections, :rate) at same with :connections_and_rates attributes. Either assign (:connections, :rate) or assign :connections_and_rates attribute"
+      end
+    end
+  end
+end
+

data/lib/hippoload/hippo_parser.rb

@@ -0,0 +1,43 @@
+module Hippoload
+  class HippoParser
+
+    DATATYPES = %w(
+                total_conenctions
+                duration
+                connections_per_second
+                min_ms_per_connection
+                avg_ms_per_connection
+                max_ms_per_connection
+                median_ms_per_connection
+                stddev_ms_per_connection
+                request_rate_per_second
+                min_replies_per_second
+                avg_replies_per_second
+                max_replies_per_second
+                stddev_replies_per_second
+                samples
+                client_timeout_errors
+                connections_reset_errors
+               )
+
+    def parse(httperf_raw_output)
+      return nil if httperf_raw_output.nil?
+
+      formatted_output = formatted_output(httperf_raw_output)
+      matched_data = formatted_output.match(/Total: connections (\d+).+test-duration ([\d.]+).+Connection rate: ([\d.]+).+Connection time \[ms\]: min ([\d.]+).+avg ([\d.]+).+max ([\d.]+).+median ([\d.]+).+stddev ([\d.]+).+Request rate: ([\d.]+).+min ([\d.]+).+avg ([\d.]+).+max ([\d.]+).+stddev ([\d.]+).+(\d+) samples.+client-timo (\d+).+connreset (\d+)/)
+
+      parsed_data = {}
+      DATATYPES.size.times do |i|
+        parsed_data[DATATYPES[i].to_sym] = matched_data[i+1]
+      end
+
+      parsed_data
+    end
+
+    private
+
+    def formatted_output(httperf_raw_output)
+      httperf_raw_output.inspect.split('\n').join(' ')
+    end
+  end
+end

data/lib/hippoload/version.rb

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

data/spec/hippo_parser_spec.rb

@@ -0,0 +1,16 @@
+require 'hippoload'
+
+describe Hippoload::Hippo do
+  let(:httperf_raw_output) { "httperf --client=0/1 --server=localhost --port=3000 --uri=/api/v1/entities?app_token=ef6baaed0d294f8f54eef80aeb8a4ee1 --rate=10 --send-buffer=4096 --recv-buffer=16384 --num-conns=100 --num-calls=1\nMaximum connect burst length: 1\n\nTotal: connections 100 requests 100 replies 100 test-duration 9.966 s\n\nConnection rate: 10.0 conn/s (99.7 ms/conn, <=1 concurrent connections)\nConnection time [ms]: min 32.1 avg 55.7 max 94.4 median 46.5 stddev 17.6\nConnection time [ms]: connect 0.1\nConnection length [replies/conn]: 1.000\n\nRequest rate: 10.0 req/s (99.7 ms/req)\nRequest size [B]: 120.0\n\nReply rate [replies/s]: min 10.0 avg 10.0 max 10.0 stddev 0.0 (1 samples)\nReply time [ms]: response 55.5 transfer 0.0\nReply size [B]: header 642.0 content 4901.0 footer 0.0 (total 5543.0)\nReply status: 1xx=0 2xx=100 3xx=0 4xx=0 5xx=0\n\nCPU time [s]: user 2.18 system 7.78 (user 21.9% system 78.0% total 99.9%)\nNet I/O: 55.5 KB/s (0.5*10^6 bps)\n\nErrors: total 0 client-timo 0 socket-timo 0 connrefused 0 connreset 0\nErrors: fd-unavail 0 addrunavail 0 ftab-full 0 other 0\n" }
+
+  it "should have DATATYPES constant" do
+    Hippoload::HippoParser::DATATYPES.should_not be_nil
+  end
+
+  describe "HippoParser#parse" do
+    it "should parse for raw input" do
+      parser = Hippoload::HippoParser.new
+      parser.parse(httperf_raw_output).size.should  > 0
+    end
+  end
+end

data/spec/hippo_spec.rb

@@ -0,0 +1,62 @@
+require 'hippoload'
+
+describe Hippoload::Hippo do
+
+  let(:basic_conf) { { :connections => 100, :rate => 10, :uri => "/posts" } }
+  let(:advanced_conf) { { :uri => "/posts", :connections_and_rates => [{ :connections => 100, :rate => 10 }] } }
+  let(:wrong_conf) do 
+    {
+      :connections => 100, 
+      :rate => 10, 
+      :uri => "/posts",
+      :connections_and_rates => [{ :connections => 100, :rate => 10 }]
+    }
+  end
+
+  describe "Hippo#attributes_methods" do
+
+    it "should have attributes reader" do
+      hippo = Hippoload::Hippo.new(basic_conf)
+      hippo.connections.should eql(100)
+      hippo.rate.should eql(10)
+      hippo.server.should eql('localhost')
+      hippo.port.should eql('3000')
+      hippo.uri.should eql('/posts')
+      hippo.connections_and_rates.should nil
+    end
+
+    it "should raise error if wrong conf passed" do
+      expect { Hippoload::Hippo.new(wrong_conf) }.to raise_error
+    end
+
+    it "should not raise error if correct conf passed" do
+      expect { Hippoload::Hippo.new(basic_conf) }.to_not raise_error
+    end
+
+    it "should have connections_and_rates attribute if we passed advanced_conf" do
+      hippo = Hippoload::Hippo.new(advanced_conf)
+      hippo.connections_and_rates.should eql(advanced_conf[:connections_and_rates])
+    end
+
+    it "should have default connections and rates if passed advanced_conf without connections_and_rates attribute" do
+      advanced_conf.delete(:connections_and_rates)
+      hippo = Hippoload::Hippo.new(advanced_conf)
+      hippo.connections_and_rates.should eql(hippo.send(:default_connections_and_rates))
+    end
+  end
+
+  describe "Hippo#attack" do
+    it "should return httperf raw output" do
+      hippo = Hippoload::Hippo.new(basic_conf)
+      hippo.attack.inspect.should include('httperf')
+    end
+  end
+
+  describe "Hippo#becomes_crazy" do
+    it "should return httperf raw output" do
+      hippo = Hippoload::Hippo.new(advanced_conf)
+      hippo.becomes_crazy
+      hippo.becomes_crazy.inspect.should include('httperf')
+    end
+  end
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification
+name: hippoload
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Santosh Wadghule
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  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: Basic Ruby wrapper for httperf
+email:
+- santosh.wadghule@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- hippoload.gemspec
+- lib/hippoload.rb
+- lib/hippoload/hippo.rb
+- lib/hippoload/hippo_parser.rb
+- lib/hippoload/version.rb
+- spec/hippo_parser_spec.rb
+- spec/hippo_spec.rb
+homepage: https://github.com/mechanicles/hippoload
+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.24
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper/parser for httperf
+test_files:
+- spec/hippo_parser_spec.rb
+- spec/hippo_spec.rb