amounts 0.0.5 → 0.0.7

data/lib/generators/amount/active_record/templates/presets/fiat.fragment

@@ -0,0 +1,163 @@
+  # Registry overview:
+  # Major Fiat Currencies:
+  # - This preset is a curated basket of widely used fiat currencies for general product and treasury workflows.
+  # - Minor-unit precision follows ISO-4217-style currency fractions: most entries use 2 decimals, while JPY uses 0.
+  # - Display symbols are English-oriented defaults inspired by CLDR conventions and may need localization in real applications.
+  # - Source: Unicode CLDR currency symbols and localization notes: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+
+  # USD: United States dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "$" as the default display symbol in an English-oriented UI.
+  # Preset default: Renders as a prefix amount, for example "$12.34".
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :USD,
+    decimals: 2,
+    display_symbol: "$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # EUR: Euro.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses the euro sign as the default display symbol.
+  # Preset default: Renders as a prefix amount for a compact English-oriented default.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :EUR,
+    decimals: 2,
+    display_symbol: "€",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # GBP: British pound sterling.
+  # Fact: Uses 2 decimal places for pence.
+  # Preset default: Uses the pound sign as the default display symbol.
+  # Preset default: Renders as a prefix amount.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :GBP,
+    decimals: 2,
+    display_symbol: "£",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # JPY: Japanese yen.
+  # Fact: Uses 0 decimal places under standard minor-unit conventions.
+  # Preset default: Uses the yen sign as the default display symbol.
+  # Preset default: Renders as a prefix amount with no fractional UI digits.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :JPY,
+    decimals: 0,
+    display_symbol: "¥",
+    display_position: :prefix,
+    ui_decimals: 0
+
+  # CHF: Swiss franc.
+  # Fact: Uses 2 decimal places for rappen/centimes.
+  # Preset default: Uses the ISO code as the display symbol to avoid locale ambiguity.
+  # Preset default: Renders as a suffix amount, for example "12.34 CHF".
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :CHF,
+    decimals: 2,
+    display_symbol: "CHF",
+    display_position: :suffix,
+    ui_decimals: 2
+
+  # CAD: Canadian dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "CA$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :CAD,
+    decimals: 2,
+    display_symbol: "CA$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # AUD: Australian dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "A$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :AUD,
+    decimals: 2,
+    display_symbol: "A$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # NZD: New Zealand dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "NZ$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :NZD,
+    decimals: 2,
+    display_symbol: "NZ$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # SGD: Singapore dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "S$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :SGD,
+    decimals: 2,
+    display_symbol: "S$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # HKD: Hong Kong dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "HK$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :HKD,
+    decimals: 2,
+    display_symbol: "HK$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # CNY: Chinese yuan renminbi.
+  # Fact: Uses 2 decimal places for jiao/fen display.
+  # Preset default: Uses "CN¥" to avoid confusion with other yen/yuan symbols in multi-currency UIs.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :CNY,
+    decimals: 2,
+    display_symbol: "CN¥",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # INR: Indian rupee.
+  # Fact: Uses 2 decimal places for paise.
+  # Preset default: Uses the rupee sign as the default display symbol.
+  # Preset default: Renders as a prefix amount.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :INR,
+    decimals: 2,
+    display_symbol: "₹",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # MXN: Mexican peso.
+  # Fact: Uses 2 decimal places for centavos.
+  # Preset default: Uses "MX$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :MXN,
+    decimals: 2,
+    display_symbol: "MX$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # BRL: Brazilian real.
+  # Fact: Uses 2 decimal places for centavos.
+  # Preset default: Uses the common Brazilian real symbol "R$".
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :BRL,
+    decimals: 2,
+    display_symbol: "R$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # AED: United Arab Emirates dirham.
+  # Fact: Uses 2 decimal places for fils.
+  # Preset default: Uses the ISO code as the display symbol for an unambiguous English-oriented default.
+  # Preset default: Renders as a suffix amount.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :AED,
+    decimals: 2,
+    display_symbol: "AED",
+    display_position: :suffix,
+    ui_decimals: 2

data/lib/generators/amount/active_record/templates/presets/metals.fragment

@@ -0,0 +1,151 @@
+  # Registry overview:
+  # Precious And Industrial Metals:
+  # - This preset is a curated basket of metals commonly tracked in treasury, vault, and commodities workflows.
+  # - Display-unit conversion factors use standard mass relationships such as troy-ounce to gram and kilogram to pound.
+  # - Storage decimals here are preset defaults chosen for application headroom; they are not exchange-mandated market standards.
+  # - Source: NIST precious-metals conversion guidance: https://www.nist.gov/pml/weights-and-measures/laws-and-regulations/precious-metals-conversion
+  # - Source: NIST metric and customary conversion guidance: https://www.nist.gov/pml/weights-and-measures/common-conversion-factors-ii
+
+  # GOLD: Gold measured with troy-ounce display defaults.
+  # Fact: The alternate gram display uses 1 troy ounce = 31.1035 grams.
+  # Fact: The alternate kilogram display uses 1 troy ounce = 0.0311035 kilograms.
+  # Preset default: Uses 8 storage decimals as a high-precision preset default rather than a market mandate.
+  # Preset default: Defaults to troy-ounce display because that is common for bullion pricing.
+  # Source: NIST precious-metals conversion guidance: https://www.nist.gov/pml/weights-and-measures/laws-and-regulations/precious-metals-conversion
+  Amount.register :GOLD,
+    decimals: 8,
+    display_symbol: "oz t",
+    display_position: :suffix,
+    ui_decimals: 4,
+    display_units: {
+      oz_t: { scale: 1, symbol: "oz t", ui_decimals: 4 },
+      gram: { scale: "31.1035", symbol: "g", ui_decimals: 2 },
+      kg:   { scale: "0.0311035", symbol: "kg", ui_decimals: 5 }
+    },
+    default_display: :oz_t
+
+  # SILVER: Silver measured with troy-ounce display defaults.
+  # Fact: The alternate gram display uses 1 troy ounce = 31.1035 grams.
+  # Fact: The alternate kilogram display uses 1 troy ounce = 0.0311035 kilograms.
+  # Preset default: Uses 8 storage decimals as a high-precision preset default.
+  # Preset default: Defaults to troy-ounce display for consistency with common bullion quoting.
+  # Source: NIST precious-metals conversion guidance: https://www.nist.gov/pml/weights-and-measures/laws-and-regulations/precious-metals-conversion
+  Amount.register :SILVER,
+    decimals: 8,
+    display_symbol: "oz t",
+    display_position: :suffix,
+    ui_decimals: 4,
+    display_units: {
+      oz_t: { scale: 1, symbol: "oz t", ui_decimals: 4 },
+      gram: { scale: "31.1035", symbol: "g", ui_decimals: 2 },
+      kg:   { scale: "0.0311035", symbol: "kg", ui_decimals: 5 }
+    },
+    default_display: :oz_t
+
+  # PLATINUM: Platinum measured with troy-ounce display defaults.
+  # Fact: The alternate gram display uses 1 troy ounce = 31.1035 grams.
+  # Fact: The alternate kilogram display uses 1 troy ounce = 0.0311035 kilograms.
+  # Preset default: Uses 8 storage decimals as a high-precision preset default.
+  # Preset default: Defaults to troy-ounce display for commodity-style pricing.
+  # Source: NIST precious-metals conversion guidance: https://www.nist.gov/pml/weights-and-measures/laws-and-regulations/precious-metals-conversion
+  Amount.register :PLATINUM,
+    decimals: 8,
+    display_symbol: "oz t",
+    display_position: :suffix,
+    ui_decimals: 4,
+    display_units: {
+      oz_t: { scale: 1, symbol: "oz t", ui_decimals: 4 },
+      gram: { scale: "31.1035", symbol: "g", ui_decimals: 2 },
+      kg:   { scale: "0.0311035", symbol: "kg", ui_decimals: 5 }
+    },
+    default_display: :oz_t
+
+  # PALLADIUM: Palladium measured with troy-ounce display defaults.
+  # Fact: The alternate gram display uses 1 troy ounce = 31.1035 grams.
+  # Fact: The alternate kilogram display uses 1 troy ounce = 0.0311035 kilograms.
+  # Preset default: Uses 8 storage decimals as a high-precision preset default.
+  # Preset default: Defaults to troy-ounce display for commodity-style pricing.
+  # Source: NIST precious-metals conversion guidance: https://www.nist.gov/pml/weights-and-measures/laws-and-regulations/precious-metals-conversion
+  Amount.register :PALLADIUM,
+    decimals: 8,
+    display_symbol: "oz t",
+    display_position: :suffix,
+    ui_decimals: 4,
+    display_units: {
+      oz_t: { scale: 1, symbol: "oz t", ui_decimals: 4 },
+      gram: { scale: "31.1035", symbol: "g", ui_decimals: 2 },
+      kg:   { scale: "0.0311035", symbol: "kg", ui_decimals: 5 }
+    },
+    default_display: :oz_t
+
+  # COPPER: Copper measured with metric-mass defaults.
+  # Fact: The tonne display uses 1 kg = 0.001 t.
+  # Fact: The pound display uses 1 kg = 2.2046226218 lb.
+  # Preset default: Uses kilograms as the default display unit for industrial inventory and warehouse-style workflows.
+  # Preset default: Uses 6 storage decimals as a high-precision preset default.
+  # Source: NIST metric and customary conversion guidance: https://www.nist.gov/pml/weights-and-measures/common-conversion-factors-ii
+  Amount.register :COPPER,
+    decimals: 6,
+    display_symbol: "kg",
+    display_position: :suffix,
+    ui_decimals: 3,
+    display_units: {
+      kg:    { scale: 1, symbol: "kg", ui_decimals: 3 },
+      tonne: { scale: "0.001", symbol: "t", ui_decimals: 6 },
+      lb:    { scale: "2.2046226218", symbol: "lb", ui_decimals: 2 }
+    },
+    default_display: :kg
+
+  # ALUMINUM: Aluminum measured with metric-mass defaults.
+  # Fact: The tonne display uses 1 kg = 0.001 t.
+  # Fact: The pound display uses 1 kg = 2.2046226218 lb.
+  # Preset default: Uses kilograms as the default display unit.
+  # Preset default: Uses 6 storage decimals as a high-precision preset default.
+  # Source: NIST metric and customary conversion guidance: https://www.nist.gov/pml/weights-and-measures/common-conversion-factors-ii
+  Amount.register :ALUMINUM,
+    decimals: 6,
+    display_symbol: "kg",
+    display_position: :suffix,
+    ui_decimals: 3,
+    display_units: {
+      kg:    { scale: 1, symbol: "kg", ui_decimals: 3 },
+      tonne: { scale: "0.001", symbol: "t", ui_decimals: 6 },
+      lb:    { scale: "2.2046226218", symbol: "lb", ui_decimals: 2 }
+    },
+    default_display: :kg
+
+  # NICKEL: Nickel measured with metric-mass defaults.
+  # Fact: The tonne display uses 1 kg = 0.001 t.
+  # Fact: The pound display uses 1 kg = 2.2046226218 lb.
+  # Preset default: Uses kilograms as the default display unit.
+  # Preset default: Uses 6 storage decimals as a high-precision preset default.
+  # Source: NIST metric and customary conversion guidance: https://www.nist.gov/pml/weights-and-measures/common-conversion-factors-ii
+  Amount.register :NICKEL,
+    decimals: 6,
+    display_symbol: "kg",
+    display_position: :suffix,
+    ui_decimals: 3,
+    display_units: {
+      kg:    { scale: 1, symbol: "kg", ui_decimals: 3 },
+      tonne: { scale: "0.001", symbol: "t", ui_decimals: 6 },
+      lb:    { scale: "2.2046226218", symbol: "lb", ui_decimals: 2 }
+    },
+    default_display: :kg
+
+  # ZINC: Zinc measured with metric-mass defaults.
+  # Fact: The tonne display uses 1 kg = 0.001 t.
+  # Fact: The pound display uses 1 kg = 2.2046226218 lb.
+  # Preset default: Uses kilograms as the default display unit.
+  # Preset default: Uses 6 storage decimals as a high-precision preset default.
+  # Source: NIST metric and customary conversion guidance: https://www.nist.gov/pml/weights-and-measures/common-conversion-factors-ii
+  Amount.register :ZINC,
+    decimals: 6,
+    display_symbol: "kg",
+    display_position: :suffix,
+    ui_decimals: 3,
+    display_units: {
+      kg:    { scale: 1, symbol: "kg", ui_decimals: 3 },
+      tonne: { scale: "0.001", symbol: "t", ui_decimals: 6 },
+      lb:    { scale: "2.2046226218", symbol: "lb", ui_decimals: 2 }
+    },
+    default_display: :kg

data/lib/generators/amount/active_record/templates/registry.rb.tt

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# Generated by:
+#   rails generate amounts:registry <%= preset_source_label %>
+#
+# Included preset categories: <%= preset_categories.join(", ") %>
+# Registered symbols: <%= registered_symbols.join(", ") %>
+#
+# This generator only seeds type registrations and display metadata.
+# Comments marked "Fact" describe protocol, standards, or conversion details
+# that are intrinsic to the asset or unit definition.
+# Comments marked "Preset default" describe application-facing defaults chosen
+# by this gem for a sensible starting point.
+# Directional default rates are intentionally omitted because conversion policy
+# is application-specific.
+
+require "amount"
+require "amount/active_record"
+
+Rails.application.config.to_prepare do
+  next if Amount.registry.registered?(:<%= registry_guard_symbol %>)
+
+<%= preset_body %>
+
+  # Register directional default rates only when your application has an
+  # explicit conversion policy for the pair in question.
+  #
+  # Example:
+  # Amount.register_default_rate :USD, :USDC, "1"
+  # Amount.register_default_rate :USDC, :USD, "1"
+
+  Amount.registry.lock! if Rails.env.production?
+end

data/test/test_active_record.rb

@@ -245,14 +245,14 @@ class AmountActiveRecordTest < Minitest::Test
     holding = ValidatedHolding.new(amount: "USDC|0.00", reserve: "USDC|1.25")
 
     refute holding.valid?
-    assert_includes holding.errors[:amount], "must be greater than USDC|0.0"
+    assert_includes holding.errors[:amount], "must be greater than USDC|0.00"
   end
 
   def test_amount_validator_rejects_amount_above_upper_bound
     holding = ValidatedHolding.new(amount: "USDC|1000.01", reserve: "USDC|1.25")
 
     refute holding.valid?
-    assert_includes holding.errors[:amount], "must be less than or equal to USDC|1000.0"
+    assert_includes holding.errors[:amount], "must be less than or equal to USDC|1000.00"
   end
 
   def test_amount_validator_allows_nil_when_allow_nil_is_set
@@ -271,14 +271,14 @@ class AmountActiveRecordTest < Minitest::Test
     holding = ValidatedHolding.new(amount: "USDC|100.00", reserve: "USDC|1.25", fee: 0)
 
     refute holding.valid?
-    assert_includes holding.errors[:fee], "must be greater than SOL|0.0"
+    assert_includes holding.errors[:fee], "must be greater than SOL|0.0000"
   end
 
   def test_amount_validator_rejects_fixed_symbol_amount_at_exclusive_upper_bound
     holding = ValidatedHolding.new(amount: "USDC|100.00", reserve: "USDC|1.25", fee: 10)
 
     refute holding.valid?
-    assert_includes holding.errors[:fee], "must be less than SOL|10.0"
+    assert_includes holding.errors[:fee], "must be less than SOL|10.0000"
   end
 
   def test_amount_validator_rejects_cross_type_threshold_without_rate

data/test/test_amount.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "json"
 require_relative "test_helper"
 
 class AmountTest < Minitest::Test
@@ -51,7 +52,7 @@ class AmountTest < Minitest::Test
     amount = Amount.parse("USDC|1.5")
 
     assert_equal 1_500_000, amount.atomic
-    assert_equal "USDC|1.5", amount.to_s
+    assert_equal "USDC|1.50", amount.to_s
   end
 
   def test_parse_accepts_explicit_v1_prefix
@@ -140,7 +141,7 @@ class AmountTest < Minitest::Test
 
     assert_equal "$1.50", amount.ui
     assert_equal "1.500000", amount.formatted
-    assert_equal "USDC|1.5", amount.to_s
+    assert_equal "USDC|1.50", amount.to_s
   end
 
   def test_frozen_amount_arithmetic_returns_unfrozen_result
@@ -207,6 +208,55 @@ class AmountTest < Minitest::Test
     end
   end
 
+  def test_trim_zeros_strips_trailing_zeros
+    Amount.register :TZ, decimals: 9, display_symbol: "TZ", display_position: :suffix, trim_zeros: true
+
+    assert_equal "2.5 TZ", Amount.new("2.5", :TZ).ui
+    assert_equal "1 TZ", Amount.new("1.0", :TZ).ui
+    assert_equal "0 TZ", Amount.new("0.0", :TZ).ui
+    assert_equal "1.123 TZ", Amount.new("1.123", :TZ).ui
+    assert_equal "0.00005 TZ", Amount.new(50_000, :TZ, from: :atomic).ui
+  end
+
+  def test_trim_zeros_false_preserves_trailing_zeros
+    assert_equal "$1.50", Amount.new("1.5", :USDC).ui
+    assert_equal "$1.00", Amount.new("1.0", :USDC).ui
+  end
+
+  def test_trim_zeros_with_decorated_false
+    Amount.register :TZ, decimals: 9, display_symbol: "TZ", display_position: :suffix, trim_zeros: true
+
+    assert_equal "2.5", Amount.new("2.5", :TZ).ui(decorated: false)
+    assert_equal "1", Amount.new("1.0", :TZ).ui(decorated: false)
+  end
+
+  def test_trim_zeros_with_display_units
+    Amount.register :TZG, decimals: 8, display_symbol: "oz t", display_position: :suffix,
+                    trim_zeros: true,
+                    display_units: { gram: { scale: "31.1035", symbol: "g", ui_decimals: 4 } }
+
+    assert_equal "31.1035 g", Amount.new("1.0", :TZG).ui(unit: :gram)
+  end
+
+  def test_trim_zeros_display_unit_override
+    Amount.register :TZO, decimals: 6, display_symbol: "T", display_position: :suffix,
+                    trim_zeros: true,
+                    display_units: { fixed: { scale: 1, symbol: "F", ui_decimals: 2, trim_zeros: false } }
+
+    assert_equal "1.50 F", Amount.new("1.5", :TZO).ui(unit: :fixed)
+  end
+
+  def test_trim_zeros_call_site_override
+    assert_equal "1.5 SOL", Amount.new("1.5", :SOL).ui(trim_zeros: true)
+    assert_equal "1.0000 SOL", Amount.new("1.0", :SOL).ui(trim_zeros: false)
+  end
+
+  def test_trim_zeros_call_site_overrides_registry
+    Amount.register :TZR, decimals: 6, display_symbol: "T", display_position: :suffix, trim_zeros: true
+
+    assert_equal "1.500000 T", Amount.new("1.5", :TZR).ui(trim_zeros: false)
+  end
+
   def test_predicates
     assert Amount.new(0, :USDC).zero?
     assert Amount.new(1, :USDC).positive?
@@ -489,6 +539,19 @@ class AmountTest < Minitest::Test
     assert_match(/missing key/, error.message)
   end
 
+  def test_as_json_returns_compact_string
+    assert_equal "USDC|1.50", Amount.new("1.5", :USDC).as_json
+  end
+
+  def test_to_json_returns_quoted_compact_string
+    assert_equal '"USDC|1.50"', Amount.new("1.5", :USDC).to_json
+  end
+
+  def test_as_json_works_when_nested_in_hash
+    hash = { amount: Amount.new("1.5", :USDC) }
+    assert_equal({ "amount" => "USDC|1.50" }, JSON.parse(hash.to_json))
+  end
+
   def test_load_rejects_unknown_serialization_version
     assert_raises(Amount::InvalidInput) do
       Amount.load(v: 2, atomic: "1500000", symbol: "USDC")

data/test/test_registry_generator.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require_relative "test_helper"
+require "tmpdir"
+require "fileutils"
+require_relative "../lib/amounts"
+require_relative "../lib/generators/amount/active_record/registry_generator"
+require "rails/generators"
+
+class AmountRegistryGeneratorTest < Minitest::Test
+  def setup
+    @destination_root = Dir.mktmpdir("amounts-generator")
+  end
+
+  def teardown
+    FileUtils.remove_entry(@destination_root)
+  end
+
+  def test_generates_fiat_initializer
+    invoke_generator("fiat")
+
+    content = File.read(output_file)
+
+    assert_includes content, 'rails generate amounts:registry fiat'
+    assert_includes content, "# Registry overview:"
+    assert_includes content, "# Major Fiat Currencies:"
+    assert_includes content, "# USD: United States dollar."
+    assert_includes content, "# Fact: Uses 2 decimal places for cents."
+    assert_includes content, "# Preset default: Uses \"$\" as the default display symbol in an English-oriented UI."
+    assert_includes content, "Amount.register :USD"
+    assert_includes content, "Amount.register :JPY"
+    refute_includes content, "Amount.register :BTC"
+  end
+
+  def test_generates_all_initializer_without_duplicate_symbols
+    invoke_generator("all")
+
+    content = File.read(output_file)
+
+    assert_equal 1, content.scan(/^\s*Amount\.register :USD,/).size
+    assert_equal 1, content.scan(/^\s*Amount\.register :USDC,/).size
+    assert_includes content, "Amount.register :GOLD"
+    assert_includes content, "Amount.register :BTC"
+  end
+
+  def test_generates_crypto_initializer_without_stale_polygon_entry
+    invoke_generator("crypto")
+
+    content = File.read(output_file)
+
+    assert_includes content, "# BTC: Bitcoin."
+    assert_includes content, "# Source: Ethereum denomination docs: https://ethereum.org/en/developers/docs/intro-to-ether/"
+    assert_includes content, "Amount.register :USDT"
+    refute_includes content, "Amount.register :MATIC"
+    refute_includes content, "Amount.register :POL"
+  end
+
+  def test_static_preset_files_exist
+    assert File.exist?(preset_file("fiat"))
+    assert File.exist?(preset_file("metals"))
+    assert File.exist?(preset_file("crypto"))
+    assert File.exist?(preset_file("all"))
+  end
+
+  def test_all_static_preset_file_includes_all_major_sections
+    content = File.read(preset_file("all"))
+
+    assert_includes content, "# Major Fiat Currencies:"
+    assert_includes content, "# Precious And Industrial Metals:"
+    assert_includes content, "# Large-Cap Crypto Assets:"
+    assert_includes content, "Amount.register :USD"
+    assert_includes content, "Amount.register :GOLD"
+    assert_includes content, "Amount.register :BTC"
+  end
+
+  def test_rejects_unknown_preset
+    _stdout, stderr = capture_io do
+      invoke_generator("unknown")
+    end
+    assert_includes stderr, "unknown preset"
+  end
+
+  private
+
+  def invoke_generator(preset)
+    Amount::ActiveRecord::RegistryGenerator.start(
+      [preset],
+      destination_root: @destination_root,
+      shell: Thor::Shell::Basic.new
+    )
+  end
+
+  def output_file
+    File.join(@destination_root, "config/initializers/amounts.rb")
+  end
+
+  def preset_file(name)
+    File.join(
+      File.dirname(__FILE__),
+      "..",
+      "lib/generators/amount/active_record/templates/presets/#{name}.fragment"
+    )
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: amounts
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.7
 platform: ruby
 authors:
 - Seb Scholl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-25 00:00:00.000000000 Z
+date: 2026-05-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -39,7 +39,6 @@ files:
 - ".rubocop.yml"
 - CHANGELOG.md
 - Gemfile
-- LICENSE.txt
 - README.md
 - Rakefile
 - bin/console
@@ -50,6 +49,7 @@ files:
 - lib/amount/active_record/attribute_definition.rb
 - 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
@@ -66,27 +66,34 @@ files:
 - lib/amount/rspec/support.rb
 - lib/amount/serialization.rb
 - lib/amount/version.rb
+- lib/amounts.rb
+- lib/generators/amount/active_record/registry_generator.rb
+- lib/generators/amount/active_record/templates/presets/all.fragment
+- lib/generators/amount/active_record/templates/presets/crypto.fragment
+- 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/dummy/app/models/holding.rb
 - test/dummy/bin/rails
 - test/dummy/config/application.rb
 - test/dummy/config/database.yml
 - test/dummy/config/environment.rb
 - test/dummy/db/schema.rb
-- test/dummy/log/development.log
 - test/dummy/log/test.log
 - test/postgresql_integration_test.rb
 - test/support/amount_test_support.rb
 - test/test_active_record.rb
 - test/test_amount.rb
 - test/test_helper.rb
+- test/test_registry_generator.rb
 homepage: https://github.com/zarpay/amounts
 licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/zarpay/amounts/issues
-  changelog_uri: https://github.com/zarpay/amounts/blob/main/CHANGELOG.md
-  documentation_uri: https://github.com/zarpay/amounts#readme
-  source_code_uri: https://github.com/zarpay/amounts
+  changelog_uri: https://github.com/zarpay/amounts/blob/main/gem/CHANGELOG.md
+  documentation_uri: https://github.com/zarpay/amounts/tree/main/gem#readme
+  source_code_uri: https://github.com/zarpay/amounts/tree/main/gem
 post_install_message:
 rdoc_options: []
 require_paths:

data/LICENSE.txt

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Seb Scholl
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.