rubybreaker 0.0.6 → 0.0.7

data/webpage/tutorial.html

@@ -40,7 +40,7 @@ to use RubyBreaker in a Rakefile later.</p>
 
 <p>The above command runs RubyBreaker in verbose mode (<code>-v</code>) and will display
 the output on the screen (<code>-s</code>). Before RubyBreaker runs <code>prog.rb</code>, it will
-import (<code>-l</code>) <code>lib.rb</code> and instrument (<code>-b</code>) classes <code>A</code> and <code>B</code>.
+import (<code>-l</code>) <code>lib.rb</code> and <em>break</em> (<code>-b</code>) classes <code>A</code> and <code>B</code>.
 Here is <code>lib.rb</code>:</p>
 
 <pre><code>class A
@@ -95,7 +95,7 @@ obtain precise and accurate type information.</p>
 <h3>Using Ruby Unit Testing Framework</h3>
 
 <p>Instead of manually inserting the entry point indicator in the source
-program, you can take advantage of Ruby's built-in testing framework. This
+program, you can take advantage of Ruby&rsquo;s built-in testing framework. This
 is preferred to modifying the source program directly, especially for the
 long term program maintainability. But no worries! This method is as simple
 as the previous one.</p>
@@ -111,7 +111,7 @@ class TestClassA &lt; Test::Unit::TestCase
 end
 </code></pre>
 
-<p>That's it! The only requirements are to indicate to RubyBreaker which modules
+<p>That&rsquo;s it! The only requirements are to indicate to RubyBreaker which modules
 and classes to "break" and to place <code>require rubybreaker</code> <em>after</em>
 <code>require test/unit</code>.</p>
 
@@ -152,7 +152,7 @@ end
 <p>Note that <code>RubyBrakerTestTask</code> can simply replace your <code>TestTask</code> block in
 Rakefile. In fact, the former is a subclass of the latter and includes all
 features supported by the latter. The only additional options are
-<code>rubybreaker_opts</code> which is RubyBreaker's command-line options and
+<code>rubybreaker_opts</code> which is RubyBreaker command-line options and
 <code>break</code> which specifies which modules and classes to monitor.  Since
 <code>Class1</code> and <code>Class2</code> are not <em>recognized</em> by this Rakefile, you must use
 string literals to specify modules and classes (and with full namespace).</p>
@@ -213,7 +213,7 @@ precise return type.</p>
 
 <h3>Duck Type</h3>
 
-<p>This type is inspired by the Ruby Language's duck typing, <em>"if it
+<p>This type is inspired by the Ruby Language&rsquo;s duck typing, <em>"if it
 walks like a duck and quacks like a duck, it must be a duck."</em> Using this
 type, an object can be represented simply by a list of method names. For
 example <code>[walks, quacks]</code> is an object that has <code>walks</code> and <code>quacks</code>
@@ -260,7 +260,7 @@ suffices, <code>?</code> and <code>*</code>, respectively.</p>
 
 <h3>Block Type</h3>
 
-<p>One of the Ruby's prominent features is the block argument. It allows
+<p>One of the Ruby&rsquo;s prominent features is the block argument. It allows
 the caller to pass in a piece of code to be executed inside the callee. This
 code block can be executed by the Ruby construct, <code>yield</code>, or by directly
 calling the <code>call</code> method of the block object. In RubyBreaker, this type can
@@ -293,7 +293,7 @@ end
 </code></pre>
 
 <p>There is no way to document the type of <code>foo</code> without using a method list
-type. Let's try to give a method type to <code>foo</code> without a method list. The
+type. Let&rsquo;s try to give a method type to <code>foo</code> without a method list. The
 closest we can come up with would be <code>foo(fixnum or string) -&gt; fixnum and
 string</code>. But RubyBreaker does not have the "and" type in the type annotation
 language because it gives me an headache! (By the way, it needs to be an
@@ -319,6 +319,35 @@ automatically documenting such a type, RubyBreaker looks for the (subtyping)
 compatibility between the return types and "promote" the method type to a
 method list type by spliting the type signature into two (or more in
 subsequent "promotions").</p>
+
+<h3>Early Dynamic Type Checking</h3>
+
+<p>RubyBreaker gives you an option to run the early dynamic type check. If a
+method is documented and its module is specified to be <em>type checked</em>, then
+RubyBreaker will verify if the argument types and the return type are
+appropriate at runtime. To allow this feature in command-line, use <code>-c</code>
+(checking) option:</p>
+
+<pre><code>rubybreaker -l lib.rb -c A prog.rb
+</code></pre>
+
+<p>Or use it in Rakefile:</p>
+
+<pre><code>require "rubybreaker/task"
+...
+desc "Run RubyBreaker"
+Rake::RubyBreakerTestTask.new(:"rubybreaker") do |t|
+  t.libs &lt;&lt; "lib" 
+  t.test_files = ["test/foo/tc_foo1.rb"]
+  # ...Other test task options..
+  t.rubybreaker_opts &lt;&lt; "-v"           # run in verbose mode
+  t.break = ["Class1", "Class2", ...]  # specify classes to monitor
+  t.check = ["Class3", ....] # specify classes to check
+end
+</code></pre>
+
+<p>Alternatively, you can use <code>RubyBreaker.check()</code> to specify classes to type
+check in the setup code of the test case.</p>
     <hr />
 		<center style="font-size:smaller; padding:0px;">
 			Copyright (C) 2012 Jong-hoon (David) An. All Rights Reserved.<br />

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubybreaker
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-23 00:00:00.000000000 Z
+date: 2012-06-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: treetop
@@ -27,11 +27,11 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: RubyBreaker is a dynamic type documentation tool for Ruby. It dynamically
-  instruments code, monitors objects during execution, and generates type documentation
-  based on the profiled information. In other words, RubyBreaker "breaks" Ruby code
-  out of its obscurity and wildness (as in "code breaking" or "horse breaking") by
-  auto-documenting type information.
+description: RubyBreaker is a dynamic type documentation/checking tool for Ruby. It
+  dynamically instruments code, monitors objects during execution, performs dynamic
+  type checking, and generates type documentation based on the profiled information.
+  In other words, RubyBreaker "breaks" Ruby code out of its obscurity and wildness
+  (as in "code breaking" or "horse breaking") by auto-documenting type information.
 email: rubybreaker@gmail.com
 executables:
 - rubybreaker
@@ -81,6 +81,7 @@ files:
 - TUTORIAL.md
 - VERSION
 - test/integrated/tc_both_documented_and_undocumented.rb
+- test/integrated/tc_checking.rb
 - test/integrated/tc_class_methods.rb
 - test/integrated/tc_inherit_broken.rb
 - test/integrated/tc_method_missing.rb
@@ -164,7 +165,6 @@ files:
 - webpage/rdoc/RubyBreaker/Runtime/Monitor.html
 - webpage/rdoc/RubyBreaker/Runtime/MonitorInstaller.html
 - webpage/rdoc/RubyBreaker/Runtime/MonitorSwitch.html
-- webpage/rdoc/RubyBreaker/Runtime/MonitorUtils.html
 - webpage/rdoc/RubyBreaker/Runtime/ObjectWrapper.html
 - webpage/rdoc/RubyBreaker/Runtime/Pluggable.html
 - webpage/rdoc/RubyBreaker/Runtime/TypeSigParser.html
@@ -202,9 +202,6 @@ licenses:
 post_install_message: 
 rdoc_options:
 - README.md
-- TUTORIAL.md
-- TOPICS.md
-- ABOUT.md
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement

data/webpage/rdoc/RubyBreaker/Runtime/MonitorUtils.html

@@ -1,402 +0,0 @@
-<!DOCTYPE html>
-
-<html>
-<head>
-<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
-
-<title>module RubyBreaker::Runtime::MonitorUtils - RDoc Documentation</title>
-
-<link type="text/css" media="screen" href="../../rdoc.css" rel="stylesheet">
-
-<script type="text/javascript">
-  var rdoc_rel_prefix = "../../";
-</script>
-
-<script type="text/javascript" charset="utf-8" src="../../js/jquery.js"></script>
-<script type="text/javascript" charset="utf-8" src="../../js/navigation.js"></script>
-<script type="text/javascript" charset="utf-8" src="../../js/search_index.js"></script>
-<script type="text/javascript" charset="utf-8" src="../../js/search.js"></script>
-<script type="text/javascript" charset="utf-8" src="../../js/searcher.js"></script>
-<script type="text/javascript" charset="utf-8" src="../../js/darkfish.js"></script>
-
-
-<body id="top" class="module">
-<nav id="metadata">
-  <nav id="home-section" class="section">
-  <h3 class="section-header">
-    <a href="../../index.html">Home</a>
-    <a href="../../table_of_contents.html#classes">Classes</a>
-    <a href="../../table_of_contents.html#methods">Methods</a>
-  </h3>
-</nav>
-
-
-  <nav id="search-section" class="section project-section" class="initially-hidden">
-  <form action="#" method="get" accept-charset="utf-8">
-    <h3 class="section-header">
-      <input type="text" name="search" placeholder="Search" id="search-field"
-             title="Type to search, Up and Down to navigate, Enter to load">
-    </h3>
-  </form>
-
-  <ul id="search-results" class="initially-hidden"></ul>
-</nav>
-
-
-  <div id="file-metadata">
-    <nav id="file-list-section" class="section">
-  <h3 class="section-header">Defined In</h3>
-  <ul>
-    <li>lib/rubybreaker/runtime/monitor.rb
-  </ul>
-</nav>
-
-    
-  </div>
-
-  <div id="class-metadata">
-    
-    
-    
-    <!-- Method Quickref -->
-<nav id="method-list-section" class="section">
-  <h3 class="section-header">Methods</h3>
-
-  <ul class="link-list">
-    
-    <li><a href="#method-c-get_alt_meth_name">::get_alt_meth_name</a>
-    
-    <li><a href="#method-c-get_orig_meth_name">::get_orig_meth_name</a>
-    
-    <li><a href="#method-c-route">::route</a>
-    
-  </ul>
-</nav>
-
-  </div>
-
-  <div id="project-metadata">
-    
-    <nav id="classindex-section" class="section project-section">
-  <h3 class="section-header">Class and Module Index</h3>
-
-  <ul class="link-list">
-  
-    <li><a href="../../RubyBreaker.html">RubyBreaker</a>
-  
-    <li><a href="../../RubyBreaker/Breakable.html">RubyBreaker::Breakable</a>
-  
-    <li><a href="../../RubyBreaker/Broken.html">RubyBreaker::Broken</a>
-  
-    <li><a href="../../RubyBreaker/Context.html">RubyBreaker::Context</a>
-  
-    <li><a href="../../RubyBreaker/Errors.html">RubyBreaker::Errors</a>
-  
-    <li><a href="../../RubyBreaker/Errors/InternalError.html">RubyBreaker::Errors::InternalError</a>
-  
-    <li><a href="../../RubyBreaker/Errors/InvalidSubtypeCheck.html">RubyBreaker::Errors::InvalidSubtypeCheck</a>
-  
-    <li><a href="../../RubyBreaker/Errors/InvalidTypeConstruction.html">RubyBreaker::Errors::InvalidTypeConstruction</a>
-  
-    <li><a href="../../RubyBreaker/Errors/SubtypeFailure.html">RubyBreaker::Errors::SubtypeFailure</a>
-  
-    <li><a href="../../RubyBreaker/Errors/TypeError.html">RubyBreaker::Errors::TypeError</a>
-  
-    <li><a href="../../RubyBreaker/Errors/UserError.html">RubyBreaker::Errors::UserError</a>
-  
-    <li><a href="../../RubyBreaker/ObjectPosition.html">RubyBreaker::ObjectPosition</a>
-  
-    <li><a href="../../RubyBreaker/Position.html">RubyBreaker::Position</a>
-  
-    <li><a href="../../RubyBreaker/RDocSupport.html">RubyBreaker::RDocSupport</a>
-  
-    <li><a href="../../RubyBreaker/RubyTypeUtils.html">RubyBreaker::RubyTypeUtils</a>
-  
-    <li><a href="../../RubyBreaker/Runtime.html">RubyBreaker::Runtime</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/Inspector.html">RubyBreaker::Runtime::Inspector</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/MethodInfo.html">RubyBreaker::Runtime::MethodInfo</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/Monitor.html">RubyBreaker::Runtime::Monitor</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/MonitorInstaller.html">RubyBreaker::Runtime::MonitorInstaller</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/MonitorSwitch.html">RubyBreaker::Runtime::MonitorSwitch</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/MonitorUtils.html">RubyBreaker::Runtime::MonitorUtils</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/ObjectWrapper.html">RubyBreaker::Runtime::ObjectWrapper</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/Pluggable.html">RubyBreaker::Runtime::Pluggable</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/TypeSigParser.html">RubyBreaker::Runtime::TypeSigParser</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/TypeSigUnparser.html">RubyBreaker::Runtime::TypeSigUnparser</a>
-  
-    <li><a href="../../RubyBreaker/Runtime/TypeSystem.html">RubyBreaker::Runtime::TypeSystem</a>
-  
-    <li><a href="../../RubyBreaker/TypeComparer.html">RubyBreaker::TypeComparer</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs.html">RubyBreaker::TypeDefs</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/AnyType.html">RubyBreaker::TypeDefs::AnyType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/BlockType.html">RubyBreaker::TypeDefs::BlockType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/DuckType.html">RubyBreaker::TypeDefs::DuckType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/FusionType.html">RubyBreaker::TypeDefs::FusionType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/MethodListType.html">RubyBreaker::TypeDefs::MethodListType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/MethodType.html">RubyBreaker::TypeDefs::MethodType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/NilType.html">RubyBreaker::TypeDefs::NilType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/NominalType.html">RubyBreaker::TypeDefs::NominalType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/OptionalType.html">RubyBreaker::TypeDefs::OptionalType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/OrType.html">RubyBreaker::TypeDefs::OrType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/SelfType.html">RubyBreaker::TypeDefs::SelfType</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/Type.html">RubyBreaker::TypeDefs::Type</a>
-  
-    <li><a href="../../RubyBreaker/TypeDefs/VarLengthType.html">RubyBreaker::TypeDefs::VarLengthType</a>
-  
-    <li><a href="../../RubyBreaker/TypeUnparser.html">RubyBreaker::TypeUnparser</a>
-  
-    <li><a href="../../RubyBreaker/Typing.html">RubyBreaker::Typing</a>
-  
-    <li><a href="../../RubyBreaker/Util.html">RubyBreaker::Util</a>
-  
-    <li><a href="../../Rake.html">Rake</a>
-  
-    <li><a href="../../Rake/RubyBreakerTestTask.html">Rake::RubyBreakerTestTask</a>
-  
-    <li><a href="../../Test.html">Test</a>
-  
-    <li><a href="../../Test/Unit.html">Test::Unit</a>
-  
-    <li><a href="../../Object.html">Object</a>
-  
-  </ul>
-</nav>
-
-  </div>
-</nav>
-
-<div id="documentation">
-  <h1 class="module">module RubyBreaker::Runtime::MonitorUtils</h1>
-
-  <div id="description" class="description">
-    
-<p>This module contains helper methods for monitoring objects and modules.</p>
-
-  </div><!-- description -->
-
-  
-  
-  
-  <section id="5Buntitled-5D" class="documentation-section">
-    
-
-    
-
-    
-
-    
-
-    <!-- Methods -->
-    
-     <section id="public-class-5Buntitled-5D-method-details" class="method-section section">
-      <h3 class="section-header">Public Class Methods</h3>
-
-    
-      <div id="method-c-get_alt_meth_name" class="method-detail ">
-        
-        <div class="method-heading">
-          <span class="method-name">get_alt_meth_name</span><span
-            class="method-args">(meth_name)</span>
-          <span class="method-click-advice">click to toggle source</span>
-        </div>
-        
-
-        <div class="method-description">
-          
-          <p>This method returns the alternative (renamed) method name</p>
-          
-
-          
-          <div class="method-source-code" id="get_alt_meth_name-source">
-            <pre><span class="ruby-comment"># File lib/rubybreaker/runtime/monitor.rb, line 171</span>
-<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">get_alt_meth_name</span>(<span class="ruby-identifier">meth_name</span>)
-  <span class="ruby-keyword">return</span> <span class="ruby-node">&quot;__#{meth_name}&quot;</span>
-<span class="ruby-keyword">end</span></pre>
-          </div><!-- get_alt_meth_name-source -->
-          
-        </div>
-
-        
-
-        
-      </div><!-- get_alt_meth_name-method -->
-
-    
-      <div id="method-c-get_orig_meth_name" class="method-detail ">
-        
-        <div class="method-heading">
-          <span class="method-name">get_orig_meth_name</span><span
-            class="method-args">(meth_name)</span>
-          <span class="method-click-advice">click to toggle source</span>
-        </div>
-        
-
-        <div class="method-description">
-          
-          <p>This method returns the original method name</p>
-          
-
-          
-          <div class="method-source-code" id="get_orig_meth_name-source">
-            <pre><span class="ruby-comment"># File lib/rubybreaker/runtime/monitor.rb, line 176</span>
-<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">get_orig_meth_name</span>(<span class="ruby-identifier">meth_name</span>)
-  <span class="ruby-keyword">return</span> <span class="ruby-identifier">meth_name</span>[<span class="ruby-value">2</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>]
-<span class="ruby-keyword">end</span></pre>
-          </div><!-- get_orig_meth_name-source -->
-          
-        </div>
-
-        
-
-        
-      </div><!-- get_orig_meth_name-method -->
-
-    
-      <div id="method-c-route" class="method-detail ">
-        
-        <div class="method-heading">
-          <span class="method-name">route</span><span
-            class="method-args">(obj,meth_name,*args,&blk)</span>
-          <span class="method-click-advice">click to toggle source</span>
-        </div>
-        
-
-        <div class="method-description">
-          
-          <p>This will do the actual routing work for a particular “monitored” method
-call.</p>
-<dl class="rdoc-list note-list"><dt>obj
-<dd>
-<p>is the object receiving the message; is never wrapped object</p>
-</dd><dt>meth_name
-<dd><dl class="rdoc-list note-list"><dt>is the original method name being called args
-<dd>
-<p>is a</p>
-</dd></dl>
-</dd><dt>list of arguments for the original method call blk
-<dd>
-<p>is the block</p>
-</dd></dl>
-
-<p>argument for the original method call</p>
-          
-
-          
-          <div class="method-source-code" id="route-source">
-            <pre><span class="ruby-comment"># File lib/rubybreaker/runtime/monitor.rb, line 99</span>
-<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">route</span>(<span class="ruby-identifier">obj</span>,<span class="ruby-identifier">meth_name</span>,*<span class="ruby-identifier">args</span>,&amp;<span class="ruby-identifier">blk</span>)
-
-  <span class="ruby-comment"># remember the switch mode before turning it off</span>
-  <span class="ruby-identifier">switch</span> = <span class="ruby-constant">GLOBAL_MONITOR_SWITCH</span>.<span class="ruby-identifier">switch</span>
-
-  <span class="ruby-comment"># turn off the monitor so we do not fall into an infinite loop</span>
-  <span class="ruby-constant">GLOBAL_MONITOR_SWITCH</span>.<span class="ruby-identifier">turn_off</span>()
-
-  <span class="ruby-comment"># use symbol instead of string throughout this code</span>
-  <span class="ruby-identifier">meth_name</span> = <span class="ruby-value">:&quot;#{meth_name}&quot;</span> 
-
-  <span class="ruby-comment"># first, get the context right</span>
-  <span class="ruby-comment"># notice the argument 2 to the caller!</span>
-  <span class="ruby-comment">#</span>
-  <span class="ruby-comment"># CONTEXT.push(obj, meth_name, </span>
-  <span class="ruby-comment">#              Position.convert_caller_to_pos(caller(2)))</span>
-  <span class="ruby-constant">CONTEXT</span>.<span class="ruby-identifier">push</span>(<span class="ruby-constant">Position</span>.<span class="ruby-identifier">convert_caller_to_pos</span>(<span class="ruby-identifier">caller</span>(<span class="ruby-value">2</span>)))
-
-  <span class="ruby-comment"># this is what the renamed method</span>
-  <span class="ruby-identifier">stub_meth_name</span> = <span class="ruby-identifier">get_alt_meth_name</span>(<span class="ruby-identifier">meth_name</span>) 
-
-  <span class="ruby-constant">RubyBreaker</span>.<span class="ruby-identifier">log</span>(<span class="ruby-node">&quot;Route to #{stub_meth_name}&quot;</span>, <span class="ruby-value">:debug</span>, <span class="ruby-constant">CONTEXT</span>)
-
-  <span class="ruby-comment"># short-circuit if switch was off--i.e., no monitoring</span>
-  <span class="ruby-keyword">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">switch</span>
-    <span class="ruby-identifier">retval</span> = <span class="ruby-identifier">obj</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">stub_meth_name</span>.<span class="ruby-identifier">to_sym</span>,*<span class="ruby-identifier">args</span>,&amp;<span class="ruby-identifier">blk</span>)
-    <span class="ruby-constant">CONTEXT</span>.<span class="ruby-identifier">pop</span>() <span class="ruby-comment"># do not forget to pop the context before returning</span>
-    <span class="ruby-keyword">return</span> <span class="ruby-identifier">retval</span>
-  <span class="ruby-keyword">end</span>
-
-  <span class="ruby-identifier">is_obj_mod</span> = (<span class="ruby-identifier">obj</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Class</span> <span class="ruby-keyword">or</span> <span class="ruby-identifier">obj</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Module</span>)
-  <span class="ruby-identifier">mod</span> = <span class="ruby-identifier">is_obj_mod</span> <span class="ruby-operator">?</span> <span class="ruby-constant">Runtime</span>.<span class="ruby-identifier">eigen_class</span>(<span class="ruby-identifier">obj</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">obj</span>.<span class="ruby-identifier">class</span>
-
-  <span class="ruby-comment"># mm = get_module_monitor(mod) unless is_obj_mod</span>
-  <span class="ruby-identifier">mm</span> = <span class="ruby-constant">MONITOR_MAP</span>[<span class="ruby-identifier">mod</span>] 
-
-  <span class="ruby-comment"># There is something wrong if there isn't a module monitor</span>
-  <span class="ruby-comment"># associated with the call.</span>
-  <span class="ruby-comment"># raise Exception if mm == nil || !mm.include?(meth_name)</span>
-
-  <span class="ruby-identifier">meth_info</span> = <span class="ruby-constant">MethodInfo</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">meth_name</span>, <span class="ruby-identifier">args</span>, <span class="ruby-identifier">blk</span>, <span class="ruby-keyword">nil</span>)
-
-  <span class="ruby-identifier">mm</span>.<span class="ruby-identifier">monitor_before_method</span>(<span class="ruby-identifier">obj</span>, <span class="ruby-identifier">meth_info</span>)
-
-  <span class="ruby-constant">RubyBreaker</span>.<span class="ruby-identifier">log</span>(<span class="ruby-string">&quot;monitor_before_method ended&quot;</span>)
-
-  <span class="ruby-comment"># we are going to turn the switch back on</span>
-  <span class="ruby-constant">GLOBAL_MONITOR_SWITCH</span>.<span class="ruby-identifier">turn_on</span>()
-
-  <span class="ruby-comment"># call the original method which was renamed</span>
-  <span class="ruby-identifier">retval</span> = <span class="ruby-identifier">obj</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">stub_meth_name</span>.<span class="ruby-identifier">to_sym</span>, *<span class="ruby-identifier">meth_info</span>.<span class="ruby-identifier">args</span>,
-                    &amp;<span class="ruby-identifier">meth_info</span>.<span class="ruby-identifier">blk</span>)
-
-  <span class="ruby-comment"># turn it off</span>
-  <span class="ruby-constant">GLOBAL_MONITOR_SWITCH</span>.<span class="ruby-identifier">turn_off</span>()
-
-  <span class="ruby-identifier">meth_info</span>.<span class="ruby-identifier">ret</span> = <span class="ruby-identifier">retval</span>
-  <span class="ruby-identifier">mm</span>.<span class="ruby-identifier">monitor_after_method</span>(<span class="ruby-identifier">obj</span>, <span class="ruby-identifier">meth_info</span>)
-  <span class="ruby-identifier">retval</span> = <span class="ruby-identifier">meth_info</span>.<span class="ruby-identifier">ret</span>  <span class="ruby-comment"># Return value may have been altered by the</span>
-                          <span class="ruby-comment"># after_method monitoring code</span>
-
-  <span class="ruby-comment"># things are done in this context. pop it off.</span>
-  <span class="ruby-constant">CONTEXT</span>.<span class="ruby-identifier">pop</span>()
-
-  <span class="ruby-comment"># it is always the case that the switch was off when this particular</span>
-  <span class="ruby-comment"># call was made. (Otherwise, it would have quit somewhere above</span>
-  <span class="ruby-constant">GLOBAL_MONITOR_SWITCH</span>.<span class="ruby-identifier">turn_on</span>() 
-
-  <span class="ruby-keyword">return</span> <span class="ruby-identifier">retval</span> <span class="ruby-comment"># always return the return value</span>
-<span class="ruby-keyword">end</span></pre>
-          </div><!-- route-source -->
-          
-        </div>
-
-        
-
-        
-      </div><!-- route-method -->
-
-    
-    </section><!-- public-class-method-details -->
-  
-  </section><!-- 5Buntitled-5D -->
-
-</div><!-- documentation -->
-
-
-<footer id="validator-badges">
-  <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
-  <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.
-  <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
-</footer>
-