icu4x 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6127d334332b2d38a6ef3518d9e7c076158d4eb21a282a982709dde0e8a9e70
-  data.tar.gz: 189fb0957980330e56c643bed174289039aa7f73f3d03d3ff91e8aab0211b6e4
+  metadata.gz: 7871f9d79af05cf7edf90ca57fc7351b6cf8d027b5017606369748825265d359
+  data.tar.gz: e47cf84063cf0d7b8841d22c8776937cabb2fab7324a0dcb3e9129e5cec2df61
 SHA512:
-  metadata.gz: 660d2834ff4811ff545c95c44e0e1ddecdfeda53b48e1cfdafd6c7ca12387a00c48c2836ae2eab58ebaf9f654386231eac0c0c2674633b2ab702a1b3ef3cd1f3
-  data.tar.gz: 87014b1b98c519d06f97b43a6697d344f94cc1ed4b055f4d4de13b269efefdb55d0d83628be2828adcbadbaebb419d4446e852dfa30c597d0c3478edab2b6560
+  metadata.gz: 9b7d7683237505c31d148451262825f40458ab916717949f7a6e1c6f76397eb94f898eda81a00d5131efee1ef904623d2b128b38a366ef39f8804c90fda48daa
+  data.tar.gz: 1ec09d4d5f4a4529aa4ac6a2747d1c16f3c5b66fbc60e3b28fcb8bafd5e0c4ba43b41a4fde5cdc5cd5e14f7bc2edb8cd0793ca86fe2b4052787929baa5e469be

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.8.0] - 2026-01-10
+
+### Added
+
+- `ICU4X::Locale#maximize!` and `#maximize` methods to expand locale using Likely Subtags algorithm (UTS #35)
+- `ICU4X::Locale#minimize!` and `#minimize` methods to remove redundant subtags
+
 ## [0.7.0] - 2026-01-09
 
 ### Added

data/ext/icu4x/src/locale.rs

@@ -1,6 +1,6 @@
 use crate::helpers;
-use icu_locale::Locale as IcuLocale;
-use magnus::{Error, RHash, RModule, Ruby, function, method, prelude::*};
+use icu_locale::{Locale as IcuLocale, LocaleExpander, TransformResult};
+use magnus::{Error, RHash, RModule, Ruby, function, method, prelude::*, typed_data::Obj};
 use std::cell::RefCell;
 
 /// Ruby wrapper for ICU4X Locale
@@ -162,6 +162,48 @@ impl Locale {
     fn eq(&self, other: &Locale) -> bool {
         *self.inner.borrow() == *other.inner.borrow()
     }
+
+    /// Maximize the locale in place (Add Likely Subtags algorithm, UTS #35)
+    /// Returns self if modified, nil if unchanged
+    fn maximize_bang(rb_self: Obj<Self>) -> Option<Obj<Self>> {
+        let expander = LocaleExpander::new_common();
+        let mut locale = rb_self.inner.borrow_mut();
+        match expander.maximize(&mut locale.id) {
+            TransformResult::Modified => Some(rb_self),
+            TransformResult::Unmodified => None,
+        }
+    }
+
+    /// Maximize the locale, returning a new Locale object
+    fn maximize(&self) -> Self {
+        let expander = LocaleExpander::new_common();
+        let mut new_id = self.inner.borrow().id.clone();
+        expander.maximize(&mut new_id);
+        Self {
+            inner: RefCell::new(IcuLocale::from(new_id)),
+        }
+    }
+
+    /// Minimize the locale in place (Remove Likely Subtags algorithm, UTS #35)
+    /// Returns self if modified, nil if unchanged
+    fn minimize_bang(rb_self: Obj<Self>) -> Option<Obj<Self>> {
+        let expander = LocaleExpander::new_common();
+        let mut locale = rb_self.inner.borrow_mut();
+        match expander.minimize(&mut locale.id) {
+            TransformResult::Modified => Some(rb_self),
+            TransformResult::Unmodified => None,
+        }
+    }
+
+    /// Minimize the locale, returning a new Locale object
+    fn minimize(&self) -> Self {
+        let expander = LocaleExpander::new_common();
+        let mut new_id = self.inner.borrow().id.clone();
+        expander.minimize(&mut new_id);
+        Self {
+            inner: RefCell::new(IcuLocale::from(new_id)),
+        }
+    }
 }
 
 pub fn init(ruby: &Ruby, module: &RModule) -> Result<(), Error> {
@@ -174,5 +216,9 @@ pub fn init(ruby: &Ruby, module: &RModule) -> Result<(), Error> {
     class.define_method("extensions", method!(Locale::extensions, 0))?;
     class.define_method("to_s", method!(Locale::to_s, 0))?;
     class.define_method("==", method!(Locale::eq, 1))?;
+    class.define_method("maximize!", method!(Locale::maximize_bang, 0))?;
+    class.define_method("maximize", method!(Locale::maximize, 0))?;
+    class.define_method("minimize!", method!(Locale::minimize_bang, 0))?;
+    class.define_method("minimize", method!(Locale::minimize, 0))?;
     Ok(())
 }

data/lib/icu4x/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module ICU4X
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
   public_constant :VERSION
 end

data/lib/icu4x/yard_docs.rb

@@ -274,6 +274,74 @@
 #       # @return [Integer] hash code
 #       #
 #       def hash; end
+#
+#       # Maximizes the locale in place using the Add Likely Subtags algorithm (UTS #35).
+#       #
+#       # Adds likely script and region subtags based on the language.
+#       # This is useful for language negotiation.
+#       #
+#       # @return [self, nil] self if the locale was modified, nil if already maximized
+#       #
+#       # @example
+#       #   locale = ICU4X::Locale.parse("en")
+#       #   locale.maximize!  #=> locale
+#       #   locale.to_s       #=> "en-Latn-US"
+#       #
+#       # @example Already maximized
+#       #   locale = ICU4X::Locale.parse("en-Latn-US")
+#       #   locale.maximize!  #=> nil
+#       #
+#       # @see https://unicode.org/reports/tr35/#Likely_Subtags
+#       #
+#       def maximize!; end
+#
+#       # Returns a new locale with likely subtags added.
+#       #
+#       # Non-destructive version of {#maximize!}. The original locale is unchanged.
+#       #
+#       # @return [Locale] a new locale with likely subtags added
+#       #
+#       # @example
+#       #   locale = ICU4X::Locale.parse("zh")
+#       #   expanded = locale.maximize
+#       #   locale.to_s    #=> "zh" (unchanged)
+#       #   expanded.to_s  #=> "zh-Hans-CN"
+#       #
+#       def maximize; end
+#
+#       # Minimizes the locale in place using the Remove Likely Subtags algorithm (UTS #35).
+#       #
+#       # Removes redundant script and region subtags that can be inferred.
+#       # This is useful for language negotiation.
+#       #
+#       # @return [self, nil] self if the locale was modified, nil if already minimal
+#       #
+#       # @example
+#       #   locale = ICU4X::Locale.parse("ja-Jpan-JP")
+#       #   locale.minimize!  #=> locale
+#       #   locale.to_s       #=> "ja"
+#       #
+#       # @example Already minimal
+#       #   locale = ICU4X::Locale.parse("en")
+#       #   locale.minimize!  #=> nil
+#       #
+#       # @see https://unicode.org/reports/tr35/#Likely_Subtags
+#       #
+#       def minimize!; end
+#
+#       # Returns a new locale with redundant subtags removed.
+#       #
+#       # Non-destructive version of {#minimize!}. The original locale is unchanged.
+#       #
+#       # @return [Locale] a new locale with redundant subtags removed
+#       #
+#       # @example
+#       #   locale = ICU4X::Locale.parse("zh-Hans-CN")
+#       #   minimal = locale.minimize
+#       #   locale.to_s   #=> "zh-Hans-CN" (unchanged)
+#       #   minimal.to_s  #=> "zh"
+#       #
+#       def minimize; end
 #     end
 #
 #     # Provides locale-aware plural rules for cardinal and ordinal numbers.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: icu4x
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - OZAWA Sakuro
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-09 00:00:00.000000000 Z
+date: 2026-01-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-configurable