philiprehberger-enum 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 870e3019e2981514154a2d9e9ea3c21398fbd009fe99e9511ecebcfc5162e6ef
-  data.tar.gz: fd6725e19f0dc48131ec4ee3143cf97c5db29b63bf30dbea8ed0edbc26fa1d15
+  metadata.gz: 3841094e2bc4093c7ee76058b058ffc2b99302c27b77c1c3e5b8724251a90f90
+  data.tar.gz: 769f7d79d66026f0f5aa6848e4845e36260d3fa5251085b453983410dc9ceadf
 SHA512:
-  metadata.gz: 4ac450c34e480d9036875c23c0e91f691d8b08695c7fab01f326ca5d5af53663d125786ffc05503bd37c4b98122cdb1d25e1c4305cf2d3507323df3692cd2b47
-  data.tar.gz: c63863fc33b8c4d25fd09c038ad25c9e782649077bae2bb4d9fca096453ab68d84f621c807f46af57fbba8225115a0c60e3a8fde7ccbcb6946ec9831c6d34ca9
+  metadata.gz: fc946c8e5d96461a2774036a34c569351a7fdda7514bf6389e97d928e0b393fd2c21b1ff4b53adae561242886dc1a028d3a5d4c01b305d202e9ee4780d7ae62b
+  data.tar.gz: 78d1dda7a94396755c7ff710d572b1f96710f9007af4bc8b66e55920e4e5e55e1ef8edd651c185f117d473807d7ef25b7f451fb53c6560f9317fcbcc3cc93f96

data/CHANGELOG.md

@@ -7,6 +7,15 @@ 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

data/README.md

@@ -84,6 +84,26 @@ 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:
@@ -133,6 +153,11 @@ Status::DRAFT.to_json  # => '{"name":"draft","ordinal":0,"value":null}'
 | `.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 |

data/lib/philiprehberger/enum/version.rb

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

data/lib/philiprehberger/enum.rb

@@ -168,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.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-04 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