money_attribute 1.1.0 → 1.2.0

data/lib/money_attribute/type.rb

@@ -1,54 +1,62 @@
 # frozen_string_literal: true
 
 module MoneyAttribute
-  # Type
-  class Type < ActiveRecord::Type::Value
-    def initialize(currency:, column_type: ActiveRecord::Type::Decimal.new)
-      @currency = currency
-      @column_type = column_type
-      super()
-    end
-
-    def cast(value)
-      if value.is_a?(String)
-        Mint::Money.parse(value, @currency)
-      else
-        super
-      end
-    end
+  # Base type for money amount attributes. Handles casting and validation.
+  class AmountType < ActiveRecord::Type::Value
+    # Casts string input into a +Mint::Money+ value.
+    #
+    # @param value [String, Numeric, Mint::Money, nil] the input value
+    # @return [Mint::Money, Numeric, nil] a Money value for strings, otherwise delegates to super
+    def cast(value) = value.is_a?(String) ? Money.parse(value, MoneyAttribute.default_currency) : super
 
+    # Validates that the value is compatible with the fixed currency type.
+    #
+    # @param value [Object] the value to validate
+    # @return [void]
+    # @raise [ArgumentError] when the value has a mismatched currency or is an unsupported type
     def assert_valid_value(value)
       case value
       when NilClass, Numeric, String then return
       when Mint::Money
-        return if value.currency == @currency
+        currency = MoneyAttribute.default_currency
+        return if value.currency == currency
 
-        message = "'#{value.inspect}' has different currency. Only #{@currency.code} allowed."
+        message = "'#{value.inspect}' has different currency. Only #{currency.code} allowed."
       else
         message = "'#{value.inspect}' is not a valid type for the attribute."
       end
       raise ArgumentError, message
     end
+  end
 
-    def deserialize(value)
-      return nil unless value
+  # Type for integer columns storing subunits (e.g. cents).
+  class IntegerAmountType < AmountType
+    # Deserializes a subunit integer into a +Mint::Money+ value.
+    #
+    # @param value [Integer, nil] the raw database value
+    # @return [Mint::Money, nil]
+    def deserialize(value) = value && Money.from_subunits(value.to_i, MoneyAttribute.default_currency)
 
-      if @column_type.is_a?(ActiveRecord::Type::Integer)
-        Mint::Money.from_subunits(value, @currency)
-      else
-        Mint::Money.from(value, @currency)
-      end
-    end
+    # Serializes a +Mint::Money+ value into subunits.
+    #
+    # @param value [Mint::Money, nil]
+    # @return [Integer, nil]
+    def serialize(value) = value&.subunits
+  end
 
-    def serialize(value)
-      return nil unless value
+  # Type for decimal columns storing unit values (e.g. 12.34).
+  class DecimalAmountType < AmountType
+    # Deserializes a decimal value into a +Mint::Money+ value.
+    #
+    # @param value [BigDecimal, nil] the raw database value
+    # @return [Mint::Money, nil]
+    def deserialize(value) = value && Money.from(value, MoneyAttribute.default_currency)
 
-      if @column_type.is_a?(ActiveRecord::Type::Integer)
-        value.subunits
-      else
-        value.to_d
-      end
-    end
+    # Serializes a +Mint::Money+ value into a decimal.
+    #
+    # @param value [Mint::Money, nil]
+    # @return [BigDecimal, nil]
+    def serialize(value) = value&.to_d
   end
 end
 

data/lib/money_attribute/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MoneyAttribute
-  VERSION = '1.1.0'
+  VERSION = '1.2.0'
 end

data/lib/money_attribute.rb

@@ -1,13 +1,27 @@
 # frozen_string_literal: true
 
+# MoneyAttribute provides ActiveRecord integrations for the Minting money gem.
+#
+# Two storage modes:
+#
+# - +money_attribute :price+ — composite (amount + currency columns)
+# - +money_amount :price+    — single column (fixed currency)
+#
+# @see MoneyAttribute::Macro
+# @see MoneyAttribute::MoneyAmount
+
 require 'minting'
-require 'money_attribute/core_ext'
+require 'money_attribute/core_ext/numeric'
 require 'money_attribute/core_ext/string'
 require 'money_attribute/configuration'
+require 'money_attribute/current'
+require 'money_attribute/attribute_spec'
+require 'money_attribute/attribute_spec_registry'
 require 'money_attribute/macro'
 require 'money_attribute/money_amount'
 require 'money_attribute/converter'
 require 'money_attribute/type'
 require 'money_attribute/form_builder_extension'
+require 'money_attribute/query'
 require 'money_attribute/railtie'
 require 'money_attribute/version'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: money_attribute
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Gilson Ferraz
@@ -50,16 +50,27 @@ files:
 - lib/generators/money_attribute/initializer_generator.rb
 - lib/generators/templates/money_attribute.rb
 - lib/money_attribute.rb
+- lib/money_attribute/attribute_spec.rb
+- lib/money_attribute/attribute_spec_registry.rb
 - lib/money_attribute/configuration.rb
 - lib/money_attribute/converter.rb
-- lib/money_attribute/core_ext.rb
+- lib/money_attribute/core_ext/numeric.rb
 - lib/money_attribute/core_ext/string.rb
+- lib/money_attribute/current.rb
 - lib/money_attribute/form_builder_extension.rb
 - lib/money_attribute/macro.rb
 - lib/money_attribute/migration_extensions/helper.rb
 - lib/money_attribute/migration_extensions/schema_statements.rb
 - lib/money_attribute/migration_extensions/table_definition.rb
 - lib/money_attribute/money_amount.rb
+- lib/money_attribute/query.rb
+- lib/money_attribute/query/amount_condition.rb
+- lib/money_attribute/query/amount_order.rb
+- lib/money_attribute/query/currency_condition.rb
+- lib/money_attribute/query/helpers.rb
+- lib/money_attribute/query/pick.rb
+- lib/money_attribute/query/pluck.rb
+- lib/money_attribute/query/sum.rb
 - lib/money_attribute/railtie.rb
 - lib/money_attribute/type.rb
 - lib/money_attribute/version.rb
@@ -88,7 +99,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.17
 specification_version: 4
 summary: Money attributes for ActiveRecord
 test_files: []