ruby-prof 2.0.3 → 2.0.4

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.
data/CHANGELOG.md CHANGED
@@ -1,607 +1,611 @@
1
- # Changelog
2
-
3
- ## 2.0.3 (2026-02-28)
4
- * Remove unnecessary visited set from FlameGraphPrinter (call tree is always acyclic)
5
- * Remove sort_by in FlameGraphPrinter to preserve natural call order
6
- * Add `max_depth` option to FlameGraphPrinter, CallStackPrinter, CallInfoPrinter, and CallTreeVisitor
7
- * Add documentation covering call tree construction and recursion handling
8
-
9
- ## 2.0.2 (2026-02-17)
10
- * Fix bin/ruby-prof passing printer options as positional arguments instead of keyword arguments
11
-
12
- ## 2.0.1 (2026-02-16)
13
- * Convert bin/ruby-prof endings from CRLF to LF
14
-
15
- ## 2.0.0 (2026-02-13)
16
- ### Features
17
- * Ruby 4.0 support.
18
- * Add flame graph visualizations with icicle mode toggle
19
- * Lots of documentation updates!
20
- * Apply consistent styling across all reports
21
- * Add `Profile#measure_mode_name` method for human-friendly measurement mode names (e.g., "Wall Time" instead of "wall_time")
22
- * Fix DotPrinter generating self-referencing edges (was using callers instead of callees)
23
- * Add Graphviz Online viewer link for dot output
24
-
25
- ### Backwards Incompatible Changes
26
- * Removed `RubyProf::MEMORY` measurement mode (no longer works on Ruby 4.0+)
27
- * Rremove compatibility API that was scheduled for removal in 2023
28
- * Printer options now use keyword arguments instead of an options hash. For example:
29
- ```ruby
30
- # Before:
31
- printer.print(STDOUT, :min_percent => 2, :sort_method => :self_time)
32
- # After:
33
- printer.print(STDOUT, min_percent: 2, sort_method: :self_time)
34
- ```
35
-
36
- ## 1.7.2 (2025-05-21)
37
- * Fix compiling on Ubuntu and Arch Linux
38
- * Update tests for Ruby 3.4
39
- * Remove tests for Ruby 3.1
40
- * Update MacOS to use clock_gettime (same as Linux) instead of proprietary mach_absolute_time API
41
- * Add CMake support
42
-
43
- ## 1.7.1 (2024-10-19)
44
- * Fix crashes when calling merge due to inconsistent method keys (Chris Heald)
45
-
46
- ## 1.7.0 (2024-01-07)
47
- * Add support for ruby 3.3.* (Charlie Savage)
48
- * Remove support for ruby 2.7.* (Charlie Savage)
49
- * Fix crash caused by referencing Profile Ruby objects from Method objects that were being moved
50
- by GC compaction (Charlie Savage)
51
-
52
- ## 1.6.3 (2023-04-20)
53
- * Remove debug code unintentionally left in ruby-prof command line program (Charlie Savage)
54
-
55
- ## 1.6.2 (2023-04-17)
56
- * Fix Profile#merge! implementation (asksurya)
57
- * Fix ruby-prof command line program (Charlie Savage)
58
- * Added CMakeLists.txt file (Charlie Savage)
59
-
60
- ## 1.6.1 (2023-02-21)
61
- * Fix loading C extension for MacOS (Charlie Savage)
62
-
63
- ## 1.6.0 (2023-02-20)
64
- * Add support for Ruby's compacting garbage collector (Charlie Savage)
65
- * Add rbs signature files (Charlie Savage)
66
- * Update rack adapter used for profiling Rails to include latest ruby-prof features (Charlie Savage)
67
- * Add warnings for deprecated methods (Charlie Savage)
68
- * Update tests to not use deprecated methods (Charlie Savage)
69
- * Improve tests on OSX (Charlie Savage)
70
-
71
- ## 1.5.0 (2023-02-06)
72
- * Add new Profile#merge! method that merges results for threads/fibers that share the same root method (Charlie Savage)
73
- * Expand API to allow creation of +Measurement+, +CallTree+, +MethodInfo+ and +Thread+ instances. This
74
- was done to make is possible to write tests for the new Profile#merge! functionality (Charlie Savage)
75
-
76
- ## 1.4.5 (2022-12-27)
77
- * Look for ruby_prof extension built on install in the lib directory (Charlie Savage)
78
- * Added Ruby 3.2.0 build for mingw-urct
79
-
80
- ## 1.4.4 (2022-12-11)
81
- * Update tests for Ruby 3.1 (Charlie Savage)
82
- * When tracing allocations always use the RUBY_INTERNAL_EVENT_NEWOBJ trace event. Previously GC stats could also be used, but that includes the creation of internal T_IMEMO objects makes reviewing results confusing (Charlie Savage)
83
- * Remove :profile option that lets a user set the prefix on callgrind output files since KCacheGrind will not automatically show these files in its open dialog. Fixes #313. (Charlie Savage)
84
- * Don't expose threads to Ruby that don't have a call tree. This can happen when a user is profiling memory usage and then sends a signint to the profiled process. New objects will be created in a new thread, but no method enter/exit trace events are generated by Ruby. Thus the thread has no call tree. Fixes #312 (Charlie Savage)
85
- * Update github Actions - change 3.0 to '3.0', add Windows mswin (MSP-Greg)
86
- * Add Ruby 3.1 to test matrix (Charlie Savage)
87
- * Use normal weight text instead of bold in call strack printer output. Fixes #297 (Charlie Savage)
88
- * Update VC project to Ruby 3.1 and Visual Studio 2022 (Charlie Savage)
89
- * Fix marshaling of profile measure. Fixes #315 (Charlie Savage)
90
- * CI: Omit duplicate 'bundle install'. PR #309 (Olle Jonsson)
91
- * Fix typo. s/perecent/percent/ (Paarth Madan)
92
- * Remove support for Ruby 2.5 and 2.6 which are now end of life (Charlie Savage)
93
-
94
- ## 1.4.3 (2021-02-16)
95
- * Remove trailing spaces (sergioro)
96
- * Load "ruby-prof.so" with require_relative (sergioro)
97
- * Use same file permissions for all test files (sergioro)
98
- * Create tmp directory for test output (sergioro)
99
- * Update git-ignore to add mkmf log (sergioro)
100
- * Fix minitest warning about using MT_CPU instead of N (sergioro)
101
- * Fix minitest warning "Use assert_nil if expecting nil (sergioro)
102
- * Add xcode project (Charlie Savage)
103
- * Update test for Ruby 3.0 (Charlie Savage)
104
- * Remove Ruby 2.4 support since it is no longer maintained (Charlie Savage)
105
- * Replace travis status badge with github status badge (Charlie Savage)
106
-
107
- ## 1.4.2 (2020-11-3)
108
- * Do NOT use Ruby 2.7.0 and 2.7.1 with ruby-prof. A bug in those versions of ruby causes ruby-prof to
109
- not work. Version 2.7.2 works correctly.
110
- * Fix crash caused be reallocating an internal stack that keeps tracks of frames *after* getting a reference to the
111
- top frame in the stack (Charlie Savage).
112
- * Fix bug where the flat printer did not correctly report the correct measurement mode.
113
-
114
- ## 1.4.1 (2020-05-14)
115
- * Fix compiling on older versions of gcc that do not default to c99 (Charlie Savage)
116
-
117
- ## 1.4.0 (2020-05-12)
118
- * API change - remove merge_fibers support since it resulted in incorrect results or crashes (Charlie Savage)
119
- * Fix crash when profiling memory usage (Charlie Savage)
120
- * When tracing execution correctly print out newobj tracepoint events (Charlie Savage)
121
- * Remove no longer needed code for building extensions (Charlie Savage)
122
-
123
- ## 1.3.2 (2020-04-19)
124
- * Fix rack profiler so it is thread safe (Charlie Savage)
125
- * Fix loading of prebuilt binaries on mingw64 to use Ruby's major and minor version (Charlie Savage)
126
-
127
- ## 1.3.1 (2020-03-11)
128
- * Add max_percent and filter_by options to flat printer (Sean McGivern)
129
- * Include binary in mingw64 build (Charlie Savage)
130
-
131
- ## 1.3.0 (2020-02-22)
132
- * Update C code to use newer RTypedData API versus older RData API.
133
- * Update C code to use rb_cObject versus the older, deprecated, rb_cData.
134
- * Update memory management - CallInfo's now keep alive their owning Profile instances. Fixes crashes that
135
- could happen in rare instances.
136
-
137
- ## 1.2.0 (2020-01-23)
138
- * Fix call stack printer broken in version 1.0.0 (Charlie Savage)
139
- * Ruby 2.7.0 support (Charlie Savage)
140
- * Switch to Windows high precision timer for measuring wall time (Charlie Savage)
141
- * Much better support for reverse call trees - if you start RubyProf at the bottom
142
- of a call tree it will correctly calculate times as it ascends the tree (Charlie Savage)
143
- * Port AggregateCallInfo from Ruby to C to increase performance
144
- * API change - CallInfo has been renamed CallTree
145
- * Fix crashes on Ruby 2.4.*
146
-
147
- ## 1.1.0 (2019-12-14)
148
- Changes
149
-
150
- * Reimplement merge_fibers (Charlie Savage)
151
- * Fix crash caused by threads being freed when profiles are freed (Charlie Savage)
152
-
153
- ## 1.0.0 (2019-07-29)
154
- ruby-prof's development stretches all the way back to 2005. Fourteen years later, it seems time for version 1.0!
155
- Version 1.0 is a significant update that greatly improves the internals of ruby-prof and adds a number of improvements.
156
-
157
- Changes (Charlie Savage):
158
-
159
- * Profiling is significantly faster - 5x in some cases
160
- * Recursive profiles are finally handled correctly. Yeah!!!
161
- * Redesigned reports (Chirs Whitefield)
162
- * New documentation website (https://ruby-prof.github.io)
163
- * The ability to measure allocations and memory usage using a standard (unpatched) version of ruby
164
- * The ability to save and reload profiling results for later analysis
165
- * The ability track object allocations
166
-
167
- At the same time, it was also time to remove old code and deprecated methods. These changes include (Charlie Savage):
168
-
169
- * Drop support for old versions of ruby. Currently 2.4 and up are required.
170
- * Remove support for method elimination (instead use method exclusion).
171
- * Remove the CPU_TIME measurement mode since it duplicates the PROCESS_TIME mode and required inline assembly code
172
- * Remove the GC_TIME and GC_RUNS measurement modes since they required patched ruby versions. In modern ruby it is possible to reimplement this functionality, but it does not seem of that much value (shout out if you want it back).
173
- * Merge the RubyProf::FlatPrinterWithLineNumbers printer into RubyProf::FlatPrinter.
174
- * Removed support for RUBY_PROF_EDITOR_URI environment variable that specified the link scheme. This features was more confusing then helpful.
175
-
176
-
177
- ## 0.18.0 (2019-05-27)
178
- ### Fixes
179
- * Fix grouping by thread/fiber (Charlie Savage)
180
- * Fix include/exclude thread checking (Charlie Savage)
181
- * Fix failing tests (Charlie Savage)
182
- * Fix grouping by thread_id and fiber_id (Charlie Savage)
183
- * Update Visual Studio solution to 2019 (Charlie Savage)
184
- * Adjust AbstractPrinter#editor_uri so it's possible to disable uri (Maciek Dubiński)-
185
- * Fix -X/--exclude-file option not working (John Lindgren)
186
- * Different directory for middleware output in readme (Aldric Giacomoni)
187
- * Fixing spelling mistakes and typos (David Kennedy and Roger Pack)
188
- * Add "allow_exceptions" option to Profile (Ryan Duryea)
189
- * Update readme (Jan Piotrowski, Nathan Seither, victor-am)
190
- * Travis updates (Niocals Leger and Charlie Savage)
191
- * Fix NewRelic module detection in exclude_common_methods! (Ben Hughes)
192
-
193
- ## 0.17.0 (2017-12-17)
194
- * Changed method/class names produced by the callgrind printer to be more kcachegrind
195
- friendly (thx to Nelson Gauthier and Ben Hughes, see https://github.com/ruby-prof/ruby-prof/pull/200).
196
- * Recursive instances of a method call are now dtected during profiling (thx to Nelson Gauthier and
197
- Ben Hughes, see https://github.com/ruby-prof/ruby-prof/pull/201).
198
- * Methods can now be ignored during a profiling run instead of eliminating them
199
- after a profile run, which has been deprecated (thx to Nelson Gauthier and Ben Hughes,
200
- see https://github.com/ruby-prof/ruby-prof/pull/202).
201
- * Use RUBY_PROF_EDITOR_URI=emacs to open source code links in the one true editor.
202
- (thx Alexander Egorov, see https://github.com/ruby-prof/ruby-prof/pull/183 and
203
- https://github.com/typester/emacs-handler).
204
- * Fixed that calling profile.stop would stop profiling all active profiling runs.
205
- * Fixed that remembering parent call frame pointer before stack reallocation could cause a segfault.
206
-
207
- ## 0.16.2 (2016-08-25)
208
- * fixed incorrect setting of RUBY_VERSION macro
209
-
210
- ## 0.16.1 (2016-08-24)
211
- * fixed compile problem with ruby 2.1.10
212
-
213
- ## 0.16.0 (2016-08-24)
214
- * ruby-prof can now be installed if ruby has been compiled with --disable-gems or
215
- RUBYOPT includes --disable-gems (thx to Arthur Nogueira Neves)
216
- * Profile.new now accepts and prefers an options hash:
217
- - measure_mode: one of the RubyProf measure mode constants
218
- - exclude_threads: an array of threads to ignore when collecting profile data
219
- - include_threads: an array of threads to include when collecting profile data
220
- - merge_fibers: whether or not to merge the profile data for all fibers under their creating thread
221
- * overhauled printer for cachegrind profiles:
222
- - profile data for each thread dumped to a separate file, as kcachegrind does not
223
- fully implement the cachegrind specification
224
- - this required a change in interface: it's now necessary to specify a directory
225
- where to dump the cachegrind files
226
- - naming convention for cachegrind files changed so that kcachegrind shows them
227
- all in the open dialog
228
- * improved Rack middleware:
229
- - it's now possible to use the MultiPrinter
230
- - new option ignore_existing_threads: will ignore all prexisiting threads
231
- when profiling a request, except the thread perfoming the request.
232
- - new option request_thread_only: will ignore all preexisting threads, but also
233
- all threads spwaned during the execution of the rack request.
234
- - new option merge_fibers: whether or not to merge the profile data for all fibers under their creating thread
235
- * fixed setting threshold bug when displaying stack profiles (thx to Michal Konarski)
236
- * code related to printing profiles is now autoloaded for efficiency (thx to Dave Gynn)
237
-
238
- ## 0.15.9 (2015-12-08)
239
- * rack profiler now supports lambdas for generating profile paths (thx to Jean Rougé)
240
- * fixed a bug when printing graph profiles
241
-
242
- ## 0.15.8 (2015-04-24)
243
- * added missing assets to gem build
244
- * fixed randomly failing test
245
-
246
- ## 0.15.7 (2015-04-23)
247
- * html profiles are now single page (thx to Thomas Leishman)
248
-
249
- ## 0.15.6 (2015-02-22)
250
- * improved upon computing children time in graph printers
251
-
252
- ## 0.15.5 (2015-02-22)
253
- * changed output format of flat_printer_with_line_number
254
- * support using multi printer from command line (Dov Murik)
255
-
256
- ## 0.15.4 (2015-02-14)
257
- * using env variable to specify mesaurement mode work again
258
- * measuring memory/object allocations works for 2.1 adn 2.2 again
259
-
260
- ## 0.15.3 (2015-01-16)
261
- * support ruby 2.2.0
262
-
263
- ## 0.15.2 (2014-05-20)
264
- * rack middleware creates print dir for profile result (Neng)
265
-
266
- ## 0.15.1 (2014-05-20)
267
- * added license to gemspec
268
-
269
- ## 0.15.0 (2014-05-02)
270
- * improved cpu time measurement (Charlie Somerville)
271
-
272
- ## 0.14.2 (2014-01-05)
273
- * hopefully fixed compile problem under Windows
274
-
275
- ## 0.14.0 (2014-01-02)
276
- * support ruby 2.1.0
277
- * dropped support for 1.8.x, 1.9.1 and 1.9.2
278
-
279
- ## 0.13.1 (2013-12-14)
280
- * speed up for displaying large call stacks (Benjamin Quoming)
281
-
282
- ## 0.13 (2013-03-10)
283
- * support fibers on 1.9.x+
284
- * improved display for very wide call stacks (Sammy Larbi)
285
-
286
- ## 0.12.2 (2013-02-13)
287
- * Fixed segfault when using falcon or railsexpress patches for 1.9.3
288
-
289
- ## 0.12.1 (2013-01-07)
290
- * Add back in pause/resume support since Rails uses it
291
-
292
- ## 0.12.0 (2013-01-06)
293
- * Ruby 2.0.0 support (Charlie Savage)
294
- * Fix issue where profiling results could exceed 100% if profile code had multiple top level methods (Charlie Savage)
295
- * Replaced RubyProf::Thread#top_method with RubyProf::Thread#top_methods (Charlie Savage)
296
- * Added RubyProf::Thread#total_time (Charlie Savage)
297
- * Remove the -r and -e command line options. If you need specific libraries or code profiled then add them
298
- to your code (Charlie Savage).
299
- * Rewrite ruby-prof script to be more self-contained (Gary Weaver)
300
- * Fix list formatting in readme (Thilo Rusche)
301
- * Remove pause/resume support since its buggy and complicates the code
302
-
303
- ## 0.11.3 (2012-12-27)
304
- * Prefix c functions with prof_ to avoid name conflicts (Kenta Murata)
305
- * Update ruby-prof script to avoid seg faults (Gary Weaver)
306
- * Rakefile updates (Roger Pack)
307
- * Fix regexp file reading (Gilbert Roulot)
308
- * Update documentation (Timo Schilling)
309
- * Fix up ruby warnings (Mike Gehard)
310
- * Remove duplicate code (Chas Lemley)
311
-
312
-
313
- ## 0.11.2 (2012-05-06)
314
- * Fix compile issue with BOOL. Should be _Bool for C99.
315
-
316
-
317
- ## 0.11.1 (2012-05-06)
318
- * Added option --exclude-common-callbacks, plus exclude #map and #inject in common cycles (Vasily Fedoseyev)
319
- * Add option --exclude-common-cycles to exclude common iterators (Vasily Fedoseyev)
320
- * Allow method elimination from command line via '-x' and '-X' keys (Vasily Fedoseyev)
321
-
322
-
323
- ## 0.11.0 (2012-05-05)
324
- * Fix pause/resume so it actually works and add tests (David Barri)
325
- * Resume now returns the result of the block when given (David Barri)
326
- * Make recursive method explanation more clear (Charlie Savage)
327
- * Fix ruby warnings (Charlie Savage)
328
- * Toggle GC.enable_stats when profiling for memory to get the data (Vasily Fedoseyev)
329
- * Fix patched ruby support and remove some warnings (Vasily Fedoseyev)
330
- * Fix tests on 1.8.7 (rogerdpack)
331
-
332
-
333
- ## 0.11.0.rc3 (2012-03-26)
334
- * Include missing files in gemspec (Charlie Savage).
335
-
336
-
337
- ## 0.11.0.rc2 (2012-03-25)
338
- * Lots of improvements to Rack handler - this can be used to profile requests
339
- in Rails and other rack-based ruby web frameworks (Charlie Savage).
340
- * Reimplemented handling of recursive calls using CallInfoVisitor (Charlie Savage).
341
- * Fix bug where child times were not correctly reported in complicated
342
- call graphs with recursion like in frameworks like Rails (Charlie Savage).
343
- * Add in recursive call information to Flat, Graph and Graph HTML reports (Charlie Savage).
344
- * Add in new thread class add added RubyProf::Thread#top_method to
345
- make report generation easier (Charlie Savage).
346
- * Add in CallInfoVisitor class to make it easy to iterate over a call graph (Charlie Savage).
347
- * Add in CallInfoPrinter to make it visualize RubyProf's internal call graphs (Charlie Savage).
348
- * Significant updates to documentation (Charlie Savage).
349
- * More c code cleanup (Charlie Savage).
350
-
351
- ## 0.11.0.rc1 (2012-03-24)
352
- * Big internal refactoring of C code to make RubyProf easier to understand and extend (Charlie Savage).
353
- * Profile results are now returned as instances of a new class RubyProf::Profile. The old api
354
- is supported via a compatability layer that at some point will be deprecated. (Charlie Savage).
355
- * On Windows, use QueryPerformanceCounter and QueryPerformanceFrequency to measure CPU time instead
356
- of rdtsc. This change is based on Microsoft's recommendation (Charlie Savage).
357
- * On Windows use GetProcessTimes to return real PROCESS_TIME times instead of wall times (Charlie Savage).
358
- * Split out tests for each time of measurement (cpu_time, process_time, etc.) (Charlie Savage).
359
- * Dropped support for Ruby 1.8.4 and 1.8.6 and 1.9.0 (Charlie Savage).
360
- * Added support for sorting results by total, self, wait and child times (Jan Suchal)
361
- * Added tests for sorting behaviour & removed options from constructor to print method (Jan Suchal)
362
- * Fix line number tests due to changes at top of file (Charlie Savage).
363
- * Add encoding statement to top of all files for Ruby 1.9.x compatability (Charlie Savage).
364
- * Add def file for VC to avoid the whole declspec annoyance (Charlie Savage).
365
- * Update test suite to ensure current working directory is correct (Charlie Savage).
366
- * Modernize gem file and remove various custom/home grown solutions that aren't needed anymore (Charlie Savage).
367
- * Remove custom mingw build scripts, use rake compiler instead (Charlie Savage).
368
- * Fixes for compiling with VC 2010 (Charlie Savage).
369
-
370
- ## 0.10.8 (2011-07-06)
371
- * 1.9.3 super class (Roger Pack)
372
-
373
- ## 0.10.7 (2011-05-09)
374
- * Fix a bug with REE's GC stats. Issue #53 [thanks graaff]
375
-
376
- ## 0.10.6 (2011-04-29)
377
- * Slightly more normalized url for linux/windows links to files.
378
-
379
- ## 0.10.5 (2011-04-20)
380
- * 1.8.6 compat for -v command (bug fix)
381
-
382
- ## 0.10.4 (2011-04-20)
383
- * Faster load time for ruby-prof itself.
384
-
385
- ## 0.10.3
386
- * Can cleanly load before rubygems now.
387
-
388
- ## 0.10.2
389
- * Fix for 1.9.2, os x for latest commits (thanks skaes!)
390
-
391
- ## 0.10.1
392
- * Fix bug in linux wall time, also load with only relative paths so that you can use it to benchmark rubygems startup overhead,
393
- itself.
394
-
395
- ## 0.10.0
396
- * Some rdoc changes, for linux wall time attempt to use higher granularity (thanks to all the contributors for this round!)
397
-
398
- ## 0.9.2
399
- * Make graphviz work on 1.8.6
400
- * Roll back some 1.9.2 optimizations until I can figure out what caused them.
401
-
402
- ## 0.9.1
403
- * Add a graphviz output
404
-
405
- ## 0.9.0
406
- * measurements for recursive methods are now correct
407
- * gave up on splitting up recursive methods according to call depth
408
- * made it possible to eliminate methods from profiling results
409
- * new printer for call stack visualization
410
- * new printer to print several profiles in one run
411
- * HTML profiles contain Textmate links so you can jump to the source code easily
412
- * producing an event log is now a runtime option
413
-
414
- ## 0.7.10 (2009-01-22)
415
- * fix SEGFAULT in 1.9
416
- * add new printer flat_printer_with_line_numbers
417
-
418
- ## 0.7.7 (2009-01-13)
419
- * "fix" multi threading support for 1.9 http://redmine.ruby-lang.org/issues/show/2012
420
- * speedups
421
-
422
- ## 0.7.6 (2009-12-31)
423
- * fix some tests for 1.9 (no real code changes)
424
-
425
- ## 0.7.5 (2009-12)
426
- * fix a GC collection bug (nobu's patch).
427
- * correctly report recursive call depths (Kevin Scaldeferri).
428
- * sort methods on output (Kevin Scaldeferri).
429
-
430
- ## 0.7.3 (2008-12-09)
431
- * Fixed compile error with new x86_64 code using GCC.
432
-
433
- ## 0.7.2 (2008-12-08)
434
- * Fixed major bug in printing child methods in graph reports.
435
-
436
- * Fixes for supporting x86_64 machines (Diego Pettenò)
437
-
438
-
439
- ## 0.7.1 (2008-11-28)
440
- * Added new AggregateCallTree class for printers to
441
- make results easier to read. Take this call sequence
442
- for example:
443
-
444
- A B C
445
- | | |
446
- Z A A
447
- | |
448
- Z Z
449
-
450
- By default, ruby-prof will show that Z was called by 3 separate
451
- instances of A. In an IDE that is helpful but in a text report
452
- it is not since it makes the report much harder to read.
453
- As a result, printers now aggregate together callers (and children),
454
- matching ruby-prof's output from versions prior to 0.7.0.
455
-
456
- * Fixes for supporting x86_64 machines (Matt Sanford)
457
-
458
-
459
- ## 0.7.0 (2008-11-04)
460
-
461
- ### Features
462
- * Added two new methods - RubyProf.resume and RubyProf.pause.
463
- RubyProf.resume takes an optional block, which ensures that
464
- RubyProf.pause is called. For example:
465
-
466
- 10.times do |i|
467
- RubyProf.resume do
468
- # Some long process
469
- end
470
- end
471
-
472
- result = RubyProf.stop
473
-
474
- * Added support for profiling tests that use Ruby's built-in
475
- unit test framework (ie, test derived from
476
- Test::Unit::TestCase). To enable profiling simply add
477
- the following line of code to your test class:
478
-
479
- include RubyProf::Test
480
-
481
- By default, profiling results are written to the current
482
- processes working directory. To change this, or other
483
- profiling options, simply modify the PROFILE_OPTIONS hash
484
- table as needed.
485
-
486
- * Used the new support for profiling test cases to revamp
487
- the way that Rails profiling works. For more information
488
- please refer to RubyProf's documentation.
489
-
490
- * Keep track of call stack for each method to enable more
491
- powerful profile visualizations in Integrated Development
492
- Environments (Hin Boean, work supported by CodeGear).
493
-
494
- * Expose measurements to Ruby (Jeremy Kemper).
495
-
496
- * Add support for additional memory measurements modes in Ruby 1.9 (Jeremy Kemper).
497
-
498
- * Add support for Lloyd Hilaiel's Ruby patch for measuring total heap size.
499
- See http://lloydforge.org/projects/ruby. (Jeremy Kemper).
500
-
501
-
502
- ### Fixes
503
- * RubyProf.profile no longer crashes if an exception is
504
- thrown during a profiling run.
505
-
506
- * Measure memory in fractional kilobytes rather than rounding down (Jeremy Kemper)
507
-
508
-
509
- ## 0.6.0 (2008-02-03)
510
-
511
- ruby-prof 0.6.0 adds support for Ruby 1.9 and memory profiling.
512
-
513
- ### Features
514
- * Added support for ruby 1.9 (Shugo Maeda)
515
- * Added support for outputting printer results to a String, Array or IO
516
- object (Michael Granger)
517
- * Add new memory profiling mode. Note this mode depends on a
518
- patched Ruby interpreter (Alexander Dymo)
519
-
520
- ### Fixes
521
- * Improvements to GraphHtmlPrinter including updated documentation,
522
- fixes for min_time support, ability to specify templates using
523
- strings or filenames, and table layout fixes (Makoto Kuwata)
524
- * Fixes to scaling factor for calltrees so that precision is not lost
525
- due to the conversion to doubles (Sylvain Joyeux)
526
- * Changed constant ALLOCATED_OBJECTS to ALLOCATIONS in the C code to
527
- match the Ruby code (Sylvain Joyeux)
528
- * Added support for calltree printer to ruby-prof binary script (Sylvain Joyeux)
529
- * Fix support for the allocator measure mode to extconf.rb (Sylvain Joyeux)
530
- * Honor measure mode when specified on the command line (Sylvain Joyeux)
531
- * Sorting of methods by total time was incorrect (Dan Fitch, Charlie Savage)
532
- * Fix ruby-prof to work with the latest version of GEMS (Alexander Dymo)
533
- * Always define MEASURE_CPU_TIME and MEASURE_ALLOCATIONS in Ruby code, but
534
- set their values to nil if the functionality is not available.
535
-
536
-
537
- ## 0.5.2 (2007-07-19)
538
-
539
- ruby-prof 0.5.2 is a bug fix release.
540
-
541
- ### Fixes
542
- * Include missing rails plugin
543
-
544
-
545
- ## 0.5.1 (2007-07-18)
546
-
547
- ruby-prof 0.5.1 is a bug fix and performance release.
548
-
549
- ### Performance
550
- * Significantly reduced the number of thread lookups by
551
- caching the last executed thread.
552
-
553
- ### Fixes
554
- * Properly escape method names in HTML reports
555
- * Fix use of -m and --min-percent command line switches
556
- * Default source file information to ruby_runtime#0 for c calls
557
- * Moved rails_plugin to top level so it is more obvious
558
- * Updated rails_plugin to write reports to the current
559
- Rails log directory
560
- * Added additional tests
561
-
562
-
563
- ## 0.5.0 (2007-07-09)
564
-
565
- ### Features
566
- * Added support for timing multi-threaded applications
567
- * Added support for 64 bit systems (patch from Diego 'Flameeyes' Petten)
568
- * Added suport for outputting data in the format used by
569
- KCacheGrind (patch from Carl Shimer)
570
- * Add filename and line numbers to call tree information (patch from Carl Shimer)
571
- * Added Visual Studio 2005 project file.
572
- * Added replace-progname switch, als rcov.
573
- * Added better support for recursive methods
574
- * Added better support for profiling Rails applications
575
-
576
- ### Fixes
577
- * Fixes bug when the type of an attached object (singleton) is inherited
578
- from T_OBJECT as opposed to being a T_OBJECT (identified by Francis Cianfrocca)
579
- * ruby-prof now works in IRB.
580
- * Fix sort order in reports.
581
- * Fixed rdoc compile error.
582
- * Fix tabs in erb template for graph html report on windows.
583
-
584
- ## 0.4.1 (2006-06-26)
585
-
586
- ### Features
587
- * Added a RubyProf.running? method to indicate whether a profile is in progress.
588
- * Added tgz and zip archives to release
589
-
590
- ### Fixes
591
- * Duplicate method names are now allowed
592
- * The documentation has been updated to show the correct API usage is RubyProf.stop not RubyProf.end
593
-
594
-
595
- ## 0.4.0 (2006-06-16)
596
- ### Features
597
- * added support for call graphs
598
- * added support for printers. Currently there is a FlatPrinter,
599
- GraphPrinter and GraphHtmlPrinter.
600
- * added support for recursive methods
601
- * added Windows support
602
- * now packaged as a RubyGem
603
-
604
- ### Fixes
605
- * Fixes bug where RubyProf would crash depending on the
606
- way it was invoked - for example, it did not run when
607
- used with Arachno Ruby's customized version of Ruby.
1
+ # Changelog
2
+
3
+ ## 2.0.4 (2026-03-03)
4
+ * Fix NoMethodError when sort_method is nil (issue #349)
5
+ * Fix broken source_code_uri on rubygems.org (issue #350)
6
+
7
+ ## 2.0.3 (2026-02-28)
8
+ * Remove unnecessary visited set from FlameGraphPrinter (call tree is always acyclic)
9
+ * Remove sort_by in FlameGraphPrinter to preserve natural call order
10
+ * Add `max_depth` option to FlameGraphPrinter, CallStackPrinter, CallInfoPrinter, and CallTreeVisitor
11
+ * Add documentation covering call tree construction and recursion handling
12
+
13
+ ## 2.0.2 (2026-02-17)
14
+ * Fix bin/ruby-prof passing printer options as positional arguments instead of keyword arguments
15
+
16
+ ## 2.0.1 (2026-02-16)
17
+ * Convert bin/ruby-prof endings from CRLF to LF
18
+
19
+ ## 2.0.0 (2026-02-13)
20
+ ### Features
21
+ * Ruby 4.0 support.
22
+ * Add flame graph visualizations with icicle mode toggle
23
+ * Lots of documentation updates!
24
+ * Apply consistent styling across all reports
25
+ * Add `Profile#measure_mode_name` method for human-friendly measurement mode names (e.g., "Wall Time" instead of "wall_time")
26
+ * Fix DotPrinter generating self-referencing edges (was using callers instead of callees)
27
+ * Add Graphviz Online viewer link for dot output
28
+
29
+ ### Backwards Incompatible Changes
30
+ * Removed `RubyProf::MEMORY` measurement mode (no longer works on Ruby 4.0+)
31
+ * Rremove compatibility API that was scheduled for removal in 2023
32
+ * Printer options now use keyword arguments instead of an options hash. For example:
33
+ ```ruby
34
+ # Before:
35
+ printer.print(STDOUT, :min_percent => 2, :sort_method => :self_time)
36
+ # After:
37
+ printer.print(STDOUT, min_percent: 2, sort_method: :self_time)
38
+ ```
39
+
40
+ ## 1.7.2 (2025-05-21)
41
+ * Fix compiling on Ubuntu and Arch Linux
42
+ * Update tests for Ruby 3.4
43
+ * Remove tests for Ruby 3.1
44
+ * Update MacOS to use clock_gettime (same as Linux) instead of proprietary mach_absolute_time API
45
+ * Add CMake support
46
+
47
+ ## 1.7.1 (2024-10-19)
48
+ * Fix crashes when calling merge due to inconsistent method keys (Chris Heald)
49
+
50
+ ## 1.7.0 (2024-01-07)
51
+ * Add support for ruby 3.3.* (Charlie Savage)
52
+ * Remove support for ruby 2.7.* (Charlie Savage)
53
+ * Fix crash caused by referencing Profile Ruby objects from Method objects that were being moved
54
+ by GC compaction (Charlie Savage)
55
+
56
+ ## 1.6.3 (2023-04-20)
57
+ * Remove debug code unintentionally left in ruby-prof command line program (Charlie Savage)
58
+
59
+ ## 1.6.2 (2023-04-17)
60
+ * Fix Profile#merge! implementation (asksurya)
61
+ * Fix ruby-prof command line program (Charlie Savage)
62
+ * Added CMakeLists.txt file (Charlie Savage)
63
+
64
+ ## 1.6.1 (2023-02-21)
65
+ * Fix loading C extension for MacOS (Charlie Savage)
66
+
67
+ ## 1.6.0 (2023-02-20)
68
+ * Add support for Ruby's compacting garbage collector (Charlie Savage)
69
+ * Add rbs signature files (Charlie Savage)
70
+ * Update rack adapter used for profiling Rails to include latest ruby-prof features (Charlie Savage)
71
+ * Add warnings for deprecated methods (Charlie Savage)
72
+ * Update tests to not use deprecated methods (Charlie Savage)
73
+ * Improve tests on OSX (Charlie Savage)
74
+
75
+ ## 1.5.0 (2023-02-06)
76
+ * Add new Profile#merge! method that merges results for threads/fibers that share the same root method (Charlie Savage)
77
+ * Expand API to allow creation of +Measurement+, +CallTree+, +MethodInfo+ and +Thread+ instances. This
78
+ was done to make is possible to write tests for the new Profile#merge! functionality (Charlie Savage)
79
+
80
+ ## 1.4.5 (2022-12-27)
81
+ * Look for ruby_prof extension built on install in the lib directory (Charlie Savage)
82
+ * Added Ruby 3.2.0 build for mingw-urct
83
+
84
+ ## 1.4.4 (2022-12-11)
85
+ * Update tests for Ruby 3.1 (Charlie Savage)
86
+ * When tracing allocations always use the RUBY_INTERNAL_EVENT_NEWOBJ trace event. Previously GC stats could also be used, but that includes the creation of internal T_IMEMO objects makes reviewing results confusing (Charlie Savage)
87
+ * Remove :profile option that lets a user set the prefix on callgrind output files since KCacheGrind will not automatically show these files in its open dialog. Fixes #313. (Charlie Savage)
88
+ * Don't expose threads to Ruby that don't have a call tree. This can happen when a user is profiling memory usage and then sends a signint to the profiled process. New objects will be created in a new thread, but no method enter/exit trace events are generated by Ruby. Thus the thread has no call tree. Fixes #312 (Charlie Savage)
89
+ * Update github Actions - change 3.0 to '3.0', add Windows mswin (MSP-Greg)
90
+ * Add Ruby 3.1 to test matrix (Charlie Savage)
91
+ * Use normal weight text instead of bold in call strack printer output. Fixes #297 (Charlie Savage)
92
+ * Update VC project to Ruby 3.1 and Visual Studio 2022 (Charlie Savage)
93
+ * Fix marshaling of profile measure. Fixes #315 (Charlie Savage)
94
+ * CI: Omit duplicate 'bundle install'. PR #309 (Olle Jonsson)
95
+ * Fix typo. s/perecent/percent/ (Paarth Madan)
96
+ * Remove support for Ruby 2.5 and 2.6 which are now end of life (Charlie Savage)
97
+
98
+ ## 1.4.3 (2021-02-16)
99
+ * Remove trailing spaces (sergioro)
100
+ * Load "ruby-prof.so" with require_relative (sergioro)
101
+ * Use same file permissions for all test files (sergioro)
102
+ * Create tmp directory for test output (sergioro)
103
+ * Update git-ignore to add mkmf log (sergioro)
104
+ * Fix minitest warning about using MT_CPU instead of N (sergioro)
105
+ * Fix minitest warning "Use assert_nil if expecting nil (sergioro)
106
+ * Add xcode project (Charlie Savage)
107
+ * Update test for Ruby 3.0 (Charlie Savage)
108
+ * Remove Ruby 2.4 support since it is no longer maintained (Charlie Savage)
109
+ * Replace travis status badge with github status badge (Charlie Savage)
110
+
111
+ ## 1.4.2 (2020-11-3)
112
+ * Do NOT use Ruby 2.7.0 and 2.7.1 with ruby-prof. A bug in those versions of ruby causes ruby-prof to
113
+ not work. Version 2.7.2 works correctly.
114
+ * Fix crash caused be reallocating an internal stack that keeps tracks of frames *after* getting a reference to the
115
+ top frame in the stack (Charlie Savage).
116
+ * Fix bug where the flat printer did not correctly report the correct measurement mode.
117
+
118
+ ## 1.4.1 (2020-05-14)
119
+ * Fix compiling on older versions of gcc that do not default to c99 (Charlie Savage)
120
+
121
+ ## 1.4.0 (2020-05-12)
122
+ * API change - remove merge_fibers support since it resulted in incorrect results or crashes (Charlie Savage)
123
+ * Fix crash when profiling memory usage (Charlie Savage)
124
+ * When tracing execution correctly print out newobj tracepoint events (Charlie Savage)
125
+ * Remove no longer needed code for building extensions (Charlie Savage)
126
+
127
+ ## 1.3.2 (2020-04-19)
128
+ * Fix rack profiler so it is thread safe (Charlie Savage)
129
+ * Fix loading of prebuilt binaries on mingw64 to use Ruby's major and minor version (Charlie Savage)
130
+
131
+ ## 1.3.1 (2020-03-11)
132
+ * Add max_percent and filter_by options to flat printer (Sean McGivern)
133
+ * Include binary in mingw64 build (Charlie Savage)
134
+
135
+ ## 1.3.0 (2020-02-22)
136
+ * Update C code to use newer RTypedData API versus older RData API.
137
+ * Update C code to use rb_cObject versus the older, deprecated, rb_cData.
138
+ * Update memory management - CallInfo's now keep alive their owning Profile instances. Fixes crashes that
139
+ could happen in rare instances.
140
+
141
+ ## 1.2.0 (2020-01-23)
142
+ * Fix call stack printer broken in version 1.0.0 (Charlie Savage)
143
+ * Ruby 2.7.0 support (Charlie Savage)
144
+ * Switch to Windows high precision timer for measuring wall time (Charlie Savage)
145
+ * Much better support for reverse call trees - if you start RubyProf at the bottom
146
+ of a call tree it will correctly calculate times as it ascends the tree (Charlie Savage)
147
+ * Port AggregateCallInfo from Ruby to C to increase performance
148
+ * API change - CallInfo has been renamed CallTree
149
+ * Fix crashes on Ruby 2.4.*
150
+
151
+ ## 1.1.0 (2019-12-14)
152
+ Changes
153
+
154
+ * Reimplement merge_fibers (Charlie Savage)
155
+ * Fix crash caused by threads being freed when profiles are freed (Charlie Savage)
156
+
157
+ ## 1.0.0 (2019-07-29)
158
+ ruby-prof's development stretches all the way back to 2005. Fourteen years later, it seems time for version 1.0!
159
+ Version 1.0 is a significant update that greatly improves the internals of ruby-prof and adds a number of improvements.
160
+
161
+ Changes (Charlie Savage):
162
+
163
+ * Profiling is significantly faster - 5x in some cases
164
+ * Recursive profiles are finally handled correctly. Yeah!!!
165
+ * Redesigned reports (Chirs Whitefield)
166
+ * New documentation website (https://ruby-prof.github.io)
167
+ * The ability to measure allocations and memory usage using a standard (unpatched) version of ruby
168
+ * The ability to save and reload profiling results for later analysis
169
+ * The ability track object allocations
170
+
171
+ At the same time, it was also time to remove old code and deprecated methods. These changes include (Charlie Savage):
172
+
173
+ * Drop support for old versions of ruby. Currently 2.4 and up are required.
174
+ * Remove support for method elimination (instead use method exclusion).
175
+ * Remove the CPU_TIME measurement mode since it duplicates the PROCESS_TIME mode and required inline assembly code
176
+ * Remove the GC_TIME and GC_RUNS measurement modes since they required patched ruby versions. In modern ruby it is possible to reimplement this functionality, but it does not seem of that much value (shout out if you want it back).
177
+ * Merge the RubyProf::FlatPrinterWithLineNumbers printer into RubyProf::FlatPrinter.
178
+ * Removed support for RUBY_PROF_EDITOR_URI environment variable that specified the link scheme. This features was more confusing then helpful.
179
+
180
+
181
+ ## 0.18.0 (2019-05-27)
182
+ ### Fixes
183
+ * Fix grouping by thread/fiber (Charlie Savage)
184
+ * Fix include/exclude thread checking (Charlie Savage)
185
+ * Fix failing tests (Charlie Savage)
186
+ * Fix grouping by thread_id and fiber_id (Charlie Savage)
187
+ * Update Visual Studio solution to 2019 (Charlie Savage)
188
+ * Adjust AbstractPrinter#editor_uri so it's possible to disable uri (Maciek Dubiński)-
189
+ * Fix -X/--exclude-file option not working (John Lindgren)
190
+ * Different directory for middleware output in readme (Aldric Giacomoni)
191
+ * Fixing spelling mistakes and typos (David Kennedy and Roger Pack)
192
+ * Add "allow_exceptions" option to Profile (Ryan Duryea)
193
+ * Update readme (Jan Piotrowski, Nathan Seither, victor-am)
194
+ * Travis updates (Niocals Leger and Charlie Savage)
195
+ * Fix NewRelic module detection in exclude_common_methods! (Ben Hughes)
196
+
197
+ ## 0.17.0 (2017-12-17)
198
+ * Changed method/class names produced by the callgrind printer to be more kcachegrind
199
+ friendly (thx to Nelson Gauthier and Ben Hughes, see https://github.com/ruby-prof/ruby-prof/pull/200).
200
+ * Recursive instances of a method call are now dtected during profiling (thx to Nelson Gauthier and
201
+ Ben Hughes, see https://github.com/ruby-prof/ruby-prof/pull/201).
202
+ * Methods can now be ignored during a profiling run instead of eliminating them
203
+ after a profile run, which has been deprecated (thx to Nelson Gauthier and Ben Hughes,
204
+ see https://github.com/ruby-prof/ruby-prof/pull/202).
205
+ * Use RUBY_PROF_EDITOR_URI=emacs to open source code links in the one true editor.
206
+ (thx Alexander Egorov, see https://github.com/ruby-prof/ruby-prof/pull/183 and
207
+ https://github.com/typester/emacs-handler).
208
+ * Fixed that calling profile.stop would stop profiling all active profiling runs.
209
+ * Fixed that remembering parent call frame pointer before stack reallocation could cause a segfault.
210
+
211
+ ## 0.16.2 (2016-08-25)
212
+ * fixed incorrect setting of RUBY_VERSION macro
213
+
214
+ ## 0.16.1 (2016-08-24)
215
+ * fixed compile problem with ruby 2.1.10
216
+
217
+ ## 0.16.0 (2016-08-24)
218
+ * ruby-prof can now be installed if ruby has been compiled with --disable-gems or
219
+ RUBYOPT includes --disable-gems (thx to Arthur Nogueira Neves)
220
+ * Profile.new now accepts and prefers an options hash:
221
+ - measure_mode: one of the RubyProf measure mode constants
222
+ - exclude_threads: an array of threads to ignore when collecting profile data
223
+ - include_threads: an array of threads to include when collecting profile data
224
+ - merge_fibers: whether or not to merge the profile data for all fibers under their creating thread
225
+ * overhauled printer for cachegrind profiles:
226
+ - profile data for each thread dumped to a separate file, as kcachegrind does not
227
+ fully implement the cachegrind specification
228
+ - this required a change in interface: it's now necessary to specify a directory
229
+ where to dump the cachegrind files
230
+ - naming convention for cachegrind files changed so that kcachegrind shows them
231
+ all in the open dialog
232
+ * improved Rack middleware:
233
+ - it's now possible to use the MultiPrinter
234
+ - new option ignore_existing_threads: will ignore all prexisiting threads
235
+ when profiling a request, except the thread perfoming the request.
236
+ - new option request_thread_only: will ignore all preexisting threads, but also
237
+ all threads spwaned during the execution of the rack request.
238
+ - new option merge_fibers: whether or not to merge the profile data for all fibers under their creating thread
239
+ * fixed setting threshold bug when displaying stack profiles (thx to Michal Konarski)
240
+ * code related to printing profiles is now autoloaded for efficiency (thx to Dave Gynn)
241
+
242
+ ## 0.15.9 (2015-12-08)
243
+ * rack profiler now supports lambdas for generating profile paths (thx to Jean Rougé)
244
+ * fixed a bug when printing graph profiles
245
+
246
+ ## 0.15.8 (2015-04-24)
247
+ * added missing assets to gem build
248
+ * fixed randomly failing test
249
+
250
+ ## 0.15.7 (2015-04-23)
251
+ * html profiles are now single page (thx to Thomas Leishman)
252
+
253
+ ## 0.15.6 (2015-02-22)
254
+ * improved upon computing children time in graph printers
255
+
256
+ ## 0.15.5 (2015-02-22)
257
+ * changed output format of flat_printer_with_line_number
258
+ * support using multi printer from command line (Dov Murik)
259
+
260
+ ## 0.15.4 (2015-02-14)
261
+ * using env variable to specify mesaurement mode work again
262
+ * measuring memory/object allocations works for 2.1 adn 2.2 again
263
+
264
+ ## 0.15.3 (2015-01-16)
265
+ * support ruby 2.2.0
266
+
267
+ ## 0.15.2 (2014-05-20)
268
+ * rack middleware creates print dir for profile result (Neng)
269
+
270
+ ## 0.15.1 (2014-05-20)
271
+ * added license to gemspec
272
+
273
+ ## 0.15.0 (2014-05-02)
274
+ * improved cpu time measurement (Charlie Somerville)
275
+
276
+ ## 0.14.2 (2014-01-05)
277
+ * hopefully fixed compile problem under Windows
278
+
279
+ ## 0.14.0 (2014-01-02)
280
+ * support ruby 2.1.0
281
+ * dropped support for 1.8.x, 1.9.1 and 1.9.2
282
+
283
+ ## 0.13.1 (2013-12-14)
284
+ * speed up for displaying large call stacks (Benjamin Quoming)
285
+
286
+ ## 0.13 (2013-03-10)
287
+ * support fibers on 1.9.x+
288
+ * improved display for very wide call stacks (Sammy Larbi)
289
+
290
+ ## 0.12.2 (2013-02-13)
291
+ * Fixed segfault when using falcon or railsexpress patches for 1.9.3
292
+
293
+ ## 0.12.1 (2013-01-07)
294
+ * Add back in pause/resume support since Rails uses it
295
+
296
+ ## 0.12.0 (2013-01-06)
297
+ * Ruby 2.0.0 support (Charlie Savage)
298
+ * Fix issue where profiling results could exceed 100% if profile code had multiple top level methods (Charlie Savage)
299
+ * Replaced RubyProf::Thread#top_method with RubyProf::Thread#top_methods (Charlie Savage)
300
+ * Added RubyProf::Thread#total_time (Charlie Savage)
301
+ * Remove the -r and -e command line options. If you need specific libraries or code profiled then add them
302
+ to your code (Charlie Savage).
303
+ * Rewrite ruby-prof script to be more self-contained (Gary Weaver)
304
+ * Fix list formatting in readme (Thilo Rusche)
305
+ * Remove pause/resume support since its buggy and complicates the code
306
+
307
+ ## 0.11.3 (2012-12-27)
308
+ * Prefix c functions with prof_ to avoid name conflicts (Kenta Murata)
309
+ * Update ruby-prof script to avoid seg faults (Gary Weaver)
310
+ * Rakefile updates (Roger Pack)
311
+ * Fix regexp file reading (Gilbert Roulot)
312
+ * Update documentation (Timo Schilling)
313
+ * Fix up ruby warnings (Mike Gehard)
314
+ * Remove duplicate code (Chas Lemley)
315
+
316
+
317
+ ## 0.11.2 (2012-05-06)
318
+ * Fix compile issue with BOOL. Should be _Bool for C99.
319
+
320
+
321
+ ## 0.11.1 (2012-05-06)
322
+ * Added option --exclude-common-callbacks, plus exclude #map and #inject in common cycles (Vasily Fedoseyev)
323
+ * Add option --exclude-common-cycles to exclude common iterators (Vasily Fedoseyev)
324
+ * Allow method elimination from command line via '-x' and '-X' keys (Vasily Fedoseyev)
325
+
326
+
327
+ ## 0.11.0 (2012-05-05)
328
+ * Fix pause/resume so it actually works and add tests (David Barri)
329
+ * Resume now returns the result of the block when given (David Barri)
330
+ * Make recursive method explanation more clear (Charlie Savage)
331
+ * Fix ruby warnings (Charlie Savage)
332
+ * Toggle GC.enable_stats when profiling for memory to get the data (Vasily Fedoseyev)
333
+ * Fix patched ruby support and remove some warnings (Vasily Fedoseyev)
334
+ * Fix tests on 1.8.7 (rogerdpack)
335
+
336
+
337
+ ## 0.11.0.rc3 (2012-03-26)
338
+ * Include missing files in gemspec (Charlie Savage).
339
+
340
+
341
+ ## 0.11.0.rc2 (2012-03-25)
342
+ * Lots of improvements to Rack handler - this can be used to profile requests
343
+ in Rails and other rack-based ruby web frameworks (Charlie Savage).
344
+ * Reimplemented handling of recursive calls using CallInfoVisitor (Charlie Savage).
345
+ * Fix bug where child times were not correctly reported in complicated
346
+ call graphs with recursion like in frameworks like Rails (Charlie Savage).
347
+ * Add in recursive call information to Flat, Graph and Graph HTML reports (Charlie Savage).
348
+ * Add in new thread class add added RubyProf::Thread#top_method to
349
+ make report generation easier (Charlie Savage).
350
+ * Add in CallInfoVisitor class to make it easy to iterate over a call graph (Charlie Savage).
351
+ * Add in CallInfoPrinter to make it visualize RubyProf's internal call graphs (Charlie Savage).
352
+ * Significant updates to documentation (Charlie Savage).
353
+ * More c code cleanup (Charlie Savage).
354
+
355
+ ## 0.11.0.rc1 (2012-03-24)
356
+ * Big internal refactoring of C code to make RubyProf easier to understand and extend (Charlie Savage).
357
+ * Profile results are now returned as instances of a new class RubyProf::Profile. The old api
358
+ is supported via a compatability layer that at some point will be deprecated. (Charlie Savage).
359
+ * On Windows, use QueryPerformanceCounter and QueryPerformanceFrequency to measure CPU time instead
360
+ of rdtsc. This change is based on Microsoft's recommendation (Charlie Savage).
361
+ * On Windows use GetProcessTimes to return real PROCESS_TIME times instead of wall times (Charlie Savage).
362
+ * Split out tests for each time of measurement (cpu_time, process_time, etc.) (Charlie Savage).
363
+ * Dropped support for Ruby 1.8.4 and 1.8.6 and 1.9.0 (Charlie Savage).
364
+ * Added support for sorting results by total, self, wait and child times (Jan Suchal)
365
+ * Added tests for sorting behaviour & removed options from constructor to print method (Jan Suchal)
366
+ * Fix line number tests due to changes at top of file (Charlie Savage).
367
+ * Add encoding statement to top of all files for Ruby 1.9.x compatability (Charlie Savage).
368
+ * Add def file for VC to avoid the whole declspec annoyance (Charlie Savage).
369
+ * Update test suite to ensure current working directory is correct (Charlie Savage).
370
+ * Modernize gem file and remove various custom/home grown solutions that aren't needed anymore (Charlie Savage).
371
+ * Remove custom mingw build scripts, use rake compiler instead (Charlie Savage).
372
+ * Fixes for compiling with VC 2010 (Charlie Savage).
373
+
374
+ ## 0.10.8 (2011-07-06)
375
+ * 1.9.3 super class (Roger Pack)
376
+
377
+ ## 0.10.7 (2011-05-09)
378
+ * Fix a bug with REE's GC stats. Issue #53 [thanks graaff]
379
+
380
+ ## 0.10.6 (2011-04-29)
381
+ * Slightly more normalized url for linux/windows links to files.
382
+
383
+ ## 0.10.5 (2011-04-20)
384
+ * 1.8.6 compat for -v command (bug fix)
385
+
386
+ ## 0.10.4 (2011-04-20)
387
+ * Faster load time for ruby-prof itself.
388
+
389
+ ## 0.10.3
390
+ * Can cleanly load before rubygems now.
391
+
392
+ ## 0.10.2
393
+ * Fix for 1.9.2, os x for latest commits (thanks skaes!)
394
+
395
+ ## 0.10.1
396
+ * Fix bug in linux wall time, also load with only relative paths so that you can use it to benchmark rubygems startup overhead,
397
+ itself.
398
+
399
+ ## 0.10.0
400
+ * Some rdoc changes, for linux wall time attempt to use higher granularity (thanks to all the contributors for this round!)
401
+
402
+ ## 0.9.2
403
+ * Make graphviz work on 1.8.6
404
+ * Roll back some 1.9.2 optimizations until I can figure out what caused them.
405
+
406
+ ## 0.9.1
407
+ * Add a graphviz output
408
+
409
+ ## 0.9.0
410
+ * measurements for recursive methods are now correct
411
+ * gave up on splitting up recursive methods according to call depth
412
+ * made it possible to eliminate methods from profiling results
413
+ * new printer for call stack visualization
414
+ * new printer to print several profiles in one run
415
+ * HTML profiles contain Textmate links so you can jump to the source code easily
416
+ * producing an event log is now a runtime option
417
+
418
+ ## 0.7.10 (2009-01-22)
419
+ * fix SEGFAULT in 1.9
420
+ * add new printer flat_printer_with_line_numbers
421
+
422
+ ## 0.7.7 (2009-01-13)
423
+ * "fix" multi threading support for 1.9 http://redmine.ruby-lang.org/issues/show/2012
424
+ * speedups
425
+
426
+ ## 0.7.6 (2009-12-31)
427
+ * fix some tests for 1.9 (no real code changes)
428
+
429
+ ## 0.7.5 (2009-12)
430
+ * fix a GC collection bug (nobu's patch).
431
+ * correctly report recursive call depths (Kevin Scaldeferri).
432
+ * sort methods on output (Kevin Scaldeferri).
433
+
434
+ ## 0.7.3 (2008-12-09)
435
+ * Fixed compile error with new x86_64 code using GCC.
436
+
437
+ ## 0.7.2 (2008-12-08)
438
+ * Fixed major bug in printing child methods in graph reports.
439
+
440
+ * Fixes for supporting x86_64 machines (Diego Pettenò)
441
+
442
+
443
+ ## 0.7.1 (2008-11-28)
444
+ * Added new AggregateCallTree class for printers to
445
+ make results easier to read. Take this call sequence
446
+ for example:
447
+
448
+ A B C
449
+ | | |
450
+ Z A A
451
+ | |
452
+ Z Z
453
+
454
+ By default, ruby-prof will show that Z was called by 3 separate
455
+ instances of A. In an IDE that is helpful but in a text report
456
+ it is not since it makes the report much harder to read.
457
+ As a result, printers now aggregate together callers (and children),
458
+ matching ruby-prof's output from versions prior to 0.7.0.
459
+
460
+ * Fixes for supporting x86_64 machines (Matt Sanford)
461
+
462
+
463
+ ## 0.7.0 (2008-11-04)
464
+
465
+ ### Features
466
+ * Added two new methods - RubyProf.resume and RubyProf.pause.
467
+ RubyProf.resume takes an optional block, which ensures that
468
+ RubyProf.pause is called. For example:
469
+
470
+ 10.times do |i|
471
+ RubyProf.resume do
472
+ # Some long process
473
+ end
474
+ end
475
+
476
+ result = RubyProf.stop
477
+
478
+ * Added support for profiling tests that use Ruby's built-in
479
+ unit test framework (ie, test derived from
480
+ Test::Unit::TestCase). To enable profiling simply add
481
+ the following line of code to your test class:
482
+
483
+ include RubyProf::Test
484
+
485
+ By default, profiling results are written to the current
486
+ processes working directory. To change this, or other
487
+ profiling options, simply modify the PROFILE_OPTIONS hash
488
+ table as needed.
489
+
490
+ * Used the new support for profiling test cases to revamp
491
+ the way that Rails profiling works. For more information
492
+ please refer to RubyProf's documentation.
493
+
494
+ * Keep track of call stack for each method to enable more
495
+ powerful profile visualizations in Integrated Development
496
+ Environments (Hin Boean, work supported by CodeGear).
497
+
498
+ * Expose measurements to Ruby (Jeremy Kemper).
499
+
500
+ * Add support for additional memory measurements modes in Ruby 1.9 (Jeremy Kemper).
501
+
502
+ * Add support for Lloyd Hilaiel's Ruby patch for measuring total heap size.
503
+ See http://lloydforge.org/projects/ruby. (Jeremy Kemper).
504
+
505
+
506
+ ### Fixes
507
+ * RubyProf.profile no longer crashes if an exception is
508
+ thrown during a profiling run.
509
+
510
+ * Measure memory in fractional kilobytes rather than rounding down (Jeremy Kemper)
511
+
512
+
513
+ ## 0.6.0 (2008-02-03)
514
+
515
+ ruby-prof 0.6.0 adds support for Ruby 1.9 and memory profiling.
516
+
517
+ ### Features
518
+ * Added support for ruby 1.9 (Shugo Maeda)
519
+ * Added support for outputting printer results to a String, Array or IO
520
+ object (Michael Granger)
521
+ * Add new memory profiling mode. Note this mode depends on a
522
+ patched Ruby interpreter (Alexander Dymo)
523
+
524
+ ### Fixes
525
+ * Improvements to GraphHtmlPrinter including updated documentation,
526
+ fixes for min_time support, ability to specify templates using
527
+ strings or filenames, and table layout fixes (Makoto Kuwata)
528
+ * Fixes to scaling factor for calltrees so that precision is not lost
529
+ due to the conversion to doubles (Sylvain Joyeux)
530
+ * Changed constant ALLOCATED_OBJECTS to ALLOCATIONS in the C code to
531
+ match the Ruby code (Sylvain Joyeux)
532
+ * Added support for calltree printer to ruby-prof binary script (Sylvain Joyeux)
533
+ * Fix support for the allocator measure mode to extconf.rb (Sylvain Joyeux)
534
+ * Honor measure mode when specified on the command line (Sylvain Joyeux)
535
+ * Sorting of methods by total time was incorrect (Dan Fitch, Charlie Savage)
536
+ * Fix ruby-prof to work with the latest version of GEMS (Alexander Dymo)
537
+ * Always define MEASURE_CPU_TIME and MEASURE_ALLOCATIONS in Ruby code, but
538
+ set their values to nil if the functionality is not available.
539
+
540
+
541
+ ## 0.5.2 (2007-07-19)
542
+
543
+ ruby-prof 0.5.2 is a bug fix release.
544
+
545
+ ### Fixes
546
+ * Include missing rails plugin
547
+
548
+
549
+ ## 0.5.1 (2007-07-18)
550
+
551
+ ruby-prof 0.5.1 is a bug fix and performance release.
552
+
553
+ ### Performance
554
+ * Significantly reduced the number of thread lookups by
555
+ caching the last executed thread.
556
+
557
+ ### Fixes
558
+ * Properly escape method names in HTML reports
559
+ * Fix use of -m and --min-percent command line switches
560
+ * Default source file information to ruby_runtime#0 for c calls
561
+ * Moved rails_plugin to top level so it is more obvious
562
+ * Updated rails_plugin to write reports to the current
563
+ Rails log directory
564
+ * Added additional tests
565
+
566
+
567
+ ## 0.5.0 (2007-07-09)
568
+
569
+ ### Features
570
+ * Added support for timing multi-threaded applications
571
+ * Added support for 64 bit systems (patch from Diego 'Flameeyes' Petten)
572
+ * Added suport for outputting data in the format used by
573
+ KCacheGrind (patch from Carl Shimer)
574
+ * Add filename and line numbers to call tree information (patch from Carl Shimer)
575
+ * Added Visual Studio 2005 project file.
576
+ * Added replace-progname switch, als rcov.
577
+ * Added better support for recursive methods
578
+ * Added better support for profiling Rails applications
579
+
580
+ ### Fixes
581
+ * Fixes bug when the type of an attached object (singleton) is inherited
582
+ from T_OBJECT as opposed to being a T_OBJECT (identified by Francis Cianfrocca)
583
+ * ruby-prof now works in IRB.
584
+ * Fix sort order in reports.
585
+ * Fixed rdoc compile error.
586
+ * Fix tabs in erb template for graph html report on windows.
587
+
588
+ ## 0.4.1 (2006-06-26)
589
+
590
+ ### Features
591
+ * Added a RubyProf.running? method to indicate whether a profile is in progress.
592
+ * Added tgz and zip archives to release
593
+
594
+ ### Fixes
595
+ * Duplicate method names are now allowed
596
+ * The documentation has been updated to show the correct API usage is RubyProf.stop not RubyProf.end
597
+
598
+
599
+ ## 0.4.0 (2006-06-16)
600
+ ### Features
601
+ * added support for call graphs
602
+ * added support for printers. Currently there is a FlatPrinter,
603
+ GraphPrinter and GraphHtmlPrinter.
604
+ * added support for recursive methods
605
+ * added Windows support
606
+ * now packaged as a RubyGem
607
+
608
+ ### Fixes
609
+ * Fixes bug where RubyProf would crash depending on the
610
+ way it was invoked - for example, it did not run when
611
+ used with Arachno Ruby's customized version of Ruby.