httperfrb 0.1.2 → 0.2.0

data/Gemfile

@@ -2,11 +2,9 @@ source :rubygems
 gem 'open4'
 
 group :development do
-  gem 'yard'
-  gem 'redcarpet'
-end
-
-group :test do
   gem 'rspec'
   gem 'simplecov'
+  gem 'yard'
+  gem 'redcarpet'
+  gem 'rake'
 end

data/HISTORY.md

@@ -1,6 +1,11 @@
 HTTPerf.rb
 ==========
 
+### 0.2.0
+
+* added parser
+* changed default output of run to parsed
+
 ### 0.1.2
 
 * fixed an issue with run output

data/README.md

@@ -31,7 +31,7 @@ Requires httperf, of course...
 
     gem install httperfrb
 
-#### Usage
+### Usage
 
 Some basic usage examples.
 
@@ -48,5 +48,69 @@ Some basic usage examples.
     unless perf.fork_err.nil?
       puts perf.fork_out
     end
+
+#### With HTTPerf::Parser
+
+    require 'httperf'
+    perf = HTTPerf.new( "server" => "host", "port" => 8080, "uri" => "/foo" )
+    puts perf.parser = true
+    puts perf.run
+
+    # or directly
+
+    puts HTTPerf::Parser.parse( HTTPerf.new( "server" => "host", "port" => 8080, "uri" => "/foo" ).run )
+
+##### Parser Keys: 
+
+    :command
+    :max_connect_burst_length
+    :total_connections
+    :total_requests
+    :total_replies
+    :total_test_duration
+    :connection_rate_per_sec
+    :connection_rate_ms_conn
+    :connection_time_min
+    :connection_time_avg
+    :connection_time_max
+    :connection_time_median
+    :connection_time_stddev
+    :connection_time_connect
+    :connection_length
+    :request_rate_per_sec
+    :request_rate_ms_request
+    :request_size
+    :reply_rate_min
+    :reply_rate_avg
+    :reply_rate_max
+    :reply_rate_stddev
+    :reply_rate_samples
+    :reply_time_response
+    :reply_time_transfer
+    :reply_size_header
+    :reply_size_content
+    :reply_size_footer
+    :reply_size_total
+    :reply_status_1xx
+    :reply_status_2xx
+    :reply_status_3xx
+    :reply_status_4xx
+    :reply_status_5xx
+    :cpu_time_user_sec
+    :cpu_time_system_sec
+    :cpu_time_user_pct
+    :cpu_time_system_pct
+    :cpu_time_total_pct
+    :net_io_kb_sec
+    :net_io_bps
+    :errors_total
+    :errors_client_timeout
+    :errors_socket_timeout
+    :errors_conn_refused
+    :errors_conn_reset
+    :errors_fd_unavail
+    :errors_addr_unavail
+    :errors_ftab_full
+    :errors_other
   
 

data/lib/httperf.rb

@@ -1,8 +1,12 @@
 # @author Joshua Mervine <joshua@mervine.net>
 require 'open4'
+require 'parser'
 class HTTPerf
   # gem version
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
+
+  # @return [Boolean] parse flag
+  attr_accessor :parse
 
   # availbe instance methods
   @fork_out, @fork_err = ''
@@ -84,7 +88,11 @@ class HTTPerf
       status = wait_thr.value
     end
     if status == 0
-      return out.join
+      if @parse
+        return Parser.parse(out.join)
+      else
+        return out.join
+      end
     else
       return err.join
     end
@@ -100,7 +108,11 @@ class HTTPerf
 
   # return results of last fork
   def fork_out
-    @fork_out
+    if @parse
+      return Parse.parse @fork_out
+    else
+      return @fork_out
+    end
   end
 
   # return errors from last fork

data/lib/parser.rb

@@ -0,0 +1,116 @@
+class HTTPerf
+
+  # Parse httperf output to a [Hash]
+  #
+  # This can be used standalone or with HTTPerf results.
+  class Parser
+
+    # @return [Hash] returns hash of parsed httperf output
+    # @param [String] raw httperf output
+    def self.parse raw
+
+      lines = raw.split("\n") 
+
+      # While this isn't the most efficent way of doing this, it's the most maintainable.
+      expressions = {
+        :command                    => /^(httperf .+)$/,
+
+        # Maximum connect burst length:
+        :max_connect_burst_length   => /Maximum connect burst length: ([0-9]*?\.?[0-9]+)$/,
+        
+        # Total:
+        :total_connections          => /^Total: connections ([0-9]*?\.?[0-9]+) /,
+        :total_requests             => /^Total: connections .+ requests ([0-9]*?\.?[0-9]+) /,
+        :total_replies              => /^Total: connections .+ replies ([0-9]*?\.?[0-9]+) /,
+        :total_test_duration        => /^Total: connections .+ test-duration ([0-9]*?\.?[0-9]+) /,
+
+        # Connection rate:
+        :connection_rate_per_sec    => /^Connection rate: ([0-9]*?\.?[0-9]+) /, 
+        :connection_rate_ms_conn    => /^Connection rate: .+ \(([0-9]*?\.?[0-9]+) ms/, 
+
+        # Connection time [ms]:
+        :connection_time_min        => /^Connection time \[ms\]: min ([0-9]*?\.?[0-9]+) /, 
+        :connection_time_avg        => /^Connection time \[ms\]: min .+ avg ([0-9]*?\.?[0-9]+) /, 
+        :connection_time_max        => /^Connection time \[ms\]: min .+ max ([0-9]*?\.?[0-9]+) /, 
+        :connection_time_median     => /^Connection time \[ms\]: min .+ median ([0-9]*?\.?[0-9]+) /, 
+        :connection_time_stddev     => /^Connection time \[ms\]: min .+ stddev ([0-9]*?\.?[0-9]+)$/, 
+        :connection_time_connect    => /^Connection time \[ms\]: connect ([0-9]*?\.?[0-9]+)$/,
+
+        # Connection length [replies/conn]:
+        :connection_length          => /^Connection length \[replies\/conn\]: ([0-9]*?\.?[0-9]+)$/,
+
+        # Request rate:
+        :request_rate_per_sec       => /^Request rate: ([0-9]*?\.?[0-9]+) req/,
+        :request_rate_ms_request    => /^Request rate: .+ \(([0-9]*?\.?[0-9]+) ms/,
+
+        # Request size [B]:
+        :request_size               => /^Request size \[B\]: ([0-9]*?\.?[0-9]+)$/,
+
+        # Reply rate [replies/s]:
+        :reply_rate_min             => /^Reply rate \[replies\/s\]: min ([0-9]*?\.?[0-9]+) /,
+        :reply_rate_avg             => /^Reply rate \[replies\/s\]: min .+ avg ([0-9]*?\.?[0-9]+) /,
+        :reply_rate_max             => /^Reply rate \[replies\/s\]: min .+ max ([0-9]*?\.?[0-9]+) /,
+        :reply_rate_stddev          => /^Reply rate \[replies\/s\]: min .+ stddev ([0-9]*?\.?[0-9]+) /,
+        :reply_rate_samples         => /^Reply rate \[replies\/s\]: min .+ \(([0-9]*?\.?[0-9]+) samples/,
+        
+        # Reply time [ms]:
+        :reply_time_response        => /^Reply time \[ms\]: response ([0-9]*?\.?[0-9]+) /,
+        :reply_time_transfer        => /^Reply time \[ms\]: response .+ transfer ([0-9]*?\.?[0-9]+)$/,
+
+        # Reply size [B]:
+        :reply_size_header          => /^Reply size \[B\]: header ([0-9]*?\.?[0-9]+) /,
+        :reply_size_content         => /^Reply size \[B\]: header .+ content ([0-9]*?\.?[0-9]+) /,
+        :reply_size_footer          => /^Reply size \[B\]: header .+ footer ([0-9]*?\.?[0-9]+) /,
+        :reply_size_total           => /^Reply size \[B\]: header .+ \(total ([0-9]*?\.?[0-9]+)\)/,
+
+        # Reply status:
+        :reply_status_1xx           => /^Reply status: 1xx=([0-9]*?\.?[0-9]+) /,
+        :reply_status_2xx           => /^Reply status: .+ 2xx=([0-9]*?\.?[0-9]+) /,
+        :reply_status_3xx           => /^Reply status: .+ 3xx=([0-9]*?\.?[0-9]+) /,
+        :reply_status_4xx           => /^Reply status: .+ 4xx=([0-9]*?\.?[0-9]+) /,
+        :reply_status_5xx           => /^Reply status: .+ 5xx=([0-9]*?\.?[0-9]+)/,
+
+        # CPU time [s]:
+        :cpu_time_user_sec          => /^CPU time \[s\]: user ([0-9]*?\.?[0-9]+) /,
+        :cpu_time_system_sec        => /^CPU time \[s\]: user .+ system ([0-9]*?\.?[0-9]+) /,
+        :cpu_time_user_pct          => /^CPU time \[s\]: user .+ \(user ([0-9]*?\.?[0-9]+)\% /,
+        :cpu_time_system_pct        => /^CPU time \[s\]: user .+ system .+ system ([0-9]*?\.?[0-9]+)\% /,
+        :cpu_time_total_pct         => /^CPU time \[s\]: user .+ total ([0-9]*?\.?[0-9]+)\%/,
+       
+        # Net I/O:
+        :net_io_kb_sec              => /^Net I\/O: ([0-9]*?\.?[0-9]+) KB/,
+        :net_io_bps                 => /^Net I\/O: .+ \((.+) bps\)/,
+
+        # Errors:
+        :errors_total               => /^Errors: total ([0-9]*?\.?[0-9]+) /,
+        :errors_client_timeout      => /^Errors: total .+ client-timo ([0-9]*?\.?[0-9]+) /,
+        :errors_socket_timeout      => /^Errors: total .+ socket-timo ([0-9]*?\.?[0-9]+) /,
+        :errors_conn_refused        => /^Errors: total .+ connrefused ([0-9]*?\.?[0-9]+) /,
+        :errors_conn_reset          => /^Errors: total .+ connreset ([0-9]*?\.?[0-9]+)/,
+        :errors_fd_unavail          => /^Errors: fd-unavail ([0-9]*?\.?[0-9]+) /,
+        :errors_addr_unavail        => /^Errors: fd-unavail .+ addrunavail ([0-9]*?\.?[0-9]+) /,
+        :errors_ftab_full           => /^Errors: fd-unavail .+ ftab-full ([0-9]*?\.?[0-9]+) /,
+        :errors_other               => /^Errors: fd-unavail .+ other ([0-9]*?\.?[0-9]+)/
+      }
+      
+      matches = {}
+
+      lines.each do |line|
+        matched = false
+        unless line.empty?
+          expressions.each do |key,exp|
+            matchdata = (exp.match(line)).to_a
+            if $1
+              matches[key] = $1
+              matched = true
+              next
+            end
+          end
+          next if matched
+        end
+      end
+      raise "mismatch error occurred" unless expressions.keys.count == matches.keys.count
+      return matches
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: httperfrb
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-10 00:00:00.000000000Z
+date: 2012-08-11 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &15314460 !ruby/object:Gem::Requirement
+  requirement: &19603340 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *15314460
+  version_requirements: *19603340
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &15313820 !ruby/object:Gem::Requirement
+  requirement: &19602580 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *15313820
+  version_requirements: *19602580
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &15313240 !ruby/object:Gem::Requirement
+  requirement: &19602060 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *15313240
+  version_requirements: *19602060
 - !ruby/object:Gem::Dependency
   name: open4
-  requirement: &15312020 !ruby/object:Gem::Requirement
+  requirement: &19601460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,7 +54,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *15312020
+  version_requirements: *19601460
 description: Simple interface for calling httperf via ruby.
 email:
 - joshua@mervine.net
@@ -62,6 +62,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/parser.rb
 - lib/httperf.rb
 - README.md
 - HISTORY.md
@@ -80,7 +81,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -118998426605859077
+      hash: 1424181618950298738
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: