internationalize 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 520c17d4993a0145c00081a95a30f21c9a3b56b0879589fc87f4731564be7f1e
-  data.tar.gz: 24478d271a6500c4104c8e26db4238ed1857b533b25e5c351e30cfc45fe7c13a
+  metadata.gz: a78574c3b203b7ae3dd699ab2c4c429503922d134f40c990e99dea103e241b12
+  data.tar.gz: 2c0ff80e85f73e66e9e04ad572d4b711150ce8853aab53880b326c65be8a551f
 SHA512:
-  metadata.gz: a15ca8db8848c85feec7d912c47905a0cbd665aed43721642b97e039f607699edbeb207666d3af98e92e412d6c6ac0c89298b4ac4aba5c9643bf2554c2f59a08
-  data.tar.gz: b380cf31e89bd26994935e733c89df8b23771e83a73606f39dd6092f833aec11f0a4e471ec8c8c8ff914cd3079a15b0d05a4d016962936adc707302acaec5683
+  metadata.gz: bbfe57de55d2e7f0d52b02c34eac3c79fa0a71c353dbccf0f65e1c82053e77f66f83ebe40fa69262a123d81bd4c7f78624bc15de6b5001d9227e7032d697633e
+  data.tar.gz: d45d9c2a223eb3e740e2da4e17266d4eb0a3590162425f9fb52620224cbe4844dfc987af7394893d42b1a601689f163fff3b05d0531009c296659efd74535162

data/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2024-11-29
+
+### Added
+
+- Validation for hyphenated locales (e.g., `zh-TW`) - raises helpful error suggesting underscore format (`zh_TW`)
+- Auto-load `Internationalize::RichText` when ActionText is available (no manual require needed)
+
+## [0.2.1] - 2024-11-29
+
+### Added
+
+- ActionText documentation in agent context files
+
 ## [0.2.0] - 2024-11-29
 
 ### Added
@@ -14,6 +27,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - ActionText support via `international_rich_text` (optional, requires ActionText)
   - Generates `has_rich_text` for each locale with unified accessor
   - Full attachment support per locale
+- Validation for `title_translations=` setter - rejects non-Hash values and invalid locales
 
 ### Removed
 

data/README.md

@@ -175,11 +175,9 @@ article.title  # => "Hello" (falls back to :en)
 
 ### ActionText Support
 
-For rich text with attachments, use `international_rich_text` (requires ActionText):
+For rich text with attachments, use `international_rich_text` (auto-loaded when ActionText is available):
 
 ```ruby
-require "internationalize/rich_text"
-
 class Article < ApplicationRecord
   include Internationalize::Model
   include Internationalize::RichText

data/context/getting-started.md

@@ -86,6 +86,7 @@ Article.international_order(:title, :desc)
 - No JOINs - data lives in the same table
 - Automatic fallback to default locale
 - Works with SQLite, PostgreSQL, and MySQL
+- ActionText support via `international_rich_text` (see Model API)
 
 ## Important: Column Defaults
 

data/context/model-api.md

@@ -21,7 +21,7 @@ For each `international :title` declaration:
 | `title=` | Set translation for current `I18n.locale` |
 | `title?` | Check if translation exists |
 | `title_translations` | Get raw hash of all translations |
-| `title_translations=` | Set all translations at once |
+| `title_translations=` | Set all translations at once (validates locale keys) |
 
 ### Locale-Specific Accessors
 
@@ -79,3 +79,37 @@ article.title_en = "Hello"
 I18n.locale = :de
 article.title  # => "Hello" (falls back to default locale)
 ```
+
+## ActionText Support
+
+For rich text with attachments, use `international_rich_text` (auto-loaded when ActionText is available):
+
+```ruby
+class Article < ApplicationRecord
+  include Internationalize::Model
+  include Internationalize::RichText
+
+  international_rich_text :content
+end
+```
+
+This generates `has_rich_text :content_en`, `has_rich_text :content_de`, etc. for each locale.
+
+### Generated Methods
+
+| Method | Description |
+|--------|-------------|
+| `content` | Get rich text for current locale (with fallback) |
+| `content=` | Set rich text for current locale |
+| `content?` | Check if rich text exists |
+| `content_en` | Direct access to English rich text |
+| `content_de` | Direct access to German rich text |
+| `content_translated?(:de)` | Check if translation exists |
+| `content_translated_locales` | Array of locales with content |
+
+```ruby
+article.content = "<p>Hello</p>"  # Sets for current locale
+article.content                    # Gets for current locale (with fallback)
+article.content.body               # ActionText::Content object
+article.content.embeds             # Attachments work per-locale
+```

data/lib/internationalize/model.rb

@@ -324,7 +324,21 @@ module Internationalize
 
         # Set all translations at once
         define_method("#{attr}_translations=") do |hash|
-          write_attribute(translations_column, hash&.stringify_keys || {})
+          return write_attribute(translations_column, {}) if hash.nil?
+
+          unless hash.is_a?(Hash)
+            raise ArgumentError, "#{attr}_translations must be a Hash, got #{hash.class}"
+          end
+
+          allowed_locales = Internationalize.locales.map(&:to_s)
+          hash.each_key do |key|
+            unless allowed_locales.include?(key.to_s)
+              raise ArgumentError, "Invalid locale '#{key}' for #{attr}_translations. " \
+                "Allowed locales: #{allowed_locales.join(', ')}"
+            end
+          end
+
+          write_attribute(translations_column, hash.stringify_keys)
         end
       end
 
@@ -334,6 +348,12 @@ module Internationalize
 
         Internationalize.locales.each do |locale|
           locale_str = locale.to_s
+
+          if locale_str.include?("-")
+            raise ArgumentError, "Locale '#{locale}' contains a hyphen which is invalid for Ruby method names. " \
+              "Use underscore format instead: :#{locale_str.tr('-', '_')}"
+          end
+
           getter_method = :"#{attr}_#{locale}"
 
           # Getter: article.title_en

data/lib/internationalize/rich_text.rb

@@ -26,6 +26,15 @@ module Internationalize
       # @param name [Symbol] the attribute name
       #
       def international_rich_text(name)
+        # Validate locales don't contain hyphens (invalid for Ruby method names)
+        Internationalize.locales.each do |locale|
+          locale_str = locale.to_s
+          if locale_str.include?("-")
+            raise ArgumentError, "Locale '#{locale}' contains a hyphen which is invalid for Ruby method names. " \
+              "Use underscore format instead: :#{locale_str.tr('-', '_')}"
+          end
+        end
+
         # Generate has_rich_text for each locale
         Internationalize.locales.each do |locale|
           rich_text_name = :"#{name}_#{locale}"

data/lib/internationalize/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Internationalize
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 end

data/lib/internationalize.rb

@@ -6,6 +6,7 @@ require "active_record"
 require_relative "internationalize/version"
 require_relative "internationalize/adapters"
 require_relative "internationalize/model"
+require_relative "internationalize/rich_text" if defined?(ActionText)
 
 module Internationalize
   class << self

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: internationalize
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Sampo Kuokkanen