betterp 0.1.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 14eca65c37298f3f7f28bd0ea317eb12fcc739db2e7502a0487addeef5997c90
-  data.tar.gz: b6fc5f08ca75600e220cc153593ca0b1bdec8a239e7af9266d4301792ba46484
+  metadata.gz: 8ea0ef4e30131dd17a73ccf0a81c9597b78f5d7538bbaf17e5aae17eae0216d6
+  data.tar.gz: 3546052c741f0687e386488a4e6e435344dffb8d725ec6d9270006434b453d44
 SHA512:
-  metadata.gz: 782f0b93d39771daaa86e13b8655a13aa1ac41c349bef5e04a0e93015ff65475a2561bdf8beda5b03b314804591b8fb75a60b7a1a942940f9aaefaffdcf22431
-  data.tar.gz: 509b64a135cc221547a497c1e6f94edf0d5cceb2a9528c0b117b95c482de535a0861b4573211ec475518d2cf4353d07e178829561c5e7cd0707c2c981e2a60e8
+  metadata.gz: 2776e06b838c9f24a3a62828cb1a0994ebb1971bc86ca1e551d7833cd5617a97e7da7ba196982767248a7916214336ef759ad16ff9a222b69d74a9ad9c1908da
+  data.tar.gz: 71c3479e6eabe34c9bacefb184a58dec62e7c5e68cb2e0ec426ff985ad180a0b404a82c3b1b7cd35507fbc06b398fae2a30fe44e39a963db9a675913028a09cb

data/.gitignore

@@ -6,11 +6,11 @@
 /spec/reports/
 /tmp/
 
-Gemfile.lock
-
 .ruby-version
 .rspec_status
 .byebug_history
 *.swp
 *.swo
 betterp-*.gem
+
+/rspec-documentation/bundle/

data/.rubocop.yml

@@ -1,18 +1,8 @@
-Style/Documentation:
-  Enabled: false
-
-Style/StringLiterals:
-  Exclude:
-    - 'lib/betterp/output.rb'
-
-Style/FormatString:
-  Exclude:
-    - 'lib/betterp/output.rb'
-
-Style/FormatStringToken:
-  Exclude:
-    - 'lib/betterp/output.rb'
+require:
+- rubocop-rake
+- rubocop-rspec
 
 AllCops:
+  NewCops: enable
   Exclude:
     - 'bin/**/*'

data/Gemfile

@@ -6,3 +6,12 @@ git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 # Specify your gem's dependencies in betterp.gemspec
 gemspec
+
+gem 'rake', '~> 13.0'
+gem 'rspec', '~> 3.12'
+gem 'rspec-documentation', '~> 0.0.11'
+gem 'rspec-its', '~> 1.3'
+gem 'rubocop', '~> 1.57'
+gem 'rubocop-rake', '~> 0.6.0'
+gem 'rubocop-rspec', '~> 2.24'
+gem 'strong_versions', '~> 0.4.5'

data/Gemfile.lock

@@ -0,0 +1,107 @@
+PATH
+  remote: .
+  specs:
+    betterp (0.1.8)
+      paintbrush (~> 0.1.3)
+      rouge (~> 4.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    base64 (0.1.1)
+    concurrent-ruby (1.2.2)
+    diff-lcs (1.5.0)
+    htmlbeautifier (1.4.2)
+    i18n (1.14.1)
+      concurrent-ruby (~> 1.0)
+    json (2.6.3)
+    kramdown (2.4.0)
+      rexml
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
+    language_server-protocol (3.17.0.3)
+    nokogiri (1.15.4-x86_64-linux)
+      racc (~> 1.4)
+    paint (2.3.0)
+    paintbrush (0.1.3)
+    parallel (1.23.0)
+    parser (3.2.2.4)
+      ast (~> 2.4.1)
+      racc
+    racc (1.7.1)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.8.2)
+    rexml (3.2.6)
+    rouge (4.2.0)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-documentation (0.0.11)
+      htmlbeautifier (~> 1.4)
+      kramdown (~> 2.4)
+      kramdown-parser-gfm (~> 1.1)
+      nokogiri (~> 1.15)
+      paintbrush (~> 0.1.3)
+      rouge (~> 4.1)
+      rspec (~> 3.12)
+    rspec-expectations (3.12.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-its (1.3.0)
+      rspec-core (>= 3.0.0)
+      rspec-expectations (>= 3.0.0)
+    rspec-mocks (3.12.6)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.1)
+    rubocop (1.57.1)
+      base64 (~> 0.1.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.2.2.4)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.28.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.29.0)
+      parser (>= 3.2.1.0)
+    rubocop-capybara (2.19.0)
+      rubocop (~> 1.41)
+    rubocop-factory_bot (2.24.0)
+      rubocop (~> 1.33)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
+    rubocop-rspec (2.24.1)
+      rubocop (~> 1.33)
+      rubocop-capybara (~> 2.17)
+      rubocop-factory_bot (~> 2.22)
+    ruby-progressbar (1.13.0)
+    strong_versions (0.4.5)
+      i18n (>= 0.5)
+      paint (~> 2.0)
+    unicode-display_width (2.5.0)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  betterp!
+  rake (~> 13.0)
+  rspec (~> 3.12)
+  rspec-documentation (~> 0.0.11)
+  rspec-its (~> 1.3)
+  rubocop (~> 1.57)
+  rubocop-rake (~> 0.6.0)
+  rubocop-rspec (~> 2.24)
+  strong_versions (~> 0.4.5)
+
+BUNDLED WITH
+   2.4.14

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2018 Robert Farrell
+Copyright 2018-2023 Robert Farrell
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

data/Makefile

@@ -3,3 +3,4 @@ test:
 	bin/rspec
 	bin/rubocop
 	bin/strong_versions
+	bundle exec rspec-documentation

data/betterp.gemspec

@@ -9,13 +9,15 @@ Gem::Specification.new do |spec|
   spec.licenses      = ['MIT']
   spec.version       = Betterp::VERSION
   spec.authors       = ['Bob Farrell']
-  spec.email         = ['bob@homeflow.co.uk']
+  spec.email         = ['git@bob.frl']
 
-  spec.summary       = 'Enhanced debug output'
-  spec.description   = 'Replaces Kernel#p with a fancier version'
+  spec.summary       = 'Enhanced colorized debug output'
+  spec.description   = 'Overwrites Kernel#p to provide output with file path, line numbers, and profiling. '
   spec.homepage      = 'https://github.com/bobf/betterp'
 
-  spec.files         = Dir.chdir(File.expand_path(__dir__)) do
+  spec.required_ruby_version = '>= 3.2'
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject do |f|
       f.match(%r{^(test|spec|features)/})
     end
@@ -24,12 +26,8 @@ Gem::Specification.new do |spec|
   spec.executables   = []
   spec.require_paths = ['lib']
 
-  spec.add_runtime_dependency 'paint', '~> 2.0'
+  spec.add_runtime_dependency 'paintbrush', '~> 0.1.3'
+  spec.add_runtime_dependency 'rouge', '~> 4.2'
 
-  spec.add_development_dependency 'bundler', '~> 1.16'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'rspec-its', '~> 1.2'
-  spec.add_development_dependency 'rubocop', '~> 0.77.0'
-  spec.add_development_dependency 'strong_versions', '~> 0.3.2'
+  spec.metadata['rubygems_mfa_required'] = 'true'
 end

data/doc/testp.rb

@@ -2,7 +2,7 @@
 
 require 'betterp'
 
-class MyCustomClass
+class MyCustomClass # rubocop:disable Lint/EmptyClass
 end
 
 p 'hello'

data/lib/betterp/configuration.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Betterp
+  # Misc. configuration options for Betterp library.
+  class Configuration
+    attr_accessor :test_mode
+    attr_writer :profiling_thresholds
+
+    # Configures colors to use for different profiling durations, defines low, medium, and high
+    # colors.
+    class ProfilingThreshold
+      attr_writer :low, :high
+
+      def color(duration)
+        return :green if low?(duration)
+        return :yellow if medium?(duration)
+
+        :red if high?(duration)
+      end
+
+      private
+
+      def low?(duration)
+        duration <= low
+      end
+
+      def medium?(duration)
+        duration.between?(low, high)
+      end
+
+      def high?(duration)
+        duration >= high
+      end
+
+      def low
+        @low || 10
+      end
+
+      def high
+        @high || 100
+      end
+    end
+
+    def profiling_threshold
+      @profiling_threshold ||= ProfilingThreshold.new
+    end
+  end
+end

data/lib/betterp/output.rb

@@ -1,27 +1,48 @@
 # frozen_string_literal: true
 
 module Betterp
+  # Transforms default output from `Kernel.p` into enhanced, colorized output with source
+  # filename, line number, method name, and duration when used with a block.
   class Output
-    COLORS = %i[red green yellow blue magenta cyan].freeze
-    EFFECTS = [:bright, nil].freeze
+    COLORS = %i[red green yellow blue purple cyan red_b green_b yellow_b blue_b purple_b cyan_b].freeze
 
-    def initialize(raw, source, options = {})
+    def initialize(raw, source, duration, options = {})
       @raw = raw
       @source = source
+      @duration = duration
       @color = color
-      @effect = effect
       @pretty = options.fetch(:pretty, false)
     end
 
-    def format(args)
+    def formatted(args)
       (@pretty ? args : args.map(&:inspect)).map do |arg|
-        style = %i[yellow]
-        header + colorize(prefix) + caller_code + Paint[pretty(arg), *style]
+        output = [
+          header, colorized_prefix, colorized_duration, caller_code, highlighted(pretty(arg))
+        ].compact.join(' ').chomp
+        "#{output}\n"
       end
     end
 
     private
 
+    def highlighted(output)
+      formatter = Rouge::Formatters::Terminal256.new
+      lexer = Rouge::Lexers::Ruby.new
+      formatter.format(lexer.lex(output))
+    end
+
+    def colorized_duration
+      return nil if @duration.nil?
+
+      duration = @duration * 1000
+      color = Betterp.configuration.profiling_threshold.color(duration)
+      Paintbrush.paintbrush { "[#{send color, "#{Float(format('%.2g', duration))}ms"}]" }
+    end
+
+    def colorized_pretty(arg)
+      Paintbrush.paintbrush { cyan pretty(arg) }
+    end
+
     def pretty(arg)
       return arg unless @pretty
 
@@ -29,22 +50,18 @@ module Betterp
       PP.pp(arg, io)
       return io.string unless io.string.include?("\n")
 
-      "\n" + io.string.split("\n").map { |line| "    #{line}" }.join("\n")
+      "\n#{io.string.split("\n").map { |line| "  #{line}" }.join("\n")}"
     end
 
     def caller_code
-      return '' unless @raw.include?(':')
+      return nil unless @raw.include?(':')
 
       path, line, *_rest = @raw.split(':')
-      return '' unless Pathname.new(path).readable? && line.to_i.positive?
-
-      Paint % [
-        +'%{open}%{code}%{close}',
-        :default,
-        open: ['{ ', :white, :default],
-        code: [find_caller(line.to_i, path).to_s.strip, :cyan],
-        close: [' } ', :white, :default]
-      ]
+      return nil unless Pathname.new(path).readable? && line.to_i.positive?
+
+      Paintbrush.paintbrush do
+        white "{ #{blue find_caller(line.to_i, path).to_s.strip} }"
+      end
     end
 
     def find_caller(line_number, path)
@@ -54,49 +71,19 @@ module Betterp
     end
 
     def header
-      Paint % [
-        +"%{standard}%{relevant}",
-        :default,
-        standard: ['   ', :default],
-        relevant: ['•••• ', @color, @effect]
-      ]
+      Paintbrush.paintbrush { send @color, '####' }
     end
 
-    def prefix
-      [
-        '%{path}',
-        '%{separator}',
-        '%{line_no}',
-        '%{method_pointer}',
-        '%{method_name}',
-        '%{terminator}'
-      ].join
-    end
-
-    def colorize(string)
-      Paint % [string, :default, mapping]
-    end
-
-    def mapping
-      {
-        path: [@source.path],
-        line_no: [@source.line_no],
-        method_name: [@source.method_name],
-
-        method_pointer: [' => ', :reset, :bright],
-        separator: [':', :reset],
-        terminator: [' :: ', :reset]
-      }
+    def colorized_prefix
+      Paintbrush.paintbrush do
+        "#{blue_b @source.path}:#{cyan_b @source.line_no} => [#{green "##{@source.method_name}"}]"
+      end
     end
 
     def color
       COLORS[hash(@raw).hex % COLORS.size]
     end
 
-    def effect
-      EFFECTS[hash(hash(@raw)).hex % EFFECTS.size]
-    end
-
     def hash(input)
       Digest::MD5.hexdigest(input)
     end

data/lib/betterp/source.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Betterp
+  # Parses a line from a stack trace to generate file path, line number, and method name.
   class Source
     def initialize(source, base_path)
       @source = source

data/lib/betterp/timed_block.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Betterp
+  # Executes a block and returns the block result and duration.
+  class TimedBlock
+    def initialize(block:)
+      @block = block
+    end
+
+    def result
+      start = Time.now.utc
+      block_result = block.call
+      [block_result, Time.now.utc - start]
+    end
+
+    private
+
+    attr_reader :block
+  end
+end

data/lib/betterp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Betterp
-  VERSION = '0.1.6'
+  VERSION = '0.1.8'
 end

data/lib/betterp.rb

@@ -2,18 +2,32 @@
 
 require 'digest'
 require 'pathname'
-require 'pp'
+require 'pp' # rubocop:disable Lint/RedundantRequireStatement
 require 'stringio'
+require 'time'
 
-require 'paint'
+require 'paintbrush'
+require 'rouge'
 
 require 'kernel'
+require 'betterp/configuration'
 require 'betterp/output'
 require 'betterp/source'
+require 'betterp/timed_block'
 require 'betterp/version'
 
+# Enhanced debug output library.
 module Betterp
   def self.root
     Pathname.new(File.dirname(__dir__))
   end
+
+  def self.configuration
+    @configuration || Configuration.new
+  end
+
+  def self.configure
+    @configuration = Configuration.new
+    yield @configuration
+  end
 end

data/lib/kernel.rb

@@ -1,23 +1,31 @@
 # frozen_string_literal: true
 
+# Overrides for `p` and `pp` Kernel methods.
 module Kernel
-  def p(*args)
+  def p(*args, &block)
     raw = caller(1..1).first
-    _betterp(raw, args)
+    _betterp(raw, args, block)
   end
 
-  def pp(*args)
+  def pp(*args, &block)
     raw = caller(1..1).first
-    _betterp(raw, args, pretty: true)
+    _betterp(raw, args, block, pretty: true)
   end
 
-  def _betterp(raw, args, options = {})
+  def _betterp(raw, args, block, options = {}) # rubocop:disable Metrics/AbcSize
     source = Betterp::Source.new(raw, Dir.pwd)
     pretty = options.fetch(:pretty, false)
 
-    Betterp::Output.new(raw, source, pretty: pretty).format(args).each do |str|
-      STDOUT.write(str + "\n")
-    end
+    block_result, duration = Betterp::TimedBlock.new(block:).result unless block.nil?
+
+    output = Betterp::Output.new(raw, source, duration, pretty:)
+    formatted_output = output.formatted(block.nil? ? args : [block_result]).join("\n")
+
+    return formatted_output if Betterp.configuration.test_mode
+
+    $stdout.write(formatted_output)
+
+    return block_result unless block.nil?
 
     args.size > 1 ? args : args.first
   end

data/rspec-documentation/pages/000-Introduction.md

@@ -0,0 +1,16 @@
+# Introduction
+
+_Betterp_ overwrites the default `p` and `pp` _Kernel_ methods to provide enhanced debug output including:
+
+* Source file and line number of invocation.
+* Colorized tags to help track debug output in noisy server logs.
+* Profiling information (pass a block to `p` or `pp` to output call duration).
+
+
+```rspec:ansi
+require 'betterp'
+
+subject { p 'hello' }
+
+it { is_expected.to include 'hello' }
+```

data/rspec-documentation/pages/010-Usage.md

@@ -0,0 +1,43 @@
+# Usage
+
+Typical usage of _Betterp_ is identical to usage of `Kernel.p` and `Kernel.pp`, simply require `betterp` somewhere in your project and call `#p` or `#pp` as normal.
+
+```rspec:ansi
+subject { p 'hi' }
+
+it { is_expected.to include 'hi' }
+```
+
+```rspec:ansi
+subject { pp({ foo: 'bar', baz: 'qux' }) }
+
+it { is_expected.to include 'qux' }
+```
+
+## Profiling
+
+Both `#p` and `#pp` can receive a block. If a block is received, the block will be timed and the execution time will be included in the output. The result of the block is returned to the caller.
+
+```rspec:ansi
+subject do
+  p { sleep(0.1); 'some return value' }
+end
+
+it { is_expected.to match /\dms/ }
+```
+
+The execution time is highlighted in `green`, `yellow`, or `red` depending on execution time.
+
+The default thresholds are:
+
+* `low`: `< 10ms`.
+* `high`: `> 100ms`.
+
+The thresholds can be modified:
+
+```ruby
+Betterp.configure do |config|
+  config.profiling_threshold.low = 100
+  config.profiling_threshold.high = 1000
+end
+```

data/rspec-documentation/pages/500-License.md

@@ -0,0 +1,11 @@
+# License
+
+## MIT
+
+Copyright 2018-2023 Robert Farrell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/rspec-documentation/spec_helper.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'betterp'
+
+Betterp.configure do |config|
+  config.test_mode = true
+end
+
+RSpec::Documentation.configure do |config|
+  # Force example tabs to have a consistent height to prevent content jumping.
+  # config.consistent_height = false
+
+  # Set a maximum height for example tabs. Tabs will scroll if content exceeds this value.
+  # config.max_height = "30rem"
+
+  # Enable or disable the table of contents for each page. This renders a list of all headings in
+  # the page, except the main heading.
+  # config.table_of_contents = true
+
+  # Enable or disable the index search above the navigation tree.
+  # config.index_search = true
+
+  config.context do
+    # Define global context here, e.g. add some `let` blocks to make them available in every example.
+    #
+    # let(:foo) { 'bar' }
+  end
+end
+
+RSpec.configure do |config|
+  # Define RSpec configuration here.
+  # Note that your main `spec/spec_helper.rb` is not loaded unless you require it in this file.
+end

metadata

@@ -1,116 +1,47 @@
 --- !ruby/object:Gem::Specification
 name: betterp
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
 platform: ruby
 authors:
 - Bob Farrell
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-08-23 00:00:00.000000000 Z
+date: 2023-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: paint
+  name: paintbrush
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 0.1.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 0.1.3
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: rouge
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.16'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: rspec-its
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.77.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.77.0
-- !ruby/object:Gem::Dependency
-  name: strong_versions
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.3.2
-  type: :development
+        version: '4.2'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.2
-description: Replaces Kernel#p with a fancier version
+        version: '4.2'
+description: 'Overwrites Kernel#p to provide output with file path, line numbers,
+  and profiling. '
 email:
-- bob@homeflow.co.uk
+- git@bob.frl
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -119,6 +50,7 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - Gemfile
+- Gemfile.lock
 - LICENSE
 - Makefile
 - README.md
@@ -132,15 +64,22 @@ files:
 - doc/images/screenshot.png
 - doc/testp.rb
 - lib/betterp.rb
+- lib/betterp/configuration.rb
 - lib/betterp/output.rb
 - lib/betterp/source.rb
+- lib/betterp/timed_block.rb
 - lib/betterp/version.rb
 - lib/kernel.rb
+- rspec-documentation/pages/000-Introduction.md
+- rspec-documentation/pages/010-Usage.md
+- rspec-documentation/pages/500-License.md
+- rspec-documentation/spec_helper.rb
 homepage: https://github.com/bobf/betterp
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -148,15 +87,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.4.10
+signing_key:
 specification_version: 4
-summary: Enhanced debug output
+summary: Enhanced colorized debug output
 test_files: []