cmdx-i18n 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c275e1af32039c765b8f70c38dd712807f96db533b312e69f9b0a2269313db13
-  data.tar.gz: e14e66c415d94e187ebdc5ab6d32b202155757438893cc7652a948ae3e8154ac
+  metadata.gz: 330eb1ca9e8ca9a61a2073fa6efcbfe0b9b01f95938e2be371127e9d958e8550
+  data.tar.gz: 764bea625ce3edd4e85dc2d7273ef220a0c2d523598f9d9dcd8f35bc9874ed62
 SHA512:
-  metadata.gz: b83a4177e7cb5717febec6fa3e1e46de66692933cdde97bd76ce02019ac13131f6ca2ff4a99499e6436e0a6d58dd8a9dc46f5dd4915f4d291942b38d7613c694
-  data.tar.gz: 464967b66d95a8581d8eda4b79f4e3359c02c000686a02d49cf10e92292a126d49d16d4d14e4c873e009b645cc87de06b2fe4274f57925cdab5acc894d079f62
+  metadata.gz: 87f5e559e7bb2a45696596cfbb26b121db382dbc50789adb81839ae3aa7cebc067672908061a6c837f579a10cf26a6fadd35b99c7a35ed5202203c8e3e59be91
+  data.tar.gz: 725ae012e65190d74c691dfca4ba2668e3cea89590fd5950b4940bbb609324cbe5a1b7261fbc9831c030159e1702e922978b05f70554a5fcab563bcc07cfb27c

data/.cursor/rules/cursor-instructions.mdc

@@ -10,12 +10,13 @@ Follow the official Ruby gem guides for best practices.
 Reference the guides outlined in https://guides.rubygems.org
 
 ## Project Context
-CMDx provides a framework for designing and executing complex
-business logic within service/command objects.
+CMDx::I18n is a collection of localized translations for the CMDx framework.
+Reference the CMDx documentation in https://github.com/drexed/cmdx/blob/main/LLM.md
 
 ## Technology Stack
 - Ruby 3.4+
 - RSpec 3.1+
+- CMDx 1.6+
 
 ## Code Style and Structure
 - Write concise, idiomatic Ruby code with accurate examples

data/CHANGELOG.md

@@ -6,6 +6,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [TODO]
 
+## [0.2.0] - 2025-08-24
+
+### Added
+- Generator to copy locales to `config/locales` in a Rails app
+
+### Changes
+- Fix railtie requirement issue
+
 ## [0.1.1] - 2025-08-23
 
 ### Changes

data/README.md

@@ -30,7 +30,16 @@ Or install it yourself as:
 
 ## Configuration
 
-By default, `cmdx-i18n` locales are automatically loaded and are managed through the `I18n.available_locales` option.
+If the `I18n` gem is installed, `cmdx-i18n` locales are automatically loaded and are managed through the `I18n.available_locales` option.
+
+Execute the following command to copy any locale to the applications `config/locales` directory:
+
+```bash
+rails generate cmdx:i18n:locale [LOCALE]
+
+# Eg: generate french locale
+rails generate cmdx:i18n:locale fr
+```
 
 ## Locales
 

data/lib/cmdx/i18n/version.rb

@@ -3,7 +3,7 @@
 module CMDx
   module I18n
 
-    VERSION = "0.1.1"
+    VERSION = "0.2.0"
 
   end
 end

data/lib/cmdx/i18n.rb

@@ -21,6 +21,9 @@ loader.inflector.inflect("cmdx" => "CMDx")
 loader.ignore("#{__dir__}/locales")
 loader.setup
 
+# Conditionally load Rails components if Rails is available
+require_relative "generators/cmdx/i18n/copy_generator" if defined?(Rails::Generators)
+
 # Load the Railtie last after everything else is required so we don't
 # need to load any CMDx::I18n components when we use this Railtie.
-require_relative "cmdx/i18n/railtie" if defined?(Rails::Railtie)
+require_relative "i18n/railtie" if defined?(Rails::Railtie)

data/lib/generators/cmdx/i18n/locale_generator.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cmdx
+  module I18n
+    # Generates CMDx locale files for Rails applications
+    #
+    # Rails generator that copies CMDx::I18n locale files into the application's
+    # config/locales directory. This allows applications to customize and extend
+    # the default CMDx::I18n locale files.
+    class LocaleGenerator < Rails::Generators::Base
+
+      source_root File.expand_path("../../../locales", __dir__)
+
+      desc "Copies CMDx::I18n locale files into app"
+
+      argument :locale, type: :string, default: "en", banner: "Locale to copy"
+
+      # Copies the locale template to the Rails application
+      #
+      # Copies the specified locale file from the gem's locales directory to the
+      # application's config/locales directory. If the locale file doesn't exist
+      # in the gem, the generator will fail gracefully.
+      #
+      # @return [void]
+      #
+      # @example
+      #   # Copy default (English) locale file
+      #   rails generate cmdx:i18n:locale
+      #   # => Creates config/locales/en.yml
+      #
+      #   # Copy Spanish locale file
+      #   rails generate cmdx:i18n:locale es
+      #   # => Creates config/locales/es.yml
+      #
+      def copy_locale_files
+        copy_file("#{locale}.yml", "config/locales/#{locale}.yml")
+      end
+
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cmdx-i18n
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Juan Gomez
@@ -173,6 +173,7 @@ files:
 - lib/cmdx/i18n.rb
 - lib/cmdx/i18n/railtie.rb
 - lib/cmdx/i18n/version.rb
+- lib/generators/cmdx/i18n/locale_generator.rb
 - lib/locales/af.yml
 - lib/locales/ar.yml
 - lib/locales/az.yml