teak_util 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ed306a1c0d8b1bd16fad11431b1d0ed8506ff01fbb536c5db9e1562ec12c096
-  data.tar.gz: 83ee0167f13ab63f51588a63f2f60246bde93032ad6798f8a78b29c0c7872470
+  metadata.gz: 0023eb85ea20bc79474e541424ce8b3fef9a1977d0604e78989b9a6a99ee712c
+  data.tar.gz: a8e891a6bc814694f72ddeba1bae0eb98168a91752e6a19462eb77180dc60947
 SHA512:
-  metadata.gz: 2b6d30e4e71b5a4b386ea1a6327df0ae877b4c1975d3976e912d37e05b5a4a23c0222a0c5a892c9feb6e6d189a049e6d12da228fe4a23cd9bc634a8c6e576d3e
-  data.tar.gz: 558b5223f4600b4e9405f545c8aea2de3c373c6cb4266546f8cd72beb6c44d238e4419df21b171c0caaae468e1b57758aaa2934db967a95c20d3b368deaf03a6
+  metadata.gz: d768f5de6e1f4d97b1446c4ccdff31b19f28ae1e4f31e7ea717065e84a22a277c1598803b3040753af9b3d06d207f75276437fea996feefe60816a01ce321c1d
+  data.tar.gz: 1bb68a45ec634666aff5aca0b0736e91b4e94f3819b0ccef9606249b711f34500f5a76b392f83195f11812607c214f709dd724f5923c089fa9f9c8d9f7d7f966

data/.gitignore

@@ -9,3 +9,5 @@
 
 # rspec failure tracking
 .rspec_status
+
+.claude/settings.local.json

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 0.4.0
+
+ENHANCEMENTS:
+
+* Added TeakUtil::DecimalJson (`wire` / `dump`) to write BigDecimal as an exact, bare
+  plain-notation JSON number through JSON.generate, ActiveSupport and Oj (compat).
+  Whole values become integers; NaN and Infinity raise.
+
 ## 0.3.0
 
 ENHANCEMENTS:

data/Gemfile

@@ -15,3 +15,4 @@ gem 'simplecov', '~> 0.22.0'
 gem 'rspec_junit_formatter'
 
 gem "nokogiri", "~> 1.18"
+gem "oj", "~> 3.16"

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    teak_util (0.3.0)
+    teak_util (0.4.0)
       aws-sdk-s3 (>= 1.102)
+      bigdecimal
       business_flow (>= 0.18.0)
       mime-types (>= 3)
       rubyzip (>= 2.3, < 4.0)
@@ -68,6 +69,8 @@ GEM
     nokogiri (1.18.10)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
+    oj (3.17.8)
+      bigdecimal (>= 3.0)
     racc (1.8.1)
     rake (13.3.0)
     rspec (3.13.1)
@@ -103,6 +106,7 @@ PLATFORMS
 
 DEPENDENCIES
   nokogiri (~> 1.18)
+  oj (~> 3.16)
   rake (~> 13.0)
   rspec (~> 3.0)
   rspec_junit_formatter

data/README.md

@@ -30,6 +30,14 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+### Worktrees
+
+`script/worktree` defaults to a path sibling to this checkout. This repo's main
+checkout doesn't live under `services/`, so pass an explicit path under
+`services/` when creating a worktree — `services/.claude/rules/` (gates,
+shared-trees, stating-evidence) only loads by walking up from there, and the
+default path lands outside it.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/teak_util.

data/lib/teak_util/decimal_json.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'bigdecimal'
+require 'json'
+
+module TeakUtil
+  # Writes BigDecimal as an exact, bare JSON number. ActiveSupport and Oj (compat) both
+  # encode a BigDecimal as a quoted string, and Float isn't exact at nine decimal places
+  # next to a large integer part, so nothing in here goes through Float.
+  #
+  #   TeakUtil::DecimalJson.dump({ 'qty' => BigDecimal('0.000000001') })
+  #   # => '{"qty":0.000000001}'
+  #
+  # Whole values become Integers, so 5 and 5.0 sign and serialize identically. Fractional
+  # values become a Fractional, which JSON.generate, ActiveSupport's to_json and Oj
+  # (compat, use_to_json) all write as plain-notation digits, never "0.123e18" or quoted.
+  module DecimalJson
+    # A fractional decimal that every JSON encoder in the stack writes as a bare number.
+    # `as_json` returns self so ActiveSupport's recursive `as_json` leaves it alone, and
+    # `to_json` is what the JSON gem and Oj (compat) call to emit the raw digits.
+    # JSON output only: use the BigDecimal (`decimal`) for anything else.
+    class Fractional < Numeric
+      attr_reader :decimal
+
+      def initialize(decimal)
+        super()
+        @decimal = decimal
+      end
+
+      def to_s(*)
+        @decimal.to_s('F')
+      end
+
+      def to_json(*)
+        to_s
+      end
+
+      def as_json(*)
+        self
+      end
+    end
+
+    # Returns a copy of the Hash/Array tree with every BigDecimal replaced by something
+    # the encoders write as a bare number. Hash keys and non-BigDecimal values are left
+    # alone. Raises ArgumentError for NaN and Infinity, which have no JSON form.
+    def self.wire(value)
+      case value
+      when BigDecimal then wire_decimal(value)
+      when Hash then value.transform_values { |v| wire(v) }
+      when Array then value.map { |v| wire(v) }
+      else value
+      end
+    end
+
+    # JSON text for the tree, with BigDecimal values written as bare numbers.
+    def self.dump(value)
+      JSON.generate(wire(value))
+    end
+
+    def self.wire_decimal(decimal)
+      raise ArgumentError, "Decimal must be finite, got #{decimal}" unless decimal.finite?
+
+      decimal.frac.zero? ? decimal.to_i : Fractional.new(decimal)
+    end
+    private_class_method :wire_decimal
+  end
+end

data/lib/teak_util/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TeakUtil
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/teak_util.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "teak_util/version"
+require_relative "teak_util/decimal_json"
 
 module TeakUtil
   class Error < StandardError; end

data/teak_util.gemspec

@@ -23,13 +23,14 @@ Gem::Specification.new do |spec|
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features|\.claude|script)/}) }
   end
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
   spec.add_dependency "aws-sdk-s3", ">= 1.102"
+  spec.add_dependency "bigdecimal"
   spec.add_dependency "business_flow", ">= 0.18.0"
   spec.add_dependency "mime-types", ">= 3"
   spec.add_dependency "rubyzip", ">= 2.3", "< 4.0"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: teak_util
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Alex Scarborough
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.102'
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: business_flow
   requirement: !ruby/object:Gem::Requirement
@@ -92,6 +106,7 @@ files:
 - bin/console
 - bin/setup
 - lib/teak_util.rb
+- lib/teak_util/decimal_json.rb
 - lib/teak_util/storage/make_externally_available_file.rb
 - lib/teak_util/storage/s3.rb
 - lib/teak_util/test_database_name.rb