minting-rails 0.8.2 → 0.8.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c6f9a0ca2ddc8795a648b6c6047728d626106e2afddbe63869ad3159fcd819e
-  data.tar.gz: 863f9135a359162e053f988e991a9ac2a832e56e310cc1c7511410212e7c0427
+  metadata.gz: 51ccbfc5e1da101cf48481d812400763aa410925247386b4a7471030ce301790
+  data.tar.gz: 2ee25dd8e7d055429ed72827d9c6637be59555ade55d8964d01809388c5e430f
 SHA512:
-  metadata.gz: 148ee6a06dde29d5685c47e5c3e284fdce46c7d75cd84ab265760087f1e3fcc43afb9f60e949bbe615cf311b576bb9a6180569f103c5665a137d10849604e42c
-  data.tar.gz: 7c0eaca1345709f22bb446764b9220c5767cca2998e0570490871555cce3c2d692e5839eea9eedcae282cdbe032dca603d1a89bb8ba61d358aa725e83b26b883
+  metadata.gz: 7326b98ee8731f4139e0e48dfaeed3569a98ea57c59b01db0582762a4546bc550fd8e0950e2f97be48ec6a872c1ea9d18b659b6d2de8dca150d6d7b33e1f4fe7
+  data.tar.gz: 244facdd52251db6a7e250a6ceab68b5553972501ea89d80749f998c58e454bf380401c35b1d12b5064e8ad5649677b72679ccbee8e9e2c7a0d8b9a71e11142a

data/README.md

@@ -1,3 +1,14 @@
+> **⚠️ DEPRECATED — use [money-attribute](https://github.com/gferraz/money-attribute) instead.**
+>
+> Since June of 2026, `minting-rails` has been renamed to **money-attribute** and will no longer be maintained.
+> All future development happens under the new name. Update your Gemfile:
+>
+> ```ruby
+> gem 'money-attribute'
+> ```
+>
+> The API is identical — just replace the gem name and you're done.
+
 # Minting::Rails
 
 [![CI](https://github.com/gferraz/minting-rails/actions/workflows/ci.yml/badge.svg)](https://github.com/gferraz/minting-rails/actions/workflows/ci.yml)
@@ -269,6 +280,46 @@ end
 
 The mapping keys are `:amount` and `:currency`; values are your database column names.
 
+## Column resolution
+
+When you declare `money_attribute :name`, the gem resolves which database columns to use by checking the table schema in this order:
+
+| Step | Condition | Columns used | Mode |
+|---|---|---|---|
+| 1 | `mapping:` provided | As specified | Explicit composite |
+| 2 | `name_currency` column exists | `name` + `name_currency` | Composite (multi-currency) |
+| 3 | `name == 'amount'` AND `currency` column exists | `amount` + `currency` | Composite (multi-currency) |
+| 4 | `name_amount` + `name_currency` columns exist | `name_amount` + `name_currency` | Composite (multi-currency) |
+| 5 | `name` column exists (no currency partner) | `name` alone | Single-column (fixed-currency) |
+
+**Example**
+
+```ruby
+create_table :financial_transactions do |t|
+  t.integer :amount
+  t.string  :currency, limit: 3
+  t.integer :discount
+  t.string  :discount_currency, limit: 3
+  t.decimal :price_amount
+  t.string  :price_currency, limit: 3
+  t.bigint  :surplus
+  t.bigint  :tax
+  t.decimal :total_amount
+  t.string  :currency_code, limit: 3
+end
+```
+
+```ruby
+class FinancialTransaction < ApplicationRecord
+  money_attribute :amount                   # step 3: amount(int) + currency
+  money_attribute :discount                 # step 2: discount(int) + discount_currency
+  money_attribute :price                    # step 4: price_amount(dec) + price_currency
+  money_attribute :surplus, currency: 'EUR' # step 5: surplus(int) (single-column, will use EUR)
+  money_attribute :tax                      # step 5: tax(int) (single-column, will use default currency)
+  money_attribute :total, mapping: { amount: :total_amount, currency: :currency_code }  # step 1: explicit
+end
+```
+
 ## Querying
 
 Fixed-currency attributes support Rails-native querying through the custom type:

data/lib/generators/templates/minting.rb

@@ -10,8 +10,8 @@ Mint.configure do |config|
   #    {currency: 'NGN', subunit: 3, symbol: '₦'}
   #   ]
   config.added_currencies = [
-    { currency: 'CRC', subunit: 2, symbol: '₡' },
-    { currency: 'NGN', subunit: 3, symbol: '₦' }
+    { currency: 'XCRC', subunit: 2, symbol: '₡' },
+    { currency: 'XNGN', subunit: 3, symbol: '₦' }
   ]
 
   # To set the default currency

data/lib/minting/money_attribute/money_attribute.rb

@@ -1,65 +1,91 @@
 # frozen_string_literal: true
 
 module Mint
-  # MoneyAttribute
   module MoneyAttribute
     extend ActiveSupport::Concern
 
     class_methods do
-      # Money attribute
       def money_attribute(name, currency: Mint.default_currency, mapping: nil)
+        columns = attribute_names
         currency = Currency.resolve!(currency)
+        name = name.to_s
         parser = Parser.new(currency)
-        if attribute_names.include? name.to_s
-          attribute(name, :mint_money, currency:)
-          normalizes(name, with: parser)
+        resolved_mapping = mapping || resolve_mapping(name, columns)
+
+        if columns.include?(name) && resolved_mapping.nil?
+          define_single_column_money_attribute(name, currency, parser)
         else
-          aggregated = find_money_attributes(name, mapping:)
-          options = {
-            allow_nil: true, class_name: 'Mint::Money',
-            constructor: parser, converter: parser,
-            mapping: {
-              aggregated[:amount] => amount_extractor_for(aggregated[:amount]),
-              aggregated[:currency] => :currency_code
-            }
-          }
-          composed_of(name, options)
+          define_composite_money_attribute(name, resolved_mapping, parser)
         end
       end
 
-      def amount_extractor_for(column_name)
-        col = columns.find { |c| c.name == column_name.to_s }
+      private
 
-        case col&.type
-        when :bigint, :integer
-          :fractional
-        else
-          :to_d # :decimal, :numeric, unknown
+      # --- Preparation (no side effects) ---
+
+      def resolve_mapping(name, columns)
+        return nil unless columns.include?(name)
+
+        if columns.include?("#{name}_currency")
+          { amount: name, currency: :"#{name}_currency" }
+        elsif columns.include?('currency') && name == 'amount'
+          { amount: name, currency: :currency }
         end
       end
 
-      def find_money_attributes(name, mapping:)
-        if mapping.present?
-          missing_keys = (%i[amount currency] - mapping.keys).join(', ')
-          if missing_keys.present?
-            raise ArgumentError,
-                  "Mapping for :#{name} money attribute is missing required keys: #{missing_keys}"
-          end
-          composite = { amount: mapping[:amount].to_s, currency: mapping[:currency].to_s }
-        else
-          composite = { amount: "#{name}_amount", currency: "#{name}_currency" }
-        end
+      def resolve_composite_for(name, mapping:)
+        composite = { amount: "#{name}_amount", currency: "#{name}_currency" }
 
-        missing = composite.values - attribute_names
-        if missing.any?
-          raise ArgumentError,
-                "Could not find columns for :#{name} money attribute. " \
-                "Expected: #{composite.values.join(', ')}, " \
-                "Found: #{attribute_names.join(', ')}"
-        end
+        composite[:amount]    = mapping[:amount].to_s   if mapping&.key?(:amount)
+        composite[:currency]  = mapping[:currency].to_s if mapping&.key?(:currency)
 
+        assert_columns_exist!(name, composite)
         composite
       end
+
+      def assert_columns_exist!(name, composite)
+        missing = composite.values - attribute_names
+        return if missing.empty?
+
+        raise ArgumentError,
+              "Could not find columns for :#{name} money attribute. " \
+              "Expected: #{composite.values.join(', ')}, " \
+              "Found: #{attribute_names.join(', ')}"
+      end
+
+      def amount_extractor_for(column_name)
+        integer_column?(column_name) ? :fractional : :to_d
+      end
+
+      def money_constructor_for(amount_column) = integer_column?(amount_column) ? :from_fractional : :from
+
+      def integer_column?(column_name)
+        col = columns.find { |c| c.name == column_name }
+        %i[integer bigint].include?(col&.type)
+      end
+
+      # --- Configuration (registers types, normalizers, composed_of) ---
+
+      def define_single_column_money_attribute(name, currency, parser)
+        column_type = integer_column?(name) ? ActiveRecord::Type::Integer.new : ActiveRecord::Type::Decimal.new
+        attribute(name.to_sym, :mint_money, currency:, column_type: column_type)
+        normalizes(name.to_sym, with: parser)
+      end
+
+      def define_composite_money_attribute(name, mapping, parser)
+        aggregated = resolve_composite_for(name, mapping:)
+
+        composed_of(name.to_sym, {
+                      allow_nil: true,
+                      class_name: 'Mint::Money',
+                      constructor: money_constructor_for(aggregated[:amount]),
+                      converter: parser,
+                      mapping: {
+                        aggregated[:amount] => amount_extractor_for(aggregated[:amount]),
+                        aggregated[:currency] => :currency_code
+                      }
+                    })
+      end
     end
   end
 end

data/lib/minting/money_attribute/money_type.rb

@@ -26,9 +26,9 @@ module Mint
       return nil unless value
 
       if @column_type.is_a?(ActiveRecord::Type::Integer)
-        Mint.money(value * @currency.fractional_multiplier, @currency)
+        Mint::Money.from_fractional(value, @currency)
       else
-        Mint.money(value, @currency)
+        Mint::Money.from(value, @currency)
       end
     end
 

data/lib/minting/money_attribute/version.rb

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

data/lib/minting/railties.rb

@@ -33,13 +33,15 @@ module Mint
     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']
-          subunit = currency_data[:subunit] || currency_data['subunit']
-          symbol = currency_data[:symbol] || currency_data['symbol']
+          code = currency_data[:currency]
+          subunit = currency_data[:subunit]
+          symbol = currency_data[:symbol]
         else
           code, subunit, symbol = *currency_data
         end
         Currency.register(code:, subunit:, symbol:)
+      rescue KeyError
+        nil
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minting-rails
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.8.4
 platform: ruby
 authors:
 - Gilson Ferraz
@@ -68,6 +68,16 @@ metadata:
   changelog_uri: https://github.com/gferraz/minting-rails/releases
   bug_tracker_uri: https://github.com/gferraz/minting-rails/issues
   rubygems_mfa_required: 'true'
+  deprecated_at: '2026-6-15'
+  replaced_by: money-attribute
+post_install_message: |2
+
+  ⚠️  `minting-rails` has been renamed to `money-attribute` and will no longer be maintained.
+  Update your Gemfile:
+
+    gem 'money-attribute'
+
+  The API is identical — just replace the gem name and you're done.
 rdoc_options: []
 require_paths:
 - lib