RubyGems - ruby-prof - Versions diffs - 0.4.0 - Mend

ruby-prof 0.4.0

Files changed (56) hide show

data/CHANGES +17 -0
data/LICENSE +23 -0
data/README +220 -0
data/Rakefile +141 -0
data/bin/ruby-prof +154 -0
data/doc/classes/RubyProf.html +563 -0
data/doc/classes/RubyProf/CallInfo.html +274 -0
data/doc/classes/RubyProf/FlatPrinter.html +207 -0
data/doc/classes/RubyProf/GraphHtmlPrinter.html +538 -0
data/doc/classes/RubyProf/GraphPrinter.html +240 -0
data/doc/classes/RubyProf/MethodInfo.html +556 -0
data/doc/classes/RubyProf/ProfileTask.html +395 -0
data/doc/classes/RubyProf/Result.html +234 -0
data/doc/created.rid +1 -0
data/doc/files/LICENSE.html +142 -0
data/doc/files/README.html +376 -0
data/doc/files/bin/ruby-prof.html +143 -0
data/doc/files/examples/flat_txt.html +187 -0
data/doc/files/examples/graph_html.html +948 -0
data/doc/files/examples/graph_txt.html +305 -0
data/doc/files/ext/ruby_prof_c.html +101 -0
data/doc/files/lib/ruby-prof/flat_printer_rb.html +101 -0
data/doc/files/lib/ruby-prof/graph_html_printer_rb.html +108 -0
data/doc/files/lib/ruby-prof/graph_printer_rb.html +101 -0
data/doc/files/lib/ruby-prof/profiletask_rb.html +109 -0
data/doc/files/lib/ruby-prof_rb.html +111 -0
data/doc/files/lib/unprof_rb.html +108 -0
data/doc/fr_class_index.html +34 -0
data/doc/fr_file_index.html +39 -0
data/doc/fr_method_index.html +67 -0
data/doc/index.html +24 -0
data/doc/rdoc-style.css +208 -0
data/examples/flat.txt +57 -0
data/examples/graph.html +827 -0
data/examples/graph.txt +171 -0
data/ext/extconf.rb +19 -0
data/ext/ruby_prof.c +1433 -0
data/lib/ruby-prof.rb +38 -0
data/lib/ruby-prof/flat_printer.rb +76 -0
data/lib/ruby-prof/graph_html_printer.rb +227 -0
data/lib/ruby-prof/graph_printer.rb +142 -0
data/lib/ruby-prof/profiletask.rb +150 -0
data/lib/unprof.rb +8 -0
data/test/basic_test.rb +141 -0
data/test/clock_mode_test.rb +73 -0
data/test/module_test.rb +45 -0
data/test/prime.rb +58 -0
data/test/prime_test.rb +24 -0
data/test/printers_test.rb +28 -0
data/test/recursive_test.rb +55 -0
data/test/test.rb +3 -0
data/test/test_helper.rb +45 -0
data/test/test_suite.rb +9 -0
data/test/thread_test.rb +32 -0
data/test/timing_test.rb +90 -0
metadata +121 -0

data/doc/files/examples/graph_txt.html ADDED Viewed

@@ -0,0 +1,305 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>File: graph.txt</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+  <div id="fileHeader">
+    <h1>graph.txt</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>examples/graph.txt
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Mon Jun 19 16:24:10 Mountain Standard Time 2006</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <h1>Graph Profiles</h1>
+<p>
+Graph profiles show how long each method runs, which methods call it and
+which methods it calls.
+</p>
+<p>
+As an example, here is the output from running printers_test.rb:
+</p>
+<p>
+Thread ID: 21277412
+</p>
+<pre>
+  %total   %self     total      self    children               calls   Name
+ --------------------------------------------------------------------------------
+ 100.00%   0.00%      8.77      0.00      8.77                   1     #toplevel
+                      8.77      0.00      8.77                 1/1     Object#run_primes
+ --------------------------------------------------------------------------------
+                      8.77      0.00      8.77                 1/1     #toplevel
+ 100.00%   0.00%      8.77      0.00      8.77                   1     Object#run_primes
+                      0.02      0.00      0.02                 1/1     Object#make_random_array
+                      2.09      0.00      2.09                 1/1     Object#find_largest
+                      6.66      0.00      6.66                 1/1     Object#find_primes
+ --------------------------------------------------------------------------------
+                      6.63      4.06      2.56             500/501     Object#is_prime
+                      2.09      0.00      2.09               1/501     Object#find_largest
+  99.48%  46.34%      8.72      4.06      4.66                 501     Integer#upto
+                      0.00      0.00      0.00               61/61     Array#[]
+                      0.00      0.00      0.00               61/61     Fixnum#&gt;
+                      2.09      2.09      0.00               61/61     Kernel.sleep
+                      1.24      1.24      0.00       250862/250862     Fixnum#==
+                      1.33      1.33      0.00       250862/250862     Fixnum#%
+ --------------------------------------------------------------------------------
+                      6.66      0.01      6.64                 1/1     Object#find_primes
+  75.93%   0.17%      6.66      0.01      6.64                   1     Array#select
+                      6.64      0.01      6.63             500/500     Object#is_prime
+ --------------------------------------------------------------------------------
+                      6.66      0.00      6.66                 1/1     Object#run_primes
+  75.93%   0.00%      6.66      0.00      6.66                   1     Object#find_primes
+                      6.66      0.01      6.64                 1/1     Array#select
+ --------------------------------------------------------------------------------
+                      6.64      0.01      6.63             500/500     Array#select
+  75.76%   0.17%      6.64      0.01      6.63                 500     Object#is_prime
+                      0.00      0.00      0.00             500/501     Fixnum#-
+                      6.63      4.06      2.56             500/501     Integer#upto
+ --------------------------------------------------------------------------------
+                      2.09      0.00      2.09                 1/1     Object#run_primes
+  23.89%   0.00%      2.09      0.00      2.09                   1     Object#find_largest
+                      0.00      0.00      0.00               1/501     Fixnum#-
+                      2.09      0.00      2.09               1/501     Integer#upto
+                      0.00      0.00      0.00                 1/1     Array#first
+                      0.00      0.00      0.00                 1/1     Array#length
+ --------------------------------------------------------------------------------
+                      2.09      2.09      0.00               61/61     Integer#upto
+  23.89%  23.89%      2.09      2.09      0.00                  61     Kernel.sleep
+ --------------------------------------------------------------------------------
+                      1.33      1.33      0.00       250862/250862     Integer#upto
+  15.12%  15.12%      1.33      1.33      0.00              250862     Fixnum#%
+ --------------------------------------------------------------------------------
+                      1.24      1.24      0.00       250862/250862     Integer#upto
+  14.13%  14.13%      1.24      1.24      0.00              250862     Fixnum#==
+ --------------------------------------------------------------------------------
+                      0.02      0.00      0.02                 1/1     Object#run_primes
+   0.18%   0.00%      0.02      0.00      0.02                   1     Object#make_random_array
+                      0.02      0.02      0.00                 1/1     Array#each_index
+                      0.00      0.00      0.00                 1/1     Class#new
+ --------------------------------------------------------------------------------
+                      0.02      0.02      0.00                 1/1     Object#make_random_array
+   0.18%   0.18%      0.02      0.02      0.00                   1     Array#each_index
+                      0.00      0.00      0.00             500/500     Kernel.rand
+                      0.00      0.00      0.00             500/500     Array#[]=
+ --------------------------------------------------------------------------------
+                      0.00      0.00      0.00             500/501     Object#is_prime
+                      0.00      0.00      0.00               1/501     Object#find_largest
+   0.00%   0.00%      0.00      0.00      0.00                 501     Fixnum#-
+ --------------------------------------------------------------------------------
+                      0.00      0.00      0.00                 1/1     Kernel.rand
+   0.00%   0.00%      0.00      0.00      0.00                   1     Integer#to_int
+ --------------------------------------------------------------------------------
+                      0.00      0.00      0.00                 1/1     Object#find_largest
+   0.00%   0.00%      0.00      0.00      0.00                   1     Array#first
+ --------------------------------------------------------------------------------
+                      0.00      0.00      0.00                 1/1     Class#new
+   0.00%   0.00%      0.00      0.00      0.00                   1     Array#initialize
+ --------------------------------------------------------------------------------
+                      0.00      0.00      0.00                 1/1     Object#find_largest
+   0.00%   0.00%      0.00      0.00      0.00                   1     Array#length
+ --------------------------------------------------------------------------------
+                      0.00      0.00      0.00                 1/1     Object#make_random_array
+   0.00%   0.00%      0.00      0.00      0.00                   1     Class#new
+                      0.00      0.00      0.00                 1/1     Array#initialize
+ --------------------------------------------------------------------------------
+                      0.00      0.00      0.00               61/61     Integer#upto
+   0.00%   0.00%      0.00      0.00      0.00                  61     Fixnum#&gt;
+ --------------------------------------------------------------------------------
+                      0.00      0.00      0.00               61/61     Integer#upto
+   0.00%   0.00%      0.00      0.00      0.00                  61     Array#[]
+ --------------------------------------------------------------------------------
+                      0.00      0.00      0.00             500/500     Array#each_index
+   0.00%   0.00%      0.00      0.00      0.00                 500     Array#[]=
+ --------------------------------------------------------------------------------
+                      0.00      0.00      0.00             500/500     Array#each_index
+   0.00%   0.00%      0.00      0.00      0.00                 500     Kernel.rand
+                      0.00      0.00      0.00                 1/1     Integer#to_int
+</pre>
+<h2>Overview</h2>
+<p>
+Dashed lines divide the report into entries, with one entry per method.
+Entries are sorted by total time which is the time spent in the method plus
+its children.
+</p>
+<p>
+Each entry has a primary line demarked by values in the %total and %self
+columns. The primary line represents the method being profiles. Lines above
+it are the methods that called this method (parents) while the lines below
+it are the methods it called (children).
+</p>
+<p>
+All values are in seconds. For the primary line, the columns represent:
+</p>
+<pre>
+        %total       - The percentage of time spent in this method and its children
+        %self        - The percentage of time spent in this method
+        total        - The time spent in this method and its children.
+        self         - The time spent in this method.
+        children     - The time spent in this method's children.
+  calls        - The number of times this method was called.
+  name         - The name of the method.
+</pre>
+<p>
+The interpretation of method names is:
+</p>
+<ul>
+<li>toplevel - The root method that calls all other methods
+</li>
+<li>Object#test - An instance method &quot;test&quot; on the class
+&quot;Object&quot;
+</li>
+<li>&lt;Class:Object&gt;test - A class method &quot;test&quot; on the class
+&quot;Object&quot;
+</li>
+<li>&lt;Object:Object&gt;test - A singleton method &quot;test&quot; on a
+singleton class inherited from &quot;Object&quot;
+</li>
+<li>Module.test - An instance method &quot;test&quot; on the module
+&quot;Module&quot;
+</li>
+</ul>
+<p>
+For example, we see that 99.48% of the time was spent in Integer#upto and
+its children. Of that time, 4.06 seconds was spent in Integer#upto itself
+and 4.66 in its children. Overall, Integer#upto was called 501 times.
+</p>
+<h2>Parents</h2>
+<p>
+In each entry, the lines above the primary line are the methods that called
+the current method. If the current method is a root method then no parents
+are shown.
+</p>
+<p>
+For parent lines, the columns represent:
+</p>
+<pre>
+        total        - The time spent in the current method and it children on behalf of the parent method.
+        self         - The time spent in this method on behalf of the parent method.
+        children     - The time spent in this method's children on behalf of the parent.
+  calls        - The number of times the parent method called this child
+</pre>
+<p>
+Looking at Integer#upto again, we see that it was called 500 times from
+Object#is_prime and 1 time from find_largest. Of the 8.72 total seconds
+spent in Integer#upto, 6.63 were done for Object#is_prime and 2.09 for
+Object#find_largest.
+</p>
+<h2>Children</h2>
+<p>
+In each entry, the lines below the primary line are the methods that the
+current method called. If the current method is a leaf method then no
+children are shown.
+</p>
+<p>
+For children lines, the columns represent:
+</p>
+<pre>
+        total        - The time spent in the child, and its children, on behalf of the current method
+        self         - The time spent in the child on behalf of the current method.
+        children     - The time spent in the child's children (ie, granchildren) in behalf of the current method
+  calls        - The number of times the child method was called by the current method.
+</pre>
+<p>
+Taking our example of Integer#upto, we see that it called five other
+methods - Array#[], Fixnum#&gt;, Kernel.sleep, Fixnum#= and Fixnum#%.
+Looking at Kernel.sleep, we see that its spent 2.09 seconds working for
+Integer#upto and its children spent 0 time working for Integer#upto. To see
+the overall time Kernel.sleep took we would have to look up its entry in
+the graph table.
+</p>
+    </div>
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- if method_list -->
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>

data/doc/files/ext/ruby_prof_c.html ADDED Viewed

@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>File: ruby_prof.c</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+  <div id="fileHeader">
+    <h1>ruby_prof.c</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>ext/ruby_prof.c
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Wed Jun 21 00:27:04 Mountain Standard Time 2006</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- if method_list -->
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>

data/doc/files/lib/ruby-prof/flat_printer_rb.html ADDED Viewed

@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>File: flat_printer.rb</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+  <div id="fileHeader">
+    <h1>flat_printer.rb</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>lib/ruby-prof/flat_printer.rb
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Wed Jun 21 00:38:39 Mountain Standard Time 2006</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- if method_list -->
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>