object_inspector 0.8.2 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8cec70cf90b2d72b87fa7c977949c7a99057364e1788e6fe84618ab73f7503c6
-  data.tar.gz: 80fa2ce2e8744f9af3cb346b00c414376d70788e2c48df7fd079779dfe68e06f
+  metadata.gz: 1468942ef1aa4a276a2138a904f34329d8b1e9846b58e013c208fbfe4a9113da
+  data.tar.gz: a552ef57ab52b60f208bbe2fceac50f96be25a340cd3854864a5d6a54e3d886f
 SHA512:
-  metadata.gz: 4822bbef66b7cebadd5f0ef7760412a54f509f3b5e81bd3651f9feb2140e052bef2fa85f11186976460deeee83c03a5f08c05cbe85a5955133526d4a076eb185
-  data.tar.gz: af24a9ea1bd74b036edb437ec18efa19b2d159cabcf98b962459fc29b381db2e6fa8bb48735e897fb39b2ef2e9a9c3776383c1c76f6f14a30cd2358eb4900987
+  metadata.gz: 2d02eab73350615584726ada8923bcdea3d428cf61d8e95abf17778b4b76836f828b2c12389dadf1aebe85e369106b4396da1e8501f81fe4e74b44a3031171b8
+  data.tar.gz: 1d044028f4889d0b6bd5615d5f035e19e5bf6ce7e5a30a30ce54a686edb403dd89a826bf8cfd0c4a89781c862af798d4e50ce9a1ed0080012f33a99ec4e477e1

data/README.md

@@ -5,7 +5,7 @@
 
 Object Inspector takes Object#inspect to the next level. Specify any combination of identification attributes, flags, issues, info, and/or a name along with an optional, self-definable scope option to represent objects. Great for the console, logging, etc.
 
-Why? Because object inspection code should be uniform, easy to build, and its output should be easy to read!
+Why? Because object inspection output should be uniform and easy to build, and its output should be easy to read! Consistency improves readability.
 
 If you'd like to just jump into an example: [Full Example](#full-example).
 
@@ -19,11 +19,15 @@ gem "object_inspector"
 
 And then execute:
 
-    $ bundle
+```sh
+$ bundle
+```
 
 Or install it yourself:
 
-    $ gem install object_inspector
+```sh
+$ gem install object_inspector
+```
 
 ## Compatibility
 
@@ -42,19 +46,19 @@ gem "object_inspector", "0.6.3"
 For Ruby 3.1 support, install object_inspector gem version 0.7.0.
 
 ```ruby
-gem "object_inspector", "0.6.3"
+gem "object_inspector", "0.7.0"
 ```
 
 Object Inspector has no other dependencies.
 
 ## Configuration
 
-Global/default values for Object Inspector can be configured via the ObjectInspector::Configuration object.
-
-_Note: In a Rails app, the following would go in e.g. `config/initializers/object_inspector.rb`_
+Global/default values for Object Inspector can be configured via the [ObjectInspector::Configuration] object.
 
 ```ruby
-# Default values are shown.
+# config/initializers/object_inspector.rb
+
+# Default values are shown. Customize to your liking.
 ObjectInspector.configure do |config|
   config.formatter_class = ObjectInspector::TemplatingFormatter
   config.inspect_method_prefix = "inspect"
@@ -71,7 +75,7 @@ end
 
 ## Usage
 
-Given, an object of any type, call ObjectInspector::Inspector.inspect.
+Pass an object of any type into `ObjectInspector::Inspector.inspect`.
 
 ```ruby
 class MyObject
@@ -83,11 +87,11 @@ end
 MyObject.new.inspect  # => "<MyObject>"
 ```
 
-See also [Helper Usage](#helper-usage) for an even simpler usage option.
+See: [Helper Usage](#helper-usage) for simpler usage.
 
 ### Output Customization
 
-Use the `identification`, `flags`, `info`, and/or `name` options to customize inspect output.
+Use the `identification`, `flags`, `issues`, `info`, and/or `name` options to customize inspect output.
 
 ```ruby
 class MyObject
@@ -96,15 +100,17 @@ class MyObject
       self,
       identification: "My Object",
       flags: "FLAG1 / FLAG2",
+      issues: "ISSUE1",
       info: "INFO",
       name: "NAME")
   end
 end
 
-MyObject.new.inspect  # => "<My Object(FLAG1 / FLAG2) INFO :: NAME>"
+MyObject.new.inspect
+# => "<My Object(FLAG1 / FLAG2) !!ISSUE1!! INFO :: NAME>"
 ```
 
-Or, define `inspect_identification`, `inspect_flags`, `inspect_info`, and/or `inspect_name` (or `display_name`) as either public or private methods on Object.
+Or, define `inspect_identification`, `inspect_flags`, `inspect_issues`, `inspect_info`, and/or `inspect_name` (or `display_name`) as either public or private methods on Object.
 
 ```ruby
 class MyObject
@@ -114,11 +120,11 @@ class MyObject
 
   private
 
-  def inspect_identification; "My Object" end
-  def inspect_flags; "FLAG1 / FLAG2" end
-  def inspect_issues; "ISSUE1 | ISSUE2" end
-  def inspect_info; "INFO" end
-  def inspect_name; "NAME" end  # Or: def display_name; "NAME" end
+  def inspect_identification = "My Object"
+  def inspect_flags = "FLAG1 / FLAG2"
+  def inspect_issues = "ISSUE1 | ISSUE2"
+  def inspect_info = "INFO"
+  def inspect_name = "NAME"  # Or: def display_name = "NAME"
 end
 
 MyObject.new.inspect
@@ -127,7 +133,7 @@ MyObject.new.inspect
 
 ## Helper Usage
 
-To save some typing, include ObjectInspector::InspectHelper into an object and ObjectInspector::Inspector.inspect will be called on `self` automatically.
+To save some typing, include ObjectInspector::InspectHelper into an object and `ObjectInspector::Inspector.inspect` will be called on `self` automatically.
 
 ```ruby
 class MyObject
@@ -164,17 +170,41 @@ class MyObject
 
   private
 
-  def inspect_identification; "My Object" end
-  def inspect_flags; "FLAG1 / FLAG2" end
-  def inspect_issues; "ISSUE1 | ISSUE2" end
-  def inspect_info; "INFO" end
-  def inspect_name; "NAME" end  # Or: def display_name; "NAME" end
+  def inspect_identification = "My Object"
+  def inspect_flags = "FLAG1 / FLAG2"
+  def inspect_issues = "ISSUE1 | ISSUE2"
+  def inspect_info = "INFO"
+  def inspect_name = "NAME"  # Or: def display_name = "NAME"
 end
 
 MyObject.new.inspect
 # => "<My Object(FLAG1) !!ISSUE1 | ISSUE2!! INFO :: NAME>"
 ```
 
+### Helper Inclusion
+
+It may be useful to conditionally include ObjectInspector::InspectorsHelper, as well as other similar methods, via a mix-in.
+
+```ruby
+module ObjectInspectionBehaviors
+  extend ActiveSupport::Concern
+
+  included do
+    # If you'd like to preserve the original inspect method, here is your
+    # chance to.
+    alias_method :__inspect__, :inspect
+
+    include ObjectInspector::InspectorsHelper
+  end
+
+  # An example of another, similar style of method you may wish to utilize in
+  # this mix-in.
+  def introspect
+    self
+  end
+end
+```
+
 ## Scopes
 
 Use the `scope` option to define the scope of the `inspect_*` methods. The supplied value will be wrapped by the ObjectInspector::Scope helper object.
@@ -192,15 +222,16 @@ my_object.inspect(scope: <scope_name>)
 
 Options:
 
-- `:self` (Default) -- Is meant to confine object interrogation to self (don't interrogate neighboring objects).
-- `:all` -- Is meant to match on all scopes, regardless of their name.
-- `<custom>` -- Anything else that makes sense for the object to key on.
+- `:self` (Default)--Is meant to confine object interrogation to self (don't interrogate neighboring objects).
+- `:all`--Is meant to match on all scopes, regardless of their name.
+- `<custom>`--Anything else that makes sense for the object to key on.
 
 ```ruby
 scope = ObjectInspector::Scope.new
-scope.self?     # => true
-scope.verbose?  # => false
-scope.complex?  # => false
+scope.self?       # => true
+scope.verbose?    # => false
+scope.complex?    # => false
+scope.<anything>? # => false
 ```
 
 #### Multiple Scope Names
@@ -223,8 +254,11 @@ scope = ObjectInspector::Scope.new(:all)
 scope.self?     # => true
 scope.verbose?  # => true
 scope.complex?  # => true
+scope.all?      # => true
 ```
 
+_**NOTE**_: Calling `#inspect!` on an object that mixes in `ObjectInspector::InspectorsHelper` is equivalent to passing in the "wild card" scope.
+
 ### Scope blocks
 
 Passing a block to a scope predicate falls back to the out-of-scope placeholder (`*` by default) if the scope does not match.
@@ -240,20 +274,19 @@ scope.complex? { "MATCH" }  # => "*"
 ObjectInspector::Scope also offers helper methods for uniformly joining inspect elements:
 
 ```ruby
-join_name # Joins name parts with ` - ` by default
-join_flags # Joins flags with ` / ` by default
-join_info # Joins info items with ` | ` by default
+join_name   # Joins name parts with ` - ` by default
+join_flags  # Joins flags with ` / ` by default
+join_issues # Joins issues with ` | ` by default
+join_info   # Joins info items with ` | ` by default
 ```
 
 For example:
 
 ```ruby
-scope = ObjectInspector::Scope.new(:verbose)
-scope.join_name([1, 2, 3])  # => "1 - 2 - 3"
-scope.join_name([1, 2, 3, nil])  # => "1 - 2 - 3"
-scope.join_flags([1, 2, 3])  # => "1 / 2 / 3"
+scope = ObjectInspector::Scope.new(:all)
+scope.join_name([1, 2, 3, nil])   # => "1 - 2 - 3"
 scope.join_flags([1, 2, 3, nil])  # => "1 / 2 / 3"
-scope.join_info([1, 2, 3])   # => "1 | 2 | 3"
+scope.join_issues([1, 2, 3, nil]) # => "1 | 2 | 3"
 scope.join_info([1, 2, 3, nil])   # => "1 | 2 | 3"
 ```
 
@@ -272,11 +305,11 @@ class MyObject
   end
 
   def associated_object1
-    OpenStruct.new(flags: "AO1_FLAG1")
+    Data.define(:flags)["AO1_FLAG1"]
   end
 
   def associated_object2
-    OpenStruct.new(flags: "AO2_FLAG1")
+    Data.define(:flags)["AO2_FLAG1"]
   end
 
   # Or `def inspect_name`
@@ -304,8 +337,11 @@ class MyObject
     scope.join_flags(flags)
   end
 
-  def inspect_issues
-    "!!WARNING!!"
+  def inspect_issues(scope:)
+    scope.join_issues([
+      "I1",
+      scope.verbose? { "VI2" },
+    ])
   end
 
   def inspect_info(scope:)
@@ -319,37 +355,43 @@ end
 
 my_object = MyObject.new("Name")
 
+my_object.inspect
+# => "<MyObject[2](DEFAULT_FLAG / *) !!I1 | *!! Default Info | * :: Name>"
+
+my_object.inspect(scope: :self)
+# => "<MyObject[2](DEFAULT_FLAG / *) !!I1 | *!! Default Info | * :: Name>"
+
 my_object.inspect(scope: :complex)
-# => "<MyObject[a2:2](DEFAULT_FLAG / *) !!!!WARNING!!!! Default Info | Complex Info | * :: Name>"
+# => "<MyObject[2](DEFAULT_FLAG / *) !!I1 | *!! Default Info | Complex Info | * :: Name>"
 
 my_object.inspect(scope: :verbose)
-# => "<MyObject[a2:2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!!!WARNING!!!! Default Info | Verbose Info :: Name>"
+# => "<MyObject[2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!I1 | VI2!! Default Info | Verbose Info :: Name>"
 
 my_object.inspect(scope: %i[self complex verbose])
-# => "<MyObject[a2:2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!!!WARNING!!!! Default Info | Complex Info | Verbose Info :: Name>"
+# => "<MyObject[2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!I1 | VI2!! Default Info | Complex Info | Verbose Info :: Name>"
 
 my_object.inspect(scope: :all)
-# => "<MyObject[a2:2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!!!WARNING!!!! Default Info | Complex Info | Verbose Info :: Name>"
+# => "<MyObject[2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!I1 | VI2!! Default Info | Complex Info | Verbose Info :: Name>"
 
-my_object.inspect
-# => "<MyObject[a2:2](DEFAULT_FLAG / *) !!!!WARNING!!!! Default Info | * :: Name>"
+my_object.inspect! # 👀 Same as passing in `scope: :all`
+# => "<MyObject[2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!I1 | VI2!! Default Info | Complex Info | Verbose Info :: Name>"
 
 ObjectInspector.configuration.default_scope = :complex
 my_object.inspect
-# => "<MyObject[a2:2](DEFAULT_FLAG / *) !!!!WARNING!!!! Default Info | Complex Info | * :: Name>"
+# => "<MyObject[2](DEFAULT_FLAG / *) !!I1 | *!! Default Info | Complex Info | * :: Name>"
 
 ObjectInspector.configuration.default_scope = %i[self complex verbose]
 my_object.inspect
-# => "<MyObject[a2:2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!!!WARNING!!!! Default Info | Complex Info | Verbose Info :: Name>"
+# => "<MyObject[2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!I1 | VI2!! Default Info | Complex Info | Verbose Info :: Name>"
 
 ObjectInspector.configuration.default_scope = :all
 my_object.inspect
-# => "<MyObject[a2:2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!!!WARNING!!!! Default Info | Complex Info | Verbose Info :: Name>"
+# => "<MyObject[2](DEFAULT_FLAG / AO1_FLAG1 / AO2_FLAG1) !!I1 | VI2!! Default Info | Complex Info | Verbose Info :: Name>"
 ```
 
 ## Wrapped Objects
 
-If the Object being inspected wraps another object -- i.e. defines #to_model and #to_model returns an object other than self -- the inspect output will re-inspect the wrapped object. The wrapper points to the wrapped object with an arrow (⇨).
+If the Object being inspected wraps another object--i.e. defines #to_model and #to_model returns an object other than self--the inspect output will re-inspect the wrapped object. The wrapper points to the wrapped object with an arrow (⇨).
 
 ```ruby
 class MyWrapperObject
@@ -361,7 +403,8 @@ class MyWrapperObject
 
   private
 
-  def inspect_flags; "WRAPPER_FLAG1" end
+  def inspect_flags = "WRAPPER_FLAG1"
+  def inspect_issues(scope:) = scope.complex? { "CI1" }
 end
 
 class MyWrappedObject
@@ -369,12 +412,16 @@ class MyWrappedObject
 
   private
 
-  def inspect_flags; "FLAG1 / FLAG2" end
-  def inspect_info; "INFO" end
+  def inspect_flags = "FLAG1 / FLAG2"
+  def inspect_info = "INFO"
+  def inspect_issues(scope:) = scope.complex? { "CI1" }
 end
 
 MyWrapperObject.new.inspect
-# => "<MyWrapperObject(WRAPPER_FLAG1)> ⇨ <MyWrappedObject(FLAG1 / FLAG2) INFO>"
+# => "<MyWrapperObject(WRAPPER_FLAG1) !!*!!>  ⇨  <MyWrappedObject(FLAG1 / FLAG2) !!*!! INFO>"
+
+MyWrapperObject.new.inspect!
+# => "<MyWrapperObject(WRAPPER_FLAG1) !!CI1!!>  ⇨  <MyWrappedObject(FLAG1 / FLAG2) !!CI1!! INFO>"
 ```
 
 This feature is recursive.
@@ -424,10 +471,10 @@ class MyWrappedObject
 
   private
 
-  def inspect_flags; "FLAG1" end
-  def inspect_info; "INFO" end
-  def inspect_issues; "ISSUE1" end
-  def inspect_name; "NAME" end
+  def inspect_flags = "FLAG1"
+  def inspect_info = "INFO"
+  def inspect_issues = "ISSUE1"
+  def inspect_name = "NAME"
 end
 
 MyDelegatingWrapperObject.new(MyWrappedObject.new).inspect
@@ -442,10 +489,10 @@ When passed as an option (as opposed to being called via an Object-defined metho
 class MyObject
   include ObjectInspector::InspectorsHelper
 
-  def my_method1; "Result1" end
-  def my_method2; "Result2" end
+  def my_method1 = "Result1"
+  def my_method2 = "Result2"
 
-  def inspect_info; :my_method2 end
+  def inspect_info = :my_method2
 end
 
 MyObject.new.inspect(info: "my_method1")  # => "<MyObject my_method1>"
@@ -461,17 +508,18 @@ Pass `nil` to any inspect method type to not display it:
 class MyObject
   include ObjectInspector::InspectorsHelper
 
-  def inspect_identification; "My Object" end
-  def inspect_info; "INFO" end
-  def inspect_flags; "FLAG1" end
-  def inspect_issues; "ISSUE1" end
+  def inspect_identification = "My Object"
+  def inspect_info = "INFO"
+  def inspect_flags = "FLAG1"
+  def inspect_issues = "ISSUE1"
+  def inspect_name = "NAME"
 end
 
 MyObject.new.inspect
-# => "<My Object(FLAG1) !!ISSUE1!! INFO>"
+# => "<My Object(FLAG1) !!ISSUE1!! INFO :: NAME>"
 MyObject.new.inspect(info: nil, flags: nil, issues: nil)
-# => "<My Object>"
-MyObject.new.inspect(identification: nil, info: nil, flags: nil, issues: nil)
+# => "<My Object :: NAME>"
+MyObject.new.inspect(identification: nil, info: nil, flags: nil, issues: nil, name: nil)
 # => "<MyObject>"
 ```
 
@@ -490,11 +538,12 @@ class MyObject
   include ObjectInspector::InspectorsHelper
 
   def inspect
-    super(formatter: MyCustomFormatter,
-          identification: "IDENTIFICATION",
-          flags: "FLAG1 / FLAG2",
-          info: "INFO",
-          name: "NAME")
+    super(
+      formatter: MyCustomFormatter,
+      identification: "IDENTIFICATION",
+      flags: "FLAG1 / FLAG2",
+      info: "INFO",
+      name: "NAME")
   end
 end
 
@@ -529,10 +578,10 @@ class MyObject
     identify(:my_method1, :my_method2)
   end
 
-  def inspect_flags; "FLAG1 / FLAG2" end
-  def inspect_issues; "ISSUE1 | ISSUE2" end
-  def inspect_info; "INFO" end
-  def inspect_name; "NAME" end
+  def inspect_flags = "FLAG1 / FLAG2"
+  def inspect_issues = "ISSUE1 | ISSUE2"
+  def inspect_info = "INFO"
+  def inspect_name = "NAME"
 end
 
 MyObject.new.inspect
@@ -543,51 +592,59 @@ MyObject.new.inspect
 
 ### Benchmarking Object Inspector
 
-ObjectInspetor is ~4x slower than Ruby's default inspect.
+ObjectInspetor is ~2.75x slower than Ruby's default inspect, in Ruby v3.4.
 
 Performance of Object Inspector can be tested by playing the [Object Inspector Benchmarking Script](https://github.com/pdobb/object_inspector/blob/master/script/benchmarking/object_inspector.rb) in the IRB console for this gem.
 
 ```ruby
 load "script/benchmarking/object_inspector.rb"
+# Reporting for: Ruby v3.4.2
+#
+# == Averaged =============================================================
+# ...
+#
 # Comparison:
-#                 Ruby:    30382.2 i/s
-# ObjectInspector::Inspector:     7712.2 i/s - 3.94x  slower
+#                 Ruby:    58957.2 i/s
+# ObjectInspector::Inspector:    21416.6 i/s - 2.75x  slower
+# == Done
 ```
 
 ### Benchmarking Formatters
 
-[ObjectInspector::TemplatingFormatter] -- which is the default Formatter -- outperforms [ObjectInspector::CombiningFormatter] by about 30% on average.
+[ObjectInspector::TemplatingFormatter]--which is the default Formatter--outperforms [ObjectInspector::CombiningFormatter] by about 30% on average.
 
 Performance of Formatters can be tested by playing the [Formatters Benchmarking Scripts](https://github.com/pdobb/object_inspector/blob/master/script/benchmarking/formatters.rb) in the IRB console for this gem.
 
 ```ruby
 load "script/benchmarking/formatters.rb"
+# Reporting for: Ruby v3.4.2
+#
 # == Averaged =============================================================
 # ...
 #
 # Comparison:
-# ObjectInspector::TemplatingFormatter:    45725.3 i/s
-# ObjectInspector::CombiningFormatter:    34973.9 i/s - 1.31x  slower
-#
+# ObjectInspector::TemplatingFormatter:    65856.3 i/s
+# ObjectInspector::CombiningFormatter:    60920.0 i/s - 1.13x  slower
 # == Done
 ```
 
 #### Benchmarking Custom Formatters
 
-Custom Formatters may be similarly gauged for comparison by adding them to the `custom_formatter_klasses` array before playing the script.
+Custom Formatters may be similarly gauged for comparison by putting them into a constant `CUSTOM_FORMATTER_CLASSES` before loading the script in the IRB console for this gem.
 
 ```ruby
-custom_formatter_klasses = [MyCustomFormatter]
+CUSTOM_FORMATTER_CLASSES = [MyCustomFormatter]
 
-play script/benchmarking/formatters.rb
+load "script/benchmarking/formatters.rb"
+# Reporting for: Ruby v3.4.2
+#
 # == Averaged =============================================================
 # ...
 #
 # Comparison:
-#    MyCustomFormatter:    52001.2 i/s
-# ObjectInspector::TemplatingFormatter:    49854.2 i/s - same-ish: difference falls within error
-# ObjectInspector::CombiningFormatter:    38963.5 i/s - 1.33x  slower
-#
+#    MyCustomFormatter:    74227.7 i/s
+# ObjectInspector::TemplatingFormatter:    66148.5 i/s - 1.12x  slower
+# ObjectInspector::CombiningFormatter:    63289.7 i/s - 1.17x  slower
 # == Done
 ```
 
@@ -601,13 +658,13 @@ To install this gem onto your local machine, run `bundle exec rake install`.
 
 To test this gem:
 
-```bash
+```sh
 rake
 ```
 
 #### Linters
 
-```bash
+```sh
 rubocop
 
 reek

data/lib/object_inspector/formatters/base_formatter.rb

@@ -16,7 +16,7 @@ class ObjectInspector::BaseFormatter
   #
   # @return [String]
   def call
-    raise NotImplementedError
+    raise(NotImplementedError)
   end
 
   # Delegates to {Inspector#wrapped_object_inspection_result}.

data/lib/object_inspector/formatters/combining_formatter.rb

@@ -38,6 +38,7 @@ class ObjectInspector::CombiningFormatter < ObjectInspector::BaseFormatter
     [
       build_identification_string,
       build_flags_string,
+      build_issues_string,
       build_info_string,
       build_name_string,
     ].compact
@@ -51,6 +52,10 @@ class ObjectInspector::CombiningFormatter < ObjectInspector::BaseFormatter
     "(#{flags.to_s.upcase})" if flags
   end
 
+  def build_issues_string
+    " !!#{issues.to_s.upcase}!!" if issues
+  end
+
   def build_info_string
     " #{info}" if info
   end

data/lib/object_inspector/inspector.rb

@@ -36,7 +36,7 @@ class ObjectInspector::Inspector
         **kwargs)
     @object = object
     @scope = ObjectInspector::Conversions.Scope(scope)
-    @formatter_klass = formatter
+    @formatter_class = formatter
     @kwargs = kwargs
   end
 
@@ -47,7 +47,8 @@ class ObjectInspector::Inspector
     formatter.call
   end
 
-  # Generate the inspect String for the wrapped object, if present.
+  # Generate the inspect String for the wrapped object, if `self` is a wrapper
+  # object.
   #
   # @return [String] if {#object_is_a_wrapper?}
   # @return [NilClass] if not {#object_is_a_wrapper?}
@@ -57,7 +58,7 @@ class ObjectInspector::Inspector
     self.class.inspect(
       extract_wrapped_object,
       scope: @scope,
-      formatter: @formatter_klass,
+      formatter: @formatter_class,
       kwargs: @kwargs)
   end
 
@@ -112,7 +113,7 @@ class ObjectInspector::Inspector
   private
 
   def formatter
-    @formatter_klass.new(self)
+    @formatter_class.new(self)
   end
 
   # @return [String] if `key` is found in {#kwargs} or if {#object} responds to

data/lib/object_inspector/inspectors_helper.rb

@@ -5,10 +5,20 @@
 # generating the inspection output.
 module ObjectInspector::InspectorsHelper
   # Calls {ObjectInspector::Inspector.inspect} on the passed in `object`,
-  # passing it the passed in `kwargs` (keyword arguments).
+  # passing through any keyword arguments.
   #
   # @return [String]
   def inspect(object = self, **)
     ObjectInspector::Inspector.inspect(object, **)
   end
+
+  # Like {#inspect} but forces scope to `:all`. This (the bang (!) version) is
+  # considered the "more dangerous" version of {#inspect} in the sense that the
+  # `:all` scope may result in additional queries or extra processing--depending
+  # on how the inspect hooks are setup.
+  #
+  # @return [String]
+  def inspect!(object = self, **)
+    ObjectInspector::Inspector.inspect(object, **, scope: :all)
+  end
 end

data/lib/object_inspector/version.rb

@@ -2,5 +2,5 @@
 
 module ObjectInspector
   # The current ObjectInspector gem version.
-  VERSION = "0.8.2"
+  VERSION = "0.10.0"
 end

data/lib/object_inspector.rb

@@ -51,7 +51,7 @@ module ObjectInspector
 
     def formatter_class=(value)
       unless value.is_a?(Class)
-        raise TypeError, "Formatter must be a Class constant"
+        raise(TypeError, "Formatter must be a Class constant")
       end
 
       @formatter_class = value

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: object_inspector
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.10.0
 platform: ruby
 authors:
 - Paul DobbinSchmaltz
 bindir: exe
 cert_chain: []
-date: 2025-01-04 00:00:00.000000000 Z
+date: 2025-04-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: benchmark-ips
@@ -110,7 +110,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.6
 specification_version: 4
 summary: Object Inspector builds uniformly formatted inspect output with customizable
   amounts of detail.