ruby-prof 0.15.4 → 0.15.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (63) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGES +7 -1
  3. data/README.rdoc +1 -1
  4. data/bin/ruby-prof +16 -4
  5. data/doc/LICENSE.html +114 -0
  6. data/doc/README_rdoc.html +592 -0
  7. data/doc/Rack.html +95 -0
  8. data/doc/Rack/RubyProf.html +264 -0
  9. data/doc/RubyProf.html +962 -0
  10. data/doc/RubyProf/AbstractPrinter.html +546 -0
  11. data/doc/RubyProf/AggregateCallInfo.html +537 -0
  12. data/doc/RubyProf/CallInfo.html +468 -0
  13. data/doc/RubyProf/CallInfoPrinter.html +120 -0
  14. data/doc/RubyProf/CallInfoVisitor.html +200 -0
  15. data/doc/RubyProf/CallStackPrinter.html +1604 -0
  16. data/doc/RubyProf/CallTreePrinter.html +359 -0
  17. data/doc/RubyProf/Cmd.html +631 -0
  18. data/doc/RubyProf/DotPrinter.html +257 -0
  19. data/doc/RubyProf/FlatPrinter.html +163 -0
  20. data/doc/RubyProf/FlatPrinterWithLineNumbers.html +208 -0
  21. data/doc/RubyProf/GraphHtmlPrinter.html +575 -0
  22. data/doc/RubyProf/GraphPrinter.html +139 -0
  23. data/doc/RubyProf/MethodInfo.html +685 -0
  24. data/doc/RubyProf/MultiPrinter.html +358 -0
  25. data/doc/RubyProf/Profile.html +764 -0
  26. data/doc/RubyProf/ProfileTask.html +490 -0
  27. data/doc/RubyProf/Thread.html +199 -0
  28. data/doc/created.rid +14 -14
  29. data/doc/examples/flat_txt.html +149 -0
  30. data/doc/examples/graph_html.html +850 -0
  31. data/doc/examples/graph_txt.html +274 -0
  32. data/doc/images/add.png +0 -0
  33. data/doc/images/arrow_up.png +0 -0
  34. data/doc/images/brick.png +0 -0
  35. data/doc/images/brick_link.png +0 -0
  36. data/doc/images/bug.png +0 -0
  37. data/doc/images/bullet_black.png +0 -0
  38. data/doc/images/bullet_toggle_minus.png +0 -0
  39. data/doc/images/bullet_toggle_plus.png +0 -0
  40. data/doc/images/date.png +0 -0
  41. data/doc/images/delete.png +0 -0
  42. data/doc/images/find.png +0 -0
  43. data/doc/images/macFFBgHack.png +0 -0
  44. data/doc/images/package.png +0 -0
  45. data/doc/images/page_green.png +0 -0
  46. data/doc/images/page_white_text.png +0 -0
  47. data/doc/images/page_white_width.png +0 -0
  48. data/doc/images/plugin.png +0 -0
  49. data/doc/images/ruby.png +0 -0
  50. data/doc/images/tag_blue.png +0 -0
  51. data/doc/images/tag_green.png +0 -0
  52. data/doc/images/transparent.png +0 -0
  53. data/doc/images/wrench.png +0 -0
  54. data/doc/images/wrench_orange.png +0 -0
  55. data/doc/images/zoom.png +0 -0
  56. data/doc/index.html +618 -0
  57. data/doc/js/search_index.js.gz +0 -0
  58. data/doc/table_of_contents.html +859 -0
  59. data/lib/ruby-prof/printers/flat_printer_with_line_numbers.rb +21 -14
  60. data/lib/ruby-prof/printers/graph_printer.rb +1 -0
  61. data/lib/ruby-prof/version.rb +1 -1
  62. data/test/measure_cpu_time_test.rb +1 -1
  63. metadata +54 -2
@@ -0,0 +1,468 @@
1
+ <!DOCTYPE html>
2
+
3
+ <html>
4
+ <head>
5
+ <meta charset="UTF-8">
6
+
7
+ <title>class RubyProf::CallInfo - ruby-prof</title>
8
+
9
+ <script type="text/javascript">
10
+ var rdoc_rel_prefix = "../";
11
+ </script>
12
+
13
+ <script src="../js/jquery.js"></script>
14
+ <script src="../js/darkfish.js"></script>
15
+
16
+ <link href="../css/fonts.css" rel="stylesheet">
17
+ <link href="../css/rdoc.css" rel="stylesheet">
18
+
19
+
20
+
21
+ <body id="top" role="document" class="class">
22
+ <nav role="navigation">
23
+ <div id="project-navigation">
24
+ <div id="home-section" role="region" title="Quick navigation" class="nav-section">
25
+ <h2>
26
+ <a href="../index.html" rel="home">Home</a>
27
+ </h2>
28
+
29
+ <div id="table-of-contents-navigation">
30
+ <a href="../table_of_contents.html#pages">Pages</a>
31
+ <a href="../table_of_contents.html#classes">Classes</a>
32
+ <a href="../table_of_contents.html#methods">Methods</a>
33
+ </div>
34
+ </div>
35
+
36
+ <div id="search-section" role="search" class="project-section initially-hidden">
37
+ <form action="#" method="get" accept-charset="utf-8">
38
+ <div id="search-field-wrapper">
39
+ <input id="search-field" role="combobox" aria-label="Search"
40
+ aria-autocomplete="list" aria-controls="search-results"
41
+ type="text" name="search" placeholder="Search" spellcheck="false"
42
+ title="Type to search, Up and Down to navigate, Enter to load">
43
+ </div>
44
+
45
+ <ul id="search-results" aria-label="Search Results"
46
+ aria-busy="false" aria-expanded="false"
47
+ aria-atomic="false" class="initially-hidden"></ul>
48
+ </form>
49
+ </div>
50
+
51
+ </div>
52
+
53
+
54
+
55
+ <div id="class-metadata">
56
+
57
+ <div id="parent-class-section" class="nav-section">
58
+ <h3>Parent</h3>
59
+
60
+
61
+ <p class="link">Object
62
+
63
+ </div>
64
+
65
+
66
+
67
+ <!-- Method Quickref -->
68
+ <div id="method-list-section" class="nav-section">
69
+ <h3>Methods</h3>
70
+
71
+ <ul class="link-list" role="directory">
72
+
73
+ <li ><a href="#method-i-call_sequence">#call_sequence</a>
74
+
75
+ <li ><a href="#method-i-children_time">#children_time</a>
76
+
77
+ <li ><a href="#method-i-eliminate-21">#eliminate!</a>
78
+
79
+ <li ><a href="#method-i-find_call">#find_call</a>
80
+
81
+ <li ><a href="#method-i-merge_call_tree">#merge_call_tree</a>
82
+
83
+ <li ><a href="#method-i-root-3F">#root?</a>
84
+
85
+ <li ><a href="#method-i-stack">#stack</a>
86
+
87
+ <li ><a href="#method-i-to_s">#to_s</a>
88
+
89
+ </ul>
90
+ </div>
91
+
92
+ </div>
93
+ </nav>
94
+
95
+ <main role="main" aria-labelledby="class-RubyProf::CallInfo">
96
+ <h1 id="class-RubyProf::CallInfo" class="class">
97
+ class RubyProf::CallInfo
98
+ </h1>
99
+
100
+ <section class="description">
101
+
102
+ </section>
103
+
104
+
105
+
106
+
107
+ <section id="5Buntitled-5D" class="documentation-section">
108
+
109
+
110
+
111
+
112
+
113
+
114
+
115
+ <section class="attribute-method-details" class="method-section">
116
+ <header>
117
+ <h3>Attributes</h3>
118
+ </header>
119
+
120
+
121
+ <div id="attribute-i-recursive" class="method-detail">
122
+ <div class="method-heading attribute-method-heading">
123
+ <span class="method-name">recursive</span><span
124
+ class="attribute-access-type">[RW]</span>
125
+ </div>
126
+
127
+ <div class="method-description">
128
+
129
+
130
+
131
+ </div>
132
+ </div>
133
+
134
+ </section>
135
+
136
+
137
+
138
+ <section id="public-instance-5Buntitled-5D-method-details" class="method-section">
139
+ <header>
140
+ <h3>Public Instance Methods</h3>
141
+ </header>
142
+
143
+
144
+ <div id="method-i-call_sequence" class="method-detail ">
145
+
146
+ <div class="method-heading">
147
+ <span class="method-name">call_sequence</span><span
148
+ class="method-args">()</span>
149
+
150
+ <span class="method-click-advice">click to toggle source</span>
151
+
152
+ </div>
153
+
154
+
155
+ <div class="method-description">
156
+
157
+
158
+
159
+
160
+
161
+
162
+ <div class="method-source-code" id="call_sequence-source">
163
+ <pre><span class="ruby-comment"># File lib/ruby-prof/call_info.rb, line 25</span>
164
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">call_sequence</span>
165
+ <span class="ruby-ivar">@call_sequence</span> <span class="ruby-operator">||=</span> <span class="ruby-keyword">begin</span>
166
+ <span class="ruby-identifier">stack</span>.<span class="ruby-identifier">map</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">method</span><span class="ruby-operator">|</span> <span class="ruby-identifier">method</span>.<span class="ruby-identifier">full_name</span>}.<span class="ruby-identifier">join</span>(<span class="ruby-string">&#39;-&gt;&#39;</span>)
167
+ <span class="ruby-keyword">end</span>
168
+ <span class="ruby-keyword">end</span></pre>
169
+ </div>
170
+
171
+ </div>
172
+
173
+
174
+
175
+
176
+ </div>
177
+
178
+
179
+ <div id="method-i-children_time" class="method-detail ">
180
+
181
+ <div class="method-heading">
182
+ <span class="method-name">children_time</span><span
183
+ class="method-args">()</span>
184
+
185
+ <span class="method-click-advice">click to toggle source</span>
186
+
187
+ </div>
188
+
189
+
190
+ <div class="method-description">
191
+
192
+
193
+
194
+
195
+
196
+
197
+ <div class="method-source-code" id="children_time-source">
198
+ <pre><span class="ruby-comment"># File lib/ruby-prof/call_info.rb, line 6</span>
199
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">children_time</span>
200
+ <span class="ruby-identifier">children</span>.<span class="ruby-identifier">inject</span>(<span class="ruby-value">0</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">sum</span>, <span class="ruby-identifier">call_info</span><span class="ruby-operator">|</span>
201
+ <span class="ruby-identifier">sum</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">call_info</span>.<span class="ruby-identifier">total_time</span>
202
+ <span class="ruby-keyword">end</span>
203
+ <span class="ruby-keyword">end</span></pre>
204
+ </div>
205
+
206
+ </div>
207
+
208
+
209
+
210
+
211
+ </div>
212
+
213
+
214
+ <div id="method-i-eliminate-21" class="method-detail ">
215
+
216
+ <div class="method-heading">
217
+ <span class="method-name">eliminate!</span><span
218
+ class="method-args">()</span>
219
+
220
+ <span class="method-click-advice">click to toggle source</span>
221
+
222
+ </div>
223
+
224
+
225
+ <div class="method-description">
226
+
227
+ <p>eliminate call info from the call tree. adds self and wait time to parent
228
+ and attaches called methods to parent. merges call trees for methods called
229
+ from both praent end self.</p>
230
+
231
+
232
+
233
+
234
+ <div class="method-source-code" id="eliminate-21-source">
235
+ <pre><span class="ruby-comment"># File lib/ruby-prof/call_info.rb, line 42</span>
236
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">eliminate!</span>
237
+ <span class="ruby-comment"># puts &quot;eliminating #{self}&quot;</span>
238
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">parent</span>
239
+ <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">add_self_time</span>(<span class="ruby-keyword">self</span>)
240
+ <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">add_wait_time</span>(<span class="ruby-keyword">self</span>)
241
+ <span class="ruby-identifier">children</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">kid</span><span class="ruby-operator">|</span>
242
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">call</span> = <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">find_call</span>(<span class="ruby-identifier">kid</span>)
243
+ <span class="ruby-identifier">call</span>.<span class="ruby-identifier">merge_call_tree</span>(<span class="ruby-identifier">kid</span>)
244
+ <span class="ruby-keyword">else</span>
245
+ <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">children</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">kid</span>
246
+ <span class="ruby-comment"># $stderr.puts &quot;setting parent of #{kid}\nto #{parent}&quot;</span>
247
+ <span class="ruby-identifier">kid</span>.<span class="ruby-identifier">parent</span> = <span class="ruby-identifier">parent</span>
248
+ <span class="ruby-keyword">end</span>
249
+ <span class="ruby-keyword">end</span>
250
+ <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">children</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-keyword">self</span>)
251
+ <span class="ruby-keyword">end</span></pre>
252
+ </div>
253
+
254
+ </div>
255
+
256
+
257
+
258
+
259
+ </div>
260
+
261
+
262
+ <div id="method-i-find_call" class="method-detail ">
263
+
264
+ <div class="method-heading">
265
+ <span class="method-name">find_call</span><span
266
+ class="method-args">(other)</span>
267
+
268
+ <span class="method-click-advice">click to toggle source</span>
269
+
270
+ </div>
271
+
272
+
273
+ <div class="method-description">
274
+
275
+ <p>find a specific call in list of children. returns nil if not found. note:
276
+ there can&#39;t be more than one child with a given target method. in other
277
+ words: x.children.grep{|y|y.target==m}.size &lt;= 1 for all method infos m
278
+ and call infos x</p>
279
+
280
+
281
+
282
+
283
+ <div class="method-source-code" id="find_call-source">
284
+ <pre><span class="ruby-comment"># File lib/ruby-prof/call_info.rb, line 62</span>
285
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">find_call</span>(<span class="ruby-identifier">other</span>)
286
+ <span class="ruby-identifier">matching</span> = <span class="ruby-identifier">children</span>.<span class="ruby-identifier">select</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">kid</span><span class="ruby-operator">|</span> <span class="ruby-identifier">kid</span>.<span class="ruby-identifier">target</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">other</span>.<span class="ruby-identifier">target</span> }
287
+ <span class="ruby-identifier">raise</span> <span class="ruby-string">&quot;inconsistent call tree&quot;</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">matching</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-value">1</span>
288
+ <span class="ruby-identifier">matching</span>.<span class="ruby-identifier">first</span>
289
+ <span class="ruby-keyword">end</span></pre>
290
+ </div>
291
+
292
+ </div>
293
+
294
+
295
+
296
+
297
+ </div>
298
+
299
+
300
+ <div id="method-i-merge_call_tree" class="method-detail ">
301
+
302
+ <div class="method-heading">
303
+ <span class="method-name">merge_call_tree</span><span
304
+ class="method-args">(other)</span>
305
+
306
+ <span class="method-click-advice">click to toggle source</span>
307
+
308
+ </div>
309
+
310
+
311
+ <div class="method-description">
312
+
313
+ <p>merge two call trees. adds self, wait, and total time of other to self and
314
+ merges children of other into children of self.</p>
315
+
316
+
317
+
318
+
319
+ <div class="method-source-code" id="merge_call_tree-source">
320
+ <pre><span class="ruby-comment"># File lib/ruby-prof/call_info.rb, line 69</span>
321
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">merge_call_tree</span>(<span class="ruby-identifier">other</span>)
322
+ <span class="ruby-comment"># $stderr.puts &quot;merging #{self}\nand #{other}&quot;</span>
323
+ <span class="ruby-keyword">self</span>.<span class="ruby-identifier">called</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">other</span>.<span class="ruby-identifier">called</span>
324
+ <span class="ruby-identifier">add_self_time</span>(<span class="ruby-identifier">other</span>)
325
+ <span class="ruby-identifier">add_wait_time</span>(<span class="ruby-identifier">other</span>)
326
+ <span class="ruby-identifier">add_total_time</span>(<span class="ruby-identifier">other</span>)
327
+ <span class="ruby-identifier">other</span>.<span class="ruby-identifier">children</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">other_kid</span><span class="ruby-operator">|</span>
328
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">kid</span> = <span class="ruby-identifier">find_call</span>(<span class="ruby-identifier">other_kid</span>)
329
+ <span class="ruby-comment"># $stderr.puts &quot;merging kids&quot;</span>
330
+ <span class="ruby-identifier">kid</span>.<span class="ruby-identifier">merge_call_tree</span>(<span class="ruby-identifier">other_kid</span>)
331
+ <span class="ruby-keyword">else</span>
332
+ <span class="ruby-identifier">other_kid</span>.<span class="ruby-identifier">parent</span> = <span class="ruby-keyword">self</span>
333
+ <span class="ruby-identifier">children</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">other_kid</span>
334
+ <span class="ruby-keyword">end</span>
335
+ <span class="ruby-keyword">end</span>
336
+ <span class="ruby-identifier">other</span>.<span class="ruby-identifier">children</span>.<span class="ruby-identifier">clear</span>
337
+ <span class="ruby-identifier">other</span>.<span class="ruby-identifier">target</span>.<span class="ruby-identifier">call_infos</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">other</span>)
338
+ <span class="ruby-keyword">end</span></pre>
339
+ </div>
340
+
341
+ </div>
342
+
343
+
344
+
345
+
346
+ </div>
347
+
348
+
349
+ <div id="method-i-root-3F" class="method-detail ">
350
+
351
+ <div class="method-heading">
352
+ <span class="method-name">root?</span><span
353
+ class="method-args">()</span>
354
+
355
+ <span class="method-click-advice">click to toggle source</span>
356
+
357
+ </div>
358
+
359
+
360
+ <div class="method-description">
361
+
362
+
363
+
364
+
365
+
366
+
367
+ <div class="method-source-code" id="root-3F-source">
368
+ <pre><span class="ruby-comment"># File lib/ruby-prof/call_info.rb, line 31</span>
369
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">root?</span>
370
+ <span class="ruby-keyword">self</span>.<span class="ruby-identifier">parent</span>.<span class="ruby-identifier">nil?</span>
371
+ <span class="ruby-keyword">end</span></pre>
372
+ </div>
373
+
374
+ </div>
375
+
376
+
377
+
378
+
379
+ </div>
380
+
381
+
382
+ <div id="method-i-stack" class="method-detail ">
383
+
384
+ <div class="method-heading">
385
+ <span class="method-name">stack</span><span
386
+ class="method-args">()</span>
387
+
388
+ <span class="method-click-advice">click to toggle source</span>
389
+
390
+ </div>
391
+
392
+
393
+ <div class="method-description">
394
+
395
+
396
+
397
+
398
+
399
+
400
+ <div class="method-source-code" id="stack-source">
401
+ <pre><span class="ruby-comment"># File lib/ruby-prof/call_info.rb, line 12</span>
402
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">stack</span>
403
+ <span class="ruby-ivar">@stack</span> <span class="ruby-operator">||=</span> <span class="ruby-keyword">begin</span>
404
+ <span class="ruby-identifier">methods</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>
405
+ <span class="ruby-identifier">call_info</span> = <span class="ruby-keyword">self</span>
406
+
407
+ <span class="ruby-keyword">while</span> <span class="ruby-identifier">call_info</span>
408
+ <span class="ruby-identifier">methods</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">call_info</span>.<span class="ruby-identifier">target</span>
409
+ <span class="ruby-identifier">call_info</span> = <span class="ruby-identifier">call_info</span>.<span class="ruby-identifier">parent</span>
410
+ <span class="ruby-keyword">end</span>
411
+ <span class="ruby-identifier">methods</span>.<span class="ruby-identifier">reverse</span>
412
+ <span class="ruby-keyword">end</span>
413
+ <span class="ruby-keyword">end</span></pre>
414
+ </div>
415
+
416
+ </div>
417
+
418
+
419
+
420
+
421
+ </div>
422
+
423
+
424
+ <div id="method-i-to_s" class="method-detail ">
425
+
426
+ <div class="method-heading">
427
+ <span class="method-name">to_s</span><span
428
+ class="method-args">()</span>
429
+
430
+ <span class="method-click-advice">click to toggle source</span>
431
+
432
+ </div>
433
+
434
+
435
+ <div class="method-description">
436
+
437
+
438
+
439
+
440
+
441
+
442
+ <div class="method-source-code" id="to_s-source">
443
+ <pre><span class="ruby-comment"># File lib/ruby-prof/call_info.rb, line 35</span>
444
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">to_s</span>
445
+ <span class="ruby-node">&quot;#{self.target.full_name} (c: #{self.called}, tt: #{self.total_time}, st: #{self.self_time}, ct: #{self.children_time})&quot;</span>
446
+ <span class="ruby-keyword">end</span></pre>
447
+ </div>
448
+
449
+ </div>
450
+
451
+
452
+
453
+
454
+ </div>
455
+
456
+
457
+ </section>
458
+
459
+ </section>
460
+ </main>
461
+
462
+
463
+ <footer id="validator-badges" role="contentinfo">
464
+ <p><a href="http://validator.w3.org/check/referer">Validate</a>
465
+ <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.0.
466
+ <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
467
+ </footer>
468
+