minting-rails 0.8.1 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dfed7ac7c21d15b7b983eac0bd391ec8f4eb4f1f89b1cb9ae0308701dd15ba76
-  data.tar.gz: da2eb9d34f56f26a71674a45a792b922adb57d0ff9d6a5098eb96d2e3cf5394a
+  metadata.gz: 6c6f9a0ca2ddc8795a648b6c6047728d626106e2afddbe63869ad3159fcd819e
+  data.tar.gz: 863f9135a359162e053f988e991a9ac2a832e56e310cc1c7511410212e7c0427
 SHA512:
-  metadata.gz: bca70a3dc33e70b65635e1dddf9a435ee718b5d6e06e26262fdc53b8d7a9c7e3b7534b88e4ee064cdc6015c2c2772d7941a9482787e96d84397c8a74ec8cd51e
-  data.tar.gz: 73ef1dcbedaa6cbbf832d37b450c08af1ebf41c12d47a76eb1a884a571ba869c1fbebb89be24a0422a855e53e245c53cd64811466b7a73ef0fa7de5878aa0791
+  metadata.gz: 148ee6a06dde29d5685c47e5c3e284fdce46c7d75cd84ab265760087f1e3fcc43afb9f60e949bbe615cf311b576bb9a6180569f103c5665a137d10849604e42c
+  data.tar.gz: 7c0eaca1345709f22bb446764b9220c5767cca2998e0570490871555cce3c2d692e5839eea9eedcae282cdbe032dca603d1a89bb8ba61d358aa725e83b26b883

data/README.md

@@ -86,6 +86,51 @@ end
 
 See the [Minting gem](https://github.com/gferraz/minting) for full configuration options (custom currencies, formatting, rounding).
 
+### I18n / Locale-aware formatting
+
+Minting-rails integrates with Rails I18n to automatically format money amounts according to the current locale.
+
+With `I18n.locale` set to `:en`:
+```ruby
+Mint.money(1234.56, 'USD').to_s  # => "$1,234.56"
+```
+
+Switch to `:'pt-BR'` and the separators change automatically (requires [`rails-i18n`](https://github.com/svenfuchs/rails-i18n) or your own locale file):
+```ruby
+I18n.locale = :'pt-BR'
+Mint.money(1234.56, 'USD').to_s  # => "$1.234,56"
+```
+
+The locale backend reads `number.currency.format` from your I18n translations and maps Rails format syntax (`%n` for amount, `%u` for unit) to `Mint::Money#to_s`. If the translation key is missing (no locale file for that language), it falls back to hardcoded defaults (`.` decimal, `,` thousand, `%<symbol>s%<amount>f` format).
+
+You can configure per-sign formatting by adding `positive`, `negative`, and `zero` keys to your locale:
+
+```yaml
+# config/locales/minting-rails.en.yml
+en:
+  number:
+    currency:
+      format:
+        format: "%u%n"           # fallback when no per-sign key matches
+        positive: "%u%n"         # "$1,234.56"
+        negative: "(%u%n)"       # "($1,234.56)"
+        zero: "--"               # "--"
+        separator: "."
+        delimiter: ","
+```
+
+When any of `positive`, `negative`, or `zero` is present, a Hash format is built. Missing keys fall back to `format`:
+
+```ruby
+Mint.money(1234.56, 'USD').to_s  # => "$1,234.56"
+Mint.money(-1234.56, 'USD').to_s # => "($1,234.56)"
+Mint.money(0, 'USD').to_s        # => "--"
+```
+
+If none of those keys are set, `format` is used as a plain string (simple formatting).
+
+> Formatting respects the currency's own `subunit` for decimal precision — `I18n` locale settings for `precision` are ignored since that is a currency property, not a locale one.
+
 ## Usage — Two modes
 
 ### Decision table
@@ -411,7 +456,7 @@ Minting-rails is intentionally minimal — it focuses on storing and reading mon
 | **Mongoid support** | Yes | ActiveRecord only |
 | **Migration helpers** | `add_monetize :products, :price` | None |
 | **View helpers** | `humanized_money`, `money_without_cents`, etc. | None |
-| **I18n / locale files** | Built-in locale-aware formatting | None |
+| **I18n / locale files** | Locale-aware formatting via I18n `number.currency.format` — reads your existing translations, no extra setup | Built-in locale-aware formatting with bundled translations |
 | **Test matcher** | `monetize(:price_cents)` RSpec matcher | None |
 | **Currency exchange** | `default_bank`, `add_rate`, EuCentralBank | None |
 | **Custom currencies** | `register_currency` for non-ISO codes | Via `minting` gem config |
@@ -429,7 +474,6 @@ If you need any of these features today, money-rails may be a better fit. mintin
 1. **Allow nil** — `money_attribute :price, currency: 'USD', allow_nil: true`
 1. **Method-level currency** — lambda-based currency resolution for multi-tenant and instance-level scenarios
 1. **Migration helper**
-1. **Internationalization**
 
 Contributions and suggestions are welcome — open an issue or PR at [gferraz/minting-rails](https://github.com/gferraz/minting-rails).
 

data/lib/minting/money_attribute/version.rb

@@ -2,6 +2,6 @@
 
 module Mint
   module MoneyAttribute
-    VERSION = '0.8.1'
+    VERSION = '0.8.2'
   end
 end

data/lib/minting/railties.rb

@@ -7,6 +7,30 @@ module Mint
     end
 
     config.after_initialize do
+      setup_locale_backend!
+      register_custom_currencies!
+    end
+
+    def self.setup_locale_backend!
+      Mint.locale_backend = lambda {
+        fmt = I18n.t('number.currency.format', default: {})
+        translator = ->(s) { s&.gsub('%n', '%<amount>f')&.gsub('%u', '%<symbol>s') }
+
+        format = if fmt.key?(:positive) || fmt.key?(:negative) || fmt.key?(:zero)
+                   {
+                     positive: translator.call(fmt[:positive] || fmt[:format]),
+                     negative: translator.call(fmt[:negative] || fmt[:format]),
+                     zero: translator.call(fmt[:zero] || fmt[:format])
+                   }
+                 else
+                   translator.call(fmt[:format])
+                 end
+
+        { decimal: fmt[:separator], thousand: fmt[:delimiter], format: format }
+      }
+    end
+
+    def self.register_custom_currencies!
       Array(Mint.config.added_currencies).each do |currency_data|
         if currency_data.respond_to?(:values_at)
           code = currency_data[:currency] || currency_data['currency']

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minting-rails
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.8.2
 platform: ruby
 authors:
 - Gilson Ferraz