philiprehberger-pluralize 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b6fc3d3282e7320753b6958d77d12d032363f99ffb107d059360ecc7770f762
-  data.tar.gz: b319efef8cc4c6a2e5613047f4b11d108494838c1bd0be1d94cdef80b9b2399b
+  metadata.gz: 8ccd680cfc70bb7869e3485f9aa6d7b30f939a0f00242c64e995aea632c1c121
+  data.tar.gz: dd1445d596873472b69da3622dcac5e6386b4e5dc33f96be67d89033e46ba9c4
 SHA512:
-  metadata.gz: 57c53612201fda89b18fb6c4849ede7903f9343dbc541d15a0c8e1c699b7acd0439e9c69545e87ce86503bf2fd956fe948c305a1e8970a20fd9f9e1346bdfdb2
-  data.tar.gz: 9ca00bb43571356ec9fef5a5ad0cccc54fa0bc9bb5dc12149d6b59ef74747a330a36446d02920e0c05155856716c64a1c0eeaec2fe613728854ef930a2353cda
+  metadata.gz: 1d3cce73efa4291d0a59c8f905fd36c6e0daa765cc33cb54a03d80e460ec37ea9d86dbf0c0455c746979f58b53f7ad1791468d0014fb575eae22aa04f781a7d2
+  data.tar.gz: 708d560d47bd7a43d520334bed8229ccd3ec2a90fb11f06129915357115845580fb3a949fb8d8e011784e66f23955fe67c14357c3504a60d2f6025fe547f22f7

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-29
+
+### Added
+- `Pluralize.indefinite_article(word, capitalize: false)` returning "a"/"an" with handling for silent-h words ("hour", "honest") and consonant-y-vowel words ("university", "unicorn")
+
 ## [0.3.0] - 2026-04-15
 
 ### Added
@@ -70,7 +75,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Custom uncountable word registration
 - String inflections: camel_case, snake_case, titleize, humanize
 
-[Unreleased]: https://github.com/philiprehberger/rb-pluralize/compare/v0.3.0...HEAD
+[Unreleased]: https://github.com/philiprehberger/rb-pluralize/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/philiprehberger/rb-pluralize/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/philiprehberger/rb-pluralize/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/philiprehberger/rb-pluralize/compare/v0.1.6...v0.2.0
 [0.1.6]: https://github.com/philiprehberger/rb-pluralize/compare/v0.1.5...v0.1.6

data/README.md

@@ -99,6 +99,15 @@ Philiprehberger::Pluralize.uncountable?('equipment')  # => true
 Philiprehberger::Pluralize.uncountable?('cat')        # => false
 ```
 
+### Indefinite Article
+
+```ruby
+Philiprehberger::Pluralize.indefinite_article('apple')      # => "an"
+Philiprehberger::Pluralize.indefinite_article('university') # => "a"
+Philiprehberger::Pluralize.indefinite_article('hour')       # => "an"
+Philiprehberger::Pluralize.indefinite_article('Apple', capitalize: true) # => "An"
+```
+
 ### Custom Irregular Words
 
 ```ruby
@@ -137,6 +146,7 @@ Philiprehberger::Pluralize.humanize('user_id')         # => "User"
 | `Pluralize.count(n, word, style:)` | Format a count with singular/plural word (`:numeric` or `:words` style) |
 | `Pluralize.pluralize(n, singular, plural = nil)` | Rails-style: format a count with a required singular and optional explicit plural |
 | `Pluralize.capitalize_and_pluralize(word)` | Capitalize a word and return its plural form |
+| `.indefinite_article(word, capitalize: false)` | Return "a" or "an" for `word`, with silent-h and consonant-y-vowel handling |
 | `Pluralize.uncountable?(word)` | Return true if the word is uncountable (built-in or custom) |
 | `Pluralize.irregular(singular, plural)` | Register a custom irregular singular/plural pair |
 | `Pluralize.uncountable(word)` | Register a word as uncountable |

data/lib/philiprehberger/pluralize/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module Pluralize
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

data/lib/philiprehberger/pluralize.rb

@@ -224,8 +224,37 @@ module Philiprehberger
         @custom_uncountables = Set.new
       end
 
+      # Return the indefinite article ("a" or "an") for `word`.
+      #
+      # Handles vowel-letter prefixes, common silent-h words ("hour", "honest"),
+      # and consonant-y-vowel cases ("university", "unicorn").
+      #
+      # @param word [String] the noun the article precedes
+      # @param capitalize [Boolean] return "A"/"An" instead of "a"/"an"
+      # @return [String] "a", "an", "A", or "An"
+      # @raise [ArgumentError] when word is empty
+      def indefinite_article(word, capitalize: false)
+        raise ArgumentError, 'word must not be empty' if word.nil? || word.empty?
+
+        lower = word.downcase
+        article =
+          if SILENT_H_AN.any? { |w| lower.start_with?(w) }
+            'an'
+          elsif CONSONANT_Y_VOWEL_A.any? { |w| lower.start_with?(w) }
+            'a'
+          elsif %w[a e i o u].include?(lower[0])
+            'an'
+          else
+            'a'
+          end
+        capitalize ? article.capitalize : article
+      end
+
       private
 
+      SILENT_H_AN = %w[hour honest honor honour heir heirloom heirs herb].freeze
+      CONSONANT_Y_VOWEL_A = %w[universe university unicorn unique uniform united union user useful one once].freeze
+
       ORDINALS = {
         1 => 'first', 2 => 'second', 3 => 'third', 4 => 'fourth', 5 => 'fifth',
         6 => 'sixth', 7 => 'seventh', 8 => 'eighth', 9 => 'ninth', 10 => 'tenth',

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-pluralize
 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-15 00:00:00.000000000 Z
+date: 2026-04-29 00:00:00.000000000 Z
 dependencies: []
 description: Pluralize and singularize English words without ActiveSupport. Includes
   200+ rules, irregular word handling, uncountable words, possessives, ordinals, plural