splittable 0.0.8 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37c4759b10b00ca1cf91aabb5e0b7611a6557f4a626e45b6ba8849b4756d6085
-  data.tar.gz: 1afade43018d247600cbb00b360b2f0e5e859358eb84fb0a00da9d2a6bf109a3
+  metadata.gz: 11114efe2ce13eb5f799082f87b27b9031d61c88dc4bbf15429bbb96c5038a62
+  data.tar.gz: 214bcc97eb502853d46db7e0b2678570269b6226658cf3c11df921607372fc75
 SHA512:
-  metadata.gz: 6c7a5a283d57fc378864f8aa22236a6b58c590cb4218a6ff62783248e8052817a27ffd4d81d0812d0ec64699f6ddbb0addeda1fdbba82ecb8f1e1684786a1ac7
-  data.tar.gz: 0f10c22baa3d728be34ccd1a01b91901cae23ff32857255d4f66c7ed3ed3bf50988ca2ecb807b7c3f6d9a93c92e5e550ede3017a94e0e7365578ea11a7de8f04
+  metadata.gz: 3b47c45ce0f0078632eef4fd3ca2914c17398d75c1e5691d344db08bc9b81a165abe6165763861819e090ffdf264ac0aaf6d5cee9415649d28fbd7f67e7e02e7
+  data.tar.gz: 7d4722cc082db9dcb8d450f7fdd876f71842ee61ea8f3ec7716a695cef935ec15b08c09c6473c2f95894f467e14902045069ff5549b5ccd1d8a19352e628cee5

data/CHANGELOG.md

@@ -1,4 +1,30 @@
-# splittable 0.0.8 (Oct 14, 2025)
+# splittable 0.0.9 (Oct 15, 2025)
+
+* **Bug Fixes**
+  * Fixed incorrect examples in README.md with mathematically accurate values
+  * Corrected division examples to show proper cent adjustment behavior
+  * Fixed normalize examples to demonstrate actual gem behavior
+
+* **Error Handling Improvements**
+  * Added proper validation for empty installments array in normalize method
+  * Added validation for nil installments parameter
+  * Improved error messages with clear ArgumentError exceptions
+  * Enhanced error handling documentation with accurate examples
+
+* **Test Coverage**
+  * Added comprehensive tests for error handling scenarios
+  * Added tests for empty and nil installments arrays
+  * Maintained 100% test coverage (38 examples, 0 failures)
+  * Improved test readability with better formatting
+
+* **Code Quality**
+  * Enhanced input validation in Splittable::Normalize class
+  * Improved error messages for better developer experience
+  * All existing functionality preserved and thoroughly tested
+
+  *Marcelo Toledo*
+
+## splittable 0.0.8 (Oct 14, 2025)
 
 * **Documentation Improvements**
   * Complete README.md rewrite with better examples and real-world use cases

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    splittable (0.0.8)
+    splittable (0.0.9)
       bigdecimal (~> 3.0)
 
 GEM

data/README.md

@@ -52,7 +52,7 @@ Split a total value into equal installments:
 ```ruby
 # Basic usage - split $0.12 into 3 equal parts
 Splittable.division(value: 0.12, quantity: 3)
-# => [0.05, 0.03, 0.03]  # Sum: 0.11 (truncated from 0.12)
+# => [0.04, 0.04, 0.04]  # Sum: 0.12
 
 # Custom precision - 3 decimal places
 Splittable.division(value: 10, quantity: 3, precision: 3)
@@ -79,7 +79,7 @@ Splittable.normalize(value: 100, installments: [33.333, 33.333, 33.333], precisi
 ```ruby
 # Split a $99.99 order into 3 monthly payments
 payments = Splittable.division(value: 99.99, quantity: 3)
-# => [33.34, 33.33, 33.33]
+# => [33.33, 33.33, 33.33]
 # Total: $99.99 ✅
 ```
 
@@ -89,17 +89,17 @@ payments = Splittable.division(value: 99.99, quantity: 3)
 departments = ['Sales', 'Marketing', 'Support']
 amounts = [400.00, 350.00, 250.00]
 
-normalized = Splittable.normalize(value: 1000.00, installments: amounts)
+normalized = Splittable.normalize(value: 1000.01, installments: amounts)
 # => [400.01, 350.00, 250.00]
-# Total: $1,000.00 ✅
+# Total: $1,000.01 ✅
 ```
 
 ### Subscription Billing
 ```ruby
 # Annual subscription split into monthly payments
-monthly_payment = Splittable.division(value: 120.00, quantity: 12)
+monthly_payment = Splittable.division(value: 120.01, quantity: 12)
 # => [10.01, 10.00, 10.00, 10.00, 10.00, 10.00, 10.00, 10.00, 10.00, 10.00, 10.00, 10.00]
-# Total: $120.00 ✅
+# Total: $120.01 ✅
 ```
 
 ## ⚠️ Error Handling
@@ -111,7 +111,11 @@ Splittable.division(value: 100, quantity: 0)
 
 # Empty installments array
 Splittable.normalize(value: 100, installments: [])
-# => NoMethodError: undefined method `[]' for nil:NilClass
+# => ArgumentError: installments should be a non-empty array
+
+# Nil installments
+Splittable.normalize(value: 100, installments: nil)
+# => ArgumentError: installments should be a non-empty array
 ```
 
 ## 🛠️ Development

data/lib/splittable/normalize.rb

@@ -2,6 +2,7 @@
 
 class Splittable::Normalize
   def initialize(value:, installments:, precision: 2)
+    check_installments_validity!(installments)
     @value = BigDecimal(value, 15).truncate(precision)
     @installments = installments.map { |installment| BigDecimal(installment.round(precision), 15) }
   end
@@ -17,4 +18,10 @@ class Splittable::Normalize
 
   attr_reader :value
   attr_accessor :installments
+
+  def check_installments_validity!(installments)
+    return if installments.is_a?(Array) && !installments.empty?
+
+    raise ArgumentError, 'installments should be a non-empty array'
+  end
 end

data/lib/splittable/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Splittable
-  VERSION = '0.0.8'
+  VERSION = '0.0.9'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: splittable
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors:
 - Arthur Brandão