clockblock 0.0.1 → 0.0.2

data/README.md

@@ -1,4 +1,93 @@
-clockblock
+ClockBlock
 ==========
 
-Wrap your code in a Clock Block to measure execution duration.
+Wrap your code in a Clock Block to measure execution duration.
+
+````ruby
+require 'clockblock'
+
+class Foo
+  extend Clockblock::Timing
+
+  def bar
+    sleep 2
+  end
+  add_timing_to :bar
+
+end
+
+f = Foo.new
+f.bar
+
+f.clockblock_timers
+# => {:bar=>{:started_at=>2012-07-26 16:04:03 -0400, :finished_at=>2012-07-26 16:04:05 -0400, :duration=>2.001059, :stage=>:finished}}
+
+````
+
+````ruby
+require 'clockblock'
+
+class Foo
+  def bar
+    sleep 2
+  end
+end
+
+f = Foo.new
+f.extend Clockblock::Timing
+f.add_timing_to :bar
+f.bar
+
+f.clockblock_timers
+# => {:bar=>{:started_at=>2012-07-26 16:04:03 -0400, :finished_at=>2012-07-26 16:04:05 -0400, :duration=>2.001059, :stage=>:finished}}
+
+````
+
+````ruby
+class Foo1
+  extend Clockblock::Timing
+  add_timing_to :baz
+
+  def bar
+    sleep 1
+  end
+  add_timing_to :bar
+
+  def baz
+    sleep 1
+  end
+end
+
+class Foo2
+  def bar
+    sleep 1
+  end
+end
+
+class Foo3
+  def bar
+    sleep 1
+  end
+end
+
+f1 = Foo1.new
+f1.bar
+puts f1.clockblock_timers
+puts Foo1.instance_variable_get(:@future_timer_methods)
+
+f2 = Foo2.new
+f2.extend Clockblock::Timing
+f2.add_timing_to :bar, :baz
+f2.bar
+puts f2.clockblock_timers
+puts f2.instance_variable_get(:@future_timer_methods)
+
+Foo3.extend Clockblock::Timing
+Foo3.add_timing_to :bar, :baz
+puts Foo3.instance_variable_get(:@future_timer_methods)
+class Foo3; def baz; sleep 1; end; end
+f3 = Foo3.new
+f3.bar
+f3.baz
+puts f3.clockblock_timers
+````

data/lib/clockblock.rb

@@ -1,5 +1,6 @@
 require "clockblock/version"
 require "clockblock/timer"
+require "clockblock/timing"
 
 module Clockblock
   # Your code goes here...

data/lib/clockblock/timing.rb

@@ -0,0 +1,50 @@
+module Clockblock
+  module Timing
+
+    module ClassMethods
+      def add_timing_to *methods
+        methods.each do |method|
+          klass = self.is_a?(Class) ? self : (class << self; self; end)
+          if klass.method_defined? method
+            add_timing_to_method method, klass
+          else
+            @future_timer_methods ||= []
+            @future_timer_methods << method
+          end
+        end
+      end
+
+      def add_timing_to_method(method, klass)
+        stashed_method = "#{method}_stashed_by_clockblock".to_sym
+        klass.class_eval do
+          alias_method stashed_method, method
+          define_method method do |*args, &block|
+            @clockblock_timers ||= {}
+            @clockblock_timers[method] = Clockblock::Timer.new
+
+            @clockblock_timers[method].clock(method) do
+              send stashed_method, *args, &block
+            end
+          end
+        end
+      end
+
+      def method_added(method)
+        if @future_timer_methods && @future_timer_methods.include?(method)
+          unless @added_by_clockblock
+            @added_by_clockblock = true
+            klass = self.is_a?(Class) ? self : (class << self; self; end)
+            add_timing_to_method method, klass
+          end
+          @added_by_clockblock = false
+        end
+      end
+    end
+
+    def self.extended(base)
+      (base.is_a?(Class) ? base : base.class).send :attr_accessor, :clockblock_timers, :future_timer_methods
+      base.send :extend, ClassMethods
+    end
+
+  end
+end

data/lib/clockblock/version.rb

@@ -1,3 +1,3 @@
 module Clockblock
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: clockblock
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-26 00:00:00.000000000 Z
+date: 2012-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70101676678120 !ruby/object:Gem::Requirement
+  requirement: &70341854789020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70101676678120
+  version_requirements: *70341854789020
 - !ruby/object:Gem::Dependency
   name: minitest
-  requirement: &70101676677580 !ruby/object:Gem::Requirement
+  requirement: &70341854773700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70101676677580
+  version_requirements: *70341854773700
 - !ruby/object:Gem::Dependency
   name: turn
-  requirement: &70101676676840 !ruby/object:Gem::Requirement
+  requirement: &70341854772740 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,7 +43,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70101676676840
+  version_requirements: *70341854772740
 description: Enables easy and DRY code timing capabilities.
 email:
 - jack.ross@technekes.com
@@ -59,6 +59,7 @@ files:
 - clockblock.gemspec
 - lib/clockblock.rb
 - lib/clockblock/timer.rb
+- lib/clockblock/timing.rb
 - lib/clockblock/version.rb
 - spec/lib/clockblock/timer_spec.rb
 - spec/spec_helper.rb
@@ -82,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.15
+rubygems_version: 1.8.17
 signing_key: 
 specification_version: 3
 summary: Wrap your code in a Clock Block to measure execution duration.