philiprehberger-csv_kit 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c48c099081a08bc9be83c75fb8879f9cb876ce2cc6e8978a44b8c18d3cd43776
-  data.tar.gz: fe72a612c3a6e5b0166c5eb24694f5593cbb0baca3eb541081dc84414939019b
+  metadata.gz: 85d915adb35a580821d1055d966fe76b802598d6422571ad1e727694dd604a4f
+  data.tar.gz: 66cc520a86bae535668b77aa56ae7d154ddc1f5df22cca7b4578d4b12a7958e8
 SHA512:
-  metadata.gz: bfff72e557a3deef83f104118ec4dddf00e5855b2d29ea1ac09a023f767a3b557f7415a9b8fd953ddca68a5cc08155b4b37b14a1800b3f2672db059b1a8a02da
-  data.tar.gz: a2bd950d995457677e70c2398efb4decb742597bc032e5f0f0454ac5a9025d4a41c2d05f4bcf18988f506c46ffdd0b20b354b7620748587c3de7e32da75387d7
+  metadata.gz: 0b719464ccea551cb56975fe78985ffa2f49480f2439e9a528f091afa53b5b24dd55219dbab3e65a8f30ec1f326959749ad4162e52d36471b1ee3bfd1272afcd
+  data.tar.gz: 7f98968c2c5063109053f2a4a8f4508f6544e5238f783440969f237f593b66f4ac2a2ace4e6b495862621944fe891c44107a247366d3c1cedd59be6208a88df9

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-04-19
+
+### Added
+- `Processor#default(key, value)` — fill nil or empty cells at `key` with a default value during transform; chains naturally with `type:` coercion
+
 ## [0.8.0] - 2026-04-17
 
 ### Added
@@ -107,7 +112,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Type coercion and row validation
 - Quick load and filtering convenience methods
 
-[Unreleased]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.8.0...HEAD
+[Unreleased]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.9.0...HEAD
+[0.9.0]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.8.0...v0.9.0
 [0.8.0]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.7.0...v0.8.0
 [0.7.0]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.5.0...v0.6.0

data/README.md

@@ -106,6 +106,17 @@ rows = Philiprehberger::CsvKit.process("data.csv") do |p|
 end
 ```
 
+### Default Values for Missing Cells
+
+Fill nil or empty-string cells with a default value before any `type` coercion runs:
+
+```ruby
+Philiprehberger::CsvKit.process("users.csv") do |p|
+  p.default(:country, "US")
+  p.type(:age, :integer)
+end
+```
+
 ### Date/Time Type Coercions
 
 ```ruby
@@ -211,6 +222,7 @@ delimiter = Philiprehberger::CsvKit::Detector.detect("data.tsv")
 | `Processor#headers(*names)` | Override header names |
 | `Processor#transform(key, &block)` | Register column transform |
 | `Processor#type(key, type, **opts)` | Register built-in type coercion (:integer, :float, :string, :date, :datetime) |
+| `Processor#default(key, value)` | Fill nil or empty cells at `key` with `value` (runs before `type` coercion) |
 | `Processor#validate(key, &block)` | Register column validation (skip invalid) |
 | `Processor#skip(n)` | Skip the first N data rows |
 | `Processor#limit(n)` | Stop after processing N rows |

data/lib/philiprehberger/csv_kit/processor.rb

@@ -31,6 +31,7 @@ module Philiprehberger
         @path_or_io = path_or_io
         @dialect = dialect ? Dialect.new(dialect) : nil
         @transforms = {}
+        @defaults = {}
         @validations = {}
         @reject_block = nil
         @each_block = nil
@@ -63,6 +64,22 @@ module Philiprehberger
         @transforms[key] = ->(v) { coercion.call(v, opts) }
       end
 
+      # Register a default value for a column.
+      #
+      # Cells where the value is `nil` or an empty string are replaced with
+      # the provided default during transform. Defaults run BEFORE `type`
+      # coercions and `transform` blocks, so callers can default a missing
+      # cell to a string and then coerce it (e.g. default to "0" then cast
+      # to :integer).
+      #
+      # @param key [Symbol] column name
+      # @param value [Object] value to use when the cell is nil or empty
+      # @return [self]
+      def default(key, value)
+        @defaults[key] = value
+        self
+      end
+
       # Register a validation for a specific column.
       def validate(key, &block)
         @validations[key] = block
@@ -122,6 +139,7 @@ module Philiprehberger
         return unless valid?(row)
         return if rejected?(row)
 
+        apply_defaults!(row)
         apply_transforms!(row)
         apply_renames!(row)
         @each_block&.call(row)
@@ -165,6 +183,13 @@ module Philiprehberger
         @reject_block&.call(row) || false
       end
 
+      def apply_defaults!(row)
+        @defaults.each do |key, value|
+          current = row[key]
+          row[key] = value if current.nil? || current.to_s.empty?
+        end
+      end
+
       def apply_transforms!(row)
         @transforms.each { |key, blk| row[key] = blk.call(row[key]) }
       end

data/lib/philiprehberger/csv_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module CsvKit
-    VERSION = '0.8.0'
+    VERSION = '0.9.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-csv_kit
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-17 00:00:00.000000000 Z
+date: 2026-04-20 00:00:00.000000000 Z
 dependencies: []
 description: Streaming CSV processor with row-by-row transforms, validations, column
   plucking, streaming each_hash iteration, filtering, writing, error recovery, and