ruby-enum 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aca947b7b06abbc0504549ab9fa43e99be4d3e0dc408a92b8e10efea700d9bf7
-  data.tar.gz: 7e57ab06229ac0552b984630493f04dd98a3579b7ca8151c819dc792417d505f
+  metadata.gz: 0424fcb26d8fc260165a669fa7be1d83e41a3a8e967ad606c5eb72abb656b349
+  data.tar.gz: 2ea8e9dc094a9612447679c7d5bebf88ac466b1c1b9a5f666d3ce5a8d0981965
 SHA512:
-  metadata.gz: f626bd0c2c072f17734527253a8ae95e96dc0631779f6d56b398c540a9d63c3b41eb000647d276d81f859ae92f11e5a0a74e9966cf96f1796cad5ef172c42239
-  data.tar.gz: 2d58616dc04acf94a9a7e65029fe6422224717bb849cd07513782206ecc543b4d478a7d539b5fa1d434ab3b841430772406cd112438152541242d32a3081e38e
+  metadata.gz: 024aac1db4f01d3528a1130817e3db22e7e413d598e99d5dc333a040057896129420193731cec1706922a5c462322809e4e6ce5de2d871f1d2492e67990b56ab
+  data.tar.gz: c8a5b49346df275afd18502410a9e24a5806fdfdb0d31d2a7a53783edf8b592b3fe27789ca19d26f32d3937142f40c561b2a9d87ef5cff66e9aa7d05c3054cf6

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+### 1.2.0 (2026/8/14)
+
+* [#49](https://github.com/dblock/ruby-enum/issues/49): Fixed `NoMethodError` on `keys`, `values`, `key?`, `value?`, `key`, `value`, `to_h`, `parse` and `each` when a subclass defines no enums of its own - [@dblock](https://github.com/dblock).
+* [#49](https://github.com/dblock/ruby-enum/issues/49): `keys`, `key?`, `value?`, `key`, `value`, `to_h`, `parse` and `each` now include enums defined in a superclass, matching the existing behavior of `values` - [@dblock](https://github.com/dblock).
+* [#61](https://github.com/dblock/ruby-enum/pull/61): Document performance overhead in README, add `rake benchmark:basic` - [@dblock](https://github.com/dblock).
+
+### 1.1.0 (2026/6/20)
+
+* [#56](https://github.com/dblock/ruby-enum/pull/56): Fix `DuplicateKeyError` when the enum class is reloaded - [@flvrone](https://github.com/flvrone).
+* [#54](https://github.com/dblock/ruby-enum/pull/54): Add support for Ruby 4.0 - [@dblock](https://github.com/dblock).
+* [#53](https://github.com/dblock/ruby-enum/pull/53): Replace code climate with coveralls - [@dblock](https://github.com/dblock).
+
 ### 1.0.0 (2023/01/10)
 
 * [#41](https://github.com/dblock/ruby-enum/pull/41): Make i18n dependency optional - [@peterfication](https://github.com/peterfication).

data/Dangerfile

@@ -1,4 +1,6 @@
 # frozen_string_literal: true
 
+danger.import_dangerfile(gem: 'danger-pr-comment')
+
 changelog.check!
 toc.check!

data/Gemfile

@@ -8,14 +8,15 @@ gem 'rake'
 
 group :development, :test do
   gem 'danger'
-  gem 'danger-changelog', '0.6.1'
-  gem 'danger-toc', '0.2.0'
-  gem 'rspec', '~> 3.0'
-  gem 'rubocop', '~> 1.0'
+  gem 'danger-changelog'
+  gem 'danger-pr-comment'
+  gem 'danger-toc'
+  gem 'rspec'
+  gem 'rubocop', '1.82.1'
   gem 'rubocop-rake'
   gem 'rubocop-rspec'
 end
 
 group :test do
-  gem 'simplecov', require: false
+  gem 'coveralls_reborn', require: false
 end

data/Gemfile.lock

@@ -1,166 +1,201 @@
 PATH
   remote: .
   specs:
-    ruby-enum (1.0.0)
+    ruby-enum (1.2.0)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    activesupport (7.1.2)
+    activesupport (8.1.1)
       base64
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
-    addressable (2.8.6)
-      public_suffix (>= 2.0.2, < 6.0)
-    ast (2.4.2)
-    base64 (0.2.0)
-    bigdecimal (3.1.5)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bigdecimal (4.0.1)
     claide (1.1.0)
     claide-plugins (0.9.2)
       cork
       nap
       open4 (~> 1.3)
-    colored2 (3.1.2)
-    concurrent-ruby (1.2.2)
-    connection_pool (2.4.1)
-    cork (0.3.0)
-      colored2 (~> 3.1)
-    danger (9.4.2)
+    colored (1.2)
+    colored2 (4.0.3)
+    concurrent-ruby (1.3.6)
+    connection_pool (3.0.2)
+    cork (0.2.0)
+      colored (~> 1.2)
+    coveralls_reborn (0.29.0)
+      simplecov (~> 0.22.0)
+      term-ansicolor (~> 1.7)
+      thor (~> 1.2)
+      tins (~> 1.32)
+    danger (9.5.3)
+      base64 (~> 0.2)
       claide (~> 1.0)
       claide-plugins (>= 0.9.2)
-      colored2 (~> 3.1)
+      colored2 (>= 3.1, < 5)
       cork (~> 0.1)
       faraday (>= 0.9.0, < 3.0)
       faraday-http-cache (~> 2.0)
-      git (~> 1.13)
-      kramdown (~> 2.3)
+      git (>= 1.13, < 3.0)
+      kramdown (>= 2.5.1, < 3.0)
       kramdown-parser-gfm (~> 1.0)
-      no_proxy_fix
       octokit (>= 4.0)
-      terminal-table (>= 1, < 4)
-    danger-changelog (0.6.1)
+      pstore (~> 0.1)
+      terminal-table (>= 1, < 5)
+    danger-changelog (0.8.0)
       danger-plugin-api (~> 1.0)
     danger-plugin-api (1.0.0)
       danger (> 2.0)
+    danger-pr-comment (0.1.0)
+      danger (~> 9)
     danger-toc (0.2.0)
       activesupport
       danger-plugin-api (~> 1.0)
       kramdown
-    diff-lcs (1.5.0)
-    docile (1.4.0)
-    drb (2.2.0)
-      ruby2_keywords
-    faraday (2.8.1)
-      base64
-      faraday-net_http (>= 2.0, < 3.1)
-      ruby2_keywords (>= 0.0.4)
-    faraday-http-cache (2.5.0)
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    drb (2.2.3)
+    faraday (2.14.0)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-http-cache (2.5.1)
       faraday (>= 0.8)
-    faraday-net_http (3.0.2)
-    git (1.19.0)
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    git (2.3.3)
+      activesupport (>= 5.0)
       addressable (~> 2.8)
+      process_executer (~> 1.1)
       rchardet (~> 1.8)
-    i18n (1.14.1)
+    i18n (1.14.8)
       concurrent-ruby (~> 1.0)
-    json (2.7.1)
-    kramdown (2.4.0)
-      rexml
+    io-console (0.8.2)
+    json (2.18.0)
+    kramdown (2.5.1)
+      rexml (>= 3.3.9)
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
-    language_server-protocol (3.17.0.3)
-    minitest (5.20.0)
-    mutex_m (0.2.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    minitest (6.0.1)
+      prism (~> 1.5)
+    mize (0.6.1)
     nap (1.1.0)
-    no_proxy_fix (0.1.2)
-    octokit (8.0.0)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    octokit (10.0.0)
       faraday (>= 1, < 3)
       sawyer (~> 0.9)
     open4 (1.3.4)
-    parallel (1.24.0)
-    parser (3.2.2.4)
+    parallel (1.27.0)
+    parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
-    public_suffix (5.0.4)
-    racc (1.7.3)
+    prism (1.7.0)
+    process_executer (1.3.0)
+    pstore (0.2.0)
+    public_suffix (7.0.0)
+    racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.1.0)
-    rchardet (1.8.0)
-    regexp_parser (2.8.3)
-    rexml (3.2.6)
-    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-expectations (3.12.3)
+    rake (13.3.1)
+    rchardet (1.10.0)
+    readline (0.0.4)
+      reline
+    regexp_parser (2.11.3)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.6)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-support (3.12.1)
-    rubocop (1.59.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    rubocop (1.82.1)
       json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
       parallel (~> 1.10)
-      parser (>= 3.2.2.4)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.30.0, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.30.0)
-      parser (>= 3.2.1.0)
-    rubocop-capybara (2.20.0)
-      rubocop (~> 1.41)
-    rubocop-factory_bot (2.25.0)
-      rubocop (~> 1.33)
-    rubocop-rake (0.6.0)
-      rubocop (~> 1.0)
-    rubocop-rspec (2.26.0)
-      rubocop (~> 1.40)
-      rubocop-capybara (~> 2.17)
-      rubocop-factory_bot (~> 2.22)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-rspec (3.8.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.81)
     ruby-progressbar (1.13.0)
-    ruby2_keywords (0.0.5)
-    sawyer (0.9.2)
+    sawyer (0.9.3)
       addressable (>= 2.3.5)
       faraday (>= 0.17.3, < 3)
+    securerandom (0.4.1)
     simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.12.3)
+    simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    terminal-table (3.0.2)
-      unicode-display_width (>= 1.1.1, < 3)
+    sync (0.5.0)
+    term-ansicolor (1.11.3)
+      tins (~> 1)
+    terminal-table (4.0.0)
+      unicode-display_width (>= 1.1.1, < 4)
+    thor (1.4.0)
+    tins (1.51.0)
+      bigdecimal
+      mize (~> 0.6)
+      readline
+      sync
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.5.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
 
 PLATFORMS
-  arm64-darwin-21
   ruby
 
 DEPENDENCIES
+  coveralls_reborn
   danger
-  danger-changelog (= 0.6.1)
-  danger-toc (= 0.2.0)
+  danger-changelog
+  danger-pr-comment
+  danger-toc
   rake
-  rspec (~> 3.0)
-  rubocop (~> 1.0)
+  rspec
+  rubocop (= 1.82.1)
   rubocop-rake
   rubocop-rspec
   ruby-enum!
-  simplecov
 
 BUNDLED WITH
-   2.5.1
+   2.1.4

data/README.md

@@ -2,8 +2,8 @@ Ruby::Enum
 ==========
 
 [![Gem Version](http://img.shields.io/gem/v/ruby-enum.svg)](http://badge.fury.io/rb/ruby-enum)
-[![Build Status](https://github.com/dblock/ruby-enum/workflows/test/badge.svg?branch=master)](https://github.com/dblock/ruby-enum/actions)
-[![Code Climate](https://codeclimate.com/github/dblock/ruby-enum.svg)](https://codeclimate.com/github/dblock/ruby-enum)
+[![Test](https://github.com/dblock/ruby-enum/actions/workflows/test.yml/badge.svg)](https://github.com/dblock/ruby-enum/actions/workflows/test.yml)
+[![Coverage Status](https://coveralls.io/repos/github/dblock/ruby-enum/badge.svg?branch=master)](https://coveralls.io/github/dblock/ruby-enum?branch=master)
 
 Enum-like behavior for Ruby, heavily inspired by [this](http://www.rubyfleebie.com/enumerations-and-ruby), and improved upon [another blog post](http://code.dblock.org/how-to-define-enums-in-ruby).
 
@@ -27,6 +27,7 @@ Enum-like behavior for Ruby, heavily inspired by [this](http://www.rubyfleebie.c
   - [Exhaustive case matcher](#exhaustive-case-matcher)
   - [I18n support](#i18n-support)
 - [Benchmarks](#benchmarks)
+  - [Performance](#performance)
 - [Contributing](#contributing)
 - [Copyright and License](#copyright-and-license)
 - [Related Projects](#related-projects)
@@ -232,7 +233,7 @@ The `DuplicateValueError` exception is raised to be consistent with the unique k
 
 ### Inheritance
 
-When inheriting from a `Ruby::Enum` class, all defined enums in the parent class will be accessible in sub classes as well. Sub classes can also provide extra enums, as usual.
+When inheriting from a `Ruby::Enum` class, all defined enums in the parent class will be accessible in subclasses as well. Subclasses can also provide extra enums, as usual.
 
 ``` ruby
 class OrderState
@@ -262,6 +263,26 @@ OrderState.values # ['CREATED', 'PAID']
 ShippedOrderState.values # ['CREATED', 'PAID', 'PREPARED', SHIPPED']
 ```
 
+All other enumerating and hashing methods (`keys`, `key?`, `value?`, `key`, `value`, `to_h`, `parse` and `each`) also consider enums defined anywhere in the class hierarchy.
+
+``` ruby
+ShippedOrderState.keys # [:CREATED, :PAID, :PREPARED, :SHIPPED]
+ShippedOrderState.key?(:CREATED) # true
+ShippedOrderState.value(:CREATED) # 'CREATED'
+```
+
+A subclass may redefine a key or value already used by a parent class without raising `DuplicateKeyError` or `DuplicateValueError`; its own definition takes precedence.
+
+``` ruby
+class ShippedOrderState < OrderState
+  define :CREATED, 'RECREATED' # does not raise, overrides the parent class' definition
+end
+
+ShippedOrderState::CREATED # 'RECREATED'
+ShippedOrderState.value(:CREATED) # 'RECREATED'
+OrderState.value(:CREATED) # 'CREATED', unaffected
+```
+
 ### Exhaustive case matcher
 
 If you want to make sure that you cover all cases in a case stament, you can use the exhaustive case matcher: `Ruby::Enum::Case`. It will raise an error if a case/enum value is not handled, or if a value is specified that's not part of the enum. This is inspired by the [Rust Pattern Syntax](https://doc.rust-lang.org/book/ch18-03-pattern-syntax.html). If multiple cases match, all matches are being executed. The return value is the value from the matched case, or an array of return values if multiple cases matched.
@@ -315,9 +336,21 @@ gem "i18n"
 Benchmark scripts are defined in the [`benchmarks`](benchmarks) folder and can be run with Rake:
 
 ```console
-rake benchmarks:case
+rake benchmark:basic
+rake benchmark:case
+rake benchmark:inheritance
 ```
 
+### Performance
+
+Constant access (e.g. `Colors::RED`) has no measurable overhead versus a plain Ruby constant, since it's just a constant lookup either way. Basic operations backed by a hash lookup - `value`, `key`, `key?`, `value?`, `keys`, `values` - carry some overhead (roughly 3-5x) compared to using a plain `Hash` directly, due to the extra method dispatch and object wrapping `Ruby::Enum` does internally. Run `rake benchmark:basic` to measure this on your own machine.
+
+This overhead is constant regardless of how deep a subclass hierarchy is - `keys`, `key?`, `value?`, `key`, `value`, `to_h`, `parse` and `each` merge and memoize enums inherited from superclasses, so a subclass' lookups are effectively as fast as the base class' (see `rake benchmark:inheritance`).
+
+The one notable exception is `Ruby::Enum::Case`, whose exhaustive `case`-like matcher is significantly slower (on the order of 50-100x, see `rake benchmark:case`) than a native Ruby `case`/`when` statement, since it builds and evaluates lambdas on every call rather than being optimized by the Ruby VM. Prefer a native `case` statement in hot code paths and reserve `Ruby::Enum::Case` for cases where its exhaustiveness check is worth the overhead.
+
+For most applications this overhead is negligible in absolute terms (low single-digit microseconds per call), but it's worth being aware of in very hot code paths.
+
 ## Contributing
 
 You're encouraged to contribute to ruby-enum. See [CONTRIBUTING](CONTRIBUTING.md) for details.

data/RELEASING.md

@@ -11,7 +11,7 @@ bundle install
 rake
 ```
 
-Check that the last build succeeded in [Travis CI](https://travis-ci.org/dblock/ruby-enum) for all supported platforms.
+Check that the last build succeeded in [GitHub Actions](https://github.com/dblock/ruby-enum/actions) for all supported platforms.
 
 Add a date to this release in [CHANGELOG.md](CHANGELOG.md).
 
@@ -28,15 +28,24 @@ git add README.md CHANGELOG.md lib/ruby-enum/version.rb
 git commit -m "Preparing for release, 0.2.2."
 ```
 
-Release.
+Release. If you have MFA enabled on RubyGems (you should), `rake release` will build the gem, tag it, and push commits/tags to GitHub, but fail at the RubyGems push. Push the gem manually with your OTP.
 
 ```
 $ rake release
 
-ruby-enum 0.2.2 built to pkg/ruby-enum-0.2.2.gem.
-Tagged v0.2.2.
+ruby-enum 1.1.0 built to pkg/ruby-enum-1.1.0.gem.
+Tagged v1.1.0.
 Pushed git commits and tags.
-Pushed ruby-enum 0.2.2 to rubygems.org.
+...
+You have enabled multi-factor authentication. Please enter OTP code.
+```
+
+Then push to RubyGems manually:
+
+```
+$ gem push pkg/ruby-enum-1.1.0.gem --otp <OTP>
+Pushing gem to https://rubygems.org...
+Successfully registered gem: ruby-enum (1.1.0)
 ```
 
 ### Prepare for the Next Version

data/Rakefile

@@ -18,8 +18,18 @@ RuboCop::RakeTask.new(:rubocop)
 task default: %i[rubocop spec]
 
 namespace :benchmark do
+  desc 'Run benchmark for basic Ruby::Enum operations vs. plain Ruby equivalents'
+  task :basic do
+    require_relative 'benchmarks/basic'
+  end
+
   desc 'Run benchmark for the Ruby::Enum::Case'
   task :case do
     require_relative 'benchmarks/case'
   end
+
+  desc 'Run benchmark for enum lookups on classes with inheritance'
+  task :inheritance do
+    require_relative 'benchmarks/inheritance'
+  end
 end

data/UPGRADING.md

@@ -1,5 +1,44 @@
 # Upgrading Ruby::Enum
 
+## Upgrading to >= 1.2.0
+
+### Inheritance & `keys`, `key?`, `value?`, `key`, `value`, `to_h`, `parse` and `each`
+
+This only applies to classes that inherit from another which is a `Ruby::Enum`.
+
+Prior to version `1.2.0`, only `values` enumerated enums defined in the entire class hierarchy; `keys`, `key?`, `value?`, `key`, `value`, `to_h`, `parse` and `each` only considered enums defined directly on the class, silently ignoring anything defined in a superclass.
+
+As of version `1.2.0`, these methods behave consistently with `values` and also enumerate/consider enums defined anywhere in the class hierarchy, ancestors first. A subclass may still redefine a key or value already used by a superclass; its own definition takes precedence.
+
+``` ruby
+class PrimaryColors
+  include Ruby::Enum
+
+  define :RED, 'RED'
+  define :GREEN, 'GREEN'
+end
+
+class RainbowColors < PrimaryColors
+  define :ORANGE, 'ORANGE'
+end
+```
+
+`gem 'ruby-enum', '< 1.2.0'`
+
+``` ruby
+RainbowColors.keys       # => [:ORANGE]
+RainbowColors.key?(:RED) # => false
+```
+
+`gem 'ruby-enum', '>= 1.2.0'`
+
+``` ruby
+RainbowColors.keys       # => [:RED, :GREEN, :ORANGE]
+RainbowColors.key?(:RED) # => true
+```
+
+See [#49](https://github.com/dblock/ruby-enum/issues/49) for more information.
+
 ## Upgrading to >= 0.9.0
 
 ### Inheritance & `Ruby::Enum.values`

data/benchmarks/basic.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'benchmark'
+require 'ruby-enum'
+
+##
+# Ruby::Enum equivalent of a plain Hash/constant lookup.
+class Colors
+  include Ruby::Enum
+
+  define :RED, 'red'
+  define :GREEN, 'green'
+  define :BLUE, 'blue'
+end
+
+# Plain Ruby equivalents, doing the same lookups without Ruby::Enum.
+PLAIN_HASH = { RED: 'red', GREEN: 'green', BLUE: 'blue' }.freeze
+
+module PlainConstants
+  RED = 'red'
+  GREEN = 'green'
+  BLUE = 'blue'
+end
+
+n = 1_000_000
+
+def benchmark(label, iterations, &block)
+  time = Benchmark.realtime { iterations.times(&block) }
+  puts "#{label}: #{time.round(4)}"
+  time
+end
+
+puts "Running #{n} iterations of each scenario below\n\n"
+
+puts '--- Constant access ---'
+enum_const_time = benchmark('Ruby::Enum constant (Colors::RED)', n) { Colors::RED }
+plain_const_time = benchmark('plain Ruby constant (PlainConstants::RED)', n) { PlainConstants::RED }
+
+puts "\n--- Key to value lookup ---"
+enum_value_time = benchmark('Ruby::Enum (Colors.value(:RED))', n) { Colors.value(:RED) }
+hash_value_time = benchmark('plain Hash (PLAIN_HASH[:RED])', n) { PLAIN_HASH[:RED] }
+
+puts "\n--- Value to key lookup ---"
+benchmark('Ruby::Enum (Colors.key(\'red\'))', n) { Colors.key('red') }
+benchmark('plain Hash (PLAIN_HASH.key(\'red\'))', n) { PLAIN_HASH.key('red') }
+
+puts "\n--- Existence checks ---"
+benchmark('Ruby::Enum (Colors.key?(:RED))', n) { Colors.key?(:RED) }
+benchmark('plain Hash (PLAIN_HASH.key?(:RED))', n) { PLAIN_HASH.key?(:RED) }
+
+puts "\n--- Enumerating all keys/values ---"
+benchmark('Ruby::Enum (Colors.keys)', n) { Colors.keys }
+benchmark('plain Hash (PLAIN_HASH.keys)', n) { PLAIN_HASH.keys }
+benchmark('Ruby::Enum (Colors.values)', n) { Colors.values }
+benchmark('plain Hash (PLAIN_HASH.values)', n) { PLAIN_HASH.values }
+
+puts "\n--- Comparison ---"
+puts "Ruby::Enum constant access is #{(enum_const_time / plain_const_time).round(2)}x plain Ruby constant access"
+puts "Ruby::Enum .value is #{(enum_value_time / hash_value_time).round(2)}x plain Hash#[]"

data/benchmarks/inheritance.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'benchmark'
+require 'ruby-enum'
+
+##
+# Base enum, no inheritance.
+class Colors
+  include Ruby::Enum
+
+  define :RED, 'red'
+  define :GREEN, 'green'
+end
+
+##
+# Subclass, adds its own enum on top of an inherited one (1 level).
+class SubColors < Colors
+  define :BLUE, 'blue'
+end
+
+##
+# Sub-subclass, adds its own enum on top of 2 inherited levels.
+class SubSubColors < SubColors
+  define :YELLOW, 'yellow'
+end
+
+n = 1_000_000
+
+def benchmark(label, iterations, &block)
+  time = Benchmark.realtime { iterations.times(&block) }
+  puts "#{label}: #{time.round(4)}"
+  time
+end
+
+puts "Running #{n} iterations of each scenario below\n\n"
+
+puts '--- .value lookups, by depth of inheritance ---'
+base_value = benchmark('base class (no inheritance)', n) { Colors.value(:RED) }
+sub_value = benchmark('subclass (1 level)', n) { SubColors.value(:RED) }
+sub_sub_value = benchmark('sub-subclass (2 levels)', n) { SubSubColors.value(:RED) }
+
+puts "\n--- Other methods on a subclass (1 level) ---"
+benchmark('.keys', n) { SubColors.keys }
+benchmark('.key?', n) { SubColors.key?(:RED) }
+benchmark('.to_h', n) { SubColors.to_h }
+count = 0
+benchmark('.each', n) { SubColors.each { |_k, _v| count += 1 } }
+
+puts "\n--- Comparison ---"
+puts "subclass value is #{(sub_value / base_value).round(2)}x base class value"
+puts "sub-subclass value is #{(sub_sub_value / base_value).round(2)}x base class value"