cutter 0.0.3 → 0.5.0

data/README.rdoc

@@ -1,30 +1,47 @@
 = cutter
 
-For now it is two-methods-gem, I use a lot for simple debugging & performance measuring purposes.
-
+For now it is two-methods-gem I use a lot for simple debugging & performance measuring purposes.
 Include it into Gemfile:
-gem 'cutter'
+  gem 'cutter'
 
 Methods are:
 
-I) As inspect! method to any of your methods:
-  def your_method *args
-    inspect!(local_variables,binding) # this string exactly!    
+==I) #inspect! 
+
+Insert #inspect! method into any of your methods:
+  def your_method *your_args
+    inspect! {} # this string exactly!    
     ...
   end
-  
+
   your_method(1,"foo",:bar) => 
     method `your_method'
       variables: 
         args: [1, "foo", :bar]
 
+or in more rigorous way:
+
+  def your_another_method(first, second, third, &block)
+    inspect!(binding)
+  end
+  
+  your_another_method(1,"foo",:bar) => 
+    method `your_another_method'
+      variables: 
+        first: 1
+        second: "foo"
+        third: :bar
+        block: 
+
 
-Gives simple but nice trace for inspection: method's name, local_variables(they include args passed to method)
+Gives simple but nice trace for inspection: method's name and args that were passed to method
 
 If you want all #inspect! methods fall silent at once, use
-    Cutter::Inspection.quiet!
+  Cutter::Inspection.quiet!
+To make them sound again do
+  Cutter::Inspection.loud!
 
-II) 
+==II) #stamper
     def your_method
       stamper("testing pieces of code") do
         piece_of_code #1
@@ -50,8 +67,8 @@ II)
       }
     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.
+Acts as self.benchmark{} (in Rails) or Benchmark.measure{} (common Ruby) but with stamps in any position in block executed.
+It is much simpler to write it quickly than all these Measure-dos.
 
 == Contributing to cutter
  
@@ -65,6 +82,6 @@ to write it quickly than all these Measure-dos.
 
 == Copyright
 
-Copyright (c) 2011 stanislaw. See LICENSE.txt for
+Copyright (c) 2011 Stanislaw Pankevich. See LICENSE.txt for
 further details.
 

data/lib/cutter/inspection.rb

@@ -1,12 +1,14 @@
 module Cutter
   class Inspection
-    attr_accessor :quiet
-
     class << self
       def quiet!
         @quiet = true
       end
 
+      def loud!
+        @quiet = nil
+      end
+
       def quiet?
         @quiet
       end
@@ -18,16 +20,20 @@ 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
+  def inspect! _binding = nil, &block
     return true if Cutter::Inspection.quiet?
-    puts "method: `#{caller[0][/`([^']*)'/,1]}'"
+    raise "Try binding as argument or wrap method content into block!" if (!block_given?&&!_binding)
+    _binding ||= block.binding
+    puts "method: `#{caller_method_name}'"
     puts %{  variables:} 
-    _local_variables.map do |lv|
-      puts %{    #{lv}: #{_binding.eval(lv.to_s)} } 
+    eval('local_variables',_binding).map do |lv|
+      puts %{    #{lv}: #{eval(lv.to_s, _binding)} } 
     end
+    yield if block_given?
   end
 
-  def test_inspector
-    puts "Cutter is working..."
+  def caller_method_name(level = 1)
+    caller[level][/`([^']*)'/,1].to_sym
   end
+
 end

metadata

@@ -2,7 +2,7 @@
 name: cutter
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.0.3
+  version: 0.5.0
 platform: ruby
 authors: 
 - stanislaw
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-06-22 00:00:00 +03:00
+date: 2011-07-15 00:00:00 +03:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -109,7 +109,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 301476861
+      hash: 951765971
       segments: 
       - 0
       version: "0"