philiprehberger-enum 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3841094e2bc4093c7ee76058b058ffc2b99302c27b77c1c3e5b8724251a90f90
-  data.tar.gz: 769f7d79d66026f0f5aa6848e4845e36260d3fa5251085b453983410dc9ceadf
+  metadata.gz: 7c70a844631a7b0fb70639905f38d7f4b5d645d46f48a5273c28b0ddf722e0fa
+  data.tar.gz: 5870b1e94fcf12b36ec5fd913188bf82aae252f9b3bdaa0e3a23af722dd942df
 SHA512:
-  metadata.gz: fc946c8e5d96461a2774036a34c569351a7fdda7514bf6389e97d928e0b393fd2c21b1ff4b53adae561242886dc1a028d3a5d4c01b305d202e9ee4780d7ae62b
-  data.tar.gz: 78d1dda7a94396755c7ff710d572b1f96710f9007af4bc8b66e55920e4e5e55e1ef8edd651c185f117d473807d7ef25b7f451fb53c6560f9317fcbcc3cc93f96
+  metadata.gz: 1a4d7013cd32642633f2ee97358885cdabe1d166956277f575bc1151656d338a3945a9244ca2d83a1bf128900dacdae78397dbefa53beef0939fd1eb719d6716
+  data.tar.gz: 532cee4c349ff698536b9f05b96ec132465c1d8aec1b8b60948a8e0f3485e38a07248bbe553215f065b0af0c41e25804eba53a070d841bbaffc98a53f32e426a

data/CHANGELOG.md

@@ -7,6 +7,18 @@ 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
+- `Enum.slice(*names)` returns an array of members matching the given symbol names, silently skipping unknown names
+- `Enum.sample(n = nil)` returns a random member when called without argument, or an array of n random members when called with an integer
+
 ## [0.3.0] - 2026-04-09
 
 ### Added

data/README.md

@@ -104,6 +104,25 @@ Status.first     # => Status::DRAFT
 Status.last      # => Status::ARCHIVED
 ```
 
+### Slice
+
+`slice` returns members matching the given names, silently skipping any that are unknown:
+
+```ruby
+Status.slice(:draft, :archived)          # => [Status::DRAFT, Status::ARCHIVED]
+Status.slice(:draft, :nonexistent)       # => [Status::DRAFT]
+Status.slice(:archived, :draft)          # => [Status::ARCHIVED, Status::DRAFT]
+```
+
+### Sample
+
+`sample` returns a random member. Pass an integer to get an array:
+
+```ruby
+Status.sample       # => Status::DRAFT  (random)
+Status.sample(2)    # => [Status::PUBLISHED, Status::ARCHIVED]  (random)
+```
+
 ### Case-Insensitive Lookup
 
 `from_name` tries an exact match first, then falls back to case-insensitive:
@@ -161,6 +180,10 @@ 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 |
 | `#name` | Return the member name as a symbol |
 | `#ordinal` | Return the ordinal position |

data/lib/philiprehberger/enum/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   class Enum
-    VERSION = '0.3.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
@@ -227,6 +245,24 @@ module Philiprehberger
         member_registry.key?(name.to_sym)
       end
 
+      # Return members matching the given symbol names, silently skipping unknown names
+      #
+      # @param names [Array<Symbol>] the member names to look up
+      # @return [Array<Enum>] array of matching members in the given order
+      def slice(*names)
+        freeze_members!
+        names.filter_map { |n| member_registry[n.to_sym] }
+      end
+
+      # Return a random member or array of random members
+      #
+      # @param n [Integer, nil] number of members to return; nil returns a single member
+      # @return [Enum, Array<Enum>] single member if n is nil, array of n members otherwise
+      def sample(n = nil)
+        freeze_members!
+        n.nil? ? member_registry.values.sample : member_registry.values.sample(n)
+      end
+
       private
 
       def inherited(subclass)

metadata

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