smarter_csv 1.16.1 → 1.16.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 043745aedb1c63fd4a044b9ae46bb8e5d98324c14e609214ee3d895acfd5f501
-  data.tar.gz: c39a10521b767daf51887278c9020c9ff6d8d93c32c5ec3f95a17ec575ebdab5
+  metadata.gz: b40fb76fef88599d7449691806af6f76a131ffcd41e2ee145d5c87f3554a2006
+  data.tar.gz: edb27057973c0a88524579f450dc8ed3ffadbd983de7155a84ff159495c31233
 SHA512:
-  metadata.gz: 5f1d125138443f02e0276e964dac9e584b996de6acafe8b3856316852a38220094e69a2c14302f922bcc93b6d23cc594bbf926940ccd70a2bd65ab08c5a18b49
-  data.tar.gz: '0929051996781c8643c0239556d123c840e7041d9c12f7d867e3800dfb2c2eb92e6f6fb77b5fc08660a36f34f470cb826f255943fa445d3e29d231e648da51b4'
+  metadata.gz: 5b9e2a17ae14a5d7b3dfddd854148f38c8892d67544b51fecba888aa11c540096057460880564b89251194fea513c3e2807c500d93f896826db885daf64271fe
+  data.tar.gz: 90b5aa10c6bc36cbc97662de879deaf61c2417a61e4cb5171924aac991a37c762588ff6413a924bfd083ca10c1fa1739049561f3c6e9de6ff196bdba85c7878f

data/CHANGELOG.md

@@ -1,6 +1,36 @@
 
 # SmarterCSV 1.x Change Log
 
+## 1.16.3 (2026-04-14) — New Feature
+
+RSpec tests: **1,425 → 1,434** (+9 tests)
+
+### New Features
+
+* **`write_headers: false`** — new `SmarterCSV::Writer` option to suppress the header line when appending rows to an existing CSV file opened in `'a'` mode.
+  Defaults to `true` (existing behavior, fully backwards-compatible).
+  
+  See [Appending to an Existing CSV File](docs/basic_write_api.md#appending-to-an-existing-csv-file).
+
+### Other
+* Refactor of internal options handling
+
+## 1.16.2 (2026-03-30) — Bug Fixes
+
+RSpec tests: **1,410 → 1,425** (+15 tests)
+
+### Bug Fixes
+
+* Fixed `value_converters` to accept lambdas and Procs in addition to class-based converters.
+  Thanks to [Jonas Staškevičius](https://github.com/pirminis) for issue [#329](https://github.com/tilo/smarter_csv/issues/329).
+
+* Fixed blank header auto-naming to use **absolute column position**, consistent with extra data column naming.
+  `name,,` now produces `column_2`/`column_3` instead of `column_1`/`column_2`.
+  ⚠️ If your code references auto-generated keys for blank headers, update those to use the absolute column position.
+
+* Fixed `Writer`: when both `map_headers:` and `header_converter:` were used together, `map_headers` was silently ignored.
+  `map_headers` is now applied first, then `header_converter` on top.
+
 ## 1.16.1 (2026-03-16) — Bug Fixes & New Features
 
 RSpec tests: **1,247 → 1,410** (+163 tests)
@@ -101,7 +131,6 @@ Measured on 19 benchmark files, Apple M1, Ruby 3.4.7. See [benchmarks](docs/rele
  * `remove_values_matching:` → use `nil_values_matching:`
  * `strict:` → use `missing_headers: :raise/:auto`
  * `verbose: true/false` → use `verbose: :debug/:normal`
- * `only_headers:` / `except_headers:` → use `headers: { only: }` / `headers: { except: }`
 
 ### Bug Fixes
 

data/CONTRIBUTORS.md

@@ -1,4 +1,4 @@
-# A Big Thank You to all 61 Contributors!!
+# A Big Thank You to all 63 Contributors!!
 
 
 A Big Thank you to everyone who filed issues, sent comments, and who contributed with pull requests:
@@ -65,3 +65,4 @@ A Big Thank you to everyone who filed issues, sent comments, and who contributed
  * [Tophe](https://github.com/tophe)
  * [Dom Lebron](https://github.com/biglebronski)
  * [Paho Lurie-Gregg](https://github.com/paholg)
+ * [Jonas Staškevičius](https://github.com/pirminis)

data/README.md

@@ -249,7 +249,7 @@ For reporting issues, please:
   * open a pull-request adding a test that demonstrates the issue
   * mention your version of SmarterCSV, Ruby, Rails
 
-# [A Special Thanks to all 62 Contributors!](CONTRIBUTORS.md) 🎉🎉🎉
+# [A Special Thanks to all 63 Contributors!](CONTRIBUTORS.md) 🎉🎉🎉
 
 
 ## Contributing

data/docs/basic_write_api.md

@@ -568,6 +568,54 @@ end
 > **Note:** Only use `write_bom: true` with UTF-8 output. Adding a UTF-8 BOM to a
 > non-UTF-8 file will corrupt it.
 
+## Appending to an Existing CSV File
+
+Use `write_headers: false` to suppress the header line when appending rows to an
+existing CSV file. The caller is responsible for opening the file in append mode — the
+Writer writes only what you ask it to write.
+
+```ruby
+# First write: create the file with header + first batch of rows
+SmarterCSV.generate('output.csv') do |csv|
+  csv << { name: 'Alice', age: 30 }
+end
+# output.csv:
+# name,age
+# Alice,30
+
+# Later: append more rows without repeating the header
+File.open('output.csv', 'a') do |f|
+  SmarterCSV.generate(f, write_headers: false) do |csv|
+    csv << { name: 'Bob', age: 25 }
+  end
+end
+# output.csv:
+# name,age
+# Alice,30
+# Bob,25
+```
+
+The Writer still uses the hash keys to determine column order, so the appended rows
+will be aligned correctly as long as the same set of keys is used. If you need to
+guarantee column order across both writes, pass `headers:` explicitly:
+
+```ruby
+HEADERS = %i[name age]
+
+SmarterCSV.generate('output.csv', headers: HEADERS) do |csv|
+  csv << { name: 'Alice', age: 30 }
+end
+
+File.open('output.csv', 'a') do |f|
+  SmarterCSV.generate(f, headers: HEADERS, write_headers: false) do |csv|
+    csv << { name: 'Bob', age: 25 }
+  end
+end
+```
+
+> **Note:** `write_headers: false` only suppresses the header line. All other
+> options (`col_sep:`, `row_sep:`, `value_converters:`, etc.) apply as normal.
+
 ## More Examples
 
 Check out the [RSpec tests](../spec/smarter_csv/writer_spec.rb) for more examples.

data/docs/options.md

@@ -45,6 +45,7 @@
 | `:write_nil_value` | `''` | String written in place of `nil` field values. E.g. `write_nil_value: 'N/A'`. |
 | `:write_empty_value` | `''` | String written in place of empty-string field values, including missing keys. E.g. `write_empty_value: 'EMPTY'`. |
 | `:write_bom` | `false` | Prepends a UTF-8 BOM (`\xEF\xBB\xBF`) to the output. Use with `encoding: 'UTF-8'` for Excel compatibility. |
+| `:write_headers` | `true` | When `false`, suppresses the header line entirely. Use when appending rows to an existing CSV file (open the file in `'a'` mode yourself and pass the IO object). |
 
 
 ## CSV Reading
@@ -119,7 +120,7 @@ See [Parsing Strategy](./parsing_strategy.md) for full details on quote handling
 |--------|---------|-------------|
 | `:strip_whitespace` | `true` | Remove whitespace before/after values and headers. |
 | `:convert_values_to_numeric` | `true` | Convert strings containing integers or floats to the appropriate numeric type. Accepts `{except: [:key1, :key2]}` or `{only: :key3}` to limit which columns. |
-| `:value_converters` | `nil` | Hash of `:header => ClassName`; each class must implement `self.convert(value)`. See [Value Converters](./value_converters.md). |
+| `:value_converters` | `nil` | Hash of `:header => converter`; converter can be a lambda/Proc or a class implementing `self.convert(value)`. See [Value Converters](./value_converters.md). |
 | `:remove_empty_values` | `true` | Remove key/value pairs where the value is `nil` or an empty string. |
 | `:remove_zero_values` | `false` | Remove key/value pairs where the numeric value equals zero. |
 | `:nil_values_matching` | `nil` | Set matching values to `nil`. Accepts a regular expression matched against the string representation of each value (e.g. `/\ANAN\z/` for NaN, `/\A#VALUE!\z/` for Excel errors). With `remove_empty_values: true` (default), nil-ified values are then removed. With `remove_empty_values: false`, the key is retained with a `nil` value. |

data/docs/releases/1.16.0/changes.md

@@ -195,8 +195,6 @@ See [performance_notes.md](performance_notes.md) and [benchmarks.md](benchmarks.
 
 **Deprecations:**
 
-- `only_headers:` → use `headers: { only: }`
-- `except_headers:` → use `headers: { except: }`
 - `remove_values_matching:` → use `nil_values_matching:`
 - `strict: true` → use `missing_headers: :raise`
 - `strict: false` → use `missing_headers: :auto`