philiprehberger-enum 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3841094e2bc4093c7ee76058b058ffc2b99302c27b77c1c3e5b8724251a90f90
-  data.tar.gz: 769f7d79d66026f0f5aa6848e4845e36260d3fa5251085b453983410dc9ceadf
+  metadata.gz: 2b55ad3be49fe204aa1e0588dca8f25995f0589f49c3c0aa6c77e670e03fa7b0
+  data.tar.gz: dd879b2ed6f61c12c3805b6b6a86cc4aac4391e383251a3188a60925989685ab
 SHA512:
-  metadata.gz: fc946c8e5d96461a2774036a34c569351a7fdda7514bf6389e97d928e0b393fd2c21b1ff4b53adae561242886dc1a028d3a5d4c01b305d202e9ee4780d7ae62b
-  data.tar.gz: 78d1dda7a94396755c7ff710d572b1f96710f9007af4bc8b66e55920e4e5e55e1ef8edd651c185f117d473807d7ef25b7f451fb53c6560f9317fcbcc3cc93f96
+  metadata.gz: c29b4d8bb1a41e1a045363596d673febbaf7c6c984d99754ca1caafbbc7535ffdf92cbd3693464af201924f1d1cd2961b135f7c3fd97c4d66f5f34875f93e389
+  data.tar.gz: 50e33959a328aa0781d2a863df411e76b580ce6788a7b5bbf667078c74dfcb539eaa1b82c92612b2e34e7086dcb32e33de589a43edcc0b6107520c7c72e38e21

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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,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 |
+| `.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.4.0'
   end
 end

data/lib/philiprehberger/enum.rb

@@ -227,6 +227,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.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-09 00:00:00.000000000 Z
+date: 2026-04-17 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