bumblebee 2.1.0 → 3.0.0

data/spec/examples/converter_test_case.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+#
+# Copyright (c) 2018-present, Blue Marble Payroll, LLC
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+#
+
+class ConverterTestCase
+  ALL = [
+    {
+      arg: {
+        type: :bigdecimal,
+        nullable: true
+      },
+      convert_cases: [
+        [nil, nil],
+        ['', nil],
+        [6, BigDecimal(6)],
+        [BigDecimal('12'), BigDecimal(12)],
+        ['24.35', BigDecimal('24.35')]
+      ]
+    },
+    {
+      arg: {
+        type: :bigdecimal,
+        nullable: false
+      },
+      convert_cases: [
+        [nil, BigDecimal(0)],
+        ['', BigDecimal(0)]
+      ]
+    },
+    {
+      arg: {
+        type: :boolean,
+        nullable: true
+      },
+      convert_cases: [
+        [nil, nil],
+        [true, true],
+        ['t', true],
+        ['true', true],
+        ['TRUE', true],
+        ['True', true],
+        ['1', true],
+        ['Y', true],
+        ['y', true],
+        ['yes', true],
+        ['YES', true],
+        ['Yes', true],
+        [false, false],
+        ['f', false],
+        ['false', false],
+        ['FALSE', false],
+        ['False', false],
+        ['0', false],
+        ['N', false],
+        ['n', false],
+        ['no', false],
+        ['NO', false],
+        ['No', false]
+      ]
+    },
+    {
+      arg: {
+        type: :boolean,
+        nullable: false
+      },
+      convert_cases: [
+        [nil, false],
+        ['', false]
+      ]
+    },
+    {
+      arg: {
+        type: :float,
+        nullable: true
+      },
+      convert_cases: [
+        [nil, nil],
+        ['', nil],
+        [6, 6.to_f],
+        [6.0, 6.0.to_f],
+        ['24.35', '24.35'.to_f]
+      ]
+    },
+    {
+      arg: {
+        type: :float,
+        nullable: false
+      },
+      convert_cases: [
+        [nil, 0.0],
+        ['', 0.0]
+      ]
+    }
+  ].freeze
+
+  class << self
+    def all
+      @all ||= ALL.map { |c| new(c) }
+    end
+  end
+
+  attr_reader :arg, :convert_cases
+
+  def initialize(arg:, convert_cases:)
+    @arg = arg
+    @convert_cases = convert_cases
+  end
+end

data/spec/examples/person_template.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+#
+# Copyright (c) 2018-present, Blue Marble Payroll, LLC
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+#
+
+class PersonTemplate < ::Bumblebee::Template
+  column 'ID #',            property: 'id',
+                            to_object: :integer
+
+  column 'First Name',      property: 'first',
+                            through: 'demo'
+
+  column 'Last Name',       property: 'last',
+                            through: 'demo'
+
+  column 'Street 1',        property: 'street1',
+                            through: %w[demo address]
+
+  column 'Street 2',        property: 'street2',
+                            through: %w[demo address]
+
+  column 'City',            property: 'city',
+                            through: %w[demo address]
+
+  column 'State',           property: 'st',
+                            through: %w[demo address]
+
+  column 'Zipcode',         property: 'zip',
+                            through: %w[demo address]
+
+  column 'Current',         property: 'current',
+                            through: %w[demo address],
+                            to_object: :boolean
+
+  column 'Home #',          property: 'home',
+                            through: 'contact'
+
+  column 'Fax #',           property: 'fax',
+                            through: 'contact'
+
+  column 'Email Address',   property: 'email',
+                            through: 'contact'
+
+  column 'Smokes',          property: 'smoker',
+                            to_object: :boolean
+
+  column 'Current Balance', property: 'balance',
+                            to_object: :bigdecimal
+
+  column 'Visits',          property: 'visit_dates',
+                            to_csv: { type: :join, separator: ';', per: :string },
+                            to_object: { type: :split, separator: ';', per: :date }
+
+  column 'Family Members',  property: 'family_members',
+                            to_csv: { type: :pluck_join, sub_property: 'id' },
+                            to_object: { type: :pluck_split, sub_property: 'id', per: :integer }
+
+  column 'Email Address Domain', property: 'email',
+                                 through: 'contact',
+                                 to_csv: ->(email) { email.to_s.split('@').last },
+                                 to_object: :ignore
+end

data/spec/examples/simple_object.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+#
+# Copyright (c) 2018-present, Blue Marble Payroll, LLC
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+#
+
+class SimpleObject
+  attr_accessor :id, :name, :dob, :phone
+
+  def initialize(id: nil, name: '', dob: nil, phone: '')
+    @id     = id
+    @name   = name
+    @dob    = dob
+    @phone  = phone
+  end
+
+  def eql?(other)
+    id == other.id && name == other.name && dob == other.dob && phone == other.phone
+  end
+
+  def ==(other)
+    eql?(other)
+  end
+end

data/spec/fixtures/people/data.csv

@@ -0,0 +1,3 @@
+ID #,First Name,Last Name,Street 1,Street 2,City,State,Zipcode,Current,Home #,Fax #,Email Address,Smokes,Current Balance,Visits,Family Members,Email Address Domain
+1,Matt,Rizzo,555 Happy Ln.,Suite 208,Mukwongo,WI,12345,true,555-444-5555,555-444-5555,something@somewhere.org,false,124.53,2018-03-02;2018-06-04,"3,4",somewhere.org
+2,Katie,Bunny,765 N. Hollywood Dr.,Apt 3B,Bel Air,CA,99999,false,123-456-7890,098-765-4321,st@elsewhere.org,true,-98.5,2010-09-10;2018-03-04,"5,6",elsewhere.org

data/spec/fixtures/people/data.yml

@@ -0,0 +1,46 @@
+- id: 1
+  demo:
+    first: Matt
+    last: Rizzo
+    address:
+      street1: 555 Happy Ln.
+      street2: Suite 208
+      city: Mukwongo
+      st: WI
+      zip: '12345'
+      current: true
+  contact:
+    home: 555-444-5555
+    fax: 555-444-5555
+    email: something@somewhere.org
+  smoker: false
+  balance: 124.53
+  visit_dates:
+    - 2018-03-02
+    - 2018-06-04
+  family_members:
+    - id: 3
+    - id: 4
+- id: 2
+  demo:
+    first: Katie
+    last: Bunny
+    address:
+      street1: 765 N. Hollywood Dr.
+      street2: Apt 3B
+      city: Bel Air
+      st: CA
+      zip: '99999'
+      current: false
+  contact:
+    home: 123-456-7890
+    fax: 098-765-4321
+    email: st@elsewhere.org
+  smoker: true
+  balance: -98.5
+  visit_dates:
+    - 2010-09-10
+    - 2018-03-04
+  family_members:
+    - id: 5
+    - id: 6

data/spec/fixtures/registrations/columns.yml

@@ -0,0 +1,35 @@
+'ID #':
+  property: id
+  to_object: integer
+'Plate #':
+  property: plate
+Date:
+  property: registration_date
+  to_object: date
+'Person ID #':
+  property: id
+  through: person
+  to_object: integer
+First Name:
+  property: first
+  through: person
+Middle Name:
+  property: middle
+  through: person
+Last Name:
+  property: last
+  through: person
+'Car ID #':
+  property: id
+  through: car
+  to_object: integer
+Make:
+  property: make
+  through: car
+Model:
+  property: model
+  through: car
+Year:
+  property: year
+  through: car
+  to_object: integer

data/spec/fixtures/registrations/data.csv

@@ -0,0 +1,3 @@
+ID #,Plate #,Date,Person ID #,First Name,Middle Name,Last Name,Car ID #,Make,Model,Year
+1,No1BBALL,2018-01-02,2,Michael,Jeffery,Jordan,3,Jeep,Wrangler,2018
+4,No2BBALL,2018-09-02,5,Scottie,Maurice,Pippen,6,Toyota,Camry,1999

data/spec/fixtures/registrations/data.yml

@@ -0,0 +1,26 @@
+- id: 1
+  registration_date: 2018-01-02
+  plate: No1BBALL
+  person:
+    id: 2
+    first: Michael
+    middle: Jeffery
+    last: Jordan
+  car:
+    id: 3
+    make: Jeep
+    model: Wrangler
+    year: 2018
+- id: 4
+  registration_date: 2018-09-02
+  plate: No2BBALL
+  person:
+    id: 5
+    first: Scottie
+    middle: Maurice
+    last: Pippen
+  car:
+    id: 6
+    make: Toyota
+    model: Camry
+    year: 1999

data/spec/fixtures/simple/columns.yml

@@ -0,0 +1,4 @@
+- id
+- name
+- dob
+- phone

data/spec/fixtures/{custom_readme_example.csv → simple/data.csv}

@@ -1,4 +1,4 @@
-ID #,First Name,Date of Birth,Phone #
+id,name,dob,phone
 1,Matt,1901-02-03,555-555-5555
 2,Nick,1921-09-03,444-444-4444
 3,Sam,1932-12-12,333-333-3333

data/spec/fixtures/simple/data.yml

@@ -0,0 +1,12 @@
+- id: '1'
+  name: Matt
+  dob: '1901-02-03'
+  phone: 555-555-5555
+- id: '2'
+  name: Nick
+  dob: '1921-09-03'
+  phone: 444-444-4444
+- id: '3'
+  name: Sam
+  dob: '1932-12-12'
+  phone: 333-333-3333

data/spec/spec_helper.rb

@@ -9,6 +9,7 @@
 
 require 'stringio'
 require 'pry'
+require 'ostruct'
 
 require 'simplecov'
 require 'simplecov-console'
@@ -17,16 +18,41 @@ SimpleCov.start
 
 require './lib/bumblebee'
 
-def fixture_path(filename)
+def fixture_path(*filename)
   File.join('spec', 'fixtures', filename)
 end
 
-def fixture(filename)
+def csv_fixture(*filename)
+  CSV.new(fixture(*filename), headers: true).map(&:to_h)
+end
+
+def yaml_fixture(*filename)
+  # rubocop:disable Security/YAMLLoad
+  YAML.load(fixture(*filename))
+  # rubocop:enable Security/YAMLLoad
+end
+
+def fixture(*filename)
   # Excel adds a Byte Order Mark to the beginning of the file. Let Ruby
   # know about this so that the first 'id' column is correctly parsed.
   # More info about the Excel Byte Order Mark and Ruby is available at:
   # https://estl.tech/of-ruby-and-hidden-csv-characters-ef482c679b35 .
-  file = File.open(fixture_path(filename), 'r:bom|utf-8')
+  file = File.open(fixture_path(*filename), 'r:bom|utf-8')
 
   file.read
 end
+
+def manually_convert_csv_object(csv_object, columns)
+  csv_object.map do |header, value|
+    column = ::Bumblebee::Column.new(header, columns[header].symbolize_keys)
+
+    converted_value =
+      if column.extractor.expect_array?
+        value
+      else
+        column.converter.convert(value)
+      end
+
+    [header, converted_value]
+  end.to_h
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bumblebee
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Matthew Ruggio
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-04 00:00:00.000000000 Z
+date: 2019-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: acts_as_hashable
@@ -134,13 +134,29 @@ files:
 - lib/bumblebee.rb
 - lib/bumblebee/bumblebee.rb
 - lib/bumblebee/column.rb
+- lib/bumblebee/column_dsl.rb
+- lib/bumblebee/column_set.rb
+- lib/bumblebee/converter.rb
+- lib/bumblebee/core_ext/hash.rb
+- lib/bumblebee/mutator.rb
+- lib/bumblebee/null_converter.rb
+- lib/bumblebee/object_interface.rb
+- lib/bumblebee/simple_converter.rb
 - lib/bumblebee/template.rb
 - lib/bumblebee/version.rb
-- spec/bumblebee/bumblebee_spec.rb
-- spec/bumblebee/column_spec.rb
+- spec/bumblebee/simple_converter_spec.rb
 - spec/bumblebee/template_spec.rb
-- spec/fixtures/custom_readme_example.csv
-- spec/fixtures/simple_readme_example.csv
+- spec/examples/converter_test_case.rb
+- spec/examples/person_template.rb
+- spec/examples/simple_object.rb
+- spec/fixtures/people/data.csv
+- spec/fixtures/people/data.yml
+- spec/fixtures/registrations/columns.yml
+- spec/fixtures/registrations/data.csv
+- spec/fixtures/registrations/data.yml
+- spec/fixtures/simple/columns.yml
+- spec/fixtures/simple/data.csv
+- spec/fixtures/simple/data.yml
 - spec/spec_helper.rb
 homepage: https://github.com/bluemarblepayroll/bumblebee
 licenses:
@@ -166,9 +182,17 @@ signing_key:
 specification_version: 4
 summary: Object/CSV Mapper
 test_files:
-- spec/bumblebee/bumblebee_spec.rb
-- spec/bumblebee/column_spec.rb
+- spec/bumblebee/simple_converter_spec.rb
 - spec/bumblebee/template_spec.rb
-- spec/fixtures/custom_readme_example.csv
-- spec/fixtures/simple_readme_example.csv
+- spec/examples/converter_test_case.rb
+- spec/examples/person_template.rb
+- spec/examples/simple_object.rb
+- spec/fixtures/people/data.csv
+- spec/fixtures/people/data.yml
+- spec/fixtures/registrations/columns.yml
+- spec/fixtures/registrations/data.csv
+- spec/fixtures/registrations/data.yml
+- spec/fixtures/simple/columns.yml
+- spec/fixtures/simple/data.csv
+- spec/fixtures/simple/data.yml
 - spec/spec_helper.rb