BIRDS-327: Add dollars_to_cents formatter

CHANGELOG.md

@@ -4,6 +4,10 @@ Inspired by [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 Note: This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.3.0] - 2026-02-24
+### Added
+- Added `dollars_to_cents` formatter, which converts a dollar amount (provided as a string or numeric value) to an integer representing the equivalent amount in cents. For example, "12.34" would be converted to 1234.
+
 ## [3.2.0] - 2026-02-19
 ### Added
 - Added `find_all_tokens` method that recursively collects all substitution parameter names, including those nested inside method call arguments.

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    parameter_substitution (3.2.0)
+    parameter_substitution (3.3.0)
       activesupport (>= 6.0)
       builder (~> 3.2)
       invoca-utils (~> 0.3)
@@ -22,7 +22,7 @@
       tzinfo (~> 2.0)
     appraisal (2.5.0)
       bundler
       rake
       thor (>= 0.14.0)
     appraisal-matrix (0.2.0)
       appraisal (~> 2.2)

lib/parameter_substitution/formatters/dollars_to_cents.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+class ParameterSubstitution::Formatters::DollarsToCents < ParameterSubstitution::Formatters::Base
+  def self.description
+    "Converts a dollar amount to cents as an integer"
+  end
+
+  def self.format(value)
+    (Float(value) * 100).round.to_i rescue nil
+  end
+end

lib/parameter_substitution/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class ParameterSubstitution
-  VERSION = "3.2.0"
+  VERSION = "3.3.0"
 end

spec/lib/parameter_substitution/formatters/dollars_to_cents_spec.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require_relative '../../../../lib/parameter_substitution/formatters/dollars_to_cents'
+
+describe ParameterSubstitution::Formatters::DollarsToCents do
+  context "DollarsToCents formatter test" do
+    before do
+      @format_class = ParameterSubstitution::Formatters::DollarsToCents
+    end
+
+    it "have a key" do
+      expect(@format_class.key).to eq("dollars_to_cents")
+    end
+
+    it "provide a description" do
+      expect(@format_class.description).to eq("Converts a dollar amount to cents as an integer")
+    end
+
+    it "converts valid string dollar amounts to cents" do
+      expect(@format_class.format("10.50")).to eq(1050)
+      expect(@format_class.format("10")).to eq(1000)
+      expect(@format_class.format("0.01")).to eq(1)
+      expect(@format_class.format("123.456")).to eq(12346)
+      expect(@format_class.format("0.001")).to eq(0)
+      expect(@format_class.format("100")).to eq(10000)
+      expect(@format_class.format("99.99")).to eq(9999)
+      expect(@format_class.format("-10.50")).to eq(-1050)
+    end
+
+    it "converts valid numeric dollar amounts to cents" do
+      expect(@format_class.format(10.50)).to eq(1050)
+      expect(@format_class.format(10)).to eq(1000)
+      expect(@format_class.format(0.01)).to eq(1)
+      expect(@format_class.format(123.456)).to eq(12346)
+      expect(@format_class.format(0.001)).to eq(0)
+      expect(@format_class.format(100)).to eq(10000)
+      expect(@format_class.format(99.99)).to eq(9999)
+      expect(@format_class.format(-10.50)).to eq(-1050)
+    end
+
+    it "returns nil for nil or invalid strings" do
+      expect(@format_class.format(nil)).to eq(nil)
+      expect(@format_class.format("")).to eq(nil)
+      expect(@format_class.format("$10.50")).to eq(nil)
+      expect(@format_class.format("not_a_number")).to eq(nil)
+    end
+  end
+end