philiprehberger-enum 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b55ad3be49fe204aa1e0588dca8f25995f0589f49c3c0aa6c77e670e03fa7b0
-  data.tar.gz: dd879b2ed6f61c12c3805b6b6a86cc4aac4391e383251a3188a60925989685ab
+  metadata.gz: 7c70a844631a7b0fb70639905f38d7f4b5d645d46f48a5273c28b0ddf722e0fa
+  data.tar.gz: 5870b1e94fcf12b36ec5fd913188bf82aae252f9b3bdaa0e3a23af722dd942df
 SHA512:
-  metadata.gz: c29b4d8bb1a41e1a045363596d673febbaf7c6c984d99754ca1caafbbc7535ffdf92cbd3693464af201924f1d1cd2961b135f7c3fd97c4d66f5f34875f93e389
-  data.tar.gz: 50e33959a328aa0781d2a863df411e76b580ce6788a7b5bbf667078c74dfcb539eaa1b82c92612b2e34e7086dcb32e33de589a43edcc0b6107520c7c72e38e21
+  metadata.gz: 1a4d7013cd32642633f2ee97358885cdabe1d166956277f575bc1151656d338a3945a9244ca2d83a1bf128900dacdae78397dbefa53beef0939fd1eb719d6716
+  data.tar.gz: 532cee4c349ff698536b9f05b96ec132465c1d8aec1b8b60948a8e0f3485e38a07248bbe553215f065b0af0c41e25804eba53a070d841bbaffc98a53f32e426a

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-04-22
+
+### Added
+- `Enum.from_ordinal(ord)` — look up a member by its ordinal position, returning nil if out of range.
+- `Enum.fetch_by_ordinal(ord)` — same lookup that raises `Error` if the ordinal is out of range.
+
 ## [0.4.0] - 2026-04-16
 
 ### Added

data/README.md

@@ -180,6 +180,8 @@ Status::DRAFT.to_json  # => '{"name":"draft","ordinal":0,"value":null}'
 | `.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 |
+| `.from_ordinal(ord)` | Look up a member by ordinal position (returns nil if out of range) |
+| `.fetch_by_ordinal(ord)` | Same as from_ordinal but raises Error if not found |
 | `.slice(*names)` | Return members matching the given symbol names, skipping unknowns |
 | `.sample(n = nil)` | Return a random member, or array of n random members |
 | `.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.4.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/enum.rb

@@ -186,6 +186,24 @@ module Philiprehberger
         from_value(val) || raise(Error, "no member with value #{val.inspect} on #{self}")
       end
 
+      # Look up a member by its ordinal position
+      #
+      # @param ord [Integer] the ordinal position (0-indexed)
+      # @return [Enum, nil] the member, or nil if the ordinal is out of range
+      def from_ordinal(ord)
+        freeze_members!
+        member_registry.values[ord] if ord.is_a?(Integer) && ord >= 0
+      end
+
+      # Look up a member by ordinal, raising if not found
+      #
+      # @param ord [Integer] the ordinal position
+      # @return [Enum] the member
+      # @raise [Error] if the ordinal is not a valid member
+      def fetch_by_ordinal(ord)
+        from_ordinal(ord) || raise(Error, "no member at ordinal #{ord.inspect} on #{self}")
+      end
+
       # Return all member names in declaration order
       #
       # @return [Array<Symbol>] frozen array of member names

metadata

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