philiprehberger-locale_kit 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c302d467b5ed11d3a39cc92d7a6ab9e7de7d12a024e5d5e621ee5205bf8291c
-  data.tar.gz: 547ad8e17b6bf0efab6d2124e3003a71100a9b35d2f26c606aab267a37064f93
+  metadata.gz: '059b92458d9232190df3b248892166ef4bd09fa20e782f5e3c61ee9d10fcf36c'
+  data.tar.gz: 28a2405801d7c58b5ecdacc2e66276c8f5ffa6020248e192955cc9a072a81d8c
 SHA512:
-  metadata.gz: 1ca0559427bdf9bb874fe52e98dde4f3c23e1cacfda4e7980c601180443b0a73660031df344059f024d58a4a2b64f3e06c7ef4c95beb3e951d71946d18a36baf
-  data.tar.gz: c8b80a6ef41cb564169222e83694b6101a5ccd8b06afc8b13d85a8dd464e5b7350e8bc4b35c3b79e228f47aa7a2f0273882ffef888dd24b5fcb257c248719b34
+  metadata.gz: e6829ac9bd5c0917f4231e127a7b572a75c4d77d9a99ec4ba77c9896cc92f5be019e7ec025f3ec879e51b74422daa7b6397ebfebfa78dfbcbc70f661fa67e38e
+  data.tar.gz: ddb0fb2a802997a63b61288f7054307a86bc2bdeeaa791185b0f7c068ac267d5f0931c1e6592469dceac801ef2dd42baf906f4a0b9fa38b0dc5e0f62b7d250b6

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-24
+
+### Added
+- `LocaleKit.language_name(code)` — look up the English name for an ISO 639-1 language code (case-insensitive); returns `nil` for unknown codes or non-String input
+
 ## [0.3.0] - 2026-04-15
 
 ### Added

data/README.md

@@ -91,6 +91,11 @@ Philiprehberger::LocaleKit.languages["ja"]  #=> "Japanese"
 
 Philiprehberger::LocaleKit.regions["US"]  #=> "United States"
 Philiprehberger::LocaleKit.regions["JP"]  #=> "Japan"
+
+# Single-lookup convenience (case-insensitive)
+Philiprehberger::LocaleKit.language_name("en")  #=> "English"
+Philiprehberger::LocaleKit.language_name("FR")  #=> "French"
+Philiprehberger::LocaleKit.language_name("zz")  #=> nil
 ```
 
 ### Language Compatibility
@@ -141,6 +146,7 @@ entries[0][:quality]     #=> 1.0
 | `.negotiate(requested, available, default: nil)` | Find the best matching locale with fallback chains |
 | `.parse_accept_language(header)` | Parse an Accept-Language header into `[{locale:, quality:}]` |
 | `.languages` | Hash of ISO 639-1 language codes to English names |
+| `.language_name(code)` | English name for an ISO 639-1 code (case-insensitive); `nil` if unknown |
 | `.regions` | Hash of ISO 3166-1 alpha-2 region codes to English names |
 
 ### `Philiprehberger::LocaleKit::Locale`

data/lib/philiprehberger/locale_kit/version.rb

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

data/lib/philiprehberger/locale_kit.rb

@@ -70,6 +70,18 @@ module Philiprehberger
       Data::LANGUAGES
     end
 
+    # Look up the English name for an ISO 639-1 language code.
+    #
+    # Case-insensitive. Returns `nil` for unknown codes or non-String input.
+    #
+    # @param code [String] a 2-letter ISO 639-1 code (e.g. "en", "EN")
+    # @return [String, nil] the English language name, or nil if unknown
+    def self.language_name(code)
+      return nil unless code.is_a?(String)
+
+      Data::LANGUAGES[code.downcase]
+    end
+
     # Returns a hash of common ISO 3166-1 alpha-2 region codes to English names.
     #
     # @return [Hash<String, String>] region code to name mapping

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-locale_kit
 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-24 00:00:00.000000000 Z
 dependencies: []
 description: Parse BCP 47 language tags, negotiate content language from Accept-Language
   headers, and match locales with fallback chains. Zero dependencies.