human_number 0.1.8 → 0.1.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42fe66194bf6870029efef196173647a511774b68b13faee24f237d665972722
-  data.tar.gz: bceac8e6a9b6ff97f8737c72068b0e2e98f11c2525dc0572c42218376e0389dc
+  metadata.gz: 25a997b6244948ebded5aa57455a54c930b8ea0f6255e17f620a315e578d0b58
+  data.tar.gz: 5ee0a391c1875a6cde5843535949a7995d87ccbc179ffd7734f315e0292f5c98
 SHA512:
-  metadata.gz: d39a9b87d7e0f1a8e7bcecbf7184931bfb35c48047992772a2635aeac8079cbaeb31a766e3443afa789b4fb9f45a1a69abe194ab0f309098c43e6860b384d052
-  data.tar.gz: ea2765ffb9962d98ec8fcd52db74a877edf20cbaa0dae1903c6d8d6edc748016160695734f0f52ca4279a16e65aae3fa235bcce28ec776376440d736fda709cc
+  metadata.gz: d566ce576fbf747a5db5263a4ed8fbe84e20ea11d96d51da4217e80ba9c0046eaa1f4e5b4a0e87494be49444e57ed1f5823354050a28edae15c25403ffbc889a
+  data.tar.gz: 0e2e0b57bba47bcd184990bd3988b4121abc8297246bd8f8a21fb53c32dbb17a3d39d2547c0dd4f7ea202c543265878698e39b918f4e84c1b2465a98089e1bb5

data/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.10] - 2025-08-19
+
+### Changed
+
+- **BREAKING CHANGE: Default number formatting behavior**: Changed `max_digits` default value from `2` to `nil`
+  - Numbers now display complete breakdown by default (e.g., `"1M 234K 567"` instead of `"1.2M"`)
+  - Previous abbreviated behavior still available by explicitly setting `max_digits: 2`
+  - Affects all methods: `HumanNumber.human_number()`, `HumanNumber.human_currency()`, and Rails helpers
+  - Provides safer default behavior with no information loss
+  - Maintains backward compatibility for explicit `max_digits` parameter usage
+
+## [0.1.9] - 2025-08-05
+
+### Changed
+- **East Asian separator formatting**: Japanese numbers now use culturally appropriate spacing
+  - Japanese: `'12億3456万7890円'` (no spaces between units)
+  - Korean/Chinese: `'12억 3456만 7890원'` (spaces maintained as default)
+- **Locale-based separator configuration**: Added `number.human.decimal_units.separator` for customizable unit separators
+
 ## [0.1.8] - 2025-08-05
 
 ### Fixed
@@ -102,5 +121,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Formatters::Currency**: Currency symbol and format string application
 - **Clean separation**: Number formatting independent of currency concerns
 
+[0.1.10]: https://github.com/ether-moon/human_number/releases/tag/v0.1.10
+[0.1.9]: https://github.com/ether-moon/human_number/releases/tag/v0.1.9
 [0.1.8]: https://github.com/ether-moon/human_number/releases/tag/v0.1.8
 [0.1.0]: https://github.com/ether-moon/human_number/releases/tag/v0.1.0

data/README.md

@@ -158,9 +158,14 @@ HumanNumber.human_number(1_000_000_000, locale: :en) #=> "1B"
 HumanNumber.human_number(1_234_567, locale: :ko) #=> "120만"  
 HumanNumber.human_number(1_234_567, locale: :ja) #=> "120万"
 HumanNumber.human_number(100_000_000, locale: :ko) #=> "1억"
+
+# Complete mode shows cultural spacing differences
+HumanNumber.human_number(12_345_678, locale: :ko, max_digits: nil) #=> "1234만 5678"  # Korean: spaces
+HumanNumber.human_number(12_345_678, locale: :ja, max_digits: nil) #=> "1234万5678"   # Japanese: no spaces
 ```
 
-**Units:** 만/万 (ten thousand), 억/億 (hundred million), 조/兆 (trillion)
+**Units:** 만/万 (ten thousand), 억/億 (hundred million), 조/兆 (trillion)  
+**Cultural spacing:** Japanese uses no spaces between units, Korean/Chinese use spaces (configurable via locale files)
 
 ### Indian System (lakh/crore)
 **Used by:** Hindi (hi), Urdu (ur), Bengali (bn), Indian English (en-IN)

data/lib/human_number/formatters/number.rb

@@ -74,7 +74,7 @@ module HumanNumber
         def default_options
           {
             abbr_units: true,
-            max_digits: 2,
+            max_digits: nil,
             min_unit: nil,
             trim_zeros: true,
           }.freeze
@@ -419,6 +419,11 @@ module HumanNumber
         ].freeze
 
         class << self
+          def format_number(number, locale:, abbr_units: true, min_unit: nil, max_digits: 2, trim_zeros: true)
+            @current_locale = locale.to_sym
+            super
+          end
+
           private
 
           def unit_definitions
@@ -437,6 +442,18 @@ module HumanNumber
           def apply_symbol_formatting_rules(symbol, _abbr_units)
             symbol
           end
+
+          # Apply culturally appropriate separators for East Asian languages
+          def finalize_result(number, formatted_parts)
+            separator = lookup_decimal_separator(@current_locale)
+            combined_result = formatted_parts.join(separator)
+            number.negative? ? "-#{combined_result}" : combined_result
+          end
+
+          # Look up separator from locale file, default to space
+          def lookup_decimal_separator(locale)
+            I18n.t("#{I18N_DECIMAL_UNITS_KEY}.separator", locale: locale, default: SPACE_SEPARATOR)
+          end
         end
       end
 

data/lib/human_number/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HumanNumber
-  VERSION = "0.1.8"
+  VERSION = "0.1.10"
 end

data/lib/locales/ja.yml

@@ -8,6 +8,7 @@ ja:
         unit: "¥"
     human:
       decimal_units:
+        separator: ""
         abbr_units:
           thousand: "千"
           ten_thousand: "万"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: human_number
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.10
 platform: ruby
 authors:
 - Ether Moon