icu4x 0.5.2-x86_64-linux → 0.6.1-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1d7e0a07b1ef3854c298d00dc2b890dac0de72cb0fdda96f81ebc0ca80da53d
-  data.tar.gz: e92ea08fe5727fb9feaf2441ce365fae13dc6ba1316d478ec539ad691b5e3dfb
+  metadata.gz: ec01535e816ded3136a1bb3c6f8dbbd76e00d8aa60caf627499b00003d6fdebc
+  data.tar.gz: ea6b3b455b5e38856071f9e3fb0a56aa9c023f6873f240355dca94c8caf2e945
 SHA512:
-  metadata.gz: afe1bc9f2f6c817e71633f7fbc03bb38ef56932ec26716f7e51872307c76c5355445a68cbf90d1ec3d4808d9baff2020cc738cf636aac6e85fa8026392c068fd
-  data.tar.gz: daa307d4f33f5e567654d7a22ebc64d1ddd2d9cbd0259356ec8b33b35da2b54b80b308c775d6080e2de9013a422bbe02f41c8e311d6615303f3a82ee46055bda
+  metadata.gz: c3b51a4f16c85c84d6facc0e701263c2600e17adb9fd78bbc0337aea762d37572afcdf547fbe66d84efe23238e3781daf4a2fca042761879a34b69bcad541c7d
+  data.tar.gz: 521eb35ef28f1c384413d3e821a8c9b065c17d11f6677b95034c686f55d0a23cb8c9256c205b99ba5441036eb69556a9aabb2a6d8c446e82cd3d1656cf5d4c6f

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 ## [Unreleased]
 
+## [0.6.1] - 2026-01-02
+
+### Changed
+
+- Re-release to publish companion data gems with Trusted Publisher configuration
+
+## [0.6.0] - 2026-01-02
+
+### Added
+
+- **Companion data gems**: `icu4x-data-full`, `icu4x-data-recommended`, `icu4x-data-modern` for bundled locale data
+  - Auto-configures default provider on require (e.g., `require "icu4x/data/recommended"`)
+- **RakeTask**: `ICU4X::RakeTask` for integrating data generation into build workflows
+- **Symbolic locale specifiers**: `DataGenerator.export` accepts `:full`, `:recommended`, `:modern`, `:moderate`, `:basic` symbols
+- **Automatic 'und' locale**: `DataGenerator.export` automatically includes the `und` (undetermined) locale for fallback
+
 ## [0.5.2] - 2026-01-01
 
 ### Fixed

data/README.md

@@ -35,7 +35,28 @@ Add to your Gemfile:
 gem "icu4x"
 ```
 
-Then generate locale data for your application:
+### Option 1: Use Pre-built Data Gem (Quick Start)
+
+Add a companion data gem for instant setup:
+
+```ruby
+gem "icu4x"
+gem "icu4x-data-recommended"  # 164 locales, ~24MB
+```
+
+```ruby
+require "icu4x"
+require "icu4x/data/recommended"  # Auto-configures default provider
+```
+
+Available data gems:
+- `icu4x-data-full` - All CLDR locales (700+)
+- `icu4x-data-recommended` - Recommended locales (164)
+- `icu4x-data-modern` - Modern coverage locales (103)
+
+### Option 2: Generate Custom Data
+
+For fine-grained control, generate only the locales you need:
 
 ```ruby
 require "icu4x"

data/lib/icu4x/data_gem_task.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+require "erb"
+require "fileutils"
+require "pathname"
+require "rake"
+require "rake/tasklib"
+require "rubygems"
+require "rubygems/package"
+
+module ICU4X
+  # Rake task for generating ICU4X data companion gems.
+  #
+  # @example Basic usage
+  #   require "icu4x/data_gem_task"
+  #
+  #   ICU4X::DataGemTask.new
+  #
+  # This creates the following tasks:
+  # - +icu4x:data_gems:build+ - Build all data gems
+  # - +icu4x:data_gems:build:full+ - Build icu4x-data-full gem
+  # - +icu4x:data_gems:build:recommended+ - Build icu4x-data-recommended gem
+  # - +icu4x:data_gems:build:modern+ - Build icu4x-data-modern gem
+  # - +icu4x:data_gems:clean+ - Clean data gem build artifacts
+  class DataGemTask < ::Rake::TaskLib
+    VARIANTS = {
+      full: {locales: :full, description: "All CLDR locales (700+)"},
+      recommended: {locales: :recommended, description: "Recommended locales (164)"},
+      modern: {locales: :modern, description: "Modern coverage locales (103)"}
+    }.freeze
+    public_constant :VARIANTS
+
+    TEMPLATE_DIR = Pathname(__dir__).join("../../templates/data_gem")
+    public_constant :TEMPLATE_DIR
+
+    def initialize
+      super
+      define_tasks
+    end
+
+    private def define_tasks
+      namespace "icu4x:data_gems" do
+        desc "Build all data gems"
+        task build: VARIANTS.keys.map {|v| "build:#{v}" }
+
+        VARIANTS.each do |variant, config|
+          desc "Build icu4x-data-#{variant} gem"
+          task "build:#{variant}" => :compile do
+            build_gem(variant, config)
+          end
+        end
+
+        desc "Clean data gem build artifacts"
+        task :clean do
+          VARIANTS.each_key {|v| FileUtils.rm_rf(tmp_dir(v)) }
+        end
+      end
+    end
+
+    private def build_gem(variant, config)
+      gem_dir = prepare_gem_structure(variant, config)
+      generate_data_blob(gem_dir, variant, config[:locales])
+      package_gem(gem_dir, variant)
+    end
+
+    private def prepare_gem_structure(variant, config)
+      gem_dir = tmp_dir(variant)
+      FileUtils.rm_rf(gem_dir)
+      gem_dir.mkpath
+
+      # Render templates
+      require "icu4x/version"
+      render_template(
+        "gemspec.erb",
+        gem_dir / "icu4x-data-#{variant}.gemspec",
+        variant:,
+        config:,
+        version: ICU4X::VERSION
+      )
+      render_template(
+        "README.md.erb",
+        gem_dir / "README.md",
+        variant:,
+        config:
+      )
+
+      lib_data_dir = gem_dir / "lib" / "icu4x" / "data"
+      lib_data_dir.mkpath
+      render_template(
+        "lib/icu4x/data/variant.rb.erb",
+        lib_data_dir / "#{variant}.rb",
+        variant:
+      )
+
+      # Copy LICENSE
+      FileUtils.cp("LICENSE.txt", gem_dir / "LICENSE.txt")
+
+      gem_dir
+    end
+
+    private def generate_data_blob(gem_dir, variant, locales)
+      data_dir = gem_dir / "data"
+      data_dir.mkpath
+
+      require "icu4x"
+      ICU4X::DataGenerator.export(
+        locales:,
+        markers: :all,
+        format: :blob,
+        output: data_dir / "#{variant}.postcard"
+      )
+    end
+
+    private def package_gem(gem_dir, variant)
+      Dir.chdir(gem_dir) do
+        spec = Gem::Specification.load("icu4x-data-#{variant}.gemspec")
+        gem_file = Gem::Package.build(spec)
+        pkg_dir = Pathname("../../pkg")
+        pkg_dir.mkpath
+        FileUtils.mv(gem_file, pkg_dir / gem_file)
+      end
+    end
+
+    private def render_template(template_name, output_path, **locals)
+      template = ERB.new(TEMPLATE_DIR.join(template_name).read, trim_mode: "-")
+      binding_with_locals = binding
+      locals.each {|k, v| binding_with_locals.local_variable_set(k, v) }
+      output_path.write(template.result(binding_with_locals))
+    end
+
+    private def tmp_dir(variant) = Pathname("tmp/icu4x-data-#{variant}")
+  end
+end

data/lib/icu4x/rake_task.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "rake"
+require "rake/clean"
+require "rake/tasklib"
+
+module ICU4X
+  # Rake task for generating ICU4X data blobs.
+  #
+  # @example Basic usage
+  #   require "icu4x/rake_task"
+  #
+  #   ICU4X::RakeTask.new do |t|
+  #     t.output = "data/icu4x.postcard"
+  #   end
+  #
+  # @example Custom task name and locales
+  #   ICU4X::RakeTask.new("myapp:generate_data") do |t|
+  #     t.locales = %w[en ja de]
+  #     t.output = "data/icu4x.postcard"
+  #   end
+  class RakeTask < ::Rake::TaskLib
+    # @return [String] The name of the task
+    attr_reader :name
+
+    # @return [Symbol, Array<String>] Locale specifier or array of locale strings
+    #   Defaults to +:recommended+
+    attr_accessor :locales
+
+    # @return [Symbol, Array<String>] Data markers to include
+    #   Defaults to +:all+
+    attr_accessor :markers
+
+    # @return [Pathname, String] Output path relative to Rakefile
+    attr_accessor :output
+
+    # Creates a new RakeTask.
+    #
+    # @param name [String] Task name (default: "icu4x:data:generate")
+    # @yield [self] Configuration block
+    # @yieldparam task [RakeTask] The task instance for configuration
+    def initialize(name="icu4x:data:generate")
+      super()
+      @name = name
+      @locales = :recommended
+      @markers = :all
+      @output = nil
+
+      yield self if block_given?
+
+      raise ArgumentError, "output is required" if @output.nil?
+
+      define_tasks
+    end
+
+    private def define_tasks
+      output_path = Pathname(@output)
+
+      desc "Generate ICU4X data blob"
+      file output_path.to_s do
+        require "icu4x"
+        output_path.dirname.mkpath
+        ICU4X::DataGenerator.export(
+          locales: @locales,
+          markers: @markers,
+          format: :blob,
+          output: output_path
+        )
+      end
+
+      desc "Generate ICU4X data blob"
+      task @name => output_path.to_s
+
+      CLOBBER.include(output_path.to_s)
+    end
+  end
+end

data/lib/icu4x/version.rb

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

data/lib/icu4x/yard_docs.rb

@@ -112,7 +112,18 @@
 #     class DataGenerator
 #       # Exports locale data to a file.
 #       #
-#       # @param locales [Array<String>] list of locale identifiers to include
+#       # The +locales+ parameter accepts either a Symbol for predefined locale sets
+#       # based on CLDR coverage levels, or an Array of locale identifier strings.
+#       # When using +with_descendants+, ancestor locales (including +und+) are
+#       # automatically included for fallback support.
+#       #
+#       # @param locales [Symbol, Array<String>] locale specification:
+#       #   - +:full+ - all CLDR locales (700+)
+#       #   - +:recommended+ - locales with basic, moderate, or modern coverage (164)
+#       #   - +:modern+ - locales with modern coverage only (103)
+#       #   - +:moderate+ - locales with moderate coverage only
+#       #   - +:basic+ - locales with basic coverage only
+#       #   - +Array<String>+ - explicit list of locale identifiers
 #       # @param markers [Symbol, Array<String>] data markers to include;
 #       #   use +:all+ for all markers, or specify individual marker names
 #       # @param format [Symbol] output format, currently only +:blob+ is supported
@@ -128,7 +139,16 @@
 #       #     output: Pathname.new("i18n_data.postcard")
 #       #   )
 #       #
+#       # @example Export data for all modern coverage locales
+#       #   ICU4X::DataGenerator.export(
+#       #     locales: :modern,
+#       #     markers: :all,
+#       #     format: :blob,
+#       #     output: Pathname.new("modern_data.postcard")
+#       #   )
+#       #
 #       # @see .available_markers
+#       # @see https://cldr.unicode.org/index/cldr-spec/coverage-levels CLDR Coverage Levels
 #       #
 #       def self.export(locales:, markers:, format:, output:); end
 #
@@ -138,7 +158,7 @@
 #       #
 #       # @example
 #       #   markers = ICU4X::DataGenerator.available_markers
-#       #   #=> ["datetime/gregory/datelengths@1", "decimal/symbols@1", ...]
+#       #   #=> ["CalendarJapaneseExtendedV1", "CalendarJapaneseModernV1", ...]
 #       #
 #       def self.available_markers; end
 #     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: icu4x
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.6.1
 platform: x86_64-linux
 authors:
 - OZAWA Sakuro
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-01 00:00:00.000000000 Z
+date: 2026-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-configurable
@@ -38,6 +38,8 @@ files:
 - lib/icu4x/3.2/icu4x.so
 - lib/icu4x/3.3/icu4x.so
 - lib/icu4x/3.4/icu4x.so
+- lib/icu4x/data_gem_task.rb
+- lib/icu4x/rake_task.rb
 - lib/icu4x/version.rb
 - lib/icu4x/yard_docs.rb
 - sig/icu4x.rbs