amounts 0.0.7 → 0.1.0

data/test/integration/postgresql_test.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require_relative "../test_helper"
+
+begin
+  require "pg"
+rescue LoadError
+  # Handled in setup.
+end
+
+ENV["RAILS_ENV"] = "test"
+
+require_relative "../dummy/config/environment"
+require "active_record/tasks/database_tasks"
+
+class PostgreSQLIntegrationTest < Minitest::Test
+  DUMMY_ROOT = File.expand_path("../dummy", __dir__)
+
+  def setup
+    skip "pg gem is not installed" unless defined?(PG)
+    skip "set AMOUNTS_POSTGRES_URL to run PostgreSQL integration tests" unless ENV["AMOUNTS_POSTGRES_URL"]
+
+    AmountTestSupport.register_active_record_types!
+    configure_database_tasks
+    recreate_schema!
+    # With a URL set, an unreachable database is an error, not a skip, so a
+    # broken CI service can't pass silently.
+    Holding.delete_all
+  end
+
+  def teardown
+    Amount.registry.clear!
+  end
+
+  def test_postgresql_round_trips_large_atomic_values_exactly
+    huge_atomic = 10**30
+    holding = Holding.create!(amount: Amount.new(huge_atomic, :SOL, from: :atomic))
+
+    assert_equal huge_atomic, holding.reload.amount.atomic
+  end
+
+  def test_postgresql_uses_default_numeric_precision_for_amount_columns
+    assert_equal 78, Holding.columns_hash.fetch("amount_atomic").precision
+  end
+
+  # Rails reports `scale` as nil for any zero-scale decimal, so check the
+  # column type PostgreSQL actually created.
+  def test_postgresql_uses_zero_scale_for_amount_columns
+    assert_equal "numeric(78,0)", Holding.columns_hash.fetch("amount_atomic").sql_type
+  end
+
+  def test_postgresql_uses_given_numeric_precision_for_amount_columns
+    assert_equal 40, Holding.columns_hash.fetch("reserve_atomic").precision
+  end
+
+  def test_postgresql_uses_zero_scale_for_amount_columns_with_given_precision
+    assert_equal "numeric(40,0)", Holding.columns_hash.fetch("reserve_atomic").sql_type
+  end
+
+  def test_postgresql_where_query_works_with_amount_columns
+    usdc = create_usdc_and_usd_holdings
+
+    assert_equal [usdc.id], Holding.where_amount("USDC|1.50").pluck(:id)
+  end
+
+  def test_postgresql_group_query_works_with_amount_columns
+    create_usdc_and_usd_holdings
+
+    assert_equal({ "USDC" => 1_500_000, "USD" => 300 }, Holding.group(:amount_symbol).sum(:amount_atomic))
+  end
+
+  private
+
+  # The USDC holding; a USD holding is created alongside.
+  def create_usdc_and_usd_holdings
+    usdc = Holding.create!(amount: "USDC|1.50")
+    Holding.create!(amount: "USD|3.00")
+    usdc
+  end
+
+  def configure_database_tasks
+    ActiveRecord::Tasks::DatabaseTasks.database_configuration = Rails.application.config.database_configuration
+    ActiveRecord::Tasks::DatabaseTasks.db_dir = File.join(DUMMY_ROOT, "db")
+    ActiveRecord::Tasks::DatabaseTasks.env = "test"
+    ActiveRecord::Tasks::DatabaseTasks.root = DUMMY_ROOT
+  end
+
+  def recreate_schema!
+    ActiveRecord::Base.establish_connection(:test)
+    ActiveRecord::Migration.verbose = false
+    load File.join(DUMMY_ROOT, "db/schema.rb")
+    Holding.reset_column_information
+  end
+end

data/test/support/active_record_test_support.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require "active_record"
+require "sqlite3"
+require_relative "amount_test_support"
+require_relative "../../lib/amount/active_record"
+
+# In-memory SQLite schema and models shared by the ActiveRecord adapter tests.
+# Loaded once per process however many test files require it.
+
+AmountTestSupport.register_active_record_types!
+
+::ActiveRecord::Base.establish_connection(adapter: "sqlite3", database: ":memory:")
+
+::ActiveRecord::Schema.define do
+  create_table :holdings, force: true do |t|
+    t.amount :amount, null: true
+    t.amount :fee, symbol: :SOL, null: true
+    t.amount :reserve, precision: 40, default: "USDC|1.25", null: false
+  end
+end
+
+class Holding < ::ActiveRecord::Base
+  has_amount :amount
+  has_amount :fee, symbol: :SOL
+  has_amount :reserve
+end
+
+class ValidatedHolding < ::ActiveRecord::Base
+  self.table_name = "holdings"
+
+  has_amount :amount
+  has_amount :fee, symbol: :SOL
+  has_amount :reserve
+
+  validates :amount, amount: {
+    symbol: :USDC,
+    greater_than: "USDC|0",
+    less_than_or_equal_to: "USDC|1000"
+  }
+  validates :fee, amount: {
+    symbol: :SOL,
+    greater_than: 0,
+    less_than: 10,
+    allow_nil: true
+  }
+  validates :reserve, amount: {
+    greater_than_or_equal_to: "USDC|1.25"
+  }
+end
+
+# Empty tables and the ActiveRecord test types before each test; an empty
+# registry after it.
+module ActiveRecordTestSetup
+  def setup
+    Holding.delete_all
+    ValidatedHolding.delete_all
+
+    AmountTestSupport.register_active_record_types!
+  end
+
+  def teardown
+    Amount.registry.clear!
+  end
+end

data/test/support/error_helpers.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "minitest"
+
+# Helpers for tests that assert on an error's message, so the raise and the
+# message can be checked in separate single-assertion tests.
+module ErrorHelpers
+  # The error the block raises. Not an assertion: the test still asserts on
+  # the result. Fails the test when nothing is raised.
+  #
+  # @param klass [Class<Exception>]
+  # @return [Exception]
+  def error_from(klass = StandardError)
+    yield
+  rescue klass => e
+    e
+  else
+    raise Minitest::Assertion, "expected #{klass} to be raised, nothing was raised"
+  end
+end
+
+Minitest::Test.include(ErrorHelpers)

data/test/support/locale_test_setup.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "i18n"
+
+# Default types plus a fresh I18n backend with en, de and fr number formats,
+# restored after each test.
+module LocaleTestSetup
+  def setup
+    AmountTestSupport.register_default_types!
+    @previous_locale = I18n.locale
+    @previous_backend = I18n.backend
+    I18n.backend = I18n::Backend::Simple.new
+    I18n.available_locales = %i[en de fr xx]
+    I18n.backend.store_translations(:en, number: { format: { delimiter: ",", separator: "." } })
+    I18n.backend.store_translations(:de, number: { format: { delimiter: ".", separator: "," } })
+    I18n.backend.store_translations(:fr, number: { format: { delimiter: " ", separator: "," } })
+    Amount.localize = false
+  end
+
+  def teardown
+    Amount.localize = false
+    I18n.backend = @previous_backend
+    I18n.locale = @previous_locale
+    Amount.registry.clear!
+  end
+
+  private
+
+  # Runs the block as if the i18n gem were not loaded.
+  def without_i18n
+    i18n = Object.send(:remove_const, :I18n)
+    yield
+  ensure
+    Object.const_set(:I18n, i18n)
+  end
+end

data/test/test_helper.rb

@@ -2,3 +2,4 @@
 
 require "minitest/autorun"
 require_relative "support/amount_test_support"
+require_relative "support/error_helpers"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: amounts
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.1.0
 platform: ruby
 authors:
 - Seb Scholl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-02 00:00:00.000000000 Z
+date: 2026-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -47,24 +47,34 @@ files:
 - lib/amount/active_record.rb
 - lib/amount/active_record/amount_validator.rb
 - lib/amount/active_record/attribute_definition.rb
+- lib/amount/active_record/locale/en.yml
 - lib/amount/active_record/migration_methods.rb
 - lib/amount/active_record/model.rb
 - lib/amount/active_record/railtie.rb
 - lib/amount/active_record/rspec.rb
 - lib/amount/active_record/rspec/matchers.rb
 - lib/amount/active_record/type.rb
-- lib/amount/allocation.rb
-- lib/amount/arithmetic.rb
-- lib/amount/comparison.rb
-- lib/amount/conversion.rb
+- lib/amount/compact.rb
+- lib/amount/concerns/allocatable.rb
+- lib/amount/concerns/calculable.rb
+- lib/amount/concerns/coercible.rb
+- lib/amount/concerns/constructible.rb
+- lib/amount/concerns/convertible.rb
+- lib/amount/concerns/formattable.rb
+- lib/amount/concerns/localizable.rb
+- lib/amount/concerns/orderable.rb
+- lib/amount/concerns/parsable.rb
+- lib/amount/concerns/registrable.rb
+- lib/amount/concerns/serializable.rb
 - lib/amount/display.rb
+- lib/amount/locale.rb
 - lib/amount/parser.rb
 - lib/amount/registry.rb
 - lib/amount/registry/generated_constructors.rb
 - lib/amount/rspec.rb
 - lib/amount/rspec/matchers.rb
 - lib/amount/rspec/support.rb
-- lib/amount/serialization.rb
+- lib/amount/ui_parser.rb
 - lib/amount/version.rb
 - lib/amounts.rb
 - lib/generators/amount/active_record/registry_generator.rb
@@ -73,6 +83,31 @@ files:
 - lib/generators/amount/active_record/templates/presets/fiat.fragment
 - lib/generators/amount/active_record/templates/presets/metals.fragment
 - lib/generators/amount/active_record/templates/registry.rb.tt
+- test/amount/active_record/amount_validator_test.rb
+- test/amount/active_record/attribute_definition_test.rb
+- test/amount/active_record/migration_methods_test.rb
+- test/amount/active_record/model_test.rb
+- test/amount/active_record/type_test.rb
+- test/amount/active_record_test.rb
+- test/amount/compact_test.rb
+- test/amount/concerns/allocatable_test.rb
+- test/amount/concerns/calculable_test.rb
+- test/amount/concerns/coercible_test.rb
+- test/amount/concerns/constructible_test.rb
+- test/amount/concerns/convertible_test.rb
+- test/amount/concerns/formattable_test.rb
+- test/amount/concerns/localizable_test.rb
+- test/amount/concerns/orderable_test.rb
+- test/amount/concerns/parsable_test.rb
+- test/amount/concerns/registrable_test.rb
+- test/amount/concerns/serializable_test.rb
+- test/amount/display_test.rb
+- test/amount/locale_test.rb
+- test/amount/parser_test.rb
+- test/amount/registry/generated_constructors_test.rb
+- test/amount/registry_test.rb
+- test/amount/ui_parser_test.rb
+- test/amount_test.rb
 - test/dummy/app/models/holding.rb
 - test/dummy/bin/rails
 - test/dummy/config/application.rb
@@ -80,12 +115,13 @@ files:
 - test/dummy/config/environment.rb
 - test/dummy/db/schema.rb
 - test/dummy/log/test.log
-- test/postgresql_integration_test.rb
+- test/generators/amount/active_record/registry_generator_test.rb
+- test/integration/postgresql_test.rb
+- test/support/active_record_test_support.rb
 - test/support/amount_test_support.rb
-- test/test_active_record.rb
-- test/test_amount.rb
+- test/support/error_helpers.rb
+- test/support/locale_test_setup.rb
 - test/test_helper.rb
-- test/test_registry_generator.rb
 homepage: https://github.com/zarpay/amounts
 licenses:
 - MIT

data/test/postgresql_integration_test.rb

@@ -1,71 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "test_helper"
-
-begin
-  require "pg"
-rescue LoadError
-  # Handled in setup.
-end
-
-ENV["RAILS_ENV"] = "test"
-
-require_relative "dummy/config/environment"
-require "active_record/tasks/database_tasks"
-
-class PostgreSQLIntegrationTest < Minitest::Test
-  def setup
-    skip "pg gem is not installed" unless defined?(PG)
-    skip "set AMOUNTS_POSTGRES_URL to run PostgreSQL integration tests" unless ENV["AMOUNTS_POSTGRES_URL"]
-
-    AmountTestSupport.register_active_record_types!
-    configure_database_tasks
-    recreate_schema!
-    Holding.delete_all
-  rescue PG::Error, ActiveRecord::ConnectionNotEstablished => error
-    skip "PostgreSQL is unavailable: #{error.message}"
-  end
-
-  def teardown
-    Amount.registry.clear!
-  end
-
-  def test_postgresql_round_trips_large_atomic_values_exactly
-    huge_atomic = 10**30
-    holding = Holding.create!(amount: Amount.new(huge_atomic, :SOL, from: :atomic))
-
-    assert_equal huge_atomic, holding.reload.amount.atomic
-  end
-
-  def test_postgresql_uses_numeric_precision_for_amount_columns
-    columns = Holding.columns_hash
-
-    assert_equal 78, columns.fetch("amount_atomic").precision
-    assert_equal 0, columns.fetch("amount_atomic").scale
-    assert_equal 40, columns.fetch("reserve_atomic").precision
-    assert_equal 0, columns.fetch("reserve_atomic").scale
-  end
-
-  def test_postgresql_where_and_group_queries_work_with_amount_columns
-    usdc = Holding.create!(amount: "USDC|1.50")
-    Holding.create!(amount: "USD|3.00")
-
-    assert_equal [usdc.id], Holding.where_amount("USDC|1.50").pluck(:id)
-    assert_equal({ "USDC" => 1_500_000, "USD" => 300 }, Holding.group(:amount_symbol).sum(:amount_atomic))
-  end
-
-  private
-
-  def configure_database_tasks
-    ActiveRecord::Tasks::DatabaseTasks.database_configuration = Rails.application.config.database_configuration
-    ActiveRecord::Tasks::DatabaseTasks.db_dir = File.expand_path("dummy/db", __dir__)
-    ActiveRecord::Tasks::DatabaseTasks.env = "test"
-    ActiveRecord::Tasks::DatabaseTasks.root = File.expand_path("dummy", __dir__)
-  end
-
-  def recreate_schema!
-    ActiveRecord::Base.establish_connection(:test)
-    load File.expand_path("dummy/db/schema.rb", __dir__)
-    Holding.reset_column_information
-  end
-end