smarter_csv 1.14.1 → 1.14.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c4619533008fc05b02a009b1409d1368d56245584baf52134511b45ff505f011
-  data.tar.gz: 051fa13106a0dfe41486accfee972a07c7d80670a65dd1066f07dfc600489be3
+  metadata.gz: 4b6c0ad6a61721dac33f4ef31cf34da3cdd221804aaa45ff8e49cf7b5894b539
+  data.tar.gz: 8c1307aa7a74fc4f434eec362519dcb4392774aa35f563fc2674d542f6b4ea62
 SHA512:
-  metadata.gz: 5ee274a0a485e87f356940eeaf5e68d6af3d83dd72cd5199eca9729f6c760d0528ac2db8931c2d741521edb69251a4ff3d0c4d458f449a824f2b8110e7ad3a51
-  data.tar.gz: 87ac821280845041514a0418b94389296e6b03faf5c5fded8e2b0a0840015c03c477ad57d6a8268316b110adffb295882c81b7876c6f9f76a444531faed3c431
+  metadata.gz: 8b7cef2ec65c990d3f6c8b05acaefa328952e70571c5868293531ac51c44fd13306dfad5e976f786eb61d206214bc7eae91cf8c2e00023a26c75d689769ed684
+  data.tar.gz: e204946071d76d264b0c8206b1d9170eb7b5c89bb25f22975322fbdc0c4d52869f4b7cf06245d5143298c6d3a89b8c2bc6aa6529fc32f0895e57e1d2ddef97d1

data/CHANGELOG.md

@@ -1,9 +1,13 @@
 
 # SmarterCSV 1.x Change Log
 
+## 1.14.2 (2025-04-10)
+ * bugfix: SmarterCSV::Writer fixing corner case with `quote_headers: true`
+ * new option: `header_converter` allows to programatically modify the headers
+
 ## 1.14.1 (2025-04-09)
- * bugfix: empty hash results in a blank line ([issue 299](https://github.com/tilo/smarter_csv/issues/299))
- * bugfix: automatically quote problematic headers ([issue #300](https://github.com/tilo/smarter_csv/issues/300))
+ * bugfix: SmarterCSV::Writer empty hash results in a blank line ([issue 299](https://github.com/tilo/smarter_csv/issues/299))
+ * bugfix: SmarterCSV::Writer need to automatically quote problematic headers ([issue #300](https://github.com/tilo/smarter_csv/issues/300))
  * new option: `quote_headers` allows to explicitly quote all headers
 
 ## 1.14.0 (2025-04-07)

data/README.md

@@ -47,6 +47,7 @@ Or install it yourself as:
     
 # Articles
   * [Parsing CSV Files in Ruby with SmarterCSV](https://tilo-sloboda.medium.com/parsing-csv-files-in-ruby-with-smartercsv-6ce66fb6cf38)
+  * [CSV Writing with SmarterCSV](https://tilo-sloboda.medium.com/csv-writing-with-smartercsv-26136d47ad0c)
   * [Processing 1.4 Million CSV Records in Ruby, fast ](https://lcx.wien/blog/processing-14-million-csv-records-in-ruby/)
   * [Faster Parsing CSV with Parallel Processing](http://xjlin0.github.io/tech/2015/05/25/faster-parsing-csv-with-parallel-processing) by [Jack lin](https://github.com/xjlin0/)
   * The original [Stackoverflow Question](https://stackoverflow.com/questions/7788618/update-mongodb-with-array-from-csv-join-table/7788746#7788746) that inspired SmarterCSV

data/docs/options.md

@@ -28,10 +28,15 @@
      |                             |           | ⚠️ This disables automatic header detection!                    |
      | :map_headers                |    {}     | Similar to `headers`, but also maps each desired key to a user-specified value that is uesd as the header. | 
      |                             |           | ⚠️ This disables automatic header detection!                    |
+     | :value_converters           |    nil    | allows to define lambdas to programmatically modify values       |
+     |                             |           | * either for specific `key` names                                |
+     |                             |           | * or using `_all` for all fields                                |
+     | :header_converter           |    nil    | allows to define one lambda to programmatically modify the headers |
      | :discover_headers           |   true    | Automatically detects all keys in the input before writing the header |
      |                             |           | Do not manually set this to `false`. ⚠️                         |
      |                             |           | But you can set this to `true` when using `map_headers` option. |
      | :disable_auto_quoting       |  false    | To manually disable auto-quoting of special characters. ⚠️ Be careful with this! |
+     | :quote_headers              |  false    | To force quoting all headers (only needed in rare cases)        |
 
 
 ## CSV Reading

data/lib/smarter_csv/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SmarterCSV
-  VERSION = "1.14.1"
+  VERSION = "1.14.2"
 end

data/lib/smarter_csv/writer.rb

@@ -54,6 +54,7 @@ module SmarterCSV
       @value_converters = options[:value_converters] || {}
       @map_all_keys = @value_converters.has_key?(:_all)
       @mapped_keys = @value_converters.keys - [:_all]
+      @header_converter = options[:header_converter]
 
       @discover_headers = true
       if options.has_key?(:discover_headers)
@@ -89,6 +90,9 @@ module SmarterCSV
 
     def finalize
       mapped_headers = @headers.map { |header| @map_headers[header] || header }
+
+      mapped_headers = @headers.map { |header| @header_converter.call(header) } if @header_converter
+
       force_quotes = @quote_headers || @force_quotes
       mapped_headers = mapped_headers.map { |x| escape_csv_field(x, force_quotes) }
 
@@ -136,7 +140,7 @@ module SmarterCSV
 
     def escape_csv_field(field, force_quotes = false)
       str = field.to_s
-      return str if @disable_auto_quoting
+      return str if @disable_auto_quoting && !force_quotes
 
       # double-quote fields if we force that, or if the field contains the comma, new-line, or quote character
       contains_special_char = str.to_s.match(@quote_regex)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smarter_csv
 version: !ruby/object:Gem::Version
-  version: 1.14.1
+  version: 1.14.2
 platform: ruby
 authors:
 - Tilo Sloboda
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-09 00:00:00.000000000 Z
+date: 2025-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_print