rsmart_toolbox 0.12 → 0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9df84131abe73171ab6f69048fdf14d029dd14c0
-  data.tar.gz: 704b9cd5c78da9f72c3be53f062bcbf0f640a34c
+  metadata.gz: 6c0cd72de9171f05cb22855c6ff161a4e42a37dc
+  data.tar.gz: c588c12162f788f24667204bea50ea8887e6427b
 SHA512:
-  metadata.gz: 3ebe50b00afa63097e166a83ac0ac170198e1d22e2ca1d2761077037f46206ab9007a629659bde252bdde87496975446b16c1273fba0cc6e70a81e7c2e6992be
-  data.tar.gz: 4a8ac96dbd5f97dde57c4f84699e1c6209465205be08c0a5b3af1b1192882e531c52eef06622faeb81fbd98db86383a90aa6ea5f9f7edba6aca3c32a15e98a0c
+  metadata.gz: 331beb417a05b9fe82098b82f228c10cff957418be37449e52093fae7419ca4a147400b46d1b04f8d2ff280f834765137a9ad3b0e3582b0a0af63e408c6d2209
+  data.tar.gz: c83f554a58847ee106404111fba5fdab2896f354f3655df1f0f938df409d8ba0df801d92e92629cdbd7240013eda8a17a4b33758f6ef6892e389509620449325

data/lib/rsmart_toolbox/etl.rb

@@ -262,6 +262,83 @@ module Rsmart::ETL
     end
   end
 
+  # Parse a SQL date from a String.
+  # @param [String] str the String to be parsed.
+  # @param [Hash] opt options Hash will be passed through to #parse_string.
+  # @return [String] the parsed date. nil or empty inputs will return '' by default.
+  # @see parse_string
+  def self.parse_date(str, opt={ valid_values: /^$|(\d{4}\-\d{2}\-\d{2}){1}/ })
+    opt[:valid_values] = /^$|(\d{4}\-\d{2}\-\d{2}){1}/ if opt[:valid_values].nil?
+    return parse_string str, opt
+  end
+
+  # Helper method for #parse_date which finds the value by column :name and mutates the SQL statement accordingly.
+  # @param [CSV::Row] row the CSV Row being parsed
+  # @param [String] insert_str the left side of the insert statement (i.e. columns)
+  # @param [String] values_str the right side of the insert statement (i.e. values)
+  # @param [Hash] opt options Hash will be passed through to #parse_date.
+  # @option opt [String] :name the name of the field being parsed. Required.
+  # @return [void]
+  # @raise [ArgumentError] :name is required.
+  # @see parse_date
+  # @see mutate_sql_stmt!
+  def self.parse_date!(row, insert_str, values_str, opt={})
+    raise ArgumentError, "opt[:name] is required!" unless opt[:name]
+    date = parse_date( row[ to_symbol( opt[:name] ) ], opt )
+    mutate_sql_stmt! insert_str, opt[:name], values_str, date
+  end
+
+  # Parse a SQL datetime from a String.
+  # @param [String] str the String to be parsed.
+  # @param [Hash] opt options Hash will be passed through to #parse_string.
+  # @return [String] the parsed datetime. nil or empty inputs will return '' by default.
+  # @see parse_string
+  def self.parse_datetime(str, opt={ valid_values: /^$|(\d{4}\-\d{2}\-\d{2}){1}\s(\d{2}:\d{2}:\d{2})?/ })
+    opt[:valid_values] = /^$|(\d{4}\-\d{2}\-\d{2}){1}\s(\d{2}:\d{2}:\d{2})?/ if opt[:valid_values].nil?
+    return parse_string str, opt
+  end
+
+  # Helper method for #parse_datetime which finds the value by column :name and mutates the SQL statement accordingly.
+  # @param [CSV::Row] row the CSV Row being parsed
+  # @param [String] insert_str the left side of the insert statement (i.e. columns)
+  # @param [String] values_str the right side of the insert statement (i.e. values)
+  # @param [Hash] opt options Hash will be passed through to #parse_datetime.
+  # @option opt [String] :name the name of the field being parsed. Required.
+  # @return [void]
+  # @raise [ArgumentError] :name is required.
+  # @see parse_datetime
+  # @see mutate_sql_stmt!
+  def self.parse_datetime!(row, insert_str, values_str, opt={})
+    raise ArgumentError, "opt[:name] is required!" unless opt[:name]
+    datetime = parse_datetime( row[ to_symbol( opt[:name] ) ], opt )
+    mutate_sql_stmt! insert_str, opt[:name], values_str, datetime
+  end
+
+  # Parse a SQL timestamp from a String.
+  # @param [String] str the String to be parsed.
+  # @param [Hash] opt options Hash will be passed through to #parse_string.
+  # @return [String] the parsed timestamp. nil or empty inputs will return '' by default.
+  # @see parse_string
+  def self.parse_timestamp(str, opt={ valid_values: /^$|(\d{4}\-\d{2}\-\d{2}){1}\s(\d{2}:\d{2}:\d{2})?/ })
+    return parse_datetime str, opt
+  end
+
+  # Helper method for #parse_timestamp which finds the value by column :name and mutates the SQL statement accordingly.
+  # @param [CSV::Row] row the CSV Row being parsed
+  # @param [String] insert_str the left side of the insert statement (i.e. columns)
+  # @param [String] values_str the right side of the insert statement (i.e. values)
+  # @param [Hash] opt options Hash will be passed through to #parse_timestamp.
+  # @option opt [String] :name the name of the field being parsed. Required.
+  # @return [void]
+  # @raise [ArgumentError] :name is required.
+  # @see parse_timestamp
+  # @see mutate_sql_stmt!
+  def self.parse_timestamp!(row, insert_str, values_str, opt={})
+    raise ArgumentError, "opt[:name] is required!" unless opt[:name]
+    timestamp = parse_datetime( row[ to_symbol( opt[:name] ) ], opt )
+    mutate_sql_stmt! insert_str, opt[:name], values_str, timestamp
+  end
+
   # Useful for parsing "flag" like values; i.e. usually single characters.
   # @param [String] str the String to be parsed.
   # @param [Hash] opt options Hash will be passed through to #parse_string.

data/lib/rsmart_toolbox/version.rb

@@ -16,5 +16,5 @@
 
 module Rsmart
   # The gem version number.
-  VERSION = "0.12"
+  VERSION = "0.13"
 end

data/spec/rsmart_toolbox/etl_spec.rb

@@ -444,4 +444,78 @@ RSpec.describe "Rsmart::ETL" do
     end
   end
 
+  describe "#parse_date" do
+    it "parses valid date strings" do
+      expect(ETL.parse_date("2014-10-31")).to eq("2014-10-31")
+      expect(ETL.parse_date(nil)).to eq('')
+      expect(ETL.parse_date('')).to eq('')
+    end
+
+    it "raises a TextParseError if invalid dates are supplied" do
+      expect { ETL.parse_date("1-1-1") }.to raise_error(TextParseError)
+      expect { ETL.parse_date("123") }.to   raise_error(TextParseError)
+      expect { ETL.parse_date("Q") }.to     raise_error(TextParseError)
+    end
+  end
+
+  describe "#parse_date!" do
+    it "modifies the insert_str and values_str based on a CSV::Row match" do
+      insert_str = ""; values_str = ""; name = "INCORPORATED_DATE"
+      row = CSV::Row.new([name.downcase.to_sym], ['2014-10-31'], true)
+      ETL.parse_date!(row, insert_str, values_str, name: name)
+      expect(insert_str).to eq "#{name},"
+      expect(values_str).to eq "'2014-10-31',"
+    end
+  end
+
+  describe "#parse_datetime" do
+    it "parses valid datetime strings" do
+      expect(ETL.parse_datetime("2014-10-31 00:00:00")).to eq("2014-10-31 00:00:00")
+      expect(ETL.parse_datetime("1970-10-31 10:10:10")).to eq("1970-10-31 10:10:10")
+      expect(ETL.parse_datetime(nil)).to eq('')
+      expect(ETL.parse_datetime('')).to eq('')
+    end
+
+    it "raises a TextParseError if invalid dates are supplied" do
+      expect { ETL.parse_datetime("1970-10-31") }.to raise_error(TextParseError)
+      expect { ETL.parse_datetime("123") }.to        raise_error(TextParseError)
+      expect { ETL.parse_datetime("Q") }.to          raise_error(TextParseError)
+    end
+  end
+
+  describe "#parse_datetime!" do
+    it "modifies the insert_str and values_str based on a CSV::Row match" do
+      insert_str = ""; values_str = ""; name = "INCORPORATED_DATE"
+      row = CSV::Row.new([name.downcase.to_sym], ['1970-10-31 10:10:10'], true)
+      ETL.parse_datetime!(row, insert_str, values_str, name: name)
+      expect(insert_str).to eq "#{name},"
+      expect(values_str).to eq "'1970-10-31 10:10:10',"
+    end
+  end
+
+  describe "#parse_timestamp" do
+    it "parses valid datetime strings" do
+      expect(ETL.parse_timestamp("2014-10-31 00:00:00")).to eq("2014-10-31 00:00:00")
+      expect(ETL.parse_timestamp("1970-10-31 10:10:10")).to eq("1970-10-31 10:10:10")
+      expect(ETL.parse_timestamp(nil)).to eq('')
+      expect(ETL.parse_timestamp('')).to eq('')
+    end
+
+    it "raises a TextParseError if invalid dates are supplied" do
+      expect { ETL.parse_timestamp("1970-10-31") }.to raise_error(TextParseError)
+      expect { ETL.parse_timestamp("123") }.to        raise_error(TextParseError)
+      expect { ETL.parse_timestamp("Q") }.to          raise_error(TextParseError)
+    end
+  end
+
+  describe "#parse_timestamp!" do
+    it "modifies the insert_str and values_str based on a CSV::Row match" do
+      insert_str = ""; values_str = ""; name = "INCORPORATED_DATE"
+      row = CSV::Row.new([name.downcase.to_sym], ['1970-10-31 10:10:10'], true)
+      ETL.parse_timestamp!(row, insert_str, values_str, name: name)
+      expect(insert_str).to eq "#{name},"
+      expect(values_str).to eq "'1970-10-31 10:10:10',"
+    end
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rsmart_toolbox
 version: !ruby/object:Gem::Version
-  version: '0.12'
+  version: '0.13'
 platform: ruby
 authors:
 - Lance Speelmon
@@ -30,7 +30,7 @@ cert_chain:
   sKRWzEtHFamxQaIspOja5O4oQKiCbWa90fEuIoCtwyy1rQtL9VKoDTs4vZASXNuc
   F/lEyekXSjN36uTtlt4LkKLn/k7k5gRbt4+C9Q==
   -----END CERTIFICATE-----
-date: 2014-10-15 00:00:00.000000000 Z
+date: 2014-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: builder