philiprehberger-enum 0.1.5 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5765112f2fd16bde7ed19854cf3e60b11826676cc2f9745d55e538ee05b1d07f
-  data.tar.gz: '0915d0457694b6de70cf61ff2193c30f21a408278a46613926e3c22ab830b61c'
+  metadata.gz: 3841094e2bc4093c7ee76058b058ffc2b99302c27b77c1c3e5b8724251a90f90
+  data.tar.gz: 769f7d79d66026f0f5aa6848e4845e36260d3fa5251085b453983410dc9ceadf
 SHA512:
-  metadata.gz: 1ae93ae4f8bbeae4dcf07e1dbf1685317bab80c288256cacbebf582baa8d6baa7f5ca4fd8d51c32240b9a60ea01a046176aeee374013516882cbbd76af42108b
-  data.tar.gz: 6ee8b1f10e6941d0d6c4d5ad56fe46f4d3b6d307842bd9bab85a352ddaa7a8fc29d38adf731cec8df4c69ba37c86958e5bccdbf2b493f4fed5303553fafddc47
+  metadata.gz: fc946c8e5d96461a2774036a34c569351a7fdda7514bf6389e97d928e0b393fd2c21b1ff4b53adae561242886dc1a028d3a5d4c01b305d202e9ee4780d7ae62b
+  data.tar.gz: 78d1dda7a94396755c7ff710d572b1f96710f9007af4bc8b66e55920e4e5e55e1ef8edd651c185f117d473807d7ef25b7f451fb53c6560f9317fcbcc3cc93f96

data/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-09
+
+### Added
+- `Enum.fetch(name)` strict lookup that raises `Error` if the name is not a member (case-insensitive fallback)
+- `Enum.fetch_by_value(val)` strict value lookup that raises `Error` if no member has the given value
+- `Enum.names` returns a frozen array of all member name symbols in declaration order
+- `Enum.values` returns a frozen array of all member values in declaration order
+- `Enum.first` / `Enum.last` return the first and last declared members
+
+## [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,58 @@ 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
+```
+
+### Strict Lookup
+
+`fetch` and `fetch_by_value` raise an error instead of returning `nil`:
+
+```ruby
+Status.fetch(:draft)          # => Status::DRAFT
+Status.fetch(:unknown)        # raises Philiprehberger::Enum::Error
+HttpCode.fetch_by_value(200)  # => HttpCode::OK
+HttpCode.fetch_by_value(999)  # raises Philiprehberger::Enum::Error
+```
+
+### Names, Values, First & Last
+
+```ruby
+HttpCode.names   # => [:ok, :not_found, :server_error]
+HttpCode.values  # => [200, 404, 500]
+Status.first     # => Status::DRAFT
+Status.last      # => Status::ARCHIVED
+```
+
+### 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 +149,16 @@ 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 |
+| `.names` | Return a frozen array of member name symbols |
+| `.values` | Return a frozen array of member values |
+| `.first` / `.last` | Return the first or last declared member |
+| `.fetch(name)` | Strict lookup by name; raises `Error` if not found |
+| `.fetch_by_value(val)` | Strict lookup by value; raises `Error` if not found |
+| `.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.3.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
@@ -130,6 +168,56 @@ module Philiprehberger
         member_registry.values.find { |m| m.value == val }
       end
 
+      # Look up a member by name, raising if not found
+      #
+      # @param name [Symbol, String] the member name
+      # @return [Enum] the member
+      # @raise [Error] if the name is not a valid member
+      def fetch(name)
+        from_name(name) || raise(Error, "no member #{name.inspect} on #{self}")
+      end
+
+      # Look up a member by value, raising if not found
+      #
+      # @param val [Object] the value to search for
+      # @return [Enum] the member
+      # @raise [Error] if the value is not found
+      def fetch_by_value(val)
+        from_value(val) || raise(Error, "no member with value #{val.inspect} on #{self}")
+      end
+
+      # Return all member names in declaration order
+      #
+      # @return [Array<Symbol>] frozen array of member names
+      def names
+        freeze_members!
+        member_registry.keys.freeze
+      end
+
+      # Return all member values in declaration order
+      #
+      # @return [Array<Object>] frozen array of member values
+      def values
+        freeze_members!
+        member_registry.values.map(&:value).freeze
+      end
+
+      # Return the first declared member
+      #
+      # @return [Enum, nil] the first member, or nil if empty
+      def first
+        freeze_members!
+        member_registry.values.first
+      end
+
+      # Return the last declared member
+      #
+      # @return [Enum, nil] the last member, or nil if empty
+      def last
+        freeze_members!
+        member_registry.values.last
+      end
+
       # Check if a name is a valid member
       #
       # @param name [Symbol, String] the member name

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-enum
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-09 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