philiprehberger-enum 0.1.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 586314a47506dc97137ae26aaf56d8902ab333f64c073a8ec0d5e74ed721eb0d
-  data.tar.gz: cabf1a0a0e30e4188f976aaf3079dc7f8513f5b294c14b6428f98fedebf33a9d
+  metadata.gz: 870e3019e2981514154a2d9e9ea3c21398fbd009fe99e9511ecebcfc5162e6ef
+  data.tar.gz: fd6725e19f0dc48131ec4ee3143cf97c5db29b63bf30dbea8ed0edbc26fa1d15
 SHA512:
-  metadata.gz: 46a4b7ca7f78905924df64f682a45873e001a22886378ff150aa75d376b28792615dccd9d89ea5d663ee346eebf08d6ef1d6166e6d9a5e12f5df928bca52aa95
-  data.tar.gz: aa33d5acd8cfe41cdb3669cbf58b4bd9c87876f293f55eab4a81f7e71bebdd15e34226cf27a8ce229e6f7000b45932696a99d63fa29b5e394fb113788f33538f
+  metadata.gz: 4ac450c34e480d9036875c23c0e91f691d8b08695c7fab01f326ca5d5af53663d125786ffc05503bd37c4b98122cdb1d25e1c4305cf2d3507323df3692cd2b47
+  data.tar.gz: c63863fc33b8c4d25fd09c038ad25c9e782649077bae2bb4d9fca096453ab68d84f621c807f46af57fbba8225115a0c60e3a8fde7ccbcb6946ec9831c6d34ca9

data/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+- Standardize README badges, support section, and license format
+
 ## [0.1.4] - 2026-03-26
 
 ### Fixed

data/README.md

@@ -2,8 +2,7 @@
 
 [![Tests](https://github.com/philiprehberger/rb-enum/actions/workflows/ci.yml/badge.svg)](https://github.com/philiprehberger/rb-enum/actions/workflows/ci.yml)
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-enum.svg)](https://rubygems.org/gems/philiprehberger-enum)
-[![License](https://img.shields.io/github/license/philiprehberger/rb-enum)](LICENSE)
-[![Sponsor](https://img.shields.io/badge/sponsor-GitHub%20Sponsors-ec6cb9)](https://github.com/sponsors/philiprehberger)
+[![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-enum)](https://github.com/philiprehberger/rb-enum/commits/main)
 
 Type-safe enumerations with ordinals, custom values, and pattern matching
 
@@ -63,6 +62,38 @@ 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
+```
+
+### 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:
@@ -98,7 +129,11 @@ 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 |
+| `.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 |
@@ -118,6 +153,24 @@ bundle exec rspec
 bundle exec rubocop
 ```
 
+## Support
+
+If you find this project useful:
+
+⭐ [Star the repo](https://github.com/philiprehberger/rb-enum)
+
+🐛 [Report issues](https://github.com/philiprehberger/rb-enum/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
+
+💡 [Suggest features](https://github.com/philiprehberger/rb-enum/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
+
+❤️ [Sponsor development](https://github.com/sponsors/philiprehberger)
+
+🌐 [All Open Source Projects](https://philiprehberger.com/open-source-packages)
+
+💻 [GitHub Profile](https://github.com/philiprehberger)
+
+🔗 [LinkedIn Profile](https://www.linkedin.com/in/philiprehberger)
+
 ## License
 
 [MIT](LICENSE)

data/lib/philiprehberger/enum/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   class Enum
-    VERSION = '0.1.4'
+    VERSION = '0.2.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

metadata

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