honey_format 0.23.0 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54b1c442221f4921f054ba328b55f066166d27b27bd56aa8499bf195bac65847
-  data.tar.gz: 58977315c3fb95a54a0cbc7ab930a8ade04016865c589f4e6374ce113a080c1c
+  metadata.gz: 4e7b05a5cbde9ef4df67f043ff78e75c545563faa02333c57c97f70f1adec0f9
+  data.tar.gz: 91275865eabfd283c22ef0507a76b0c433d64a36c2ab68d92501548b982a00c8
 SHA512:
-  metadata.gz: 1cbbc61c953422dea9de989ebe429b05325140868c54b2861dbaafac222425706d8af481d86c0a0f3a75bbc19bcabfb5d580d0261c0a3ba928c3a2d45390abf7
-  data.tar.gz: d07789988d8ad6f335fa517bc07954f0f9800c3dce3ab10a9295c6edae81994fd78ca9ed2e44c6ac6b8759593e0807edeb78457bbb54ce4e348db116f953374a
+  metadata.gz: c5904b276f295163855c1d74f7afa27568572e50583ec54532e571f70eb59ce06648e60a0e0d29806289d7126b8d0a9351acdd746967c247db03004cec3c4356
+  data.tar.gz: e498be3c0e31e594cc42d2186404d367564111d70d2fffbe0011d0ea208e5f217ff8416061f12cbdff5137b3075e1f09d857b2dd189d785b865381d02c429d07

data/CHANGELOG.md

@@ -1,8 +1,19 @@
 # HEAD
 
+## v0.24.0
+
+* Add support for multiple/chained converters. [PR#69](https://github.com/buren/honey_format/pull/69)
+  ```ruby
+  csv_string = "Id,Username\n1,  BuRen  "
+  type_map = { username: [:strip, :downcase] }
+  csv = HoneyFormat::CSV.new(csv_string, type_map: type_map)
+  csv.rows.first.username # => "buren"
+  ```
+* Add `strip` and `strip!` converter
+
 ## v0.23.0
 
-* Add `Rows#columnns` method that returns header columns
+* Add `Rows#columns` method that returns header columns
 
 ## v0.22.0
 

data/README.md

@@ -107,6 +107,14 @@ csv = HoneyFormat::CSV.new(csv_string, type_map: type_map)
 csv.rows.first.username # => "BUREN"
 ```
 
+Combine multiple converters
+```ruby
+csv_string = "Id,Username\n1,  BuRen  "
+type_map = { username: [:strip, :downcase] }
+csv = HoneyFormat::CSV.new(csv_string, type_map: type_map)
+csv.rows.first.username # => "buren"
+```
+
 Register your own converter
 ```ruby
 HoneyFormat.configure do |config|
@@ -376,6 +384,50 @@ matrix.to_csv    # => "name,id\nJACOB,1\n"
 
 If you want to see more usage examples check out the [`examples/`](https://github.com/buren/honey_format/tree/master/examples) and [`spec/`](https://github.com/buren/honey_format/tree/master/spec) directories and of course [on RubyDoc](https://www.rubydoc.info/gems/honey_format/).
 
+
+__SQL example__
+
+When you want the result as an object, with certain columns converted to objects.
+
+```ruby
+require 'mysql2'
+
+class DBClient
+  def initialize(host:, username:, password:, port: 3306)
+    @client = Mysql2::Client.new(
+      host: host,
+      username: username,
+      password: password,
+      port: port
+    )
+  end
+
+  def query(sql, type_map: {})
+    result = @client.query(sql)
+    return if result.first.nil?
+
+    matrix = HoneyFormat::Matrix.new(
+      result.map(&:values),
+      header: result.first.keys,
+      type_map: type_map
+    )
+    matrix.rows
+  end
+end
+```
+
+Usage example with a fictional "users" database table (schema: `name`, `created_at`)
+```ruby
+client = DbClient.new(host: '127.0.0.1', username: 'root', password: nil)
+users = client.query(
+  'SELECT * FROM users',
+  type_map: { created_at: :datetime! }
+)
+user = users.first
+user.name # => buren
+user.created_at.class # => Time
+```
+
 ## CLI
 
 > Perfect when you want to get something simple done quickly.

data/lib/honey_format/converters/convert_string.rb

@@ -10,6 +10,9 @@ module HoneyFormat
   # Convert to upcase or nil
   ConvertUpcase = proc { |v| v&.upcase }
 
+  # Convert to stripped string
+  ConvertStrip = proc { |v| v&.strip }
+
   # Convert to symbol or nil
   ConvertSymbol = proc { |v| v&.to_sym }
 
@@ -35,8 +38,13 @@ module HoneyFormat
     ConvertDowncase.call(v) || raise(ArgumentError, "can't convert nil to downcased string")
   end
 
+  # Convert to downcase or raise error
+  StrictConvertStrip = proc do |v|
+    ConvertStrip.call(v) || raise(ArgumentError, "can't convert nil to downcased string")
+  end
+
   # Convert to symbol or raise error
   StrictConvertSymbol = proc do |v|
-    ConvertSymbol.call(v) || raise(ArgumentError, "can't convert nil to symbol")
+    ConvertSymbol.call(v) || raise(ArgumentError, "can't convert nil to stripped string")
   end
 end

data/lib/honey_format/converters/converters.rb

@@ -20,6 +20,7 @@ module HoneyFormat
       symbol!: StrictConvertSymbol,
       downcase!: StrictConvertDowncase,
       upcase!: StrictConvertUpcase,
+      strip!: StrictConvertStrip,
       boolean!: StrictConvertBoolean,
       # safe variants
       decimal: ConvertDecimal,
@@ -31,6 +32,7 @@ module HoneyFormat
       symbol: ConvertSymbol,
       downcase: ConvertDowncase,
       upcase: ConvertUpcase,
+      strip: ConvertStrip,
       boolean: ConvertBoolean,
       md5: ConvertMD5,
       hex: ConvertHex,

data/lib/honey_format/matrix/row_builder.rb

@@ -57,7 +57,11 @@ module HoneyFormat
 
       # Convert values
       @type_map.each do |column, type|
-        row[column] = @converter.call(row[column], type)
+        types = type.respond_to?(:each) ? type : [type]
+        value = row[column]
+        types.each { |t| value = @converter.call(value, t) }
+
+        row[column] = value
       end
 
       return row unless @builder

data/lib/honey_format/version.rb

@@ -4,7 +4,7 @@ module HoneyFormat
   # Gem version
   VERSION = [
     MAJOR_VERSION = 0,
-    MINOR_VERSION = 23,
+    MINOR_VERSION = 24,
     PATCH_VERSION = 0,
   ].join('.')
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: honey_format
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 0.24.0
 platform: ruby
 authors:
 - Jacob Burenstam
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-11-29 00:00:00.000000000 Z
+date: 2021-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: benchmark-ips
@@ -153,7 +153,7 @@ homepage: https://github.com/buren/honey_format
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -168,8 +168,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key:
+rubygems_version: 3.1.4
+signing_key: 
 specification_version: 4
 summary: Makes working with CSVs as smooth as honey.
 test_files: []