Sha256: 2860c5dacb449da3a53d602c8087e6b303cf3f8622528cf106dc621bd5c56dd8

Contents?: true

Size: 1.92 KB

Versions: 99

Compression:

Stored size: 1.92 KB

Contents

# frozen_string_literal: true

require "active_support/core_ext/benchmark"
require "active_support/core_ext/hash/keys"

module ActiveSupport
  module Benchmarkable
    # Allows you to measure the execution time of a block in a template and
    # records the result to the log. Wrap this block around expensive operations
    # or possible bottlenecks to get a time reading for the operation. For
    # example, let's say you thought your file processing method was taking too
    # long; you could wrap it in a benchmark block.
    #
    #  <% benchmark 'Process data files' do %>
    #    <%= expensive_files_operation %>
    #  <% end %>
    #
    # That would add something like "Process data files (345.2ms)" to the log,
    # which you can then use to compare timings when optimizing your code.
    #
    # You may give an optional logger level (<tt>:debug</tt>, <tt>:info</tt>,
    # <tt>:warn</tt>, <tt>:error</tt>) as the <tt>:level</tt> option. The
    # default logger level value is <tt>:info</tt>.
    #
    #  <% benchmark 'Low-level files', level: :debug do %>
    #    <%= lowlevel_files_operation %>
    #  <% end %>
    #
    # Finally, you can pass true as the third argument to silence all log
    # activity (other than the timing information) from inside the block. This
    # is great for boiling down a noisy block to just a single statement that
    # produces one log line:
    #
    #  <% benchmark 'Process data files', level: :info, silence: true do %>
    #    <%= expensive_and_chatty_files_operation %>
    #  <% end %>
    def benchmark(message = "Benchmarking", options = {})
      if logger
        options.assert_valid_keys(:level, :silence)
        options[:level] ||= :info

        result = nil
        ms = Benchmark.ms { result = options[:silence] ? logger.silence { yield } : yield }
        logger.send(options[:level], "%s (%.1fms)" % [ message, ms ])
        result
      else
        yield
      end
    end
  end
end

Version data entries

99 entries across 90 versions & 11 rubygems

Version Path
activesupport-6.0.4.1 lib/active_support/benchmarkable.rb
mumukit-content-type-1.11.1 vendor/bundle/ruby/2.6.0/gems/activesupport-6.0.4/lib/active_support/benchmarkable.rb
activesupport-6.0.4 lib/active_support/benchmarkable.rb
activesupport-5.2.6 lib/active_support/benchmarkable.rb
activesupport-6.0.3.7 lib/active_support/benchmarkable.rb
activesupport-5.2.4.6 lib/active_support/benchmarkable.rb
activesupport-6.0.3.6 lib/active_support/benchmarkable.rb
activesupport-5.2.5 lib/active_support/benchmarkable.rb
activesupport-6.0.3.5 lib/active_support/benchmarkable.rb
activesupport-5.2.4.5 lib/active_support/benchmarkable.rb
activesupport-6.0.3.4 lib/active_support/benchmarkable.rb
grape-extra_validators-2.0.0 vendor/bundle/ruby/2.6.0/gems/activesupport-5.2.4.1/lib/active_support/benchmarkable.rb
grape-extra_validators-2.0.0 vendor/bundle/ruby/2.6.0/gems/activesupport-6.0.3.2/lib/active_support/benchmarkable.rb
activesupport-5.2.4.4 lib/active_support/benchmarkable.rb
activesupport-6.0.3.3 lib/active_support/benchmarkable.rb
activesupport-6.0.3.2 lib/active_support/benchmarkable.rb
activesupport-6.0.3.1 lib/active_support/benchmarkable.rb
activesupport-5.2.4.3 lib/active_support/benchmarkable.rb
activesupport-6.0.3 lib/active_support/benchmarkable.rb
activesupport-6.0.3.rc1 lib/active_support/benchmarkable.rb