tsung_stats_server 0.0.1

data/doc/setup.erb

@@ -0,0 +1,33 @@
+<% chapter "Setup" do %>
+  <% section "Requirements" do %>
+    Your system needs the following software to run **tsung\_stats\_server**.
+
+    | Software                        | Description               | Notes                                        |
+    | --------                        | -----------               | -----                                        |
+    | [Ruby](http://ruby-lang.org)    | Ruby language interpreter | Version 1.8.6 is required.                   |
+    | [RubyGems](http://rubygems.org) | Ruby packaging system     | Version 1.3.1 is required.                   |
+    | [Sinatra](http://www.sinatrarb.com) | The Sinatra web framework     | Version 0.9.x is required.                   |
+    | [Rubyzip](http://rubyzip.sourceforge.net/ ) | Zip file library     | Version 0.9.7 is required.                   |
+    | [Inochi](http://snk.tuxfamily.org/lib/inochi) | Inochi      | Version 0.3.0 is required.                   |
+    | [Tsung](http://tsung.erlang-projects.org/) | Tsung          | Version 1.3.0 is required.                   |
+  <% end %>
+
+  <% section "Installation" do %>
+    You can install **Tsung Stats Server** by running this command:
+
+        gem install -f <%= $program %>
+
+    To check whether the installation was sucessful, run this command:
+
+        <%= $program %> --version
+
+    If the installation was successful, you will see output like this:
+
+    <pre><%= verbatim `ruby bin/#{$program} --version` %></pre>
+
+    If you do not see such output, you may
+    <%= xref "License", "ask the author(s)" %> for help.
+  <% end %>
+
+ 
+<% end %>

data/doc/style.css

@@ -0,0 +1,81 @@
+body { font-family: Myriad, Helvetica, Arial, Verdana, sans-serif; font-size: 10pt; }
+#nav ul { list-style: none; padding: 0; margin: 0; }
+#nav ul li { white-space: nowrap; }
+#nav ul li.deprecated a { text-decoration: line-through; font-style: italic; }
+#nav li em { font-size: 0.9em; color: #999; }
+#nav h1 { font-size: 1.2em; }
+h1 { font-size: 1.5em; background: #eee; color: #000; padding: 3px; text-decoration: none; }
+h2 { font-size: 1.2em; background: #eef; color: #000; padding: 3px; text-decoration: none; }
+h3 { font-size: 1.0em; }
+.clear { clear: both; }
+.section.module h1.title, .section.class h1.title, .section.readme h1 { color: #000; background: #ddd; border: 1px solid #ccc; padding: 7px; margin: 0; margin-bottom: 7px; }
+.section.class h1.title { border-bottom: 0; margin-bottom: 0; }
+.section.class > .section.docstring, .section.module > .section.docstring { padding: 0; }
+#initialize-instance_method .methodsignature .return_types { display: none; }
+.methodsignature .visibility { display: none; }
+.methodsignature .name { font-weight: bold; }
+.methoddetails .method_header h3 { display: none; }
+.section h3 { margin-left: 20px; }
+.section.method { background: #eee; margin-bottom: 0.8em; }
+.overload .section.method { background: #f5f5f5; margin-left: 2em; margin-right: 2em; }
+.section.tags,.section.docstring,.section.source { padding: 5px 12px; }
+.section.method .details_title { font-size: 1.1em; background: #dde; padding: 7px; }
+.overload .section.method .details_title { background: #e2e2ea; }
+.overload .section.source { display: none; }
+.section.method .details_title p.aliases { padding: 0; margin: 0; font-style: italic; font-size: 0.9em; }
+.section.method .details_title p.aliases tt { font-weight: bold; font-style: normal; font-size: 1.1em; }
+.section.constants dl { font-family: monospace; }
+.section.constants dt { font-weight: bold; font-size: 1.1em; }
+.section.constants dt:after { content: " = "; }
+.section.constants dd { margin-bottom: 1em; }
+.section .source_link { font-size: 0.9em; }
+.section .source_code { display: none; }
+/*.section.source .source_code pre { float: left; }*/
+.section.attributes table { padding: 0; width: 100%; }
+.section.attributes .readwrite { width: 5%; }
+.section.attributes .name { font-weight: bold; width: 10%; }
+.section.attributes .aliases { padding-top: 0; padding-left: 0; }
+.section.attributes .aliases .text { font-size: 0.8em; }
+.section.attributes .aliases .alias { font-family: monospace; font-weight: bold; }
+.section.attributes .visibility { font-style: italic; color: #666; width: 5%; }
+.section.attributes td, .section.attributes th { vertical-align: top; padding: 5px; }
+.section.attributes th { padding-left: 0; text-align: left; }
+.section.attributes .docstring p.returns { color: #555; font-style: italic; }
+.section.attributes .docstring .return_types { font-style: normal; }
+.section.attributes .docstring { width: 80%; }
+.section.attributes .docstring * { display: inline; }
+.section.attributes tr.hasaliases td, .section.attributes tr.hasaliases th { padding-bottom: 0; }
+.section.deprecated { margin-left: 15px; }
+.section.inheritance { background: #ddd; padding: 5px; border: 1px solid #ccc; border-top: 0; }
+.section.inheritance ul { list-style: none; padding-left: 2.2em; margin: 0; }
+.section.inheritance ul li { line-height: 1.2em; }
+.section.inheritance ul li:before { content: "↳ "; }
+.section.inheritance > ul { padding-left: 5px; }
+.section.inheritance > ul > li:before { content: ""; }
+.section.inheritance > ul > ul { padding-left: 1em; }
+.section.methodsummary table { width: 100%; }
+.section.methodsummary td, .section.methodsummary th { background: #eee; vertical-align: top; padding: 5px; }
+.section.methodsummary th { background: #dde; text-align: left; white-space: nowrap; padding-right: 12px; }
+.section.methodsummary .signature { font-family: monospace; font-weight: normal; }
+.section.methodsummary .signature .name { font-weight: bold; }
+.section.methodsummary .signature .alias, .section.methodsummary .signature .overload { display: block; }
+.section.methodsummary .docstring { width: 80%; }
+.section.methodsummary .docstring * { display: inline; }
+.section.methodsummary .docstring p.returns { color: #555; font-style: italic; }
+.section.methodsummary .docstring .return_types { font-style: normal; }
+.section.tags div { clear: both; }
+.section.tags h2 { display: none; }
+.section.tags h3 { font-size: 1.0em; margin-top: 3px; }
+.section.tags dl { margin-left: 2em; }
+.section.tags .option table { width: 100%; border: 0; padding: 0; }
+.section.tags .option th { text-align: left; background: #e5e5e5; padding: 3px; }
+.section.tags .option td.name { font-family: monospace; }
+.section.methodmissing p.note { font-style: italic; }
+.section.constructor p.inherited_msg { font-style: italic; }
+.included h1, .inherited h1 { font-size: 1em !important; border: 0; margin: 0; padding: 5px; border-bottom: 1px solid #ccc; }
+.included div, .inherited div { color: #444; margin: 1.5em 0; width: 47%; border: 1px solid #ccc; float: left; margin-right: 12px; }
+.included p .name, .inherited p .name { font-family: monospace; }
+.included p, .inherited p { margin: 5px; }
+#yard_info a:link, #yard_info a:visited { color: #333; }
+#yard_info { margin-top: 12px; margin-bottom: 7px; text-align: center; color: #444; background: #ddd; padding: 8px; border: 1px solid #ccc; font-size: 0.8em; }
+#yard_info .yard { font-weight: bold; }

data/doc/syntax_highlight.css

@@ -0,0 +1,24 @@
+/* Canvas */
+.source_code pre.lines { margin-right: 20px; text-align: right; color: #888; }
+.docstring pre { padding: 12px; padding-left: 0; }
+.docstring pre, .source_code { background: #222; padding: 12px; margin-top: 8px; border: 1px dashed #ccc; font-size: 0.9em; overflow-x: auto; }
+
+/* Token colours. Borrowed from pastie.org's "Blackboard" theme */
+pre.code, pre.lines { font-family: Monaco, Courier, monospace; }
+pre.code { color: #fff; }
+pre.code .info.file { color: #888; }
+pre.code .val, pre.code .int, pre.code .float { color: #61CE3C; }
+pre.code .dstring, pre.code .tstring_content, 
+pre.code .regexp_beg, pre.code .regexp_end,
+pre.code .tstring_beg, pre.code .tstring_end { color: #61DE3C; }
+pre.code .embexpr_beg, pre.code .tstring, pre.code .tstring .rbrace { color: #7CFE65; }
+pre.code .fid, pre.code .id.new, pre.code .id.to_s, 
+pre.code .id.to_sym, pre.code .id.to_f, 
+pre.code .dot + pre.code .id,
+pre.code .id.to_i pre.code .id.each { color: #FF6400; }
+pre.code .comment { color: #AEAEAE; }
+pre.code .constant, pre.code .const, pre.code .symbol, pre.code .symbeg { color: #D8FA3C; }
+pre.code .kw { color: #FBDE2D; }
+pre.code .ivar { color: #AACEFB; }
+pre.code .gvar, pre.code .backref, pre.code .id.nth_ref { color: #BADEFF; }
+pre.code .regexp, .dregexp { color: #EA5EFB; }

data/doc/theory.erb

@@ -0,0 +1,3 @@
+<% chapter "Theory of operation" do %>
+
+<% end %>

data/doc/top-level-namespace.html

@@ -0,0 +1,25 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+  <head>
+    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
+<link rel="stylesheet" href="style.css" type="text/css" charset="utf-8" />
+<link rel="stylesheet" href="custom.css" type="text/css" charset="utf-8" />
+<link rel="stylesheet" href="syntax_highlight.css" type="text/css" charset="utf-8" />
+
+    <script src="jquery.js" type="text/javascript" charset="utf-8"></script>
+    <script src="app.js" type="text/javascript" charset="utf-8"></script>
+    <title>Top Level Namespace</title>
+  </head>
+  <body>
+    <div id="content">
+      
+    </div>
+    <div id="yard_info">
+  Generated on Tuesday, July 21 2009 at 11:24:31 PM by 
+  <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
+  0.2.3.2 (ruby-1.9.1).
+</div>
+
+  </body>
+</html>

data/doc/usage.erb

@@ -0,0 +1,23 @@
+<% chapter "Usage" do %>
+  <% section "Command-line interface" do %>
+  
+    You can see the online help by running the following command:
+  
+        <%= $program %> --help
+
+    The command-line arguments are:
+   
+    | Argument      | Description                             | Default                                   |
+    | --------      | -----------                             | -------                                   |
+    | --logdir      | The directory containing the tsung logs | ~/.tsung/log                              |
+    | --tsung-stats | The command used to call tsung_stats.pl | perl -S /usr/lib/tsung/bin/tsung_stats.pl |
+    | --port        | The port to run the server on           | 1764 (42 ** 2)                            |
+   
+    This starts the server on your machine. Point your browser to
+   
+        http://localhost:1764
+      
+    to see a list of available logs and options.
+  <% end %>
+
+<% end %>

data/lib/tsung_stats_server.rb

@@ -0,0 +1,15 @@
+require 'rubygems'
+#gem 'inochi', '~> 0'
+require 'inochi'
+
+Inochi.init :TsungStatsServer,
+  :project => 'skadesgems',
+  :version => '0.0.1',
+  :release => '2009-03-14',
+  :website => 'http://skadesgems.rubyforge.org',
+  :tagline => 'A simple webserver serving tsung stats',
+  :require => {
+    'sinatra' => '~> 0.9',
+    'rubyzip' => '~> 0.9',
+    'markaby' => '~> 0.5'
+  }

data/lib/webapp.rb

@@ -0,0 +1,134 @@
+require 'sinatra'
+require 'markaby'
+require 'zip/zip'
+require 'wilson/web'
+
+Markaby::Builder.set(:indent, 2)
+
+Sinatra::Application.set(:run => false, :environment => 
+:production)
+
+#
+# The TSSApp class serves log files generated by the Tsung stress
+# testing tool.
+#
+# @representation xml
+#     <?xml encoding="utf-8">
+#     <report>
+#       bla
+#     </report>
+# @representation json
+#     { "report": "bla" }
+#
+class TSSApp < Sinatra::Application
+  include Wilson::Web
+  
+  configure do
+    set :public, COMMAND_LINE.logdir
+    set :logdir, COMMAND_LINE.logdir
+    set :tsung_stats, COMMAND_LINE.tsung_stats
+  end
+  
+  ##
+  # Shows the list of all logs present on the machine.
+  #
+  # @output_types [text/html]
+  # @output_languages [en-US]
+  #
+  get '/' do
+    logdirs = (Dir.entries(options.logdir) - [".", ".."]).sort
+    logdirs.reject! {|file| file =~ /\.zip/ }
+    list_dirs(logdirs)  
+  end
+  
+  ##
+  # Shows a report. If the report is not generated already, it will be.
+  #
+  # @url_param dir The date on which the measurement was taken.
+  # @get force If present and set to any value, 
+  #              regeneration of the report is forced
+  # @output_types [text/html]
+  # @output_languages [en-US]
+  #
+  get '/:dir/report.html' do
+    run_stats(params[:dir])
+  end
+  
+  #
+  # Delivers a report as zip file. If not generated, report generation takes place.
+  #
+  # @url_param [dir] The date on which the measurement was taken.
+  #
+  # @output_types [application/zip]
+  #
+  get '/:dir.zip' do
+    filename = params[:dir].gsub(/:/, '-')
+    unless File.exists?(File.join(options.logdir, "#{filename}.zip"))
+      zip(params[:dir], filename)
+    end
+    attachment("#{filename}.zip")
+    content_type("application/zip")
+    File.read(File.join(options.logdir, "#{filename}.zip"))
+  end
+  
+  #
+  # Runs the report generation. If a report already exists, 
+  # it wont be generated a second time, unless forced explicitly.
+  #
+  # @param dir [String] The logfile directory of the report.
+  # @param force [true, false] If set to true, the report gets
+  #                            created unconditionally.
+  #
+  # @return [String] The contents of #{dir}/report.html
+  def run_stats(dir, force = false)
+    Dir.chdir( File.join(options.logdir, dir) ) do
+      unless File.exists?('report.html') && force == false
+        system(options.tsung_stats)
+      end
+      File.read('report.html')
+    end
+  end
+  
+  #
+  # Creates a zip file out of a directory. 
+  #
+  # @param dir [String] The directories name.
+  # @param filename [String] The output filename.
+  #
+  # @return [undefined] unspecified
+  def zip(dir, filename)
+    Dir.chdir( File.join(options.logdir) ) do
+      unless File.exists?("#{dir}.zip")
+        Zip::ZipFile.open("#{filename}.zip", true) do |zf|
+          Dir["#{dir}/**/*"].each { |f| zf.add(f, f) }
+        end
+      end
+    end
+  end
+  
+  #
+  # Generates a HTML document listing of all logs present on the machine.
+  #
+  # @param logdirs [Array<String>] The directories that contain logs.
+  #
+  # @return [String<text/html>] The generated document.
+  def list_dirs(logdirs)
+    doc = Markaby::Builder.new
+    doc.html do
+      head do
+        title "Logpickin'"
+      end
+      body do
+        h1 "Pick a log:"
+        ul.logs do
+          logdirs.each do |dir|
+            li.log do
+              a "Log #{dir}", :href => "/#{dir}/report.html"
+              a "As zip", :href => "/#{dir}.zip"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/test/tsung_stats_server.rb

@@ -0,0 +1,13 @@
+#describe TsungStatsServer do
+#  it 'has inochi' do
+#    assert TsungStatsServer.const_defined? :INOCHI
+#
+#    TsungStatsServer::INOCHI.each do |param, value|
+#      const = param.to_s.upcase
+#
+#      assert TsungStatsServer.const_defined? const
+#      TsungStatsServer.const_get(const).must_equal value
+#    end
+#  end
+#end
+#

metadata

@@ -0,0 +1,153 @@
+--- !ruby/object:Gem::Specification 
+name: tsung_stats_server
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Florian Gilcher
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-07-28 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.9"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rubyzip
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.9"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: markaby
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.5"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: inochi
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: inochi
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1"
+    version: 
+description: A simple webserver serving tsung stats
+email: flo@andersground.net
+executables: 
+- tsung_stats_server
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/tsung_stats_server
+- doc/all-files.html
+- doc/all-methods.html
+- doc/all-namespaces.html
+- doc/api/apple-touch-icon.png
+- doc/api/classes/Object.html
+- doc/api/classes/TSSApp.html
+- doc/api/created.rid
+- doc/api/css/main.css
+- doc/api/css/panel.css
+- doc/api/css/reset.css
+- doc/api/favicon.ico
+- doc/api/files/lib/tsung_stats_server_rb.html
+- doc/api/files/lib/webapp_rb.html
+- doc/api/files/LICENSE.html
+- doc/api/files/Rakefile.html
+- doc/api/files/README.html
+- doc/api/i/arrows.png
+- doc/api/i/results_bg.png
+- doc/api/i/tree_bg.png
+- doc/api/index.html
+- doc/api/js/jquery-1.3.2.min.js
+- doc/api/js/jquery-effect.js
+- doc/api/js/main.js
+- doc/api/js/searchdoc.js
+- doc/api/panel/index.html
+- doc/api/panel/search_index.js
+- doc/api/panel/tree.js
+- doc/app.js
+- doc/custom.css
+- doc/history.erb
+- doc/index.erb
+- doc/index.html
+- doc/index.xhtml
+- doc/intro.erb
+- doc/jquery.js
+- doc/README.html
+- doc/setup.erb
+- doc/style.css
+- doc/syntax_highlight.css
+- doc/theory.erb
+- doc/top-level-namespace.html
+- doc/TSSApp.html
+- doc/usage.erb
+- lib/tsung_stats_server.rb
+- lib/webapp.rb
+- LICENSE
+- Rakefile
+- README
+- test/tsung_stats_server.rb
+has_rdoc: true
+homepage: http://skadesgems.rubyforge.org
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: skadesgems
+rubygems_version: 1.3.4
+signing_key: 
+specification_version: 3
+summary: A simple webserver serving tsung stats
+test_files: []
+