hitimes 0.3.0-x86-mswin32-60

data/ext/rbconfig.rb

@@ -0,0 +1,178 @@
+
+# This file was created by mkconfig.rb when ruby was built.  Any
+# changes made to this file will be lost the next time ruby is built.
+
+module Config
+  RUBY_VERSION == "1.8.6" or
+    raise "ruby lib version (1.8.6) doesn't match executable version (#{RUBY_VERSION})"
+
+  TOPDIR = File.dirname(__FILE__).chomp!("/lib/ruby/1.8/i386-mingw32")
+  DESTDIR = '' unless defined? DESTDIR
+  CONFIG = {}
+  CONFIG["DESTDIR"] = DESTDIR
+  CONFIG["INSTALL"] = '/opt/local/bin/ginstall -c'
+  CONFIG["prefix"] = (TOPDIR || DESTDIR + "#{ENV["HOME"]}/ruby-mingw32")
+  CONFIG["EXEEXT"] = ".exe"
+  CONFIG["ruby_install_name"] = "ruby"
+  CONFIG["RUBY_INSTALL_NAME"] = "ruby"
+  CONFIG["RUBY_SO_NAME"] = "msvcrt-ruby18"
+  CONFIG["SHELL"] = "/bin/sh"
+  CONFIG["PATH_SEPARATOR"] = ":"
+  CONFIG["PACKAGE_NAME"] = ""
+  CONFIG["PACKAGE_TARNAME"] = ""
+  CONFIG["PACKAGE_VERSION"] = ""
+  CONFIG["PACKAGE_STRING"] = ""
+  CONFIG["PACKAGE_BUGREPORT"] = ""
+  CONFIG["exec_prefix"] = "$(prefix)"
+  CONFIG["bindir"] = "$(exec_prefix)/bin"
+  CONFIG["sbindir"] = "$(exec_prefix)/sbin"
+  CONFIG["libexecdir"] = "$(exec_prefix)/libexec"
+  CONFIG["datarootdir"] = "$(prefix)/share"
+  CONFIG["datadir"] = "$(datarootdir)"
+  CONFIG["sysconfdir"] = "$(prefix)/etc"
+  CONFIG["sharedstatedir"] = "$(prefix)/com"
+  CONFIG["localstatedir"] = "$(prefix)/var"
+  CONFIG["includedir"] = "$(prefix)/include"
+  CONFIG["oldincludedir"] = "/usr/include"
+  CONFIG["docdir"] = "$(datarootdir)/doc/$(PACKAGE)"
+  CONFIG["infodir"] = "$(datarootdir)/info"
+  CONFIG["htmldir"] = "$(docdir)"
+  CONFIG["dvidir"] = "$(docdir)"
+  CONFIG["pdfdir"] = "$(docdir)"
+  CONFIG["psdir"] = "$(docdir)"
+  CONFIG["libdir"] = "$(exec_prefix)/lib"
+  CONFIG["localedir"] = "$(datarootdir)/locale"
+  CONFIG["mandir"] = "$(datarootdir)/man"
+  CONFIG["ECHO_C"] = ""
+  CONFIG["ECHO_N"] = "-n"
+  CONFIG["ECHO_T"] = ""
+  CONFIG["LIBS"] = "-lwsock32 "
+  CONFIG["build_alias"] = "i686-darwin9.2.2"
+  CONFIG["host_alias"] = "i386-mingw32"
+  CONFIG["target_alias"] = "i386-mingw32"
+  CONFIG["MAJOR"] = "1"
+  CONFIG["MINOR"] = "8"
+  CONFIG["TEENY"] = "6"
+  CONFIG["build"] = "i686-pc-darwin9.2.2"
+  CONFIG["build_cpu"] = "i686"
+  CONFIG["build_vendor"] = "pc"
+  CONFIG["build_os"] = "darwin9.2.2"
+  CONFIG["host"] = "i386-pc-mingw32"
+  CONFIG["host_cpu"] = "i386"
+  CONFIG["host_vendor"] = "pc"
+  CONFIG["host_os"] = "mingw32"
+  CONFIG["target"] = "i386-pc-mingw32"
+  CONFIG["target_cpu"] = "i386"
+  CONFIG["target_vendor"] = "pc"
+  CONFIG["target_os"] = "mingw32"
+  CONFIG["CC"] = "i386-mingw32-gcc"
+  CONFIG["CFLAGS"] = "-g -O2 "
+  CONFIG["LDFLAGS"] = "-L. "
+  CONFIG["CPPFLAGS"] = ""
+  CONFIG["OBJEXT"] = "o"
+  CONFIG["CPP"] = "i386-mingw32-gcc -E"
+  CONFIG["GREP"] = "/usr/bin/grep"
+  CONFIG["EGREP"] = "/usr/bin/grep -E"
+  CONFIG["GNU_LD"] = "yes"
+  CONFIG["CPPOUTFILE"] = "-o conftest.i"
+  CONFIG["OUTFLAG"] = "-o "
+  CONFIG["YACC"] = "bison -y"
+  CONFIG["YFLAGS"] = ""
+  CONFIG["RANLIB"] = "i386-mingw32-ranlib"
+  CONFIG["AR"] = "i386-mingw32-ar"
+  CONFIG["AS"] = "i386-mingw32-as"
+  CONFIG["ASFLAGS"] = ""
+  CONFIG["NM"] = "i386-mingw32-nm"
+  CONFIG["WINDRES"] = "i386-mingw32-windres"
+  CONFIG["DLLWRAP"] = "i386-mingw32-dllwrap"
+  CONFIG["OBJDUMP"] = "i386-mingw32-objdump"
+  CONFIG["LN_S"] = "ln -s"
+  CONFIG["SET_MAKE"] = ""
+  CONFIG["INSTALL_PROGRAM"] = "$(INSTALL)"
+  CONFIG["INSTALL_SCRIPT"] = "$(INSTALL)"
+  CONFIG["INSTALL_DATA"] = "$(INSTALL) -m 644"
+  CONFIG["RM"] = "rm -f"
+  CONFIG["CP"] = "cp"
+  CONFIG["MAKEDIRS"] = "mkdir -p"
+  CONFIG["ALLOCA"] = ""
+  CONFIG["DLDFLAGS"] = " -Wl,--enable-auto-image-base,--enable-auto-import,--export-all"
+  CONFIG["ARCH_FLAG"] = ""
+  CONFIG["STATIC"] = ""
+  CONFIG["CCDLFLAGS"] = ""
+  CONFIG["LDSHARED"] = "i386-mingw32-gcc -shared -s"
+  CONFIG["DLEXT"] = "so"
+  CONFIG["DLEXT2"] = "dll"
+  CONFIG["LIBEXT"] = "a"
+  CONFIG["LINK_SO"] = ""
+  CONFIG["LIBPATHFLAG"] = " -L\"%s\""
+  CONFIG["RPATHFLAG"] = ""
+  CONFIG["LIBPATHENV"] = ""
+  CONFIG["TRY_LINK"] = ""
+  CONFIG["STRIP"] = "strip"
+  CONFIG["EXTSTATIC"] = ""
+  CONFIG["setup"] = "Setup"
+  CONFIG["MINIRUBY"] = "ruby -I/Users/jeremy/pkgs/ruby-1.8.6-p114 -rfake"
+  CONFIG["PREP"] = "fake.rb"
+  CONFIG["RUNRUBY"] = "$(MINIRUBY) -I`cd $(srcdir)/lib; pwd`"
+  CONFIG["EXTOUT"] = ".ext"
+  CONFIG["ARCHFILE"] = ""
+  CONFIG["RDOCTARGET"] = ""
+  CONFIG["XCFLAGS"] = " -DRUBY_EXPORT"
+  CONFIG["XLDFLAGS"] = " -Wl,--stack,0x02000000"
+  CONFIG["LIBRUBY_LDSHARED"] = "i386-mingw32-gcc -shared -s"
+  CONFIG["LIBRUBY_DLDFLAGS"] = " -Wl,--enable-auto-image-base,--enable-auto-import,--export-all -Wl,--out-implib=$(LIBRUBY)"
+  CONFIG["rubyw_install_name"] = "rubyw"
+  CONFIG["RUBYW_INSTALL_NAME"] = "rubyw"
+  CONFIG["LIBRUBY_A"] = "lib$(RUBY_SO_NAME)-static.a"
+  CONFIG["LIBRUBY_SO"] = "$(RUBY_SO_NAME).dll"
+  CONFIG["LIBRUBY_ALIASES"] = ""
+  CONFIG["LIBRUBY"] = "lib$(LIBRUBY_SO).a"
+  CONFIG["LIBRUBYARG"] = "$(LIBRUBYARG_SHARED)"
+  CONFIG["LIBRUBYARG_STATIC"] = "-l$(RUBY_SO_NAME)-static"
+  CONFIG["LIBRUBYARG_SHARED"] = "-l$(RUBY_SO_NAME)"
+  CONFIG["SOLIBS"] = "$(LIBS)"
+  CONFIG["DLDLIBS"] = ""
+  CONFIG["ENABLE_SHARED"] = "yes"
+  CONFIG["MAINLIBS"] = ""
+  CONFIG["COMMON_LIBS"] = "m"
+  CONFIG["COMMON_MACROS"] = ""
+  CONFIG["COMMON_HEADERS"] = "windows.h winsock.h"
+  CONFIG["EXPORT_PREFIX"] = ""
+  CONFIG["MAKEFILES"] = "Makefile GNUmakefile"
+  CONFIG["arch"] = "i386-mingw32"
+  CONFIG["sitearch"] = "i386-msvcrt"
+  CONFIG["sitedir"] = "$(prefix)/lib/ruby/site_ruby"
+  CONFIG["configure_args"] = " '--host=i386-mingw32' '--target=i386-mingw32' '--build=i686-darwin9.2.2' '--prefix=/Users/jeremy/ruby-mingw32' 'build_alias=i686-darwin9.2.2' 'host_alias=i386-mingw32' 'target_alias=i386-mingw32'"
+  CONFIG["NROFF"] = "/usr/bin/nroff"
+  CONFIG["MANTYPE"] = "doc"
+  CONFIG["ruby_version"] = "$(MAJOR).$(MINOR)"
+  CONFIG["rubylibdir"] = "$(libdir)/ruby/$(ruby_version)"
+  CONFIG["archdir"] = "$(rubylibdir)/$(arch)"
+  CONFIG["sitelibdir"] = "$(sitedir)/$(ruby_version)"
+  CONFIG["sitearchdir"] = "$(sitelibdir)/$(sitearch)"
+  CONFIG["topdir"] = File.dirname(__FILE__)
+  MAKEFILE_CONFIG = {}
+  CONFIG.each{|k,v| MAKEFILE_CONFIG[k] = v.dup}
+  def Config::expand(val, config = CONFIG)
+    val.gsub!(/\$\$|\$\(([^()]+)\)|\$\{([^{}]+)\}/) do |var|
+      if !(v = $1 || $2)
+	'$'
+      elsif key = config[v = v[/\A[^:]+(?=(?::(.*?)=(.*))?\z)/]]
+	pat, sub = $1, $2
+	config[v] = false
+	Config::expand(key, config)
+	config[v] = key
+	key = key.gsub(/#{Regexp.quote(pat)}(?=\s|\z)/n) {sub} if pat
+	key
+      else
+	var
+      end
+    end
+    val
+  end
+  CONFIG.each_value do |val|
+    Config::expand(val)
+  end
+end
+RbConfig = Config # compatibility for ruby-1.9
+CROSS_COMPILING = nil unless defined? CROSS_COMPILING

data/gemspec.rb

@@ -0,0 +1,55 @@
+require 'rubygems'
+require 'hitimes/version'
+require 'tasks/config'
+
+Hitimes::GEM_SPEC = Gem::Specification.new do |spec|
+  proj = Configuration.for('project')
+  spec.name         = proj.name
+  spec.version      = Hitimes::VERSION
+  
+  spec.author       = proj.author
+  spec.email        = proj.email
+  spec.homepage     = proj.homepage
+  spec.summary      = proj.summary
+  spec.description  = proj.description
+  spec.platform     = Gem::Platform::RUBY
+
+  
+  pkg = Configuration.for('packaging')
+  spec.files        = pkg.files.all
+  spec.executables  = pkg.files.bin.collect { |b| File.basename(b) }
+
+  # add dependencies here
+  spec.add_dependency("rake", ">= 0.8.1")
+  spec.add_dependency("configuration", ">= 0.0.5")
+  spec.add_dependency("mkrf", ">= 0.2.3")
+
+  if ext_conf = Configuration.for_if_exist?("extension") then
+    spec.extensions <<  ext_conf.configs
+    spec.require_paths << 'ext'
+    spec.extensions.flatten!
+  end   
+
+  if rdoc = Configuration.for_if_exist?('rdoc') then
+    spec.has_rdoc         = true
+    spec.extra_rdoc_files = pkg.files.rdoc
+    spec.rdoc_options     = rdoc.options + [ "--main" , rdoc.main_page ]
+  else
+    spec.has_rdoc         = false
+  end 
+
+  if test = Configuration.for_if_exist?('testing') then
+    spec.test_files       = test.files
+  end 
+
+  if rf = Configuration.for_if_exist?('rubyforge') then
+    spec.rubyforge_project  = rf.project
+  end 
+end
+
+Hitimes::GEM_SPEC_WIN = Hitimes::GEM_SPEC.clone
+Hitimes::GEM_SPEC_WIN.platform = ::Gem::Platform.new( "i386-mswin32_60" )
+Hitimes::GEM_SPEC_WIN.extensions = []
+Hitimes::GEM_SPEC_WIN.files +=  ["lib/hitimes_ext.so"]
+
+Hitimes::SPECS = [ Hitimes::GEM_SPEC, Hitimes::GEM_SPEC_WIN ]

data/lib/hitimes.rb

@@ -0,0 +1,21 @@
+#--
+# Copyright (c) 2008 Jeremy Hinegardner
+# All rights reserved.  See LICENSE and/or COPYING for details.
+#++
+
+#
+# The top level module containing the contents of the hitimes library
+#
+# use the library with:
+#
+#   require 'hitimes'
+#
+module Hitimes
+  #
+  # Base class of all errors in Hitimes
+  #
+  class Error < ::StandardError; end
+end
+require 'hitimes/paths'
+require 'hitimes/version'
+require 'hitimes/timer'

data/lib/hitimes/paths.rb

@@ -0,0 +1,54 @@
+#--
+# Copyright (c) 2008 Jeremy Hinegardner
+# All rights reserved.  See LICENSE and/or COPYING for details.
+#++
+#
+module Hitimes
+  #
+  # Access to various paths inside the project programatically
+  #
+  module Paths
+    #   
+    # :call-seq:
+    #    Hitimes::Paths.root_dir -> String
+    #
+    # Returns The full expanded path of the parent directory of +lib+
+    # going up the path from the current file.  A trailing File::SEPARATOR 
+    # is guaranteed.
+    #   
+    def self.root_dir
+      unless @root_dir
+        path_parts = ::File.expand_path(__FILE__).split(::File::SEPARATOR)
+        lib_index  = path_parts.rindex("lib")
+        @root_dir = path_parts[0...lib_index].join(::File::SEPARATOR) + ::File::SEPARATOR
+      end 
+      return @root_dir
+    end 
+
+    # 
+    # :call-seq:
+    #   Hitimes::Paths.lib_path( *args ) -> String
+    #
+    # Returns The full expanded path of the +lib+ directory below
+    # _root_dir_.  All parameters passed in are joined onto the 
+    # result. A trailing File::SEPARATOR is guaranteed if 
+    # _args_ are *not* present.
+    #   
+    def self.lib_path(*args)
+      self.sub_path("lib", *args)
+    end 
+
+    #
+    # :call-seq:
+    #   Hitimes::Paths.sub_path( sub, *args ) -> String
+    #
+    # Returns the full expanded path of the +sub+ directory below _root_dir.  All
+    # _arg_ parameters passed in are joined onto the result.  A trailing
+    # File::SEPARATOR is guaranteed if _args_ are *not* present.
+    #
+    def self.sub_path(sub,*args)
+      sp = ::File.join(root_dir, sub) + File::SEPARATOR
+      sp = ::File.join(sp, *args) if args
+    end
+  end
+end

data/lib/hitimes/timer.rb

@@ -0,0 +1,223 @@
+#--
+# 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