hitimes 1.1.0-java

data/tasks/distribution.rake

@@ -0,0 +1,93 @@
+require 'tasks/config'
+
+#-------------------------------------------------------------------------------
+# Distribution and Packaging
+#-------------------------------------------------------------------------------
+if pkg_config = Configuration.for_if_exist?("packaging") then
+
+  require 'gemspec'
+  require 'rake/gempackagetask'
+  require 'rake/contrib/sshpublisher'
+
+  namespace :dist do
+
+    Rake::GemPackageTask.new(Hitimes::GEM_SPEC) do |pkg|
+      pkg.need_tar = pkg_config.formats.tgz
+      pkg.need_zip = pkg_config.formats.zip
+    end
+
+    desc "Install as a gem"
+    task :install => [:clobber, :package] do
+      sh "sudo gem install pkg/#{Hitimes::GEM_SPEC.full_name}.gem"
+    end
+
+    desc "Uninstall gem"
+    task :uninstall do 
+      sh "sudo gem uninstall -x #{Hitimes::GEM_SPEC.name}"
+    end
+
+    desc "dump gemspec"
+    task :gemspec do
+      puts Hitimes::GEM_SPEC.to_ruby
+    end
+
+    desc "dump gemspec for win"
+    task :gemspec_win do
+      puts Hitimes::GEM_SPEC_WIN.to_ruby
+    end
+
+    desc "dump gemspec for java"
+    task :gemspec_java do
+      puts Hitimes::GEM_SPEC_JAVA.to_ruby
+    end
+
+    desc "reinstall gem"
+    task :reinstall => [:uninstall, :repackage, :install]
+
+    desc "package up a windows gem"
+    task :package_win => :clean  do
+      Configuration.for("extension").cross_rbconfig.keys.each do |rbconfig|
+        v = rbconfig.split("-").last
+        s = v.sub(/\.\d$/,'')
+        sh "rake ext:build_win-#{v}"
+        mkdir_p "lib/hitimes/#{s}", :verbose => true
+        cp "ext/hitimes/hitimes_ext.so", "lib/hitimes/#{s}/", :verbose => true
+      end
+
+      Hitimes::SPECS.each do |spec|
+        next if spec.platform == "ruby"
+        spec.files += FileList["lib/hitimes/{1.8,1.9}/**.{dll,so}"]
+        Gem::Builder.new( spec ).build
+        mkdir "pkg" unless File.directory?( 'pkg' )
+        mv Dir["*.gem"].first, "pkg"
+      end
+    end
+
+    if RUBY_PLATFORM == "java" then
+      desc "package up a jruby gem"
+      task :package_java => "ext:build_java" do
+        Hitimes::GEM_SPEC_JAVA.files += FileList["lib/hitimes/*.jar"]
+        Hitimes::GEM_SPEC_JAVA.files += FileList["ext/java/src/hitimes/*.java"]
+        Gem::Builder.new( Hitimes::GEM_SPEC_JAVA ).build
+        mv Dir["*.gem"].first, "pkg"
+      end
+    end
+
+    task :clobber do
+      rm_rf "lib/hitimes/1.8"
+      rm_rf "lib/hitimes/1.9"
+      rm_rf "lib/hitimes/*.jar"
+    end
+
+    task :prep => [:clean, :package, :package_win, :package_java ]
+
+    desc "distribute copiously"
+    task :copious => [:clean, :package, :package_win, :package_java ] do
+      gems = Hitimes::SPECS.collect { |s| "#{s.full_name}.gem" }
+      Rake::SshFilePublisher.new('jeremy@copiousfreetime.org',
+                               '/var/www/vhosts/www.copiousfreetime.org/htdocs/gems/gems',
+                               'pkg', *gems).upload
+      sh "ssh jeremy@copiousfreetime.org rake -f /var/www/vhosts/www.copiousfreetime.org/htdocs/gems/Rakefile"
+    end 
+ end
+end

data/tasks/documentation.rake

@@ -0,0 +1,32 @@
+require 'tasks/config'
+
+#-----------------------------------------------------------------------
+# Documentation
+#-----------------------------------------------------------------------
+
+if rdoc_config = Configuration.for_if_exist?('rdoc') then
+
+  namespace :doc do
+
+    require 'rdoc'
+    require 'rake/rdoctask'
+
+    # generating documentation locally
+    Rake::RDocTask.new do |rdoc|
+      rdoc.rdoc_dir   = rdoc_config.output_dir
+      rdoc.options    = rdoc_config.options
+      rdoc.rdoc_files = rdoc_config.files.sort
+      rdoc.title      = rdoc_config.title
+      rdoc.main       = rdoc_config.main_page
+    end 
+
+    if rubyforge_config = Configuration.for_if_exist?('rubyforge') then
+      desc "Deploy the RDoc documentation to #{rubyforge_config.rdoc_location}"
+      task :deploy => :rerdoc do
+        sh "rsync -zav --delete #{rdoc_config.output_dir}/ #{rubyforge_config.rdoc_location}"
+      end 
+    end 
+
+  end 
+end
+

data/tasks/extension.rake

@@ -0,0 +1,108 @@
+require 'tasks/config'
+require 'pathname'
+
+#-----------------------------------------------------------------------
+# Extensions
+#-----------------------------------------------------------------------
+
+if ext_config = Configuration.for_if_exist?('extension') then
+  namespace :ext do  
+    desc "Build the extension(s)"
+    task :build => :clobber do
+      ext_config.configs.each do |extension|
+        path  = Pathname.new(extension)
+        parts = path.split
+        conf  = parts.last
+        Dir.chdir(path.dirname) do |d| 
+          ruby conf.to_s
+          sh "make" 
+
+          # install into requireable location so specs will run
+          subdir = "hitimes/#{RUBY_VERSION.sub(/\.\d$/,'')}"
+          dest_dir = Hitimes::Paths.lib_path( subdir )
+          mkdir_p dest_dir, :verbose => true
+          cp "hitimes_ext.#{Config::CONFIG['DLEXT']}", dest_dir, :verbose => true
+        end
+      end
+    end 
+
+    if RUBY_PLATFORM == "java" then
+      desc "Build the jruby extension"
+      task :build_java => [ :clobber, "lib/hitimes/hitimes.jar" ]
+
+      file "lib/hitimes/hitimes.jar" => FileList["ext/java/src/hitimes/*.java"] do |t|
+        jruby_home = Config::CONFIG['prefix']
+        jruby_jar  = File.join( jruby_home, 'lib', 'jruby.jar' )
+
+        mkdir_p 'pkg/classes'
+        sh "javac -classpath #{jruby_jar} -d pkg/classes #{t.prerequisites.join(' ')}"  
+
+        dest_dir = File.dirname(t.name)
+        sh "jar cf #{t.name} -C pkg/classes ."
+      end
+    end
+
+
+    def build_win( version = "1.8.6" )
+      ext_config = Configuration.for("extension")
+      rbconfig = ext_config.cross_rbconfig["rbconfig-#{version}"]
+      raise ArgumentError, "No cross compiler for version #{version}, we have #{ext_config.cross_rbconfig.keys.join(",")}" unless rbconfig
+      Hitimes::GEM_SPEC.extensions.each do |extension|
+        path = Pathname.new(extension)
+        parts = path.split
+        conf = parts.last
+        rvm = File.expand_path( "~/.rvm/bin/rvm" )
+        Dir.chdir(path.dirname) do |d| 
+          if File.exist?( "Makefile" ) then
+            sh "make clean distclean"
+          end
+          cp "#{rbconfig}", "rbconfig.rb"
+          rubylib = ENV['RUBYLIB']
+          ENV['RUBYLIB'] = "."
+          sh %[#{rvm} #{version} -S extconf.rb]
+          ENV['RUBYLIB'] = rubylib
+          sh "make"
+        end
+      end
+    end
+
+    win_builds = []
+    ext_config.cross_rbconfig.keys.each do |v|
+      s = v.split("-").last
+      desc "Build the extension for windows version #{s}"
+      win_bname = "build_win-#{s}"
+      win_builds << win_bname
+      task win_bname => :clean do
+        build_win( s )
+      end
+    end
+
+    task :clean do
+      ext_config.configs.each do |extension|
+        path  = Pathname.new(extension)
+        parts = path.split
+        conf  = parts.last
+        Dir.chdir(path.dirname) do |d| 
+          if File.exist?( "Makefile" ) then
+            sh "make clean"
+          end
+          rm_f "rbconfig.rb"
+        end 
+      end 
+    end 
+
+    task :clobber do
+      ext_config.configs.each do |extension|
+        path  = Pathname.new(extension)
+        parts = path.split
+        conf  = parts.last
+        Dir.chdir(path.dirname) do |d| 
+          if File.exist?( "Makefile" ) then
+            sh "make distclean"
+          end
+          rm_f "rbconfig.rb"
+        end 
+      end 
+    end
+  end
+end

data/tasks/rspec.rake

@@ -0,0 +1,33 @@
+
+require 'tasks/config'
+
+#--------------------------------------------------------------------------------
+# configuration for running rspec.  This shows up as the test:default task
+#--------------------------------------------------------------------------------
+if spec_config = Configuration.for_if_exist?("test") then
+  if spec_config.mode == "spec" then
+    namespace :test do
+
+      task :default => :spec
+
+      require 'spec/rake/spectask'
+      Spec::Rake::SpecTask.new do |r| 
+        r.ruby_opts   = spec_config.ruby_opts
+        r.libs        = [ Hitimes::Paths.lib_path, 
+                          Hitimes::Paths.root_dir ]
+        r.spec_files  = spec_config.files 
+        r.spec_opts   = spec_config.options
+
+        if rcov_config = Configuration.for_if_exist?('rcov') then
+          r.rcov      = true
+          r.rcov_dir  = rcov_config.output_dir
+          r.rcov_opts = rcov_config.rcov_opts
+        end
+      end
+
+      pre_req = "ext:build"
+      pre_req += "_java" if RUBY_PLATFORM == "java"
+      task :spec => pre_req
+    end
+  end
+end

data/tasks/rubyforge.rake

@@ -0,0 +1,55 @@
+require 'tasks/config'    
+
+#-----------------------------------------------------------------------
+# Rubyforge additions to the task library
+#-----------------------------------------------------------------------
+if rf_conf = Configuration.for_if_exist?("rubyforge") then
+
+  abort("rubyforge gem not installed 'gem install rubyforge'") unless Utils.try_require('rubyforge')
+  
+  proj_conf = Configuration.for('project')
+
+  namespace :dist do
+    desc "Release files to rubyforge"
+    task :rubyforge => [:clean, :package, :package_win] do
+
+      rubyforge = RubyForge.new
+
+      config = {}
+      config["release_notes"]     = proj_conf.description
+      config["release_changes"]   = Utils.release_notes_from(proj_conf.history)[Hitimes::VERSION]
+      config["Prefomatted"]       = true
+ 
+
+      rubyforge.configure config
+
+      # make sure this release doesn't already exist
+      releases = rubyforge.autoconfig['release_ids']
+      if releases.has_key?(Hitimes::GEM_SPEC.name) and releases[Hitimes::GEM_SPEC.name][Hitimes::VERSION] then
+        abort("Release #{Hitimes::VERSION} already exists! Unable to release.")
+      end
+
+      puts "Uploading to rubyforge..."
+      files = FileList[File.join("pkg","#{Hitimes::GEM_SPEC.name}-#{Hitimes::VERSION}*.*")].to_a
+      files.each do |f|
+        puts "  * #{f}"
+      end
+      rubyforge.login
+      rubyforge.add_release(Hitimes::GEM_SPEC.rubyforge_project, Hitimes::GEM_SPEC.name, Hitimes::VERSION, *files)
+      puts "done."
+    end
+  end
+
+  namespace :announce do
+    desc "Post news of #{proj_conf.name} to #{rf_conf.project} on rubyforge"
+    task :rubyforge do
+      info = Utils.announcement
+      rubyforge = RubyForge.new
+      rubyforge.configure
+      rubyforge.login
+      rubyforge.post_news(rf_conf.project, info[:subject], "#{info[:title]}\n\n#{info[:urls]}\n\n#{info[:release_notes]}")
+      puts "Posted to rubyforge"
+    end
+
+  end
+end

data/tasks/utils.rb

@@ -0,0 +1,80 @@
+require 'hitimes/version'
+
+#-------------------------------------------------------------------------------
+# Additions to the Configuration class that are useful
+#-------------------------------------------------------------------------------
+class Configuration
+  class << self
+    def exist?( name )
+      Configuration::Table.has_key?( name )
+    end
+
+    def for_if_exist?( name )
+      if self.exist?( name ) then
+        self.for( name )
+      end
+    end
+  end
+end
+
+#-------------------------------------------------------------------------------
+# some useful utilitiy methods for the tasks
+#-------------------------------------------------------------------------------
+module Utils
+  class << self
+
+    # Try to load the given _library_ using the built-in require, but do not
+    # raise a LoadError if unsuccessful. Returns +true+ if the _library_ was
+    # successfully loaded; returns +false+ otherwise.
+    #
+    def try_require( lib ) 
+      require lib
+      true 
+    rescue LoadError 
+      false 
+    end 
+
+    # partition an rdoc file into sections, and return the text of the section
+    # given.  
+    def section_of(file, section_name) 
+      File.read(file).split(/^(?==)/).each do |section|
+        lines = section.split("\n")
+        return lines[1..-1].join("\n").strip if lines.first =~ /#{section_name}/i
+      end
+      nil
+    end
+
+    # Get an array of all the changes in the application for a particular
+    # release.  This is done by looking in the history file and grabbing the
+    # information for the most recent release.  The history file is assumed to
+    # be in RDoc format and version release are 2nd tier sections separated by
+    # '== Version X.Y.Z'
+    #
+    # returns:: A hash of notes keyed by version number
+    #
+    def release_notes_from(history_file)
+      releases = {}
+      File.read(history_file).split(/^(?=== Version)/).each do |section|
+        lines = section.split("\n")
+        md = %r{Version ((\w+\.)+\w+)}.match(lines.first)
+        next unless md
+        releases[md[1]] = lines[1..-1].join("\n").strip
+      end
+      return releases
+    end
+
+    # return a hash of useful information for the latest release
+    # urls, subject, title, description and latest release notes
+    #
+    def announcement
+      cfg = Configuration.for("project") 
+      { 
+        :subject        => "#{cfg.name} #{Hitimes::VERSION} Released",
+        :title          => "#{cfg.name} version #{Hitimes::VERSION} has been released.",
+        :urls           => "#{cfg.homepage}",
+        :description    => "#{cfg.description.rstrip}",
+        :release_notes  => Utils.release_notes_from(cfg.history)[Hitimes::VERSION].rstrip 
+      }
+    end
+  end
+end # << self

metadata

@@ -0,0 +1,191 @@
+--- !ruby/object:Gem::Specification 
+name: hitimes
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+    - 1
+    - 1
+    - 0
+  version: 1.1.0
+platform: java
+authors: 
+  - Jeremy Hinegardner
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-28 00:00:00 -06:00
+default_executable: 
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: rake
+    prerelease: false
+    requirement: &id001 !ruby/object:Gem::Requirement 
+      requirements: 
+        - - ~>
+          - !ruby/object:Gem::Version 
+            segments: 
+              - 0
+              - 8
+              - 1
+            version: 0.8.1
+    type: :runtime
+    version_requirements: *id001
+  - !ruby/object:Gem::Dependency 
+    name: configuration
+    prerelease: false
+    requirement: &id002 !ruby/object:Gem::Requirement 
+      requirements: 
+        - - ~>
+          - !ruby/object:Gem::Version 
+            segments: 
+              - 0
+              - 0
+              - 5
+            version: 0.0.5
+    type: :runtime
+    version_requirements: *id002
+  - !ruby/object:Gem::Dependency 
+    name: json
+    prerelease: false
+    requirement: &id003 !ruby/object:Gem::Requirement 
+      requirements: 
+        - - ~>
+          - !ruby/object:Gem::Version 
+            segments: 
+              - 1
+              - 1
+              - 3
+            version: 1.1.3
+    type: :development
+    version_requirements: *id003
+  - !ruby/object:Gem::Dependency 
+    name: rake-compiler
+    prerelease: false
+    requirement: &id004 !ruby/object:Gem::Requirement 
+      requirements: 
+        - - ~>
+          - !ruby/object:Gem::Version 
+            segments: 
+              - 0
+              - 5
+              - 0
+            version: 0.5.0
+    type: :development
+    version_requirements: *id004
+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: []
+
+extensions: []
+
+extra_rdoc_files: 
+  - README
+  - HISTORY
+  - LICENSE
+  - lib/hitimes.rb
+  - lib/hitimes/metric.rb
+  - lib/hitimes/mutexed_stats.rb
+  - lib/hitimes/paths.rb
+  - lib/hitimes/stats.rb
+  - lib/hitimes/timed_metric.rb
+  - lib/hitimes/timed_value_metric.rb
+  - lib/hitimes/value_metric.rb
+  - lib/hitimes/version.rb
+files: 
+  - examples/benchmarks.rb
+  - examples/stats.rb
+  - ext/hitimes/hitimes_ext.c
+  - ext/hitimes/hitimes_instant_clock_gettime.c
+  - ext/hitimes/hitimes_instant_osx.c
+  - ext/hitimes/hitimes_instant_windows.c
+  - ext/hitimes/hitimes_interval.c
+  - ext/hitimes/hitimes_stats.c
+  - ext/hitimes/hitimes_interval.h
+  - ext/hitimes/hitimes_stats.h
+  - ext/hitimes/extconf.rb
+  - lib/hitimes.rb
+  - lib/hitimes/metric.rb
+  - lib/hitimes/mutexed_stats.rb
+  - lib/hitimes/paths.rb
+  - lib/hitimes/stats.rb
+  - lib/hitimes/timed_metric.rb
+  - lib/hitimes/timed_value_metric.rb
+  - lib/hitimes/value_metric.rb
+  - lib/hitimes/version.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/timed_metric_spec.rb
+  - spec/timed_value_metric_spec.rb
+  - spec/value_metric_spec.rb
+  - spec/version_spec.rb
+  - README
+  - HISTORY
+  - LICENSE
+  - tasks/announce.rake
+  - tasks/distribution.rake
+  - tasks/documentation.rake
+  - tasks/extension.rake
+  - tasks/rspec.rake
+  - tasks/rubyforge.rake
+  - tasks/config.rb
+  - tasks/utils.rb
+  - Rakefile
+  - gemspec.rb
+  - lib/hitimes/hitimes.jar
+  - ext/java/src/hitimes/Hitimes.java
+  - ext/java/src/hitimes/HitimesInterval.java
+  - ext/java/src/hitimes/HitimesService.java
+  - ext/java/src/hitimes/HitimesStats.java
+has_rdoc: true
+homepage: http://copiousfreetime.rubyforge.org/hitimes/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+  - --line-numbers
+  - --main
+  - README
+require_paths: 
+  - lib
+  - ext
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+          - 0
+        version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+          - 0
+        version: "0"
+requirements: []
+
+rubyforge_project: copiousfreetime
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Hitimes is a fast, high resolution timer library for recording performance metrics
+test_files: []
+