cutter 0.0.2 → 0.0.3

data/README.rdoc

@@ -1,6 +1,57 @@
 = cutter
 
-Description goes here.
+For now it is two-methods-gem, I use a lot for simple debugging & performance measuring purposes.
+
+Include it into Gemfile:
+gem 'cutter'
+
+Methods are:
+
+I) As inspect! method to any of your methods:
+  def your_method *args
+    inspect!(local_variables,binding) # this string exactly!    
+    ...
+  end
+  
+  your_method(1,"foo",:bar) => 
+    method `your_method'
+      variables: 
+        args: [1, "foo", :bar]
+
+
+Gives simple but nice trace for inspection: method's name, local_variables(they include args passed to method)
+
+If you want all #inspect! methods fall silent at once, use
+    Cutter::Inspection.quiet!
+
+II) 
+    def your_method
+      stamper("testing pieces of code") do
+        piece_of_code #1
+        stamp("piece #1 performed!")
+        piece_of_code #2
+        stamp("piece #2 performed!")
+        pirce_of_code #3
+      end
+    end
+
+    your_method => 
+    ~ testing pieces of code 
+    ~ testing: start
+    ~ testing: piece #1 performed!, 10ms
+    ~ testing: piece #2 performed!, 231ms
+    ~ testing: end (247ms)
+
+    
+    or simply:
+    def test_method
+      stamper {
+        piece of code
+      }
+    end
+
+Acts as self.benchmark{} or Benchmark.measure{} but with stamps in any position in block executed, and it is much simpler 
+to write it quickly than all these Measure-dos.
 
 == Contributing to cutter
  

data/lib/cutter.rb

@@ -1,3 +1,3 @@
 require 'cutter/railtie' if defined?(Rails)
-require 'cutter/inspector'
+require 'cutter/inspection'
 require 'cutter/stamper'

data/lib/cutter/{inspector.rb → inspection.rb}

@@ -1,9 +1,25 @@
-class Object
+module Cutter
+  class Inspection
+    attr_accessor :quiet
+
+    class << self
+      def quiet!
+        @quiet = true
+      end
 
+      def quiet?
+        @quiet
+      end
+    end
+  end
+end
+
+class Object
   # For now inspect! method only may be used with two arguments (local_variables, binding)
   # Binding is a Ruby class: http://www.ruby-doc.org/core/classes/Binding.html
   
   def inspect! _local_variables, _binding
+    return true if Cutter::Inspection.quiet?
     puts "method: `#{caller[0][/`([^']*)'/,1]}'"
     puts %{  variables:} 
     _local_variables.map do |lv|

data/lib/cutter/stamper.rb

@@ -8,7 +8,7 @@ class Object
       time_passed = time_now - @time_initial
       puts("~ testing: #{message}, #{time_passed}ms")
     end
-    puts("  #{message}")
+    puts("~ #{message}")
     puts("~ testing: start")
     @time_initial = time_now
     yield

metadata

@@ -2,7 +2,7 @@
 name: cutter
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors: 
 - stanislaw
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-06-09 00:00:00 +03:00
+date: 2011-06-22 00:00:00 +03:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -90,7 +90,7 @@ extra_rdoc_files:
 - README.rdoc
 files: 
 - lib/cutter.rb
-- lib/cutter/inspector.rb
+- lib/cutter/inspection.rb
 - lib/cutter/railtie.rb
 - lib/cutter/stamper.rb
 - LICENSE.txt
@@ -109,7 +109,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: -962111089
+      hash: 301476861
       segments: 
       - 0
       version: "0"