ruby-prof 0.13.1 → 1.4.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (209) hide show
  1. checksums.yaml +5 -5
  2. data/CHANGES +579 -371
  3. data/LICENSE +24 -23
  4. data/README.rdoc +5 -433
  5. data/Rakefile +98 -110
  6. data/bin/ruby-prof +328 -329
  7. data/bin/ruby-prof-check-trace +45 -0
  8. data/ext/ruby_prof/extconf.rb +16 -59
  9. data/ext/ruby_prof/rp_aggregate_call_tree.c +59 -0
  10. data/ext/ruby_prof/rp_aggregate_call_tree.h +13 -0
  11. data/ext/ruby_prof/rp_allocation.c +287 -0
  12. data/ext/ruby_prof/rp_allocation.h +31 -0
  13. data/ext/ruby_prof/rp_call_tree.c +369 -0
  14. data/ext/ruby_prof/rp_call_tree.h +43 -0
  15. data/ext/ruby_prof/rp_call_trees.c +288 -0
  16. data/ext/ruby_prof/rp_call_trees.h +28 -0
  17. data/ext/ruby_prof/rp_measure_allocations.c +50 -65
  18. data/ext/ruby_prof/rp_measure_memory.c +42 -73
  19. data/ext/ruby_prof/rp_measure_process_time.c +65 -71
  20. data/ext/ruby_prof/rp_measure_wall_time.c +64 -42
  21. data/ext/ruby_prof/rp_measurement.c +237 -0
  22. data/ext/ruby_prof/rp_measurement.h +50 -0
  23. data/ext/ruby_prof/rp_method.c +491 -420
  24. data/ext/ruby_prof/rp_method.h +62 -57
  25. data/ext/ruby_prof/rp_profile.c +908 -0
  26. data/ext/ruby_prof/rp_profile.h +35 -0
  27. data/ext/ruby_prof/rp_stack.c +212 -128
  28. data/ext/ruby_prof/rp_stack.h +53 -51
  29. data/ext/ruby_prof/rp_thread.c +362 -268
  30. data/ext/ruby_prof/rp_thread.h +39 -27
  31. data/ext/ruby_prof/ruby_prof.c +52 -695
  32. data/ext/ruby_prof/ruby_prof.h +26 -55
  33. data/ext/ruby_prof/vc/ruby_prof.sln +28 -21
  34. data/ext/ruby_prof/vc/{ruby_prof_20.vcxproj → ruby_prof.vcxproj} +56 -8
  35. data/lib/ruby-prof.rb +52 -67
  36. data/lib/ruby-prof/assets/call_stack_printer.html.erb +710 -0
  37. data/lib/ruby-prof/assets/call_stack_printer.png +0 -0
  38. data/lib/ruby-prof/assets/graph_printer.html.erb +355 -0
  39. data/lib/ruby-prof/call_tree.rb +57 -0
  40. data/lib/ruby-prof/call_tree_visitor.rb +36 -0
  41. data/lib/ruby-prof/compatibility.rb +99 -169
  42. data/lib/ruby-prof/exclude_common_methods.rb +198 -0
  43. data/lib/ruby-prof/measurement.rb +17 -0
  44. data/lib/ruby-prof/method_info.rb +78 -131
  45. data/lib/ruby-prof/printers/abstract_printer.rb +137 -85
  46. data/lib/ruby-prof/printers/call_info_printer.rb +53 -41
  47. data/lib/ruby-prof/printers/call_stack_printer.rb +180 -773
  48. data/lib/ruby-prof/printers/call_tree_printer.rb +151 -92
  49. data/lib/ruby-prof/printers/dot_printer.rb +132 -132
  50. data/lib/ruby-prof/printers/flat_printer.rb +53 -69
  51. data/lib/ruby-prof/printers/graph_html_printer.rb +63 -255
  52. data/lib/ruby-prof/printers/graph_printer.rb +113 -116
  53. data/lib/ruby-prof/printers/multi_printer.rb +127 -56
  54. data/lib/ruby-prof/profile.rb +37 -77
  55. data/lib/ruby-prof/rack.rb +62 -15
  56. data/lib/ruby-prof/task.rb +147 -147
  57. data/lib/ruby-prof/thread.rb +10 -12
  58. data/lib/ruby-prof/version.rb +3 -0
  59. data/lib/unprof.rb +10 -10
  60. data/ruby-prof.gemspec +65 -61
  61. data/test/abstract_printer_test.rb +26 -0
  62. data/test/alias_test.rb +126 -0
  63. data/test/basic_test.rb +43 -128
  64. data/test/call_tree_visitor_test.rb +32 -0
  65. data/test/call_trees_test.rb +66 -0
  66. data/test/duplicate_names_test.rb +32 -32
  67. data/test/dynamic_method_test.rb +53 -74
  68. data/test/enumerable_test.rb +21 -16
  69. data/test/exceptions_test.rb +24 -16
  70. data/test/exclude_methods_test.rb +151 -0
  71. data/test/exclude_threads_test.rb +53 -54
  72. data/test/fiber_test.rb +129 -65
  73. data/test/gc_test.rb +90 -0
  74. data/test/inverse_call_tree_test.rb +175 -0
  75. data/test/line_number_test.rb +158 -71
  76. data/test/marshal_test.rb +113 -0
  77. data/test/measure_allocations.rb +30 -0
  78. data/test/measure_allocations_test.rb +375 -25
  79. data/test/measure_allocations_trace_test.rb +375 -0
  80. data/test/measure_memory_trace_test.rb +1101 -0
  81. data/test/measure_process_time_test.rb +785 -62
  82. data/test/measure_times.rb +56 -0
  83. data/test/measure_wall_time_test.rb +434 -254
  84. data/test/multi_printer_test.rb +71 -82
  85. data/test/no_method_class_test.rb +15 -15
  86. data/test/pause_resume_test.rb +175 -166
  87. data/test/prime.rb +54 -54
  88. data/test/prime_script.rb +6 -0
  89. data/test/printer_call_stack_test.rb +27 -0
  90. data/test/printer_call_tree_test.rb +30 -0
  91. data/test/printer_flat_test.rb +99 -0
  92. data/test/printer_graph_html_test.rb +59 -0
  93. data/test/printer_graph_test.rb +40 -0
  94. data/test/printers_test.rb +141 -257
  95. data/test/printing_recursive_graph_test.rb +81 -0
  96. data/test/profile_test.rb +16 -0
  97. data/test/rack_test.rb +93 -0
  98. data/test/recursive_test.rb +206 -215
  99. data/test/singleton_test.rb +38 -38
  100. data/test/stack_printer_test.rb +64 -78
  101. data/test/start_stop_test.rb +109 -112
  102. data/test/test_helper.rb +13 -115
  103. data/test/thread_test.rb +144 -178
  104. data/test/unique_call_path_test.rb +120 -224
  105. data/test/yarv_test.rb +56 -0
  106. metadata +77 -133
  107. data/doc/LICENSE.html +0 -155
  108. data/doc/README_rdoc.html +0 -648
  109. data/doc/Rack.html +0 -167
  110. data/doc/Rack/RubyProf.html +0 -319
  111. data/doc/RubyProf.html +0 -1000
  112. data/doc/RubyProf/AbstractPrinter.html +0 -580
  113. data/doc/RubyProf/AggregateCallInfo.html +0 -570
  114. data/doc/RubyProf/CallInfo.html +0 -512
  115. data/doc/RubyProf/CallInfoPrinter.html +0 -190
  116. data/doc/RubyProf/CallInfoVisitor.html +0 -332
  117. data/doc/RubyProf/CallStackPrinter.html +0 -1600
  118. data/doc/RubyProf/CallTreePrinter.html +0 -413
  119. data/doc/RubyProf/Cmd.html +0 -669
  120. data/doc/RubyProf/DotPrinter.html +0 -312
  121. data/doc/RubyProf/FlatPrinter.html +0 -229
  122. data/doc/RubyProf/FlatPrinterWithLineNumbers.html +0 -267
  123. data/doc/RubyProf/GraphHtmlPrinter.html +0 -630
  124. data/doc/RubyProf/GraphPrinter.html +0 -209
  125. data/doc/RubyProf/MethodInfo.html +0 -713
  126. data/doc/RubyProf/MultiPrinter.html +0 -407
  127. data/doc/RubyProf/Profile.html +0 -821
  128. data/doc/RubyProf/ProfileTask.html +0 -532
  129. data/doc/RubyProf/Test.html +0 -578
  130. data/doc/RubyProf/Thread.html +0 -262
  131. data/doc/created.rid +0 -32
  132. data/doc/examples/flat_txt.html +0 -191
  133. data/doc/examples/graph_txt.html +0 -305
  134. data/doc/images/add.png +0 -0
  135. data/doc/images/brick.png +0 -0
  136. data/doc/images/brick_link.png +0 -0
  137. data/doc/images/bug.png +0 -0
  138. data/doc/images/bullet_black.png +0 -0
  139. data/doc/images/bullet_toggle_minus.png +0 -0
  140. data/doc/images/bullet_toggle_plus.png +0 -0
  141. data/doc/images/date.png +0 -0
  142. data/doc/images/delete.png +0 -0
  143. data/doc/images/find.png +0 -0
  144. data/doc/images/loadingAnimation.gif +0 -0
  145. data/doc/images/macFFBgHack.png +0 -0
  146. data/doc/images/package.png +0 -0
  147. data/doc/images/page_green.png +0 -0
  148. data/doc/images/page_white_text.png +0 -0
  149. data/doc/images/page_white_width.png +0 -0
  150. data/doc/images/plugin.png +0 -0
  151. data/doc/images/ruby.png +0 -0
  152. data/doc/images/tag_blue.png +0 -0
  153. data/doc/images/tag_green.png +0 -0
  154. data/doc/images/transparent.png +0 -0
  155. data/doc/images/wrench.png +0 -0
  156. data/doc/images/wrench_orange.png +0 -0
  157. data/doc/images/zoom.png +0 -0
  158. data/doc/index.html +0 -647
  159. data/doc/js/darkfish.js +0 -155
  160. data/doc/js/jquery.js +0 -18
  161. data/doc/js/navigation.js +0 -142
  162. data/doc/js/search.js +0 -94
  163. data/doc/js/search_index.js +0 -1
  164. data/doc/js/searcher.js +0 -228
  165. data/doc/rdoc.css +0 -543
  166. data/doc/table_of_contents.html +0 -462
  167. data/examples/empty.png +0 -0
  168. data/examples/flat.txt +0 -55
  169. data/examples/graph.dot +0 -106
  170. data/examples/graph.html +0 -823
  171. data/examples/graph.png +0 -0
  172. data/examples/graph.txt +0 -170
  173. data/examples/minus.png +0 -0
  174. data/examples/multi.flat.txt +0 -23
  175. data/examples/multi.graph.html +0 -906
  176. data/examples/multi.grind.dat +0 -194
  177. data/examples/multi.stack.html +0 -573
  178. data/examples/plus.png +0 -0
  179. data/examples/stack.html +0 -573
  180. data/ext/ruby_prof/rp_call_info.c +0 -407
  181. data/ext/ruby_prof/rp_call_info.h +0 -48
  182. data/ext/ruby_prof/rp_measure.c +0 -48
  183. data/ext/ruby_prof/rp_measure.h +0 -45
  184. data/ext/ruby_prof/rp_measure_cpu_time.c +0 -112
  185. data/ext/ruby_prof/rp_measure_gc_runs.c +0 -65
  186. data/ext/ruby_prof/rp_measure_gc_time.c +0 -57
  187. data/ext/ruby_prof/vc/ruby_prof_18.vcxproj +0 -108
  188. data/ext/ruby_prof/vc/ruby_prof_19.vcxproj +0 -110
  189. data/ext/ruby_prof/version.h +0 -7
  190. data/lib/ruby-prof/aggregate_call_info.rb +0 -72
  191. data/lib/ruby-prof/call_info.rb +0 -89
  192. data/lib/ruby-prof/call_info_visitor.rb +0 -44
  193. data/lib/ruby-prof/images/empty.png +0 -0
  194. data/lib/ruby-prof/images/minus.png +0 -0
  195. data/lib/ruby-prof/images/plus.png +0 -0
  196. data/lib/ruby-prof/printers/flat_printer_with_line_numbers.rb +0 -57
  197. data/lib/ruby-prof/test.rb +0 -150
  198. data/test/aggregate_test.rb +0 -136
  199. data/test/call_info_test.rb +0 -78
  200. data/test/call_info_visitor_test.rb +0 -31
  201. data/test/exec_test.rb +0 -14
  202. data/test/measure_cpu_time_test.rb +0 -220
  203. data/test/measure_gc_runs_test.rb +0 -32
  204. data/test/measure_gc_time_test.rb +0 -36
  205. data/test/measure_memory_test.rb +0 -31
  206. data/test/method_elimination_test.rb +0 -84
  207. data/test/module_test.rb +0 -45
  208. data/test/stack_test.rb +0 -138
  209. data/test/test_suite.rb +0 -37
@@ -1,532 +0,0 @@
1
- <!DOCTYPE html>
2
-
3
- <html>
4
- <head>
5
- <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
6
-
7
- <title>class RubyProf::ProfileTask - ruby-prof</title>
8
-
9
- <link type="text/css" media="screen" href="../rdoc.css" rel="stylesheet">
10
-
11
- <script type="text/javascript">
12
- var rdoc_rel_prefix = "../";
13
- </script>
14
-
15
- <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
16
- <script type="text/javascript" charset="utf-8" src="../js/navigation.js"></script>
17
- <script type="text/javascript" charset="utf-8" src="../js/search_index.js"></script>
18
- <script type="text/javascript" charset="utf-8" src="../js/search.js"></script>
19
- <script type="text/javascript" charset="utf-8" src="../js/searcher.js"></script>
20
- <script type="text/javascript" charset="utf-8" src="../js/darkfish.js"></script>
21
-
22
-
23
- <body id="top" class="class">
24
- <nav id="metadata">
25
- <nav id="home-section" class="section">
26
- <h3 class="section-header">
27
- <a href="../index.html">Home</a>
28
- <a href="../table_of_contents.html#classes">Classes</a>
29
- <a href="../table_of_contents.html#methods">Methods</a>
30
- </h3>
31
- </nav>
32
-
33
-
34
- <nav id="search-section" class="section project-section" class="initially-hidden">
35
- <form action="#" method="get" accept-charset="utf-8">
36
- <h3 class="section-header">
37
- <input type="text" name="search" placeholder="Search" id="search-field"
38
- title="Type to search, Up and Down to navigate, Enter to load">
39
- </h3>
40
- </form>
41
-
42
- <ul id="search-results" class="initially-hidden"></ul>
43
- </nav>
44
-
45
-
46
- <div id="file-metadata">
47
- <nav id="file-list-section" class="section">
48
- <h3 class="section-header">Defined In</h3>
49
- <ul>
50
- <li>lib/ruby-prof/task.rb
51
- </ul>
52
- </nav>
53
-
54
-
55
- </div>
56
-
57
- <div id="class-metadata">
58
-
59
- <nav id="parent-class-section" class="section">
60
- <h3 class="section-header">Parent</h3>
61
-
62
- <p class="link">Rake::TestTask
63
-
64
- </nav>
65
-
66
-
67
- <!-- Method Quickref -->
68
- <nav id="method-list-section" class="section">
69
- <h3 class="section-header">Methods</h3>
70
-
71
- <ul class="link-list">
72
-
73
- <li><a href="#method-c-new">::new</a>
74
-
75
- <li><a href="#method-i-clean_output_directory">#clean_output_directory</a>
76
-
77
- <li><a href="#method-i-create_output_directory">#create_output_directory</a>
78
-
79
- <li><a href="#method-i-define">#define</a>
80
-
81
- <li><a href="#method-i-output_directory">#output_directory</a>
82
-
83
- <li><a href="#method-i-run_script">#run_script</a>
84
-
85
- </ul>
86
- </nav>
87
-
88
- </div>
89
-
90
- <div id="project-metadata">
91
- <nav id="fileindex-section" class="section project-section">
92
- <h3 class="section-header">Pages</h3>
93
-
94
- <ul>
95
-
96
- <li class="file"><a href="../LICENSE.html">LICENSE</a>
97
-
98
- <li class="file"><a href="../README_rdoc.html">README</a>
99
-
100
- <li class="file"><a href="../examples/flat_txt.html">flat</a>
101
-
102
- <li class="file"><a href="../examples/graph_txt.html">graph</a>
103
-
104
- </ul>
105
- </nav>
106
-
107
- <nav id="classindex-section" class="section project-section">
108
- <h3 class="section-header">Class and Module Index</h3>
109
-
110
- <ul class="link-list">
111
-
112
- <li><a href="../RubyProf.html">RubyProf</a>
113
-
114
- <li><a href="../RubyProf/AbstractPrinter.html">RubyProf::AbstractPrinter</a>
115
-
116
- <li><a href="../RubyProf/AggregateCallInfo.html">RubyProf::AggregateCallInfo</a>
117
-
118
- <li><a href="../RubyProf/CallInfo.html">RubyProf::CallInfo</a>
119
-
120
- <li><a href="../RubyProf/CallInfoPrinter.html">RubyProf::CallInfoPrinter</a>
121
-
122
- <li><a href="../RubyProf/CallInfoVisitor.html">RubyProf::CallInfoVisitor</a>
123
-
124
- <li><a href="../RubyProf/CallStackPrinter.html">RubyProf::CallStackPrinter</a>
125
-
126
- <li><a href="../RubyProf/CallTreePrinter.html">RubyProf::CallTreePrinter</a>
127
-
128
- <li><a href="../RubyProf/Cmd.html">RubyProf::Cmd</a>
129
-
130
- <li><a href="../RubyProf/DotPrinter.html">RubyProf::DotPrinter</a>
131
-
132
- <li><a href="../RubyProf/FlatPrinter.html">RubyProf::FlatPrinter</a>
133
-
134
- <li><a href="../RubyProf/FlatPrinterWithLineNumbers.html">RubyProf::FlatPrinterWithLineNumbers</a>
135
-
136
- <li><a href="../RubyProf/GraphHtmlPrinter.html">RubyProf::GraphHtmlPrinter</a>
137
-
138
- <li><a href="../RubyProf/GraphPrinter.html">RubyProf::GraphPrinter</a>
139
-
140
- <li><a href="../RubyProf/MethodInfo.html">RubyProf::MethodInfo</a>
141
-
142
- <li><a href="../RubyProf/MultiPrinter.html">RubyProf::MultiPrinter</a>
143
-
144
- <li><a href="../RubyProf/Profile.html">RubyProf::Profile</a>
145
-
146
- <li><a href="../RubyProf/ProfileTask.html">RubyProf::ProfileTask</a>
147
-
148
- <li><a href="../RubyProf/Test.html">RubyProf::Test</a>
149
-
150
- <li><a href="../RubyProf/Thread.html">RubyProf::Thread</a>
151
-
152
- <li><a href="../Rack.html">Rack</a>
153
-
154
- <li><a href="../Rack/RubyProf.html">Rack::RubyProf</a>
155
-
156
- </ul>
157
- </nav>
158
-
159
- </div>
160
- </nav>
161
-
162
- <div id="documentation">
163
- <h1 class="class">class RubyProf::ProfileTask</h1>
164
-
165
- <div id="description" class="description">
166
-
167
- <p>Define a task library for profiling unit tests with ruby-prof.</p>
168
-
169
- <p>All of the options provided by the Rake:TestTask are supported except the
170
- loader which is set to ruby-prof. For detailed information please refer to
171
- the Rake:TestTask documentation.</p>
172
-
173
- <p>ruby-prof specific options include:</p>
174
-
175
- <pre>output_dir - For each file specified an output
176
- file with profile information will be
177
- written to the output directory.
178
- By default, the output directory is
179
- called &quot;profile&quot; and is created underneath
180
- the current working directory.
181
-
182
- printer - Specifies the output printer. Valid values include
183
- :flat, :graph, :graph_html and :call_tree.
184
-
185
- min_percent - Methods that take less than the specified percent
186
- will not be written out.</pre>
187
-
188
- <p>Example:</p>
189
-
190
- <pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;ruby-prof/task&#39;</span>
191
-
192
- <span class="ruby-constant">RubyProf</span><span class="ruby-operator">::</span><span class="ruby-constant">ProfileTask</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">t</span><span class="ruby-operator">|</span>
193
- <span class="ruby-identifier">t</span>.<span class="ruby-identifier">test_files</span> = <span class="ruby-constant">FileList</span>[<span class="ruby-string">&#39;test/test*.rb&#39;</span>]
194
- <span class="ruby-identifier">t</span>.<span class="ruby-identifier">output_dir</span> = <span class="ruby-string">&quot;c:/temp&quot;</span>
195
- <span class="ruby-identifier">t</span>.<span class="ruby-identifier">printer</span> = :<span class="ruby-identifier">graph</span>
196
- <span class="ruby-identifier">t</span>.<span class="ruby-identifier">min_percent</span> = <span class="ruby-value">10</span>
197
- <span class="ruby-keyword">end</span>
198
- </pre>
199
-
200
- <p>If rake is invoked with a “TEST=filename” command line option, then the
201
- list of test files will be overridden to include only the filename
202
- specified on the command line. This provides an easy way to run just one
203
- test.</p>
204
-
205
- <p>If rake is invoked with a “TESTOPTS=options” command line option, then the
206
- given options are passed to the test process after a &#39;–&#39;. This
207
- allows Test::Unit options to be passed to the test suite.</p>
208
-
209
- <p>Examples:</p>
210
-
211
- <pre>rake profile # run tests normally
212
- rake profile TEST=just_one_file.rb # run just one test file.
213
- rake profile TESTOPTS=&quot;-v&quot; # run in verbose mode
214
- rake profile TESTOPTS=&quot;--runner=fox&quot; # use the fox test runner</pre>
215
-
216
- </div><!-- description -->
217
-
218
-
219
-
220
-
221
- <section id="5Buntitled-5D" class="documentation-section">
222
-
223
-
224
-
225
-
226
-
227
-
228
-
229
- <!-- Attributes -->
230
- <section id="attribute-method-details" class="method-section section">
231
- <h3 class="section-header">Attributes</h3>
232
-
233
-
234
- <div id="attribute-i-min_percent" class="method-detail">
235
- <div class="method-heading attribute-method-heading">
236
- <span class="method-name">min_percent</span><span
237
- class="attribute-access-type">[RW]</span>
238
- </div>
239
-
240
- <div class="method-description">
241
-
242
-
243
-
244
- </div>
245
- </div>
246
-
247
- <div id="attribute-i-output_dir" class="method-detail">
248
- <div class="method-heading attribute-method-heading">
249
- <span class="method-name">output_dir</span><span
250
- class="attribute-access-type">[RW]</span>
251
- </div>
252
-
253
- <div class="method-description">
254
-
255
-
256
-
257
- </div>
258
- </div>
259
-
260
- <div id="attribute-i-printer" class="method-detail">
261
- <div class="method-heading attribute-method-heading">
262
- <span class="method-name">printer</span><span
263
- class="attribute-access-type">[RW]</span>
264
- </div>
265
-
266
- <div class="method-description">
267
-
268
-
269
-
270
- </div>
271
- </div>
272
-
273
- </section><!-- attribute-method-details -->
274
-
275
-
276
- <!-- Methods -->
277
-
278
- <section id="public-class-5Buntitled-5D-method-details" class="method-section section">
279
- <h3 class="section-header">Public Class Methods</h3>
280
-
281
-
282
- <div id="method-c-new" class="method-detail ">
283
-
284
- <div class="method-heading">
285
- <span class="method-name">new</span><span
286
- class="method-args">(name = :profile)</span>
287
- <span class="method-click-advice">click to toggle source</span>
288
- </div>
289
-
290
-
291
- <div class="method-description">
292
-
293
-
294
-
295
-
296
-
297
- <div class="method-source-code" id="new-source">
298
- <pre><span class="ruby-comment"># File lib/ruby-prof/task.rb, line 63</span>
299
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">name</span> = <span class="ruby-value">:profile</span>)
300
- <span class="ruby-keyword">super</span>(<span class="ruby-identifier">name</span>)
301
- <span class="ruby-keyword">end</span></pre>
302
- </div><!-- new-source -->
303
-
304
- </div>
305
-
306
-
307
-
308
-
309
- </div><!-- new-method -->
310
-
311
-
312
- </section><!-- public-class-method-details -->
313
-
314
- <section id="public-instance-5Buntitled-5D-method-details" class="method-section section">
315
- <h3 class="section-header">Public Instance Methods</h3>
316
-
317
-
318
- <div id="method-i-clean_output_directory" class="method-detail ">
319
-
320
- <div class="method-heading">
321
- <span class="method-name">clean_output_directory</span><span
322
- class="method-args">()</span>
323
- <span class="method-click-advice">click to toggle source</span>
324
- </div>
325
-
326
-
327
- <div class="method-description">
328
-
329
-
330
-
331
-
332
-
333
- <div class="method-source-code" id="clean_output_directory-source">
334
- <pre><span class="ruby-comment"># File lib/ruby-prof/task.rb, line 134</span>
335
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">clean_output_directory</span>
336
- <span class="ruby-keyword">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-identifier">output_directory</span>)
337
- <span class="ruby-identifier">files</span> = <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">glob</span>(<span class="ruby-identifier">output_directory</span> <span class="ruby-operator">+</span> <span class="ruby-string">&#39;/*&#39;</span>)
338
- <span class="ruby-constant">FileUtils</span>.<span class="ruby-identifier">rm</span>(<span class="ruby-identifier">files</span>)
339
- <span class="ruby-keyword">end</span>
340
- <span class="ruby-keyword">end</span></pre>
341
- </div><!-- clean_output_directory-source -->
342
-
343
- </div>
344
-
345
-
346
-
347
-
348
- </div><!-- clean_output_directory-method -->
349
-
350
-
351
- <div id="method-i-create_output_directory" class="method-detail ">
352
-
353
- <div class="method-heading">
354
- <span class="method-name">create_output_directory</span><span
355
- class="method-args">()</span>
356
- <span class="method-click-advice">click to toggle source</span>
357
- </div>
358
-
359
-
360
- <div class="method-description">
361
-
362
-
363
-
364
-
365
-
366
- <div class="method-source-code" id="create_output_directory-source">
367
- <pre><span class="ruby-comment"># File lib/ruby-prof/task.rb, line 128</span>
368
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">create_output_directory</span>
369
- <span class="ruby-keyword">if</span> <span class="ruby-keyword">not</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-identifier">output_directory</span>)
370
- <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">mkdir</span>(<span class="ruby-identifier">output_directory</span>)
371
- <span class="ruby-keyword">end</span>
372
- <span class="ruby-keyword">end</span></pre>
373
- </div><!-- create_output_directory-source -->
374
-
375
- </div>
376
-
377
-
378
-
379
-
380
- </div><!-- create_output_directory-method -->
381
-
382
-
383
- <div id="method-i-define" class="method-detail ">
384
-
385
- <div class="method-heading">
386
- <span class="method-name">define</span><span
387
- class="method-args">()</span>
388
- <span class="method-click-advice">click to toggle source</span>
389
- </div>
390
-
391
-
392
- <div class="method-description">
393
-
394
- <p>Create the tasks defined by this task lib.</p>
395
-
396
-
397
-
398
- <div class="method-source-code" id="define-source">
399
- <pre><span class="ruby-comment"># File lib/ruby-prof/task.rb, line 68</span>
400
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">define</span>
401
- <span class="ruby-identifier">lib_path</span> = <span class="ruby-ivar">@libs</span>.<span class="ruby-identifier">join</span>(<span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">PATH_SEPARATOR</span>)
402
- <span class="ruby-identifier">desc</span> <span class="ruby-string">&quot;Profile&quot;</span> <span class="ruby-operator">+</span> (<span class="ruby-ivar">@name</span><span class="ruby-operator">==</span><span class="ruby-value">:profile</span> <span class="ruby-operator">?</span> <span class="ruby-string">&quot;&quot;</span> <span class="ruby-operator">:</span> <span class="ruby-node">&quot; for #{@name}&quot;</span>)
403
-
404
- <span class="ruby-identifier">task</span> <span class="ruby-ivar">@name</span> <span class="ruby-keyword">do</span>
405
- <span class="ruby-identifier">create_output_directory</span>
406
-
407
- <span class="ruby-ivar">@ruby_opts</span>.<span class="ruby-identifier">unshift</span>( <span class="ruby-node">&quot;-I#{lib_path}&quot;</span> )
408
- <span class="ruby-ivar">@ruby_opts</span>.<span class="ruby-identifier">unshift</span>( <span class="ruby-string">&quot;-w&quot;</span> ) <span class="ruby-keyword">if</span> <span class="ruby-ivar">@warning</span>
409
- <span class="ruby-ivar">@ruby_opts</span>.<span class="ruby-identifier">push</span>(<span class="ruby-string">&quot;-S ruby-prof&quot;</span>)
410
- <span class="ruby-ivar">@ruby_opts</span>.<span class="ruby-identifier">push</span>(<span class="ruby-node">&quot;--printer #{@printer}&quot;</span>)
411
- <span class="ruby-ivar">@ruby_opts</span>.<span class="ruby-identifier">push</span>(<span class="ruby-node">&quot;--min_percent #{@min_percent}&quot;</span>)
412
-
413
- <span class="ruby-identifier">file_list</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file_path</span><span class="ruby-operator">|</span>
414
- <span class="ruby-identifier">run_script</span>(<span class="ruby-identifier">file_path</span>)
415
- <span class="ruby-keyword">end</span>
416
- <span class="ruby-keyword">end</span>
417
- <span class="ruby-keyword">self</span>
418
- <span class="ruby-keyword">end</span></pre>
419
- </div><!-- define-source -->
420
-
421
- </div>
422
-
423
-
424
-
425
-
426
- </div><!-- define-method -->
427
-
428
-
429
- <div id="method-i-output_directory" class="method-detail ">
430
-
431
- <div class="method-heading">
432
- <span class="method-name">output_directory</span><span
433
- class="method-args">()</span>
434
- <span class="method-click-advice">click to toggle source</span>
435
- </div>
436
-
437
-
438
- <div class="method-description">
439
-
440
-
441
-
442
-
443
-
444
- <div class="method-source-code" id="output_directory-source">
445
- <pre><span class="ruby-comment"># File lib/ruby-prof/task.rb, line 124</span>
446
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">output_directory</span>
447
- <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-ivar">@output_dir</span>)
448
- <span class="ruby-keyword">end</span></pre>
449
- </div><!-- output_directory-source -->
450
-
451
- </div>
452
-
453
-
454
-
455
-
456
- </div><!-- output_directory-method -->
457
-
458
-
459
- <div id="method-i-run_script" class="method-detail ">
460
-
461
- <div class="method-heading">
462
- <span class="method-name">run_script</span><span
463
- class="method-args">(script_path)</span>
464
- <span class="method-click-advice">click to toggle source</span>
465
- </div>
466
-
467
-
468
- <div class="method-description">
469
-
470
- <p>Run script</p>
471
-
472
-
473
-
474
- <div class="method-source-code" id="run_script-source">
475
- <pre><span class="ruby-comment"># File lib/ruby-prof/task.rb, line 89</span>
476
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">run_script</span>(<span class="ruby-identifier">script_path</span>)
477
- <span class="ruby-identifier">run_code</span> = <span class="ruby-string">&#39;&#39;</span>
478
- <span class="ruby-constant">RakeFileUtils</span>.<span class="ruby-identifier">verbose</span>(<span class="ruby-ivar">@verbose</span>) <span class="ruby-keyword">do</span>
479
- <span class="ruby-identifier">file_name</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-identifier">script_path</span>, <span class="ruby-constant">File</span>.<span class="ruby-identifier">extname</span>(<span class="ruby-identifier">script_path</span>))
480
- <span class="ruby-keyword">case</span> <span class="ruby-ivar">@printer</span>
481
- <span class="ruby-keyword">when</span> <span class="ruby-value">:flat</span>, <span class="ruby-value">:graph</span>, <span class="ruby-value">:call_tree</span>
482
- <span class="ruby-identifier">file_name</span> <span class="ruby-operator">+=</span> <span class="ruby-string">&quot;.txt&quot;</span>
483
- <span class="ruby-keyword">when</span> <span class="ruby-value">:graph_html</span>
484
- <span class="ruby-identifier">file_name</span> <span class="ruby-operator">+=</span> <span class="ruby-string">&quot;.html&quot;</span>
485
- <span class="ruby-keyword">else</span>
486
- <span class="ruby-identifier">file_name</span> <span class="ruby-operator">+=</span> <span class="ruby-string">&quot;.txt&quot;</span>
487
- <span class="ruby-keyword">end</span>
488
-
489
- <span class="ruby-identifier">output_file_path</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">output_directory</span>, <span class="ruby-identifier">file_name</span>)
490
-
491
- <span class="ruby-identifier">command_line</span> = <span class="ruby-ivar">@ruby_opts</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">&quot; &quot;</span>) <span class="ruby-operator">+</span>
492
- <span class="ruby-string">&quot; --file=&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">output_file_path</span> <span class="ruby-operator">+</span>
493
- <span class="ruby-string">&quot; &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">script_path</span>
494
-
495
- <span class="ruby-identifier">puts</span> <span class="ruby-string">&quot;ruby &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">command_line</span>
496
- <span class="ruby-comment"># We have to catch the exeption to continue on. However,</span>
497
- <span class="ruby-comment"># the error message will have been output to STDERR</span>
498
- <span class="ruby-comment"># already by the time we get here so we don&#39;t have to</span>
499
- <span class="ruby-comment"># do that again</span>
500
- <span class="ruby-keyword">begin</span>
501
- <span class="ruby-identifier">ruby</span> <span class="ruby-identifier">command_line</span>
502
- <span class="ruby-keyword">rescue</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
503
- <span class="ruby-constant">STDOUT</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">e</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-string">&quot;\n&quot;</span>
504
- <span class="ruby-constant">STDOUT</span>.<span class="ruby-identifier">flush</span>
505
- <span class="ruby-keyword">end</span>
506
- <span class="ruby-identifier">puts</span> <span class="ruby-string">&quot;&quot;</span>
507
- <span class="ruby-identifier">puts</span> <span class="ruby-string">&quot;&quot;</span>
508
- <span class="ruby-keyword">end</span>
509
- <span class="ruby-keyword">end</span></pre>
510
- </div><!-- run_script-source -->
511
-
512
- </div>
513
-
514
-
515
-
516
-
517
- </div><!-- run_script-method -->
518
-
519
-
520
- </section><!-- public-instance-method-details -->
521
-
522
- </section><!-- 5Buntitled-5D -->
523
-
524
- </div><!-- documentation -->
525
-
526
-
527
- <footer id="validator-badges">
528
- <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
529
- <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.1.
530
- <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
531
- </footer>
532
-