ruby-prof 0.13.1 → 1.4.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +5 -5
- data/CHANGES +579 -371
- data/LICENSE +24 -23
- data/README.rdoc +5 -433
- data/Rakefile +98 -110
- data/bin/ruby-prof +328 -329
- data/bin/ruby-prof-check-trace +45 -0
- data/ext/ruby_prof/extconf.rb +16 -59
- data/ext/ruby_prof/rp_aggregate_call_tree.c +59 -0
- data/ext/ruby_prof/rp_aggregate_call_tree.h +13 -0
- data/ext/ruby_prof/rp_allocation.c +287 -0
- data/ext/ruby_prof/rp_allocation.h +31 -0
- data/ext/ruby_prof/rp_call_tree.c +369 -0
- data/ext/ruby_prof/rp_call_tree.h +43 -0
- data/ext/ruby_prof/rp_call_trees.c +288 -0
- data/ext/ruby_prof/rp_call_trees.h +28 -0
- data/ext/ruby_prof/rp_measure_allocations.c +50 -65
- data/ext/ruby_prof/rp_measure_memory.c +42 -73
- data/ext/ruby_prof/rp_measure_process_time.c +65 -71
- data/ext/ruby_prof/rp_measure_wall_time.c +64 -42
- data/ext/ruby_prof/rp_measurement.c +237 -0
- data/ext/ruby_prof/rp_measurement.h +50 -0
- data/ext/ruby_prof/rp_method.c +491 -420
- data/ext/ruby_prof/rp_method.h +62 -57
- data/ext/ruby_prof/rp_profile.c +908 -0
- data/ext/ruby_prof/rp_profile.h +35 -0
- data/ext/ruby_prof/rp_stack.c +212 -128
- data/ext/ruby_prof/rp_stack.h +53 -51
- data/ext/ruby_prof/rp_thread.c +362 -268
- data/ext/ruby_prof/rp_thread.h +39 -27
- data/ext/ruby_prof/ruby_prof.c +52 -695
- data/ext/ruby_prof/ruby_prof.h +26 -55
- data/ext/ruby_prof/vc/ruby_prof.sln +28 -21
- data/ext/ruby_prof/vc/{ruby_prof_20.vcxproj → ruby_prof.vcxproj} +56 -8
- data/lib/ruby-prof.rb +52 -67
- data/lib/ruby-prof/assets/call_stack_printer.html.erb +710 -0
- data/lib/ruby-prof/assets/call_stack_printer.png +0 -0
- data/lib/ruby-prof/assets/graph_printer.html.erb +355 -0
- data/lib/ruby-prof/call_tree.rb +57 -0
- data/lib/ruby-prof/call_tree_visitor.rb +36 -0
- data/lib/ruby-prof/compatibility.rb +99 -169
- data/lib/ruby-prof/exclude_common_methods.rb +198 -0
- data/lib/ruby-prof/measurement.rb +17 -0
- data/lib/ruby-prof/method_info.rb +78 -131
- data/lib/ruby-prof/printers/abstract_printer.rb +137 -85
- data/lib/ruby-prof/printers/call_info_printer.rb +53 -41
- data/lib/ruby-prof/printers/call_stack_printer.rb +180 -773
- data/lib/ruby-prof/printers/call_tree_printer.rb +151 -92
- data/lib/ruby-prof/printers/dot_printer.rb +132 -132
- data/lib/ruby-prof/printers/flat_printer.rb +53 -69
- data/lib/ruby-prof/printers/graph_html_printer.rb +63 -255
- data/lib/ruby-prof/printers/graph_printer.rb +113 -116
- data/lib/ruby-prof/printers/multi_printer.rb +127 -56
- data/lib/ruby-prof/profile.rb +37 -77
- data/lib/ruby-prof/rack.rb +62 -15
- data/lib/ruby-prof/task.rb +147 -147
- data/lib/ruby-prof/thread.rb +10 -12
- data/lib/ruby-prof/version.rb +3 -0
- data/lib/unprof.rb +10 -10
- data/ruby-prof.gemspec +65 -61
- data/test/abstract_printer_test.rb +26 -0
- data/test/alias_test.rb +126 -0
- data/test/basic_test.rb +43 -128
- data/test/call_tree_visitor_test.rb +32 -0
- data/test/call_trees_test.rb +66 -0
- data/test/duplicate_names_test.rb +32 -32
- data/test/dynamic_method_test.rb +53 -74
- data/test/enumerable_test.rb +21 -16
- data/test/exceptions_test.rb +24 -16
- data/test/exclude_methods_test.rb +151 -0
- data/test/exclude_threads_test.rb +53 -54
- data/test/fiber_test.rb +129 -65
- data/test/gc_test.rb +90 -0
- data/test/inverse_call_tree_test.rb +175 -0
- data/test/line_number_test.rb +158 -71
- data/test/marshal_test.rb +113 -0
- data/test/measure_allocations.rb +30 -0
- data/test/measure_allocations_test.rb +375 -25
- data/test/measure_allocations_trace_test.rb +375 -0
- data/test/measure_memory_trace_test.rb +1101 -0
- data/test/measure_process_time_test.rb +785 -62
- data/test/measure_times.rb +56 -0
- data/test/measure_wall_time_test.rb +434 -254
- data/test/multi_printer_test.rb +71 -82
- data/test/no_method_class_test.rb +15 -15
- data/test/pause_resume_test.rb +175 -166
- data/test/prime.rb +54 -54
- data/test/prime_script.rb +6 -0
- data/test/printer_call_stack_test.rb +27 -0
- data/test/printer_call_tree_test.rb +30 -0
- data/test/printer_flat_test.rb +99 -0
- data/test/printer_graph_html_test.rb +59 -0
- data/test/printer_graph_test.rb +40 -0
- data/test/printers_test.rb +141 -257
- data/test/printing_recursive_graph_test.rb +81 -0
- data/test/profile_test.rb +16 -0
- data/test/rack_test.rb +93 -0
- data/test/recursive_test.rb +206 -215
- data/test/singleton_test.rb +38 -38
- data/test/stack_printer_test.rb +64 -78
- data/test/start_stop_test.rb +109 -112
- data/test/test_helper.rb +13 -115
- data/test/thread_test.rb +144 -178
- data/test/unique_call_path_test.rb +120 -224
- data/test/yarv_test.rb +56 -0
- metadata +77 -133
- data/doc/LICENSE.html +0 -155
- data/doc/README_rdoc.html +0 -648
- data/doc/Rack.html +0 -167
- data/doc/Rack/RubyProf.html +0 -319
- data/doc/RubyProf.html +0 -1000
- data/doc/RubyProf/AbstractPrinter.html +0 -580
- data/doc/RubyProf/AggregateCallInfo.html +0 -570
- data/doc/RubyProf/CallInfo.html +0 -512
- data/doc/RubyProf/CallInfoPrinter.html +0 -190
- data/doc/RubyProf/CallInfoVisitor.html +0 -332
- data/doc/RubyProf/CallStackPrinter.html +0 -1600
- data/doc/RubyProf/CallTreePrinter.html +0 -413
- data/doc/RubyProf/Cmd.html +0 -669
- data/doc/RubyProf/DotPrinter.html +0 -312
- data/doc/RubyProf/FlatPrinter.html +0 -229
- data/doc/RubyProf/FlatPrinterWithLineNumbers.html +0 -267
- data/doc/RubyProf/GraphHtmlPrinter.html +0 -630
- data/doc/RubyProf/GraphPrinter.html +0 -209
- data/doc/RubyProf/MethodInfo.html +0 -713
- data/doc/RubyProf/MultiPrinter.html +0 -407
- data/doc/RubyProf/Profile.html +0 -821
- data/doc/RubyProf/ProfileTask.html +0 -532
- data/doc/RubyProf/Test.html +0 -578
- data/doc/RubyProf/Thread.html +0 -262
- data/doc/created.rid +0 -32
- data/doc/examples/flat_txt.html +0 -191
- data/doc/examples/graph_txt.html +0 -305
- data/doc/images/add.png +0 -0
- data/doc/images/brick.png +0 -0
- data/doc/images/brick_link.png +0 -0
- data/doc/images/bug.png +0 -0
- data/doc/images/bullet_black.png +0 -0
- data/doc/images/bullet_toggle_minus.png +0 -0
- data/doc/images/bullet_toggle_plus.png +0 -0
- data/doc/images/date.png +0 -0
- data/doc/images/delete.png +0 -0
- data/doc/images/find.png +0 -0
- data/doc/images/loadingAnimation.gif +0 -0
- data/doc/images/macFFBgHack.png +0 -0
- data/doc/images/package.png +0 -0
- data/doc/images/page_green.png +0 -0
- data/doc/images/page_white_text.png +0 -0
- data/doc/images/page_white_width.png +0 -0
- data/doc/images/plugin.png +0 -0
- data/doc/images/ruby.png +0 -0
- data/doc/images/tag_blue.png +0 -0
- data/doc/images/tag_green.png +0 -0
- data/doc/images/transparent.png +0 -0
- data/doc/images/wrench.png +0 -0
- data/doc/images/wrench_orange.png +0 -0
- data/doc/images/zoom.png +0 -0
- data/doc/index.html +0 -647
- data/doc/js/darkfish.js +0 -155
- data/doc/js/jquery.js +0 -18
- data/doc/js/navigation.js +0 -142
- data/doc/js/search.js +0 -94
- data/doc/js/search_index.js +0 -1
- data/doc/js/searcher.js +0 -228
- data/doc/rdoc.css +0 -543
- data/doc/table_of_contents.html +0 -462
- data/examples/empty.png +0 -0
- data/examples/flat.txt +0 -55
- data/examples/graph.dot +0 -106
- data/examples/graph.html +0 -823
- data/examples/graph.png +0 -0
- data/examples/graph.txt +0 -170
- data/examples/minus.png +0 -0
- data/examples/multi.flat.txt +0 -23
- data/examples/multi.graph.html +0 -906
- data/examples/multi.grind.dat +0 -194
- data/examples/multi.stack.html +0 -573
- data/examples/plus.png +0 -0
- data/examples/stack.html +0 -573
- data/ext/ruby_prof/rp_call_info.c +0 -407
- data/ext/ruby_prof/rp_call_info.h +0 -48
- data/ext/ruby_prof/rp_measure.c +0 -48
- data/ext/ruby_prof/rp_measure.h +0 -45
- data/ext/ruby_prof/rp_measure_cpu_time.c +0 -112
- data/ext/ruby_prof/rp_measure_gc_runs.c +0 -65
- data/ext/ruby_prof/rp_measure_gc_time.c +0 -57
- data/ext/ruby_prof/vc/ruby_prof_18.vcxproj +0 -108
- data/ext/ruby_prof/vc/ruby_prof_19.vcxproj +0 -110
- data/ext/ruby_prof/version.h +0 -7
- data/lib/ruby-prof/aggregate_call_info.rb +0 -72
- data/lib/ruby-prof/call_info.rb +0 -89
- data/lib/ruby-prof/call_info_visitor.rb +0 -44
- data/lib/ruby-prof/images/empty.png +0 -0
- data/lib/ruby-prof/images/minus.png +0 -0
- data/lib/ruby-prof/images/plus.png +0 -0
- data/lib/ruby-prof/printers/flat_printer_with_line_numbers.rb +0 -57
- data/lib/ruby-prof/test.rb +0 -150
- data/test/aggregate_test.rb +0 -136
- data/test/call_info_test.rb +0 -78
- data/test/call_info_visitor_test.rb +0 -31
- data/test/exec_test.rb +0 -14
- data/test/measure_cpu_time_test.rb +0 -220
- data/test/measure_gc_runs_test.rb +0 -32
- data/test/measure_gc_time_test.rb +0 -36
- data/test/measure_memory_test.rb +0 -31
- data/test/method_elimination_test.rb +0 -84
- data/test/module_test.rb +0 -45
- data/test/stack_test.rb +0 -138
- 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 "profile" 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">'ruby-prof/task'</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">'test/test*.rb'</span>]
|
|
194
|
-
<span class="ruby-identifier">t</span>.<span class="ruby-identifier">output_dir</span> = <span class="ruby-string">"c:/temp"</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 '–'. 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="-v" # run in verbose mode
|
|
214
|
-
rake profile TESTOPTS="--runner=fox" # 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">'/*'</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">"Profile"</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">""</span> <span class="ruby-operator">:</span> <span class="ruby-node">" for #{@name}"</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">"-I#{lib_path}"</span> )
|
|
408
|
-
<span class="ruby-ivar">@ruby_opts</span>.<span class="ruby-identifier">unshift</span>( <span class="ruby-string">"-w"</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">"-S ruby-prof"</span>)
|
|
410
|
-
<span class="ruby-ivar">@ruby_opts</span>.<span class="ruby-identifier">push</span>(<span class="ruby-node">"--printer #{@printer}"</span>)
|
|
411
|
-
<span class="ruby-ivar">@ruby_opts</span>.<span class="ruby-identifier">push</span>(<span class="ruby-node">"--min_percent #{@min_percent}"</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">''</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">".txt"</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">".html"</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">".txt"</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">" "</span>) <span class="ruby-operator">+</span>
|
|
492
|
-
<span class="ruby-string">" --file="</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">output_file_path</span> <span class="ruby-operator">+</span>
|
|
493
|
-
<span class="ruby-string">" "</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">"ruby "</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'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">></span> <span class="ruby-identifier">e</span>
|
|
503
|
-
<span class="ruby-constant">STDOUT</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">e</span> <span class="ruby-operator"><<</span> <span class="ruby-string">"\n"</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">""</span>
|
|
507
|
-
<span class="ruby-identifier">puts</span> <span class="ruby-string">""</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
|
-
|