hitimes 1.3.0-x64-mingw32

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cd0753ca4c87ef476f9a46520c0d522122f735378d77c7310eaf03f8db88b341
+  data.tar.gz: 9d1dfc523449870050d5e86a7f2145eab1742e01c83c7cf71a2493961aa9c28f
+SHA512:
+  metadata.gz: 17de5f09502c772ac53cd13f7497edb2a955db925edafe39e0f2e3daea0b3ef290213fa4362a84832dd327ea157c09c9e0f499bbf044c158e6eefd43e4764880
+  data.tar.gz: f540282f60503bc87a3180276695b984e5ae023dd1de590bfa31da389d1df8e38b19a0f1823367aeb18cdab238ea7d003d4788aac22083e7237147d251f33db2

data/CONTRIBUTING.md

@@ -0,0 +1,57 @@
+# Hi there!
+
+I see you are interested in contributing. That is wonderful. I love
+contributions.
+
+I guarantee that there are bugs in this software. And I guarantee that there is
+a feature you want that is not in here yet. As such, any and all bugs reports
+are gratefully accepted, bugfixes even more so. Helping out with bugs is the
+easiest way to contribute.
+
+
+## The Quick Version
+
+* Have a [GitHub Account][].
+* Search the [GitHub Issues][] and see if your issue already present. If so
+  add your comments, :thumbsup:, etc.
+* Issue not there? Not a problem, open up a [new issue][].
+    * **Bug reports** please be as detailed as possible. Include:
+        * full ruby engine and version: `ruby -e 'puts RUBY_DESCRIPTION'`
+        * operating system and version
+        * version of hitimes `ruby -rubygems -e "require 'hitimes'; puts Hitimes::VERSION"`
+        * as much detail about the bug as possible so I can replicated it. Feel free
+          to link in a [gist][]
+    * **New Feature**
+        * What the new feature should do.
+        * What benefit the new feature brings to the project.
+* Fork the [repo][].
+* Create a new branch for your issue: `git checkout -b issue/my-issue`
+* Lovingly craft your contribution:
+    * `rake develop` to get started
+    * `rake test` to run tests
+* Make sure that `rake test` passes. Its important, I said it twice.
+* Add yourself to the contributors section below.
+* Submit your [pull request][].
+
+## Building Windows Binaries
+
+This is done using https://github.com/rake-compiler/rake-compiler-dock
+
+1. have VirtualBox installed
+2. have Docker Machine installed (https://docs.docker.com/engine/installation/)
+3. `gem install rake-compiler-dock`
+4. `rake-compiler-dock` (this could take a while)
+5. `bundle`
+6. `rake cross native gem`
+
+# Contributors
+
+* Jeremy Hinegardner
+* Wojciech Piekutowski
+
+[GitHub Account]: https://github.com/signup/free "GitHub Signup"
+[GitHub Issues]:  https://github.com/copiousfreetime/hitimes/issues "Hitimes Issues"
+[new issue]:      https://github.com/copiousfreetime/hitimes/issues/new "New Hitimes Issue"
+[gist]:           https://gist.github.com/ "New Gist"
+[repo]:           https://github.com/copiousfreetime/hitimes "hitimes Repo"
+[pull request]:   https://help.github.com/articles/using-pull-requests "Using Pull Requests"

data/HISTORY.md

@@ -0,0 +1,124 @@
+# Hitimes Changelog
+## Version 1.3.0 2018-06-15
+
+* Add api method `Hitimes.raw_instant` to expose raw OS instant value
+* Add api constant `Hitimes::INSTANT_CONVERSION_FACTOR` to expose raw OS instant conversion factor
+* other development cleanup tasks
+
+## Version 1.2.6 2017-08-04
+
+* Resolve version number issue (#61) (thanks @anthraxx)
+
+## Version 1.2.5 2017-05-25
+
+* Update dependencies
+* Add ruby 2.4 to windows fatbinary
+* Update docs to indicate windows ruby before 2.0 is no longer supported
+
+## Version 1.2.4 2016-05-01
+
+* Fix finding the extension on ruby 2.1.10 (thanks @wpiekutowski)
+* Add more readable load error (thanks @mbautin)
+* Update README with what versions of ruby are supported.
+
+## Version 1.2.3 2015-09-13
+
+* Release new fatbinary version for windows
+* Update README to indicate duration units
+* Provide a more friendly error message if the gem is not installed correctly
+
+## Version 1.2.2 2014-07-09
+
+* fix compilation issue with clock_gettime in libc (reported by eradman and virtualfunction)
+* Switch to minispec for tests
+
+## Version 1.2.1 2013-03-12
+
+* Update dependencies
+* Ruby 2.0 fixes
+* Switch to Markdown, Yeah RDoc 4.0!
+
+## Version 1.2.0 2013-02-09
+
+* Update dependencies
+* Documentation cleanup
+* Fix use of deprecated JRuby API in java extension
+* Fix use of deprecated OSX system calls in C extension
+* Make hitimes -w clean
+* Fix ambiguity of calling duration on non-started Interval
+* Use RbConfig instead of Config (eregon)
+* Added Hitimes.measure
+* Switch to using rake-compiler for cross compilation of gems
+
+## Version 1.1.1 2010-09-04
+
+* Remove the unnecessary dependencies that should be development dependencies
+
+## Version 1.1.0 2010-07-28
+
+* Add a pure java extension so hitimes may be used in jruby with the same API
+
+## Version 1.0.5 2010-07-20
+
+* Fix 'circular require considered harmful' warnings in 1.9.x (reported by Roger Pack)
+* Fix 'method redefined' warnings in 1.9.x (reported by Roger Pack)
+
+## Version 1.0.4 2009-08-01
+
+* Add in support for x86-mingw32 gem
+* Add version subdirectory for extension on all platforms
+
+## Version 1.0.3 2009-06-28
+
+* Fix bug with time.h on linode (reported by Roger Pack) 
+* Fix potential garbage collection issue with Interval class
+* Windows gem is now a fat binary to support installing in 1.8 or 1.9 from the
+  same gem
+
+## Version 1.0.1 2009-06-12
+
+* Fix examples
+* performance tuning, new Hitimes::Metric derived classes are faster than old Timer class
+
+## Version 1.0.0 2009-06-12
+
+* Major version bump with complete refactor of the metric collection API
+* 3 types of metrics now instead of just 1 Timer
+    * Hitimes::ValueMetric
+    * Hitimes::TimedMetric
+    * Hitimes::TimedValueMetric
+* The ability to convert all metrics #to_hash
+* Updated documentation with examples using each metric type
+
+## Version 0.4.1 2009-02-19
+
+* change to ISC License
+* fix bug in compilation on gentoo
+
+## Version 0.4.0 2008-12-20
+
+* Added new stat 'rate'
+* Added new stat method to_hash
+* Added Hitimes::MutexedStats class for threadsafe stats collection 
+    - not needed when used in MRI 1.8.x
+* remove stale dependency on mkrf
+
+## Version 0.3.0
+
+* switched to extconf for building extensions
+* first release of windows binary gem
+* reverted back to normal rdoc
+
+## Version 0.2.1
+
+* added Timer#rate method
+* switched to darkfish rdoc
+
+## Version 0.2.0
+
+* Performance improvements
+* Added Hitimes::Stats class
+
+## Version 0.1.0
+
+* Initial completion

data/LICENSE

@@ -0,0 +1,16 @@
+ISC LICENSE - http://opensource.org/licenses/isc-license.txt
+
+Copyright (c) 2008-2015 Jeremy Hinegardner
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

data/Manifest.txt

@@ -0,0 +1,44 @@
+CONTRIBUTING.md
+HISTORY.md
+LICENSE
+Manifest.txt
+README.md
+Rakefile
+examples/benchmarks.rb
+examples/stats.rb
+ext/hitimes/c/extconf.rb
+ext/hitimes/c/hitimes.c
+ext/hitimes/c/hitimes_instant_clock_gettime.c
+ext/hitimes/c/hitimes_instant_osx.c
+ext/hitimes/c/hitimes_instant_windows.c
+ext/hitimes/c/hitimes_interval.c
+ext/hitimes/c/hitimes_interval.h
+ext/hitimes/c/hitimes_stats.c
+ext/hitimes/c/hitimes_stats.h
+ext/hitimes/java/src/hitimes/Hitimes.java
+ext/hitimes/java/src/hitimes/HitimesInterval.java
+ext/hitimes/java/src/hitimes/HitimesService.java
+ext/hitimes/java/src/hitimes/HitimesStats.java
+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/hitimes_spec.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
+tasks/default.rake
+tasks/extension.rake
+tasks/this.rb

data/README.md

@@ -0,0 +1,200 @@
+# Hitimes
+
+[![Build Status](https://travis-ci.org/copiousfreetime/hitimes.svg?branch=master)](https://travis-ci.org/copiousfreetime/hitimes)
+
+A fast, high resolution timer library for recording peformance metrics.
+
+* [Homepage](http://github.com/copiousfreetime/hitimes)
+* [Github project](http://github.com.org/copiousfreetime/hitimes)
+* email jeremy at copiousfreetime dot org
+* `git clone url git://github.com/copiousfreetime/hitimes.git`
+
+## Table of Contents
+
+* [Requirements](#requirements)
+* [Usage](#usage)
+* [Contributing](#contributing)
+* [Support](#support)
+* [License](#license)
+
+
+## Requirements
+
+Hitimes requires the following to run:
+
+  * Ruby
+
+## Usage
+
+Hitimes easiest to use when installed with `rubygems`:
+
+```sh
+gem install hitimes
+```
+
+Or as part of your bundler `Gemfile`:
+
+```ruby
+gem 'hitimes'
+```
+
+You can load it with the standard ruby require statement.
+
+```ruby
+require 'hitimes'
+```
+
+### Interval
+
+Use `Hitimes::Interval` to calculate only the duration of a block of code.
+Returns the time as seconds.
+
+```ruby
+duration = Hitimes::Interval.measure do
+             1_000_000.times do |x|
+               2 + 2
+             end
+           end
+
+puts duration  # => 0.047414297 (seconds)
+```
+
+### TimedMetric
+
+Use a `Hitimes::TimedMetric` to calculate statistics about an iterative operation
+
+```ruby
+timed_metric = Hitimes::TimedMetric.new('operation on items')
+```
+
+Explicitly use `start` and `stop`:
+
+```ruby
+collection.each do |item|
+  timed_metric.start
+  # .. do something with item
+  timed_metric.stop
+end
+```
+
+Or use the block. In `TimedMetric` the return value of `measure` is the return
+value of the block.
+
+```ruby
+collection.each do |item|
+  result_of_do_something = timed_metric.measure { do_something( item ) }
+end
+```
+And then look at the stats
+
+```ruby
+puts timed_metric.mean
+puts timed_metric.max
+puts timed_metric.min
+puts timed_metric.stddev
+puts timed_metric.rate
+```
+### ValueMetric
+
+Use a `Hitimes::ValueMetric` to calculate statistics about measured samples.
+
+``` ruby
+value_metric = Hitimes::ValueMetric.new( 'size of thing' )
+loop do
+  # ... do stuff changing sizes of 'thing'
+  value_metric.measure( thing.size )
+  # ... do other stuff that may change size of thing
+end
+
+puts value_metric.mean
+puts value_metric.max
+puts value_metric.min
+puts value_metric.stddev
+puts value_metric.rate
+```
+
+### TimedValueMetric
+
+Use a `Hitimes::TimedValueMetric` to calculate statistics about batches of samples.
+
+``` ruby
+timed_value_metric = Hitimes::TimedValueMetric.new( 'batch times' )
+loop do 
+  batch = ... # get a batch of things
+  timed_value_metric.start
+  # .. do something with batch
+  timed_value_metric.stop( batch.size )
+end
+
+puts timed_value_metric.rate
+
+puts timed_value_metric.timed_stats.mean
+puts timed_value_metric.timed_stats.max
+puts timed_value_metric.timed_stats.min
+puts timed_value_metric.timed_stats.stddev
+
+puts timed_value_metric.value_stats.mean
+puts timed_value_metric.value_stats.max
+puts timed_value_metric.value_stats.min
+puts timed_value_metric.value_stats.stddev
+```
+
+### Implementation details
+
+Hitimes use the appropriate low-level system call for each operating system to
+get the highest granularity time increment possible. Generally this is
+nanosecond resolution, or whatever the hardware chip in the CPU supports.
+
+It currently supports any of the following systems:
+
+* any system with the POSIX call `clock_gettime()`
+* Mac OS X
+* Windows
+* JRuby
+
+## Support
+
+Hitimes is supported on whatever versions of ruby are currently supported.
+Hitimes also follows [semantic versioning](http://semver.org/).
+
+The current officially supported versions of Ruby are:
+
+* MRI Ruby (all platforms) 2.3 - 2.5
+* JRuby 9.1.17.0, 9.2.0.0
+
+Unofficially supported versions, these have been supported in the past when they
+were the primary rubies around. In all likelihood they still work, but are not
+supported.
+
+* MRI Ruby (linux/mac/bsd/unix/etc) - everything from 1.8.7 to 2.2
+* MRI Ruby (windows) - 2.0 and up
+  * Ruby 1.8 and 1.9 for windows are supported in hitimes version 1.2.4 or earlier
+* JRuby - I think everything back to 1.4
+* Rubinius
+
+## Contributing
+
+Please read the [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## Credits
+
+* [Bruce Williams](https://github.com/bruce) for suggesting the idea
+
+## License
+
+Hitimes is licensed under the [ISC](https://opensource.org/licenses/ISC)
+license.
+
+Copyright (c) 2008-2016 Jeremy Hinegardner
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.