miniprof 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a58f4c04b94083b464628ef5086602a6243e44b2
+  data.tar.gz: 0376251c8eb208b8cfee5538e7dcdbd200f09dbb
+SHA512:
+  metadata.gz: 39fc1340fcd198452f8f7d60c75275f355d038cd77909577ecd68c3707a4ac412e2d331b8b341dd762bff148c810eb68b715f5d02cec74233f0b82d77719aa59
+  data.tar.gz: 34359ca90878712c81702cf456943c523d8365205890d36076411531be72460a5ec81976310372406fd8d1c09cabdf8264c0d0a5ff97dc6b4eec42196c848b8f

checksums.yaml.gz.asc

@@ -0,0 +1,12 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG/MacGPG2 v2.0.19 (Darwin)
+Comment: GPGTools - http://gpgtools.org
+
+iQEcBAABCgAGBQJS2F0HAAoJEP5F5V2hilTWnPoIAK2AOUsnInA5QeYp81zUkWk7
+H1O5Jo+zNBfi0NvWRt8/AtUAFjOD4v1aN3zYsX2E/PM1DQytgGovvGbPNSVdObr4
+tYuwdpiLrk9eCfTkgzOg8WZSr96sXOSyhmFlhwNrDF4/67jR+1yNGDsd6s8LWTxK
+HaH+aQMt85DnrUiZEkiH5qaSc6NOUoi3AqNn2kcnHqEAf1E7A255L0NjKkd0YQIE
+KZIqRPpU2R5O7myCLxnol4wJhrgLsdxRowX3wfMLcQgIbJSjNIV0p/8lKUMImlED
+zt7QAJlPdsGI9nFs4V2n1ztt8Mar7fOKuJUQBm/mPunjzsujMwcxu+jkcIZJZn8=
+=PVzU
+-----END PGP SIGNATURE-----

data.tar.gz.asc

@@ -0,0 +1,12 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG/MacGPG2 v2.0.19 (Darwin)
+Comment: GPGTools - http://gpgtools.org
+
+iQEcBAABCgAGBQJS2F0HAAoJEP5F5V2hilTW3TQH/RPwrf4tYAGxtF8jDX6B1ZcC
+HWUMNPZXtK2aOOqSDSWAMkKCVZ6dXhhushfzCCtXplX/UkLioOHebxHGeDWOUyp0
+0bo7AWNeWFeE4iN00AObF93z5SjWvbQ7IKo3R69evzjg1J1zevYEW9VzhRtw5En/
+oS0pai9ihffluMMlv5ibKISbn+4ZXAjd+T3/OcVop757hz5ffF/jdc2InywZrcOR
+EwABCKqXenlCCiZB+WsScfxGxMWpZao9IBxX8tDDJPWzioy9nbCI5/nRvJwtILuQ
+1BEJdZXpOYTIYXOY86ia3heak+oMa/f7WdAnVwQa69QbyWFnuF8qRhprBWgkl3s=
+=55h8
+-----END PGP SIGNATURE-----

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in miniprof.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,31 @@
+Copyright (c) 2012-2014 Grant T. Olson
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+
+    * Neither the name of the Grant T. Olson nor the names of
+      additional contributors may be used to endorse or promote
+      products derived from this software without specific prior
+      written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,64 @@
+MiniProf
+========
+
+A quick-and-dirty lightweight profiler that allows you to measure
+the various steps in walltime.  The main benefit of this is that it
+is much easier to control and interpret the output than raw
+profiling data which can overwhelm you.
+
+Calling MiniProf.profile returns a block containing a MiniProf
+instance.  This instance will record the time for each step when you
+feed in a step description via the << operator.
+
+This tool is indented for development only.  We probably don't ever
+want to commit active MiniProf code and/or release it to production.
+
+Sample usage
+------------
+
+    johnmudhead:pikimal grant$ cat mini_prof_test.rb 
+    def test_method
+      MiniProf.profile do |tick|
+        #simulated possibly long operation
+        sleep 1
+        tick << "Step one complete"
+    
+        # simulated really long operation
+        sleep 5
+        tick << "Step two complete"
+      end
+    end
+  
+    test_method
+    johnmudhead:pikimal grant$ rails console < mini_prof_test.rb 
+    Loading development environment (Rails 3.0.7)
+
+    ...
+
+    Tick: (0 ms since last, 0 ms since start) Started mini_prof...
+    Tick: (1000 ms since last, 1000 ms since start) Step one complete
+    Tick: (5000 ms since last, 6000 ms since start) Step two complete
+    Tick: (0 ms since last, 6000 ms since start) Ended mini_prof...
+     => nil 
+    ruby-1.9.2-p0 > 
+
+### Verifying the software
+
+The gem is signed with
+[rubygems-openpgp](https://github.com/grant-olson/rubygems-openpgp).
+Assuming you have rubygems-openpgp configured, you can verify the
+software:
+
+    gem install bmf --verify
+
+More details are available at the [rubygems-openpgp project
+page](https://github.com/grant-olson/rubygems-openpgp).
+
+Signing Key:
+
+    pub   2048R/E3B5806F 2010-01-11 [expires: 2014-01-03]
+          Key fingerprint = A530 C31C D762 0D26 E2BA  C384 B6F6 FFD0 E3B5 806F
+    uid                  Grant T. Olson (Personal email) <kgo at grant-olson dot net>
+    sub   2048R/6A8F7CF6 2010-01-11 [expires: 2014-01-03]
+    sub   2048R/A18A54D6 2010-03-01 [expires: 2014-01-03]
+    sub   2048R/D53982CE 2010-08-31 [expires: 2014-01-03]

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/miniprof.rb

@@ -0,0 +1,56 @@
+require "miniprof/version"
+
+class MiniProf
+  # Get the seconds since epoch.  using to_f provides sub-second
+  # accuracy
+  def seconds_since_epoch
+    Time.now.to_f
+  end
+
+  # Initialize the profiler
+  #
+  # The optional marker will prefix each message, so you can
+  # distingish the output of multiple profilers.
+  def initialize marker="", opts={}
+    @start_time = seconds_since_epoch
+    @last_tick_time = @start_time
+    @marker = marker
+    @enabled = true
+    @enabled = opts[:enabled] if opts.has_key?(:enabled)
+  end
+
+  # Main loop
+  def profile &block
+    self.<< "Started mini_prof..."
+    return_value = yield self
+    self.<< "Ended mini_prof..."
+    return return_value
+  end
+  
+  def seconds_to_ms seconds
+    (seconds * 1000).to_i
+  end
+
+  # Print out a mesage indicating how long it's been since the last
+  # step and since the start of profiling
+  def << msg
+    return if @enabled == false
+
+    new_time = seconds_since_epoch
+    since_start = seconds_to_ms(new_time - @start_time)
+    since_last = seconds_to_ms(new_time - @last_tick_time)
+    @last_tick_time = new_time
+
+    msg = "Tick: (#{since_last} ms since last, #{since_start} ms since start) #{msg}"
+    msg = @marker + " " + msg if !@marker.empty?
+    puts msg
+  end
+  
+  # Create a profiler object and execute it.  The optional marker will
+  # print at the beginning of each line of output.
+  def self.profile marker="",opts={}, &block
+    mp = MiniProf.new marker, opts
+    mp.profile &block
+  end
+  
+end

data/lib/miniprof/version.rb

@@ -0,0 +1,3 @@
+class MiniProf
+  VERSION = "1.0.0"
+end

data/miniprof.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'miniprof/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "miniprof"
+  spec.version       = MiniProf::VERSION
+  spec.authors       = ["Grant T. Olson"]
+  spec.email         = ["kgo@grant-olson.net"]
+  spec.summary       = %q{Simple tool to assist with manual profiling}
+  spec.homepage      = ""
+  spec.license       = "BSD"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: miniprof
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Grant T. Olson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- kgo@grant-olson.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/miniprof.rb
+- lib/miniprof/version.rb
+- miniprof.gemspec
+homepage: ''
+licenses:
+- BSD
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0
+signing_key: 
+specification_version: 4
+summary: Simple tool to assist with manual profiling
+test_files: []

metadata.gz.asc

@@ -0,0 +1,12 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG/MacGPG2 v2.0.19 (Darwin)
+Comment: GPGTools - http://gpgtools.org
+
+iQEcBAABCgAGBQJS2F0HAAoJEP5F5V2hilTW3SkIAIk9E7k5BS+55QdrZ9EPigvR
+L7dPnOBgU1RhSggrjBAzbT6MxHAj/VrkdhQoSN841jQP/3owWcf6Y+qAqfjqjKeX
+1gr/3TMFfVfb/SHTEqmkdzhz0xBf/QsLfkRYwDBk4FW9JrwfYx8AHD3CBM/0AacA
+gENpwkpXmdMSmZHUkR1GBre1REwc+rV5ZtS2NEMx49ri9kq0jV9sn4XJ1d8D7R9R
+X32r22in+GiXbZsyhqE5t1oEjZ37Uxt2cTWQX6NtUCzwBnuksyCbY84FZ0SV/89/
+HvLOnFOD7VnCpdEi14no/3B/fpeEbdlI4CwMDkOaHLF9NoDeGQ1tVS+oF4LpMwo=
+=Cfp0
+-----END PGP SIGNATURE-----