etl 0.9.5.rc1

data/test/database_join_processor_test.rb

@@ -0,0 +1,43 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class DatabaseJoinProcessorTest < Test::Unit::TestCase
+
+  def new_processor(options)
+    ETL::Processor::DatabaseJoinProcessor.new(nil, options)
+  end
+  
+  should 'raise an error unless :fields is specified' do
+    error = assert_raises(ETL::ControlError) { new_processor({}) }
+    assert_equal ":target must be specified", error.message
+  end
+
+  should 'return the row and the database result' do
+    row = ETL::Row[:id => 1, :first_name => 'Bob', :last_name => 'Smith', :ssn => '111234444']
+    control = ETL::Control::Control.parse(File.dirname(__FILE__) + 
+      '/delimited.ctl')
+
+    Person.delete_all
+    assert_equal 0, Person.count
+    
+    # First define a basic configuration to check defaults
+    configuration = { 
+      :target => :data_warehouse,
+      :database => 'etl_unittest',
+      :table => 'people',
+      :buffer_size => 0 
+    }
+    mapping = { :order => [:id, :first_name, :last_name, :ssn] }
+    dest = ETL::Control::DatabaseDestination.new(control, configuration, mapping)
+    dest.write(row)
+    dest.close
+    
+    assert_equal 1, Person.find(:all).length
+
+    row = ETL::Row[:last_name => "Smith"]
+    processor = new_processor(:target => :data_warehouse,
+                              :query => "SELECT first_name FROM people WHERE last_name = \#{connection.quote(row[:last_name])}",
+                              :fields => ["first_name"]).process(row)
+    assert_equal row[:first_name], "Bob"
+  end
+  
+end

data/test/date_dimension_builder_test.rb

@@ -0,0 +1,96 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class DateDimensionBuilderTest < Test::Unit::TestCase
+  
+  context "the DateDimensionBuilder" do
+    context "when initialized with defaults" do
+      setup do
+        @builder = ETL::Builder::DateDimensionBuilder.new
+      end
+      should "have a start date of 5 years ago" do
+        assert_equal Time.now.years_ago(5).to_date, @builder.start_date.to_date
+      end
+      should "have an end date of now" do
+        assert_equal Time.now.to_date, @builder.end_date.to_date
+      end
+      should "have an empty of array of holiday indicators" do
+        assert_equal [], @builder.holiday_indicators
+      end
+    end
+    context "when initialized with arguments" do
+      setup do 
+        @start_date = Time.now.years_ago(2)
+        @end_date = Time.now.years_ago(1)
+        @builder = ETL::Builder::DateDimensionBuilder.new(@start_date, @end_date)
+      end
+      should "respect a custom start date" do
+        assert_equal @start_date.to_date, @builder.start_date.to_date
+      end
+      should "respect a custom end date" do
+        assert_equal @end_date.to_date, @builder.end_date.to_date
+      end
+    end
+    context "when building a date dimension using the default settings" do
+      setup do
+        # specific dates required when testing, because leap years affect
+        # how many records are built
+        @start_date = Date.parse('2002-05-19').to_time
+        @end_date = Date.parse('2007-05-19').to_time
+        @builder = ETL::Builder::DateDimensionBuilder.new(@start_date, @end_date)
+        @records = @builder.build
+      end
+      should "build a dimension with the correct number of records" do
+        assert_equal 1827, @records.length
+      end
+      should "have the correct first date" do
+        assert_date_dimension_record_equal(@builder.start_date, @records.first)
+      end
+    end
+    context "when building a date dimension with a fiscal year offset month" do
+      should_eventually "respect the fiscal year offset month" do
+        
+      end
+    end
+  end
+  
+  def assert_date_dimension_record_equal(date, record)
+    real_date = date
+    date = date.to_time
+    assert_equal date.strftime("%m/%d/%Y"), record[:date]
+    assert_equal date.strftime("%B %d,%Y"), record[:full_date_description]
+    assert_equal date.strftime("%A"), record[:day_of_week]
+    assert_equal date.day, record[:day_number_in_calendar_month]
+    assert_equal date.yday, record[:day_number_in_calendar_year]
+    assert_equal date.day, record[:day_number_in_fiscal_month]
+    assert_equal date.fiscal_year_yday, record[:day_number_in_fiscal_year]
+    assert_equal "Week #{date.week}", record[:calendar_week]
+    assert_equal date.week, record[:calendar_week_number_in_year]
+    assert_equal date.strftime("%B"), record[:calendar_month_name]
+    assert_equal date.month, record[:calendar_month_number_in_year]
+    assert_equal date.strftime("%Y-%m"), record[:calendar_year_month]
+    assert_equal "Q#{date.quarter}", record[:calendar_quarter]
+    assert_equal date.quarter, record[:calendar_quarter_number_in_year]
+    assert_equal "#{date.strftime('%Y')}-#{record[:calendar_quarter]}", record[:calendar_year_quarter]
+    assert_equal "#{date.year}", record[:calendar_year]
+    assert_equal "FY Week #{date.fiscal_year_week}", record[:fiscal_week]
+    assert_equal date.fiscal_year_week, record[:fiscal_week_number_in_year]
+    assert_equal date.fiscal_year_month, record[:fiscal_month]
+    assert_equal date.fiscal_year_month, record[:fiscal_month_number_in_year]
+    assert_equal "FY#{date.fiscal_year}-" + date.fiscal_year_month.to_s.rjust(2, '0'), record[:fiscal_year_month]
+    assert_equal "FY Q#{date.fiscal_year_quarter}", record[:fiscal_quarter]
+    assert_equal "FY#{date.fiscal_year}-Q#{date.fiscal_year_quarter}", record[:fiscal_year_quarter]
+    assert_equal date.fiscal_year_quarter, record[:fiscal_year_quarter_number]
+    assert_equal "FY#{date.fiscal_year}", record[:fiscal_year]
+    assert_equal date.fiscal_year, record[:fiscal_year_number]
+    assert_equal 'Nonholiday', record[:holiday_indicator]
+    assert_equal weekday_indicators[date.wday], record[:weekday_indicator]
+    assert_equal 'None', record[:selling_season]
+    assert_equal 'None', record[:major_event]
+    assert_equal record[:sql_date_stamp], real_date
+  end
+  
+  private
+  def weekday_indicators
+    ['Weekend','Weekday','Weekday','Weekday','Weekday','Weekday','Weekend']
+  end
+end

data/test/destination_test.rb

@@ -0,0 +1,275 @@
+require 'rubygems'
+require 'spreadsheet'
+require File.dirname(__FILE__) + '/test_helper'
+
+class Person < ActiveRecord::Base
+end
+
+class BadDestination < ETL::Control::Destination
+  def initialize(control, configuration, mapping)
+    super
+  end
+end
+
+# Test the functionality of destinations
+class DestinationTest < Test::Unit::TestCase
+  # Test a file destination
+  def test_file_destination
+    outfile = 'output/test_file_destination.txt'
+    outfile2 = 'output/test_file_destination.2.txt'
+    row = ETL::Row[ :address => '123 SW 1st Street', :city => 'Melbourne', 
+      :state => 'Florida', :country => 'United States' ]
+    row_needs_escape = ETL::Row[ :address => "Allen's Way", 
+      :city => 'Some City', :state => 'Some State', :country => 'Mexico' ]
+    control = ETL::Control::Control.parse(File.dirname(__FILE__) + 
+      '/delimited.ctl')
+
+    # First define a basic configuration to check defaults
+    configuration = { 
+      :file => outfile, 
+      :buffer_size => 0,
+    }
+    mapping = { 
+      :order => [:address, :city, :state, :country, :country_code],
+      :virtual => {
+        :country_code => Proc.new do |r|
+          {
+            'United States' => 'US',
+            'Mexico' => 'MX'
+          }[r[:country]]
+        end
+      }
+    }
+    
+    dest = ETL::Control::FileDestination.new(control, configuration, mapping)    
+    dest.write(row)
+    dest.write(row_needs_escape)
+    dest.close
+    
+    configuration[:file] = outfile2
+    configuration[:separator] = '|'
+    configuration[:eol] = "[EOL]\n"
+    
+    dest = ETL::Control::FileDestination.new(control, configuration, mapping)
+    dest.write(row)
+    dest.write(row_needs_escape)
+    dest.close
+    
+    # Read back the resulting
+    lines = open(File.join(File.dirname(__FILE__), outfile), 'r').readlines
+    assert_equal "123 SW 1st Street,Melbourne,Florida,United States,US\n", lines[0]
+    assert_equal "Allen's Way,Some City,Some State,Mexico,MX\n", lines[1]
+    
+    lines = open(File.join(File.dirname(__FILE__), outfile2), 'r').readlines
+    assert_equal "123 SW 1st Street|Melbourne|Florida|United States|US[EOL]\n", lines[0]
+    assert_equal "Allen's Way|Some City|Some State|Mexico|MX[EOL]\n", lines[1]
+  end
+  
+  # Test a database destination
+  def test_database_destination
+    row = ETL::Row[:id => 1, :first_name => 'Bob', :last_name => 'Smith', :ssn => '111234444']
+    row_needs_escape = ETL::Row[:id => 2, :first_name => "Foo's", :last_name => "Bar", :ssn => '000000000' ]
+    control = ETL::Control::Control.parse(File.dirname(__FILE__) + 
+      '/delimited.ctl')
+    
+    Person.delete_all
+    assert_equal 0, Person.count
+    
+    # First define a basic configuration to check defaults
+    configuration = { 
+      :target => :data_warehouse,
+      :database => 'etl_unittest',
+      :table => 'people',
+      :buffer_size => 0 
+    }
+    mapping = { :order => [:id, :first_name, :last_name, :ssn] }
+    dest = ETL::Control::DatabaseDestination.new(control, configuration, mapping)
+    dest.write(row)
+    dest.close
+    
+    assert_equal 1, Person.find(:all).length
+  end
+  
+  def test_database_destination_with_control
+    row = ETL::Row[:id => 1, :first_name => 'Bob', :last_name => 'Smith', :ssn => '111234444']
+    control = ETL::Control::Control.parse(File.dirname(__FILE__) + 
+      '/delimited_destination_db.ctl')
+    Person.delete_all
+    assert_equal 0, Person.count
+    d = control.destinations.first
+    dest = ETL::Control::DatabaseDestination.new(control, d.configuration, d.mapping)
+    dest.write(row)
+    dest.close
+    assert_equal 1, Person.count
+  end
+  
+  def test_unique
+    row1 = ETL::Row[:id => 1, :first_name => 'Bob', :last_name => 'Smith', :ssn => '111234444']
+    row2 = ETL::Row[:id => 2, :first_name => 'Bob', :last_name => 'Smith', :ssn => '111234444']
+    row3 = ETL::Row[:id => 3, :first_name => 'John', :last_name => 'Smith', :ssn => '000112222']
+         
+    outfile = 'output/test_unique.txt'
+    control = ETL::Control::Control.parse(File.dirname(__FILE__) + '/delimited.ctl')
+
+    # First define a basic configuration to check defaults
+    configuration = { :file => outfile, :buffer_size => 0, :unique => [:ssn]}
+    mapping = { 
+      :order => [:first_name, :last_name, :ssn]
+    }
+    dest = ETL::Control::FileDestination.new(control, configuration, mapping)    
+    dest.write(row1)
+    dest.write(row2)
+    dest.write(row3)
+    
+    # Close (and flush) the destination
+    dest.close
+    
+    # Read back the resulting
+    lines = open(File.join(File.dirname(__FILE__), outfile), 'r').readlines
+    assert_equal "Bob,Smith,111234444\n", lines[0]
+    assert_equal "John,Smith,000112222\n", lines[1]
+  end
+  
+  def test_multiple_unique
+    row1 = ETL::Row[:id => 1, :first_name => 'Bob', :last_name => 'Smith', :ssn => '111234444']
+    row2 = ETL::Row[:id => 2, :first_name => 'Bob', :last_name => 'Smith', :ssn => '111234444']
+    row3 = ETL::Row[:id => 3, :first_name => 'Bob', :last_name => 'Smith', :ssn => '000112222']
+    
+    outfile = 'output/test_multiple_unique.txt'
+    control = ETL::Control::Control.parse(File.dirname(__FILE__) + '/delimited.ctl')
+
+    # First define a basic configuration to check defaults
+    configuration = { :file => outfile, :buffer_size => 0, :unique => [:last_name,:first_name]}
+    mapping = { 
+      :order => [:first_name, :last_name, :ssn]
+    }
+    dest = ETL::Control::FileDestination.new(control, configuration, mapping)    
+    dest.write(row1)
+    dest.write(row2)
+    dest.write(row3)
+    
+    # Close (and flush) the destination
+    dest.close
+    
+    # Read back the resulting
+    lines = open(File.join(File.dirname(__FILE__), outfile), 'r').readlines
+    assert_equal "Bob,Smith,111234444\n", lines[0]
+    assert_equal 1, lines.length
+  end
+
+  def test_bad_destination
+    control = ETL::Control::Control.parse_text('')
+    configuration = {}
+    mapping = {}
+    dest = BadDestination.new(control, configuration, mapping)
+    dest.write(nil)
+    assert_raise NotImplementedError do
+      dest.flush
+    end
+    assert_raise NotImplementedError do
+      dest.close
+    end
+  end
+
+  def test_excel_destination
+    outfile = 'output/test_excel_destination.xls'
+    row = ETL::Row[ :address => '123 SW 1st Street', :city => 'Melbourne', 
+      :state => 'Florida', :country => 'United States' ]
+    control = ETL::Control::Control.parse(File.dirname(__FILE__) + 
+      '/delimited_excel.ctl')
+
+    # First define a basic configuration to check defaults
+    configuration = { 
+      :file => outfile, 
+      :buffer_size => 0,
+    }
+    mapping = { 
+      :order => [:address, :city, :state, :country, :country_code],
+      :virtual => {
+        :country_code => Proc.new do |r|
+          {
+            'United States' => 'US',
+            'Mexico' => 'MX'
+          }[r[:country]]
+        end
+      }
+    }
+    
+    dest = ETL::Control::ExcelDestination.new(control, configuration, mapping)    
+    dest.write(row)
+    dest.close
+    
+    # Read back the resulting
+    book = Spreadsheet.open File.join(File.dirname(__FILE__), outfile)
+    sheet = book.worksheet(0)
+
+    assert_equal "123 SW 1st Street", sheet[0, 0]
+    assert_equal "Melbourne", sheet[0, 1]
+    assert_equal "Florida", sheet[0, 2]
+    assert_equal "United States", sheet[0, 3]
+    assert_equal "US", sheet[0, 4]
+  end
+
+  # Test a update database destination
+  def test_update_database_destination
+    row = ETL::Row[:id => 1, :first_name => 'Bob', :last_name => 'Smith', :ssn => '111234444']
+    control = ETL::Control::Control.parse(File.dirname(__FILE__) + 
+      '/delimited_update.ctl')
+    
+    Person.delete_all
+    assert_equal 0, Person.count
+    test_database_destination
+
+    # First define a basic configuration to check defaults
+    configuration = { 
+      :type => :update_database,
+      :target => :data_warehouse,
+      :database => 'etl_unittest',
+      :table => 'people',
+      :buffer_size => 0 
+    }
+    mapping = {
+      :conditions => [{:field => "\#{conn.quote_column_name(:id)}", :value => "\#{conn.quote(row[:id])}", :comp => "="}],
+      :order => [:id, :first_name, :last_name, :ssn]
+    }
+    dest = ETL::Control::UpdateDatabaseDestination.new(control, configuration, mapping)
+    dest.write(row)
+    dest.close
+    
+    assert_equal 1, Person.find(:all).length
+
+  end
+
+  # Test a insert update database destination
+  def test_insert_update_database_destination
+    row = ETL::Row[:id => 1, :first_name => 'Bob', :last_name => 'Smith', :ssn => '111234444']
+    row_needs_escape = ETL::Row[:id => 2, :first_name => "Foo's", :last_name => "Bar", :ssn => '000000000' ]
+    row_needs_update = ETL::Row[:id => 1, :first_name => "Sean", :last_name => "Toon", :ssn => '000000000' ]
+    control = ETL::Control::Control.parse(File.dirname(__FILE__) + 
+      '/delimited_insert_update.ctl')
+    
+    Person.delete_all
+    assert_equal 0, Person.count
+    
+    # First define a basic configuration to check defaults
+    configuration = { 
+      :type => :insert_update_database,
+      :target => :data_warehouse,
+      :database => 'etl_unittest',
+      :table => 'people',
+      :buffer_size => 0 
+    }
+    mapping = {
+      :primarykey => [:id],
+      :order => [:id, :first_name, :last_name, :ssn]
+    }
+    dest = ETL::Control::InsertUpdateDatabaseDestination.new(control, configuration, mapping)
+    dest.write(row)
+    dest.write(row_needs_escape)
+    dest.write(row_needs_update)
+    dest.close
+    
+    assert_equal 2, Person.find(:all).length
+  end
+  
+end

data/test/directive_test.rb

@@ -0,0 +1,23 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class BadDirective < ETL::Batch::Directive
+  
+end
+
+class BatchTest < Test::Unit::TestCase
+  
+  attr_reader :file
+  attr_reader :engine
+  def setup
+    @file =  File.dirname(__FILE__) + '/all.ebf'
+    @engine = ETL::Engine.new
+  end
+  
+  def test_directive_without_implementation_should_fail
+    batch = ETL::Batch::Batch.resolve(file, engine)
+    assert_raise RuntimeError do
+      d = BadDirective.new(batch)
+      d.execute
+    end
+  end
+end

data/test/encode_processor_test.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+require File.dirname(__FILE__) + '/test_helper'
+
+class EncodeProcessorTest < Test::Unit::TestCase
+
+  SOURCE = 'data/encode_source_latin1.txt'
+  TARGET = 'output/encode_destination_utf-8.txt'
+
+  def setup
+    @control = flexmock("control")
+    @control.should_receive(:file).twice.and_return(File.dirname(__FILE__) + '/fake-control.ctl')
+  end
+  
+  def test_should_transform_a_latin1_file_to_utf8_with_grace
+    configuration = { :source_file => SOURCE, :source_encoding => 'latin1', :target_file => TARGET, :target_encoding => 'utf-8' }
+    ETL::Processor::EncodeProcessor.new(@control, configuration).process
+    assert_equal "éphémère has accents.\nlet's encode them.", IO.read(File.join(File.dirname(__FILE__),TARGET))
+  end
+  
+  def test_should_throw_exception_on_unsupported_encoding
+    configuration = { :source_file => SOURCE, :source_encoding => 'acme-encoding', :target_file => TARGET, :target_encoding => 'utf-8' }
+    error = assert_raise(ETL::ControlError) { ETL::Processor::EncodeProcessor.new(@control, configuration) }
+    assert_equal "Either the source encoding 'acme-encoding' or the target encoding 'utf-8' is not supported", error.message
+  end
+  
+  def test_should_throw_exception_when_target_and_source_are_the_same
+    configuration = { :source_file => SOURCE, :source_encoding => 'latin1', :target_file => SOURCE, :target_encoding => 'utf-8' }
+    error = assert_raise(ETL::ControlError) { ETL::Processor::EncodeProcessor.new(@control, configuration) }
+    assert_equal "Source and target file cannot currently point to the same file", error.message
+  end
+  
+end