stella 0.3.2 → 0.5.1

data/lib/stella/test/definition.rb

@@ -2,18 +2,13 @@
 
 module Stella
   
-
+  # Stella::Test::Definition
+  # 
+  # This class defines the properties of load test. These are "generic" properties
+  # in that they don't relate to a specific tool. 
   module Test
-    
-    # Stella::Test::Definition
-    # 
-    # This class defines the properties of load test. These are "generic" properties
-    # in that they don't relate to a specific tool.
     class Definition
       
-      # Stella::Test::Definition::Rampup
-      # 
-      # This class holds the values for a rampup: interval and ceiling.
       class Rampup
         attr_accessor :interval
         attr_accessor :ceiling
@@ -52,7 +47,7 @@ module Stella
       attr_accessor :message
     
       def initialize  
-        @repetitions = 3
+        @repetitions = 1
       end
       
       def repetitions=(v)

data/lib/stella/test/{run/summary.rb → runsummary.rb}

@@ -1,9 +1,12 @@
 
 
 
-module Stella::Test::Run
+module Stella
+module Test
 
-  class Summary < Stella::Storable
+  
+  
+  class RunSummary < Stella::Storable
     
     attr_accessor :note
     attr_accessor :tool, :version
@@ -29,8 +32,6 @@ module Stella::Test::Run
       (@transactions / @successful).to_f * 100
     end
     
-    # We calculate the throughput because Apache Bench does not provide this
-    # value in the output. 
     def throughput
       return 0 if !@elapsed_time || @elapsed_time == 0
       (@data_transferred / @elapsed_time).to_f
@@ -47,4 +48,5 @@ module Stella::Test::Run
   end
   
   
+end
 end

data/lib/stella/test/{base.rb → summarybase.rb}

@@ -1,19 +1,23 @@
 
 module Stella::Test
   
-  module Base
+  module SummaryBase
     
     attr_reader :message
     attr_reader :elapsed_time_avg, :transaction_rate_avg, :vusers_avg, :response_time_avg
     attr_reader :elapsed_time_sdev, :transaction_rate_sdev, :vusers_sdev, :response_time_sdev
     attr_accessor :transactions_total, :headers_transferred_total, :data_transferred_total
-    attr_accessor :successful_total, :failed_total, :elapsed_time_total, :throughput_avg, :throughput_sdev
+    attr_accessor :successful_total, :failed_total, :elapsed_time_total
     
     def availability
       return 0 if @successful_total == 0
       (@transactions_total / @successful_total).to_f * 100
     end
     
+    def throughput
+      return 0 if @elapsed_time_total == 0
+      (@data_transferred_total / @elapsed_time_total).to_f
+    end
     
     # Defines the fields the are output by to_hash and to_csv. 
     # For to_csv, this also determines the field order
@@ -26,7 +30,7 @@ module Stella::Test
         :transactions_total, :successful_total, :failed_total,
         :data_transferred_total, :headers_transferred_total,
         
-        :elapsed_time_total, :availability, :throughput_avg, :throughput_sdev
+        :elapsed_time_total, :availability, :throughput
       ]
     end
     

data/lib/stella/test/{summary.rb → testsummary.rb}

@@ -1,11 +1,10 @@
 
-require 'stella/test/base'
+require 'stella/test/summarybase'
 
 module Stella::Test
   
-  # Stella::Test::Summary
-  class Summary < Stella::Storable
-    include Base
+  class TestSummary < Stella::Storable
+    include SummaryBase
     
     attr_reader :runs
     
@@ -16,32 +15,34 @@ module Stella::Test
     
     # Add a TestRun object to the list
     def add_run(run)
-      raise "I got a #{run.class} but I wanted a Run::Summary" unless run.is_a?(Run::Summary)
+      raise "I got a #{run.class} but I wanted a RunSummary" unless run.is_a?(RunSummary)
       @runs << run
       calculate
     end
     
     private 
     def calculate
-      # We simply keep a running tally of these
       @transactions_total = 0
       @headers_transferred_total = 0
       @data_transferred_total = 0
-      @elapsed_time_total = 0
+      
+      @elapsed_time_avg = 0
+      @response_time_avg = 0
+      @transaction_rate_avg = 0
+      @vusers_avg = 0
+      
       @successful_total = 0
       @failed_total = 0
       
-      # We keep a list of the values for averaging and std dev
       elapsed_times = []
       transaction_rates = []
       vusers_list = []
       response_times = []
-      response_time = []
-      transaction_rate = []
-      throughput = []
-      vusers = []
+      @elapsed_time_total = 0
+      response_time = 0
+      transaction_rate = 0
+      vusers = 0
       
-      # Each run is the summary of a single run (i.e. run01/SUMMARY.csv)
       runs.each do |run|
         # These are totaled
         @transactions_total += run.transactions
@@ -49,32 +50,33 @@ module Stella::Test
         @data_transferred_total += run.data_transferred
         @successful_total += run.successful
         @failed_total += run.failed
+        
         @elapsed_time_total += run.elapsed_time
         
+        response_time += run.response_time
+        
+        transaction_rate += run.transaction_rate
+        vusers += run.vusers
+        
         # These are used for standard deviation
         elapsed_times << run.elapsed_time
         transaction_rates << run.transaction_rate
         vusers_list << run.vusers
         response_times << run.response_time
-        throughput << run.throughput
-        response_time << run.response_time
-        transaction_rate << run.transaction_rate
-        vusers << run.vusers
       end
       
+      
       # Calculate Averages
-      @elapsed_time_avg = elapsed_times.average
-      @throughput_avg = throughput.average
-      @response_time_avg = response_time.average
-      @transaction_rate_avg = transaction_rate.average
-      @vusers_avg = vusers.average 
+      @elapsed_time_avg = @elapsed_time_total / runs.size
+      @transaction_rate_avg = transaction_rate / runs.size
+      @vusers_avg = (vusers / runs.size)  
+      @response_time_avg = response_time / runs.size
       
       # Calculate Standard Deviations
-      @elapsed_time_sdev = elapsed_times.standard_deviation
-      @throughput_sdev= throughput.standard_deviation
-      @transaction_rate_sdev = transaction_rates.standard_deviation
-      @vusers_sdev = vusers_list.standard_deviation
-      @response_time_sdev = response_times.standard_deviation
+      @elapsed_time_sdev = MathUtil.standard_deviation(elapsed_times)
+      @transaction_rate_sdev = MathUtil.standard_deviation(transaction_rates)
+      @vusers_sdev = MathUtil.standard_deviation(vusers_list)
+      @response_time_sdev = MathUtil.standard_deviation(response_times)
       
     end
   end

data/lib/utils/mathutil.rb

@@ -1,41 +1,5 @@
 
 
-module MathUtil
-  
-  def self.variance(population)
-    n = 0
-    mean = 0.0
-    s = 0.0
-    population.each { |x|
-      n = n + 1
-      delta = (x - mean).to_f
-      mean = (mean + (delta / n)).to_f
-      s = (s + delta * (x - mean)).to_f
-    }
-    
-    return s / n
-  end
-
-  # calculate the standard deviation of a population
-  # accepts: an array, the population
-  # returns: the standard deviation
-  def self.standard_deviation(population)
-    Math.sqrt(variance(population))
-  end
-  
-  # enforce_limit
-  #
-  # Enforce a minimum and maximum value 
-  def self.enforce_limit(val,min,max)
-    val = min  if val < min
-    val = max  if val > max
-    val
-  end
-  
-end
-
-
-
 
 module Enumerable
 
@@ -75,4 +39,38 @@ module Enumerable
         return Math.sqrt(self.sample_variance)
     end
 
+end
+
+module MathUtil
+  
+  def self.variance(population)
+    n = 0
+    mean = 0.0
+    s = 0.0
+    population.each { |x|
+      n = n + 1
+      delta = (x - mean).to_f
+      mean = (mean + (delta / n)).to_f
+      s = (s + delta * (x - mean)).to_f
+    }
+    
+    return s / n
+  end
+
+  # calculate the standard deviation of a population
+  # accepts: an array, the population
+  # returns: the standard deviation
+  def self.standard_deviation(population)
+    Math.sqrt(variance(population))
+  end
+  
+  # enforce_limit
+  #
+  # Enforce a minimum and maximum value 
+  def self.enforce_limit(val,min,max)
+    val = min  if val < min
+    val = max  if val > max
+    val
+  end
+  
 end

data/spec/base.rb

@@ -0,0 +1,26 @@
+require 'rubygems'
+require 'spec'
+
+STELLA_HOME = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+$: << File.join(STELLA_HOME, 'lib')
+$: << File.join(STELLA_HOME, 'vendor', 'useragent', 'lib')
+
+require 'optparse' 
+require 'rdoc/usage'
+require 'ostruct'
+require 'date'
+
+require 'stella/storable'
+require 'stella/command'
+require 'stella/config'
+require 'stella/response'
+require 'stella/command/harness'
+  
+require 'utils/httputil'
+require 'utils/crypto-key'
+require 'utils/fileutil'
+
+## Create and run the application
+#app = Stella::Command.new(ARGV, STDIN)
+#app.run

data/spec/shell_spec.rb

@@ -0,0 +1,12 @@
+require File.dirname(__FILE__) + '/base'
+require 'stella/command'
+
+describe Stella::Command do
+	before do
+		@shell = Stella::Command.new(['-h'], nil)
+	end
+
+	it "gets help" do
+		@shell.should be_kind_of(Stella)
+	end
+end

data/support/text/en.yaml

@@ -5,12 +5,6 @@
     :enabled: true
 :text_available_languages: "Available languages: %s"
 
-
-:agents_option_full: Return complete user-agent strings.
-:agents_option_list: List available user-agent shortnames. 
-:agents_option_search: Return only user agents which match the search term.
-:agents_count_message: "There are %d user agent strings matching your query"
-
 :option_help_stdout: Print STDOUT output from load tool for each test run
 :option_help_stderr: Print STDERR output from load tool for each test run
 :option_help_verbose: Specify the output verbosity (level 1, 2 or 3)
@@ -42,7 +36,7 @@
 :option_help_format: "Output file format. One of: csv [default], yaml, tsv, json"
 :option_help_version: Display the version, then exit
 :option_help_sleep: Number of seconds to sleep between runs
-:option_help_agent: Specify a User-Agent. Can be a short string or complete agent string. Defaults to 'random'. 
+:option_help_agent: Specify a User-Agent. Can be a short string or complete agent string.
 :option_help_help: Displays this message
 :option_help_rampup: Execute multiple tests, incremented by R users every test, up to U users
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: stella
 version: !ruby/object:Gem::Version 
-  version: 0.3.2
+  version: 0.5.1
 platform: ruby
 authors: 
 - Delano Mandelbaum
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-12-23 00:00:00 -05:00
+date: 2008-12-22 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -41,6 +41,100 @@ extra_rdoc_files:
 files: 
 - Rakefile
 - bin/stella
+- doc/classes
+- doc/classes/Crypto
+- doc/classes/Crypto/Key.html
+- doc/classes/Crypto.html
+- doc/classes/Enumerable.html
+- doc/classes/FileUtil.html
+- doc/classes/HTTPUtil.html
+- doc/classes/MathUtil.html
+- doc/classes/Stella
+- doc/classes/Stella/Adapter
+- doc/classes/Stella/Adapter/ApacheBench.html
+- doc/classes/Stella/Adapter/Base.html
+- doc/classes/Stella/Adapter/CommandNotReady.html
+- doc/classes/Stella/Adapter/Httperf.html
+- doc/classes/Stella/Adapter/Siege.html
+- doc/classes/Stella/Adapter.html
+- doc/classes/Stella/CLI
+- doc/classes/Stella/CLI/Base.html
+- doc/classes/Stella/CLI/Language.html
+- doc/classes/Stella/CLI/LocalTest.html
+- doc/classes/Stella/CLI.html
+- doc/classes/Stella/Command
+- doc/classes/Stella/Command/Base.html
+- doc/classes/Stella/Command.html
+- doc/classes/Stella/Config.html
+- doc/classes/Stella/InvalidArgument.html
+- doc/classes/Stella/LocalTest.html
+- doc/classes/Stella/Logger.html
+- doc/classes/Stella/Response.html
+- doc/classes/Stella/Storable.html
+- doc/classes/Stella/Test
+- doc/classes/Stella/Test/DaySummary.html
+- doc/classes/Stella/Test/Definition
+- doc/classes/Stella/Test/Definition/Rampup.html
+- doc/classes/Stella/Test/Definition.html
+- doc/classes/Stella/Test/RunSummary.html
+- doc/classes/Stella/Test/SummaryBase.html
+- doc/classes/Stella/Test/TestSummary.html
+- doc/classes/Stella/Test.html
+- doc/classes/Stella/Text
+- doc/classes/Stella/Text/Resource.html
+- doc/classes/Stella/Text.html
+- doc/classes/Stella/UnavailableAdapter.html
+- doc/classes/Stella/UnknownValue.html
+- doc/classes/Stella/UnsupportedLanguage.html
+- doc/classes/Stella/Util.html
+- doc/classes/Stella.html
+- doc/classes/TextGraph.html
+- doc/classes/TimerUtil.html
+- doc/created.rid
+- doc/files
+- doc/files/lib
+- doc/files/lib/stella
+- doc/files/lib/stella/adapter
+- doc/files/lib/stella/adapter/ab_rb.html
+- doc/files/lib/stella/adapter/base_rb.html
+- doc/files/lib/stella/adapter/httperf_rb.html
+- doc/files/lib/stella/adapter/siege_rb.html
+- doc/files/lib/stella/cli
+- doc/files/lib/stella/cli/base_rb.html
+- doc/files/lib/stella/cli/language_rb.html
+- doc/files/lib/stella/cli/localtest_rb.html
+- doc/files/lib/stella/cli_rb.html
+- doc/files/lib/stella/command
+- doc/files/lib/stella/command/base_rb.html
+- doc/files/lib/stella/command/localtest_rb.html
+- doc/files/lib/stella/logger_rb.html
+- doc/files/lib/stella/response_rb.html
+- doc/files/lib/stella/storable_rb.html
+- doc/files/lib/stella/support_rb.html
+- doc/files/lib/stella/test
+- doc/files/lib/stella/test/daysummary_rb.html
+- doc/files/lib/stella/test/definition_rb.html
+- doc/files/lib/stella/test/runsummary_rb.html
+- doc/files/lib/stella/test/summarybase_rb.html
+- doc/files/lib/stella/test/testsummary_rb.html
+- doc/files/lib/stella/text
+- doc/files/lib/stella/text/resource_rb.html
+- doc/files/lib/stella/text_rb.html
+- doc/files/lib/stella_rb.html
+- doc/files/lib/utils
+- doc/files/lib/utils/crypto-key_rb.html
+- doc/files/lib/utils/fileutil_rb.html
+- doc/files/lib/utils/httputil_rb.html
+- doc/files/lib/utils/mathutil_rb.html
+- doc/files/lib/utils/textgraph_rb.html
+- doc/files/lib/utils/timerutil_rb.html
+- doc/files/LICENSE_txt.html
+- doc/files/README_txt.html
+- doc/fr_class_index.html
+- doc/fr_file_index.html
+- doc/fr_method_index.html
+- doc/index.html
+- doc/rdoc-style.css
 - lib/stella
 - lib/stella/adapter
 - lib/stella/adapter/ab.rb
@@ -48,7 +142,6 @@ files:
 - lib/stella/adapter/httperf.rb
 - lib/stella/adapter/siege.rb
 - lib/stella/cli
-- lib/stella/cli/agents.rb
 - lib/stella/cli/base.rb
 - lib/stella/cli/language.rb
 - lib/stella/cli/localtest.rb
@@ -61,23 +154,24 @@ files:
 - lib/stella/storable.rb
 - lib/stella/support.rb
 - lib/stella/test
-- lib/stella/test/base.rb
+- lib/stella/test/daysummary.rb
 - lib/stella/test/definition.rb
-- lib/stella/test/run
-- lib/stella/test/run/summary.rb
-- lib/stella/test/summary.rb
+- lib/stella/test/runsummary.rb
+- lib/stella/test/summarybase.rb
+- lib/stella/test/testsummary.rb
 - lib/stella/text
 - lib/stella/text/resource.rb
 - lib/stella/text.rb
 - lib/stella.rb
 - lib/utils
 - lib/utils/crypto-key.rb
-- lib/utils/escape.rb
 - lib/utils/fileutil.rb
 - lib/utils/httputil.rb
 - lib/utils/mathutil.rb
 - lib/utils/textgraph.rb
 - lib/utils/timerutil.rb
+- spec/base.rb
+- spec/shell_spec.rb
 - support/text
 - support/text/en.yaml
 - support/text/nl.yaml