hitimes 0.4.1-x86-mswin32-60 → 1.0.0-x86-mswin32-60

data/tasks/config.rb

@@ -83,7 +83,7 @@ Configuration.for('rdoc') {
   files       Configuration.for('packaging').files.rdoc
   main_page   files.first
   title       Configuration.for('project').name
-  options     %w[ --line-numbers --inline-source ]#-f darkfish ]
+  options     %w[ --line-numbers --inline-source ]
   output_dir  "doc"
 }
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: hitimes
 version: !ruby/object:Gem::Version 
-  version: 0.4.1
+  version: 1.0.0
 platform: x86-mswin32-60
 authors: 
 - Jeremy Hinegardner
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-02-19 00:00:00 -07:00
+date: 2009-06-12 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -18,7 +18,7 @@ dependencies:
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
         version: 0.8.1
     version: 
@@ -28,11 +28,21 @@ dependencies:
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
         version: 0.0.5
     version: 
-description: Hitimes is a fast, high resolution timer library for recording performance metrics.  It uses the appropriate C method calls for each system to get the highest granularity time increments possible.    It currently supports any system with the POSIX call clock_gettime(), Mac OS X and Windows.  Using Hitimes can be faster than using a series of Time.new calls, and it will have a much higher granularity.   It is definitely faster than using Process.times.
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.1.3
+    version: 
+description: "Hitimes is a fast, high resolution timer library for recording performance metrics.  It uses the appropriate C method calls for each system to get the highest granularity time increments possible.    It currently supports any of the following systems:  * any system with the POSIX call <tt>clock_gettime()</tt>, * Mac OS X * Windows  Using Hitimes can be faster than using a series of +Time.new+ calls, and it will have a much higher granularity.   It is definitely faster than using +Process.times+."
 email: jeremy@copiousfreetime.org
 executables: []
 
@@ -42,10 +52,13 @@ extra_rdoc_files:
 - README
 - HISTORY
 - LICENSE
+- lib/hitimes/metric.rb
 - lib/hitimes/mutexed_stats.rb
 - lib/hitimes/paths.rb
 - lib/hitimes/stats.rb
-- lib/hitimes/timer.rb
+- lib/hitimes/timed_metric.rb
+- lib/hitimes/timed_value_metric.rb
+- lib/hitimes/value_metric.rb
 - lib/hitimes/version.rb
 - lib/hitimes.rb
 - ext/hitimes_ext.c
@@ -68,18 +81,24 @@ files:
 - ext/extconf.rb
 - ext/rbconfig-mingw.rb
 - ext/rbconfig.rb
+- lib/hitimes/metric.rb
 - lib/hitimes/mutexed_stats.rb
 - lib/hitimes/paths.rb
 - lib/hitimes/stats.rb
-- lib/hitimes/timer.rb
+- lib/hitimes/timed_metric.rb
+- lib/hitimes/timed_value_metric.rb
+- lib/hitimes/value_metric.rb
 - lib/hitimes/version.rb
 - lib/hitimes.rb
 - spec/interval_spec.rb
+- spec/metric_spec.rb
 - spec/mutex_stats_spec.rb
 - spec/paths_spec.rb
 - spec/spec_helper.rb
 - spec/stats_spec.rb
-- spec/timer_spec.rb
+- spec/timed_metric_spec.rb
+- spec/timed_value_metric_spec.rb
+- spec/value_metric_spec.rb
 - spec/version_spec.rb
 - README
 - HISTORY

data/lib/hitimes/timer.rb

@@ -1,223 +0,0 @@
-#--
-# Copyright (c) 2008 Jeremy Hinegardner
-# All rights reserved.  See LICENSE and/or COPYING for details.
-#++
-
-require 'hitimes'
-require 'hitimes_ext'
-
-module Hitimes
-  #
-  # A Timer combines together an Interval and a Stats object to provide
-  # aggregate information about timings.  
-  #
-  # A Timer has many of the same methods as an Interval and would be used in
-  # preference to an Interval in those situations where you want to track
-  # statistics about the item you are monitoring.
-  #
-  class Timer
-
-    # holds all the statistics
-    attr_reader :stats
-
-    class << self
-
-      # 
-      # :call-seq:
-      #   Timer.now -> Timer
-      #
-      # Return a newly allocated Timer that has already been started
-      #
-      def now
-        t = Timer.new
-        t.start
-        return t
-      end
-
-      # 
-      # :call-seq:
-      #   Timer.measure { ... } -> Float
-      #
-      # Return the number of seconds that a block of code took to
-      # execute.
-      #
-      def measure( &block )
-        Interval.measure { yield }
-      end
-    end
-
-    #
-    # :call-seq:
-    #   Timer.new -> Timer
-    #
-    def initialize
-      @stats = Stats.new
-      @current_interval = nil
-    end
-
-    #
-    # :call-seq:
-    #   timer.current_interval -> Interval
-    #
-    # Return the current interval, if one doesn't exist create one.
-    #
-    def current_interval
-      @current_interval ||= Interval.new
-    end
-
-    #
-    # :call-seq:
-    #   timer.running? -> true or false
-    #
-    # return whether or not the timer is currently running.  
-    #
-    def running?
-      current_interval.running?
-    end
-
-    # 
-    # :call-seq:
-    #   timer.start -> nil
-    #
-    # Start the current timer, if the current timer is already started, then
-    # this is a noop.  
-    #
-    def start
-      current_interval.start unless running?
-      nil
-    end
-
-    #
-    # :call-seq:
-    #   timer.stop -> Float or nil
-    #
-    # Stop the current timer.  This updates the stats and removes the current
-    # interval. If the timer is not running then this is a noop.  If the
-    # timer was stopped then the duration of the last Interval is returned.  If
-    # the timer was already stopped then false is returned.
-    # 
-    def stop
-      if running? then
-        d = current_interval.stop
-        @current_interval = nil
-        stats.update( d )
-        return d
-      end
-      return false
-    end
-
-    #
-    # :call-seq:
-    #   timer.measure {  ... } -> Float
-    #
-    # Measure the execution of a block and add those stats to the running stats.
-    #
-    def measure( &block )
-      t = 0.0
-      begin
-        start
-        yield
-      ensure
-        t = stop
-      end
-      return t
-    end
-
-    #
-    # :call-seq:
-    #   timer.split -> Flaot
-    #
-    # Split the current timer.  Essentially, mark a split time. This means
-    # stop the current interval and create a new interval, but make sure
-    # that the new interval lines up exactly, timewise, behind the previous
-    # interval.
-    #
-    # If the timer is running, then split returns the duration of the previous
-    # interval, i.e. the split-time.  If the timer is not running, nothing
-    # happens and false is returned.
-    #
-    def split  
-      if running? then 
-        next_interval = current_interval.split
-        d = current_interval.duration
-        stats.update( d )
-        @current_interval = next_interval 
-        return d
-      end 
-      return false
-    end
-
-    # 
-    # :call-seq:
-    #   timer.sum -> Float
-    #   timer.duration -> Float 
-    #
-    # The total time the timer has been measuring.  
-    #
-    def sum
-      stats.sum
-    end
-    alias duration sum
-
-    #
-    # :call-seq:
-    #   timer.mean -> Float
-    #
-    # The mean value of all the the stopped intervals.  The current interval, if
-    # it is still running, is not included.
-    #
-    def mean
-      stats.mean
-    end
-
-    #
-    # :call-seq:
-    #   timer.rate -> Float
-    #
-    # Return the rate of the states, which is the count / duration
-    #
-    def rate
-      stats.rate
-    end
-
-    #
-    # :call-seq:
-    #   timer.stddev -> Float
-    #
-    # The standard deviation of all the intervals
-    #
-    def stddev
-      stats.stddev
-    end
-
-    #
-    # :call-seq:
-    #   timer.count -> Integer
-    #
-    # The count of intervals in this timer
-    #
-    def count
-      stats.count
-    end
-
-    #
-    # :call-seq:
-    #   timer.max -> Float
-    #
-    # The maximum duration of all the intervals this Timer has seen
-    # 
-    def max
-      stats.max
-    end
-
-    #
-    # :call-seq:
-    #   timer.min -> Float
-    #
-    # The minimum duration of all the intervals this Timer has seen
-    #
-    def min
-      stats.min
-    end
-  end
-end

data/spec/timer_spec.rb

@@ -1,105 +0,0 @@
-require File.expand_path( File.join( File.dirname( __FILE__ ), "spec_helper.rb" ) )
-
-require 'hitimes/timer'
-
-describe Hitimes::Timer do
-
-  it "knows if it is running or not" do
-    t = Hitimes::Timer.new
-    t.should_not be_running
-    t.start
-    t.should be_running
-    t.stop
-    t.should_not be_running
-  end
-
-  it "#split returns the last duration and the timer is still running" do
-    t = Hitimes::Timer.now
-    d = t.split
-    t.should be_running
-    d.should > 0
-    t.count.should == 1
-    t.duration.should == d
-  end
-
-  it "#stop returns false if called more than once in a row" do
-    t = Hitimes::Timer.new
-    t.start
-    t.stop.should > 0
-    t.stop.should == false
-  end
-
-  it "does not count a currently running interval as an interval in calculations" do
-    t = Hitimes::Timer.new
-    t.start
-    t.count.should == 0
-    t.split
-    t.count.should == 1
-  end
-
-  it "#split called on a stopped timer does nothing" do
-    t = Hitimes::Timer.new
-    t.start
-    t.stop
-    t.split.should == false
-  end
-
-  it "calculates the mean of the durations" do
-    t = Hitimes::Timer.new
-    2.times { t.start ; sleep 0.05 ; t.stop }
-    t.mean.should > 0.04
-  end
-
-  it "calculates the rate of the counts " do
-    t = Hitimes::Timer.new
-    5.times { t.start ; sleep 0.05 ; t.stop }
-    t.rate.should > 19.0
-  end
-
-
-  it "calculates the stddev of the durations" do
-    t = Hitimes::Timer.new
-    2.times { t.start ; sleep 0.05 ; t.stop }
-    t.stddev.should > 0.0
-  end
-
-  it "returns 0.0 for stddev if there is no data" do
-    t = Hitimes::Timer.new
-    t.stddev.should == 0.0
-  end
-
-  it "retuns 0.0 for mean if there is no data" do
-    Hitimes::Timer.new.mean.should == 0.0
-  end
-
-  it "keeps track of the min value" do
-    t = Hitimes::Timer.new
-    2.times { t.start ; sleep 0.05 ; t.stop }
-    t.min.should > 0
-  end
-
-  it "keeps track of the max value" do
-    t = Hitimes::Timer.new
-    2.times { t.start ; sleep 0.05 ; t.stop }
-    t.max.should > 0
-  end
-
-  it "can create an already running timer" do
-    t = Hitimes::Timer.now
-    t.should be_running
-  end
-
-  it "can measure a block of code's execution time" do
-    dur = Hitimes::Timer.measure { sleep 0.05 }
-    dur.should > 0.025
-  end
-
-  it "can measuer a block of code from an instance" do
-    t = Hitimes::Timer.new
-    3.times { t.measure { sleep 0.05 } }
-    t.duration.should > 0.14
-    t.count.should == 3
-  end
-
-end
-