httperfrb 0.3.11 → 0.3.12

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6b705e7247c6744494b65c15825a3ac1327e8851
+  data.tar.gz: 8919ba451a401f501fafec0507b6c6d7c6fbcf5d
+SHA512:
+  metadata.gz: f7024b403d7cccf306542812ce63b64a5bdbd35bceec29b0aa7e88d3aeb125389c05c64fb8a14d42798fdfc5d2b91da378662673035aa83fcc17e1d2ab56ca40
+  data.tar.gz: dd259a990b807a93814242abdc43c8f38d324ed19bfb7871d1be1ff5a9e6fa6d64727e1a2b443fb0b19002a22cb8f21282360bd352dd5433fa1f7869538aa7a4

data/Gemfile

@@ -1,5 +1,4 @@
 source "https://rubygems.org"
-gemspec
 gem 'open4'
 group :development do
   gem 'rspec'

data/README.md

@@ -1 +1,204 @@
-## See: [www.rubyops.net/gems/httperfrb](http://www.rubyops.net/gems/httperfrb)
+# HTTPerf.rb
+
+![Gem Version](https://badge.fury.io/rb/httperfrb.png)   ![Build Status](https://travis-ci.org/jmervine/httperfrb.png?branch=master)
+
+Simple Ruby interface for httperf.
+
+## Installing 'httperf'
+
+Requires [httperf](http://mervine.net/httperf), of course...
+
+#### Mac
+
+    :::shell
+    sudo port install httperf
+
+#### Debian / Ubuntu
+
+    :::shell
+    sudo apt-get install httperf
+
+#### Redhat / CentOS
+
+    :::shell
+    sudo yum install httperf
+
+#### My 'httperf'
+
+See: [httperf-0.9.1 with individual connection times](http://mervine.net/httperf-0-9-1-with-individual-connection-times).
+
+## Install
+
+    :::shell
+    gem install httperfrb
+
+## Usage - HTTPerf
+
+Some basic usage examples.
+
+    :::ruby
+    require 'httperf'
+    perf = HTTPerf.new( "server" => "host", "port" => 8080, "uri" => "/foo" )
+    puts perf.run
+
+    perf.update_option("uri", "/foo/bar")
+    thread = perf.fork
+    while((thread.alive?))
+      sleep 0.01
+      print "#"
+    end
+    unless perf.fork_err.nil?
+      puts perf.fork_out
+    end
+
+### Teeing output
+
+Added in 0.3.10.
+
+> Adding the `tee` param will print httperf output while running the process.
+
+    :::ruby
+    require 'httperf'
+    perf = HTTPerf.new( "server" => "host", "port" => 8080, "uri" => "/foo", "tee" => true )
+    output = perf.run
+
+### With HTTPerf::Parser
+
+    :::ruby
+    require 'httperf'
+    perf = HTTPerf.new( "server" => "host", "port" => 8080, "uri" => "/foo" )
+    puts perf.parse = true
+    puts perf.run
+
+    # or directly
+
+    puts HTTPerf::Parser.parse( HTTPerf.new( "server" => "host", "port" => 8080, "uri" => "/foo" ).run )
+
+## Useage - HTTPerf::Parser
+
+    :::ruby
+    require 'httperf/parser'
+
+    # read result from a file, for example
+    puts HTTPerf::Parser.parse( File.open("httperf.out", "r").read )
+
+    # or verbose output
+    puts HTTPerf::Parser.parse( File.open("httperf_verbose.out", "r").read, true )
+
+#### From the command line:
+
+Something I've been playing around with, it's more of hack really. But it works well for seralizing output to YAML or JSON:
+
+##### To JSON file:
+
+    :::shell
+    httperf --num-conns=10 --verbose | ruby -e 'require "httperf/parser"; require "json"; puts HTTPerf::Parser.parse(ARGF.read).to_json' > httperf.json
+
+##### To YAML file:
+
+    :::shell
+    httperf --num-conns=10 --verbose | ruby -e 'require "httperf/parser"; require "yaml"; puts HTTPerf::Parser.parse(ARGF.read).to_yaml' > httperf.yml
+
+#### Parser Keys:
+
+    :::ruby
+    :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
+
+#### Verbose Percentile Parser Keys:
+
+    :connection_time_75_pct
+    :connection_time_80_pct
+    :connection_time_85_pct
+    :connection_time_90_pct
+    :connection_time_95_pct
+    :connection_time_99_pct
+
+
+#### Accepted Options:
+
+- `"add-header"`
+- `"burst-length"`
+- `"client"`
+- `"close-with-reset"`
+- `"debug"`
+- `"failure-status"`
+- `"hog"`
+- `"http-version"`
+- `"max-connections"`
+- `"max-piped-calls"`
+- `"method"`
+- `"no-host-hdr"`
+- `"num-calls"`
+- `"num-conns"`
+- `"period"`
+- `"port"`
+- `"print-reply"`
+- `"print-request"`
+- `"rate"`
+- `"recv-buffer"`
+- `"retry-on-failure"`
+- `"send-buffer"`
+- `"server"`
+- `"server-name"`
+- `"session-cookies"`
+- `"ssl"`
+- `"ssl-ciphers"`
+- `"ssl-no-reuse"`
+- `"think-timeout"`
+- `"timeout"`
+- `"uri"`
+- `"verbose"`
+- `"version"`
+- `"wlog"`
+- `"wsess"`
+- `"wsesslog"`
+- `"wset"`

data/lib/httperf.rb

@@ -122,7 +122,7 @@ class HTTPerf
   # return results of last fork
   def fork_out
     if @parse
-      return Parse.parse(@fork_out, self.parse)
+      return Parser.parse(@fork_out)
     else
       return @fork_out
     end

data/lib/httperf/version.rb

@@ -1,4 +1,4 @@
 class HTTPerf
-  VERSION = "0.3.11"
+  VERSION = "0.3.12"
 end
 

metadata

@@ -1,78 +1,69 @@
 --- !ruby/object:Gem::Specification
 name: httperfrb
 version: !ruby/object:Gem::Version
-  version: 0.3.11
-  prerelease: 
+  version: 0.3.12
 platform: ruby
 authors:
 - Joshua Mervine
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-01 00:00:00.000000000 Z
+date: 2014-04-14 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: simplecov
   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: yard
   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: open4
   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: Simple interface for calling httperf via ruby.
@@ -82,35 +73,34 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- Gemfile
+- HISTORY.md
+- README.md
 - lib/httperf.rb
-- lib/httperf/version.rb
 - lib/httperf/parser.rb
-- README.md
-- HISTORY.md
-- Gemfile
+- lib/httperf/version.rb
 homepage: http://www.rubyops.net/gems/httperfrb
 licenses: []
+metadata: {}
 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: 1.3.6
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.2.0
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: HTTPerf via Ruby
 test_files: []
 has_rdoc: