Object Identifier

Object Identifier allows quick, easy, and uniform identification of an object by inspecting its class name and outputting any desirable attributes/methods. It is great for logging, sending descriptive notification messages, etc.

For example:

some_object.identify(:id, :name)

Which is the same as:

"#{some_object.class.name}[id:#{some_object.id}, name:\"#{some_object.name}\"]"

Add this line to your application's Gemfile:

gem "object_identifier"

And then execute:

$ bundle

Or install it yourself as:

$ gem install object_identifier

Tested MRI Ruby Versions:

• 3.1
• 3.2
• 3.3

Note: For Ruby 2.7 or 3.1 support, install object_identifier gem version 0.7.0.

gem "object_identifier", "0.7.0"

Object Identifier has no other dependencies.

Global/default values for Object Identifier can be configured via the ObjectIdentifier::Configuration object.

Note: In a Rails app, the following would go in e.g. config/initializers/object_identifier.rb

# Default values are shown.
ObjectIdentifier.configure do |config|
  config.formatter_class = ObjectIdentifier::StringFormatter
  config.default_attributes = %i[id]
end

identify outputs the id of the receiving object by default, if it exists and no other attributes/methods are specified.

my_movie.identify                # => Movie[1]

identify doesn't output labels if only identifying a single attribute/method. It includes labels when two or more attributes/methods are being identified.

my_movie.identify(:id)           # => Movie[1]
my_movie.identify(:rating)       # => Movie["7/10"]
my_movie.identify(:id, :rating)  # => Movie[id:1, rating:"7/10"]

Private methods can be identified just the same as public methods.

my_movie.identify(:my_private_method)  # => Movie["Shh"]

If the object doesn't respond to a specified attribute/method it is simply ignored:

my_movie.identify(:id, :rating, :other)  # => Movie[id:1, rating:"7/10"]

my_delayed_job.identify(klass: "Delayed::Job")  # => Delayed::Job[1]
my_movie.identify(klass: nil)                   # => [1]

nil.identify(:id, :name)                 # => [no objects]
nil.identify(:id, :name, klass: "Nope")  # => [no objects]

Collections of objects are each identified in turn.

[my_movie, my_user].identify(:id, :name)
# => Movie[id:1, name:"Pi"], User[id:1, name:"Bob"]

The number of results that will be identified from a collection can be truncated by specifying the limit option.

[my_movie, my_user].identify(:id, :name, limit: 1)
# => Movie[id:1, name:"Pi"], ... (1 more)

[].identify  # => [no objects]
{}.identify  # => [no objects]

Object Identifier works great with the Object Inspector gem.

Performance of Formatters can be tested by playing the Formatters Benchmarking Scripts in the IRB console for this gem.

Custom Formatters may be similarly gauged for comparison by adding them to the custom_formatter_klasses array before playing (loading) the script.

custom_formatter_klasses = [MyCustomFormatter]

load "script/benchmarking/formatters.rb"
# ObjectIdentifier::StringFormatter
#     58.478k (± 0.8%) i/s -    295.776k in   5.058178s
# MyCustomFormatter
#                          ...

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. Or, run rake to run the tests plus linters as well as yard (to confirm proper YARD documentation practices). You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install.

To test this gem:

rake

rubocop

reek

npx prettier . --check
npx prettier . --write

To release a new version of this gem to RubyGems:

1. Update the version number in version.rb
2. Update CHANGELOG.md
3. Run bundle to update Gemfile.lock with the latest version info
4. Commit the changes. e.g. Bump to vX.Y.Z
5. Run rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

YARD documentation can be generated and viewed live:

1. Install YARD: gem install yard
2. Run the YARD server: yard server --reload
3. Open the live documentation site: open http://localhost:8808

While the YARD server is running, documentation in the live site will be auto-updated on source code save (and site reload).

Bug reports and pull requests are welcome on GitHub at https://github.com/pdobb/object_identifier.

The gem is available as open source under the terms of the MIT License.