philiprehberger-enum 0.1.5 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5765112f2fd16bde7ed19854cf3e60b11826676cc2f9745d55e538ee05b1d07f
-  data.tar.gz: '0915d0457694b6de70cf61ff2193c30f21a408278a46613926e3c22ab830b61c'
+  metadata.gz: 870e3019e2981514154a2d9e9ea3c21398fbd009fe99e9511ecebcfc5162e6ef
+  data.tar.gz: fd6725e19f0dc48131ec4ee3143cf97c5db29b63bf30dbea8ed0edbc26fa1d15
 SHA512:
-  metadata.gz: 1ae93ae4f8bbeae4dcf07e1dbf1685317bab80c288256cacbebf582baa8d6baa7f5ca4fd8d51c32240b9a60ea01a046176aeee374013516882cbbd76af42108b
-  data.tar.gz: 6ee8b1f10e6941d0d6c4d5ad56fe46f4d3b6d307842bd9bab85a352ddaa7a8fc29d38adf731cec8df4c69ba37c86958e5bccdbf2b493f4fed5303553fafddc47
+  metadata.gz: 4ac450c34e480d9036875c23c0e91f691d8b08695c7fab01f326ca5d5af53663d125786ffc05503bd37c4b98122cdb1d25e1c4305cf2d3507323df3692cd2b47
+  data.tar.gz: c63863fc33b8c4d25fd09c038ad25c9e782649077bae2bb4d9fca096453ab68d84f621c807f46af57fbba8225115a0c60e3a8fde7ccbcb6946ec9831c6d34ca9

data/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-04-03
+
+### Added
+- Include `Enumerable` at the class level with `each` yielding each member (`map`, `select`, `to_a`, etc.)
+- `Enum.to_h` returns `{ name_symbol => value }` hash of all members
+- `Enum.members_by_value` returns `{ value => member }` reverse lookup hash
+- `Enum.size` / `Enum.count` returns the number of defined members
+
+### Changed
+- `Enum.from_name` now falls back to case-insensitive matching when exact match fails
+
+## [0.1.6] - 2026-03-31
+
+### Added
+- Add GitHub issue templates, dependabot config, and PR template
+
 ## [0.1.5] - 2026-03-31
 
 ### Changed

data/README.md

@@ -62,6 +62,38 @@ Status.valid?(:draft)       # => true
 Status.valid?(:unknown)     # => false
 ```
 
+### Enumerable
+
+Enum classes include `Enumerable`, so you can iterate, map, select, etc.:
+
+```ruby
+Status.each { |member| puts member.name }
+Status.map(&:name)                # => [:draft, :published, :archived]
+Status.select { |m| m.ordinal > 0 } # => [PUBLISHED, ARCHIVED]
+Status.to_a                       # => [DRAFT, PUBLISHED, ARCHIVED]
+Status.min                        # => DRAFT
+```
+
+### Collection Methods
+
+```ruby
+Status.to_h              # => { draft: nil, published: nil, archived: nil }
+HttpCode.to_h            # => { ok: 200, not_found: 404, server_error: 500 }
+HttpCode.members_by_value # => { 200 => OK, 404 => NOT_FOUND, 500 => SERVER_ERROR }
+Status.size              # => 3
+Status.count             # => 3
+```
+
+### Case-Insensitive Lookup
+
+`from_name` tries an exact match first, then falls back to case-insensitive:
+
+```ruby
+Status.from_name(:draft)    # => Status::DRAFT (exact match)
+Status.from_name("DRAFT")   # => Status::DRAFT (case-insensitive)
+Status.from_name("Draft")   # => Status::DRAFT (case-insensitive)
+```
+
 ### Comparison
 
 Members are comparable by ordinal:
@@ -97,7 +129,11 @@ Status::DRAFT.to_json  # => '{"name":"draft","ordinal":0,"value":null}'
 |--------|-------------|
 | `.member(name, value: nil)` | Define a new enum member with optional custom value |
 | `.members` | Return all members in declaration order |
-| `.from_name(name)` | Look up a member by symbol or string name |
+| `.each` | Yield each member (includes `Enumerable`) |
+| `.to_h` | Return `{ name_symbol => value }` hash |
+| `.members_by_value` | Return `{ value => member }` reverse lookup hash |
+| `.size` / `.count` | Return the number of defined members |
+| `.from_name(name)` | Look up by name (case-insensitive fallback) |
 | `.from_string(string)` | Look up a member by string name |
 | `.from_value(val)` | Look up a member by custom value |
 | `.valid?(name)` | Check if a name is a valid member |

data/lib/philiprehberger/enum/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   class Enum
-    VERSION = '0.1.5'
+    VERSION = '0.2.0'
   end
 end

data/lib/philiprehberger/enum.rb

@@ -75,6 +75,17 @@ module Philiprehberger
     end
 
     class << self
+      include Enumerable
+
+      # Yield each member in declaration order
+      #
+      # @yield [Enum] each member
+      # @return [Enumerator] if no block given
+      def each(&)
+        freeze_members!
+        member_registry.values.each(&)
+      end
+
       # Define a new member on this enum class
       #
       # @param name [Symbol] the member name
@@ -104,13 +115,40 @@ module Philiprehberger
         member_registry.values.freeze
       end
 
-      # Look up a member by its name
+      # Return a hash of name symbols to values
+      #
+      # @return [Hash{Symbol => Object}] name => value pairs
+      def to_h
+        freeze_members!
+        member_registry.transform_values(&:value)
+      end
+
+      # Return a reverse lookup hash of values to members
+      #
+      # @return [Hash{Object => Enum}] value => member pairs
+      def members_by_value
+        freeze_members!
+        member_registry.each_value.to_h { |m| [m.value, m] }
+      end
+
+      # Return the number of defined members
+      #
+      # @return [Integer] the member count
+      def size
+        freeze_members!
+        member_registry.size
+      end
+
+      alias count size
+
+      # Look up a member by its name, with case-insensitive fallback
       #
       # @param name [Symbol, String] the member name
       # @return [Enum, nil] the member, or nil if not found
       def from_name(name)
         freeze_members!
-        member_registry[name.to_sym]
+        key = name.to_sym
+        member_registry[key] || member_registry.values.find { |m| m.name.to_s.downcase == key.to_s.downcase }
       end
 
       # Look up a member by its string representation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-enum
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.2.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-04 00:00:00.000000000 Z
 dependencies: []
 description: Define type-safe enums in Ruby with automatic ordinals, custom values,
   lookup methods, and Ruby 3.x pattern matching support. A cleaner alternative to
@@ -24,11 +24,11 @@ files:
 - README.md
 - lib/philiprehberger/enum.rb
 - lib/philiprehberger/enum/version.rb
-homepage: https://github.com/philiprehberger/rb-enum
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-enum
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-enum
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-enum
   source_code_uri: https://github.com/philiprehberger/rb-enum
   changelog_uri: https://github.com/philiprehberger/rb-enum/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/philiprehberger/rb-enum/issues