balinterdi-activewarehouse-etl 0.9.2

data/TODO

@@ -0,0 +1,28 @@
+TODO
+
+* Add build-in support for audit_dimension
+* Do not rerun the processing if it isn't needed, i.e. the source and control files have not been modified (allow forced override)
+* Provide greater control in error handling
+** Allow a error threshold
+** Don't die completely if a parse error, just stop processing that specific file if error threshold is reached
+** Allow mismatch row length error in delimited parser to be ignored
+* Improve error messages throughout, but especially in problems with the control files
+* Add support for paritioned views during the insert process. Use specifiable columns as the trigger columns for determining the data output destination.
+* Check if a temp table exists and the last job run was successful, in which case skip during the current run
+* Create models for each of the tables in each of the databases defined in ETL::Engine.connections
+
+Audit Record
+  
+Process-Level
+  * Start Time
+  * End Time
+  * (Duration)
+  * Rows Read
+  * Rows Written
+  * Rows Rejected
+  * Errors
+  * Destination
+Record-Level
+  * Source
+  * Timestamp
+  * Transformation Log

data/VERSION

@@ -0,0 +1 @@
+0.9.2

data/active_support_logger.patch

@@ -0,0 +1,78 @@
+Index: lib/active_support/clean_logger.rb
+===================================================================
+--- lib/active_support/clean_logger.rb	(revision 5963)
++++ lib/active_support/clean_logger.rb	(working copy)
+@@ -1,10 +1,21 @@
+ require 'logger'
+ require File.dirname(__FILE__) + '/core_ext/class/attribute_accessors'
+ 
+-class Logger #:nodoc:
++# Extensions to the built in Ruby logger.
++#
++# If you want to use the default log formatter as defined in the Ruby core, then you 
++# will need to set the formatter for the logger as in:
++#
++#   logger.formatter = Formatter.new
++#
++# You can then specify the datetime format, for example:
++#
++#   logger.datetime_format = "%Y-%m-%d"
++class Logger
++  # Set to false to disable the silencer
+   cattr_accessor :silencer
+   self.silencer = true
+-
++  
+   # Silences the logger for the duration of the block.
+   def silence(temporary_level = Logger::ERROR)
+     if silencer
+@@ -18,6 +29,35 @@
+       yield self
+     end
+   end
++  
++  alias :old_datetime_format= :datetime_format=
++  # Logging date-time format (string passed to +strftime+). Ignored if the formatter
++  # does not respond to datetime_format=.
++  def datetime_format=(datetime_format)
++    formatter.datetime_format = datetime_format if formatter.respond_to?(:datetime_format=)
++  end
++  
++  alias :old_datetime_format :datetime_format
++  # Get the logging datetime format. Returns nil if the formatter does not support
++  # datetime formatting.
++  def datetime_format
++    formatter.datetime_format if formatter.respond_to?(:datetime_format)
++  end
++  
++  alias :old_formatter :formatter
++  # Get the current formatter. The default formatter is a SimpleFormatter which only
++  # displays the log message
++  def formatter
++    @formatter ||= SimpleFormatter.new
++  end
++  
++  # Simple formatter which only displays the message.
++  class SimpleFormatter < Logger::Formatter
++    # This method is invoked when a log event occurs
++    def call(severity, timestamp, progname, msg)
++      "#{msg}\n"
++    end
++  end
+ 
+   private
+     alias old_format_message format_message
+@@ -28,11 +68,11 @@
+     # with Logger from 1.8.3 and vice versa.
+     if method_defined?(:formatter=)
+       def format_message(severity, timestamp, progname, msg)
+-        "#{msg}\n"
++        formatter.call(severity, timestamp, progname, msg)
+       end
+     else
+       def format_message(severity, timestamp, msg, progname)
+-        "#{msg}\n"
++        formatter.call(severity, timestamp, progname, msg)
+       end
+     end
+ end

data/balinterdi-activewarehouse-etl.gemspec

@@ -0,0 +1,221 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE
+# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{balinterdi-activewarehouse-etl}
+  s.version = "0.9.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Anthony Eden", "Balint Erdi"]
+  s.date = %q{2009-10-14}
+  s.description = %q{      ActiveWarehouse ETL is a pure Ruby Extract-Transform-Load application for loading data into a database.
+}
+  s.email = %q{balint.erdi@gmail.com}
+  s.executables = ["etl", "etl.cmd"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README"
+  ]
+  s.files = [
+    ".gitignore",
+     "0.9-UPGRADE",
+     "CHANGELOG",
+     "HOW_TO_RELEASE",
+     "LICENSE",
+     "README",
+     "Rakefile",
+     "TODO",
+     "VERSION",
+     "active_support_logger.patch",
+     "balinterdi-activewarehouse-etl.gemspec",
+     "bin/etl",
+     "bin/etl.cmd",
+     "examples/database.example.yml",
+     "lib/etl.rb",
+     "lib/etl/batch.rb",
+     "lib/etl/batch/batch.rb",
+     "lib/etl/batch/directives.rb",
+     "lib/etl/builder.rb",
+     "lib/etl/builder/date_dimension_builder.rb",
+     "lib/etl/builder/time_dimension_builder.rb",
+     "lib/etl/commands/etl.rb",
+     "lib/etl/control.rb",
+     "lib/etl/control/control.rb",
+     "lib/etl/control/destination.rb",
+     "lib/etl/control/destination/database_destination.rb",
+     "lib/etl/control/destination/file_destination.rb",
+     "lib/etl/control/source.rb",
+     "lib/etl/control/source/database_source.rb",
+     "lib/etl/control/source/enumerable_source.rb",
+     "lib/etl/control/source/file_source.rb",
+     "lib/etl/control/source/model_source.rb",
+     "lib/etl/core_ext.rb",
+     "lib/etl/core_ext/time.rb",
+     "lib/etl/core_ext/time/calculations.rb",
+     "lib/etl/engine.rb",
+     "lib/etl/execution.rb",
+     "lib/etl/execution/base.rb",
+     "lib/etl/execution/batch.rb",
+     "lib/etl/execution/job.rb",
+     "lib/etl/execution/migration.rb",
+     "lib/etl/generator.rb",
+     "lib/etl/generator/generator.rb",
+     "lib/etl/generator/surrogate_key_generator.rb",
+     "lib/etl/http_tools.rb",
+     "lib/etl/parser.rb",
+     "lib/etl/parser/apache_combined_log_parser.rb",
+     "lib/etl/parser/delimited_parser.rb",
+     "lib/etl/parser/fixed_width_parser.rb",
+     "lib/etl/parser/parser.rb",
+     "lib/etl/parser/sax_parser.rb",
+     "lib/etl/parser/xml_parser.rb",
+     "lib/etl/processor.rb",
+     "lib/etl/processor/block_processor.rb",
+     "lib/etl/processor/bulk_import_processor.rb",
+     "lib/etl/processor/check_exist_processor.rb",
+     "lib/etl/processor/check_unique_processor.rb",
+     "lib/etl/processor/copy_field_processor.rb",
+     "lib/etl/processor/encode_processor.rb",
+     "lib/etl/processor/hierarchy_exploder_processor.rb",
+     "lib/etl/processor/print_row_processor.rb",
+     "lib/etl/processor/processor.rb",
+     "lib/etl/processor/rename_processor.rb",
+     "lib/etl/processor/require_non_blank_processor.rb",
+     "lib/etl/processor/row_processor.rb",
+     "lib/etl/processor/sequence_processor.rb",
+     "lib/etl/processor/surrogate_key_processor.rb",
+     "lib/etl/processor/truncate_processor.rb",
+     "lib/etl/row.rb",
+     "lib/etl/screen.rb",
+     "lib/etl/screen/row_count_screen.rb",
+     "lib/etl/transform.rb",
+     "lib/etl/transform/block_transform.rb",
+     "lib/etl/transform/date_to_string_transform.rb",
+     "lib/etl/transform/decode_transform.rb",
+     "lib/etl/transform/default_transform.rb",
+     "lib/etl/transform/foreign_key_lookup_transform.rb",
+     "lib/etl/transform/hierarchy_lookup_transform.rb",
+     "lib/etl/transform/ordinalize_transform.rb",
+     "lib/etl/transform/sha1_transform.rb",
+     "lib/etl/transform/string_to_date_transform.rb",
+     "lib/etl/transform/string_to_datetime_transform.rb",
+     "lib/etl/transform/string_to_time_transform.rb",
+     "lib/etl/transform/transform.rb",
+     "lib/etl/transform/trim_transform.rb",
+     "lib/etl/transform/type_transform.rb",
+     "lib/etl/util.rb",
+     "lib/etl/version.rb",
+     "test/.ignore",
+     "test/all.ebf",
+     "test/apache_combined_log.ctl",
+     "test/batch_test.rb",
+     "test/batch_with_error.ebf",
+     "test/batched1.ctl",
+     "test/batched2.ctl",
+     "test/block_processor.ctl",
+     "test/block_processor_error.ctl",
+     "test/block_processor_pre_post_process.ctl",
+     "test/block_processor_remove_rows.ctl",
+     "test/block_processor_test.rb",
+     "test/connection/native_mysql/connection.rb",
+     "test/connection/native_mysql/schema.sql",
+     "test/connection/postgresql/connection.rb",
+     "test/connection/postgresql/schema.sql",
+     "test/control_test.rb",
+     "test/data/apache_combined_log.txt",
+     "test/data/bulk_import.txt",
+     "test/data/bulk_import_with_empties.txt",
+     "test/data/decode.txt",
+     "test/data/delimited.txt",
+     "test/data/encode_source_latin1.txt",
+     "test/data/fixed_width.txt",
+     "test/data/multiple_delimited_1.txt",
+     "test/data/multiple_delimited_2.txt",
+     "test/data/people.txt",
+     "test/data/sax.xml",
+     "test/data/xml.xml",
+     "test/database.example.yml",
+     "test/database.mysql.yml",
+     "test/database.postgres.yml",
+     "test/database.yml",
+     "test/date_dimension_builder_test.rb",
+     "test/delimited.ctl",
+     "test/delimited_absolute.ctl",
+     "test/delimited_destination_db.ctl",
+     "test/delimited_with_bulk_load.ctl",
+     "test/destination_test.rb",
+     "test/directive_test.rb",
+     "test/encode_processor_test.rb",
+     "test/engine_test.rb",
+     "test/errors.ctl",
+     "test/etl_test.rb",
+     "test/fixed_width.ctl",
+     "test/generator_test.rb",
+     "test/inline_parser.ctl",
+     "test/mocks/mock_destination.rb",
+     "test/mocks/mock_source.rb",
+     "test/model_source.ctl",
+     "test/multiple_delimited.ctl",
+     "test/multiple_source_delimited.ctl",
+     "test/output/.ignore",
+     "test/parser_test.rb",
+     "test/performance/delimited.ctl",
+     "test/processor_test.rb",
+     "test/row_processor_test.rb",
+     "test/sax.ctl",
+     "test/scd/1.txt",
+     "test/scd/2.txt",
+     "test/scd/3.txt",
+     "test/scd_test.rb",
+     "test/scd_test_type_1.ctl",
+     "test/scd_test_type_2.ctl",
+     "test/screen_test.rb",
+     "test/screen_test_error.ctl",
+     "test/screen_test_fatal.ctl",
+     "test/source_test.rb",
+     "test/test_helper.rb",
+     "test/transform_test.rb",
+     "test/xml.ctl"
+  ]
+  s.homepage = %q{http://github.com/balinterdi/activewarehouse-etl}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{ActiveWarehouse ETL}
+  s.test_files = [
+    "test/batch_test.rb",
+     "test/block_processor_test.rb",
+     "test/connection/native_mysql/connection.rb",
+     "test/connection/postgresql/connection.rb",
+     "test/control_test.rb",
+     "test/date_dimension_builder_test.rb",
+     "test/destination_test.rb",
+     "test/directive_test.rb",
+     "test/encode_processor_test.rb",
+     "test/engine_test.rb",
+     "test/etl_test.rb",
+     "test/generator_test.rb",
+     "test/mocks/mock_destination.rb",
+     "test/mocks/mock_source.rb",
+     "test/parser_test.rb",
+     "test/processor_test.rb",
+     "test/row_processor_test.rb",
+     "test/scd_test.rb",
+     "test/screen_test.rb",
+     "test/source_test.rb",
+     "test/test_helper.rb",
+     "test/transform_test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/bin/etl

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+
+#--
+# Copyright (c) 2006 Anthony Eden
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+require 'etl'
+require 'etl/commands/etl'

data/bin/etl.cmd

@@ -0,0 +1,8 @@
+@echo off
+
+rem The purpose of this Windows script is to let you use the etl command line with a non-gem version of AW-ETL (eg: unpacked gem, pistoned trunk).
+rem Just add the current folder on top of your PATH variable to use it instead of the etl command provided with the gem release.
+
+rem %~dp0 returns the absolute path where the current script is. We just append 'etl' to it, and forward all the arguments with %*
+
+ruby "%~dp0etl" %*

data/examples/database.example.yml

@@ -0,0 +1,16 @@
+etl_execution:
+  adapter: mysql
+  username: root
+  host: localhost
+  database: etl_execution
+  encoding: utf8
+datawarehouse:
+  adapter: mysql
+  username: root
+  host: localhost
+  database: datawarehouse_development
+operational:
+  adapter: mysql
+  username: root
+  host: localhost
+  database: operational_production

data/lib/etl.rb

@@ -0,0 +1,78 @@
+# This source file requires all of the necessary gems and source files for ActiveWarehouse ETL. If you
+# load this source file all of the other required files and gems will also be brought into the 
+# runtime.
+
+#--
+# Copyright (c) 2006-2007 Anthony Eden
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+
+require 'logger'
+require 'yaml'
+require 'erb'
+
+require 'rubygems'
+
+unless defined?(REXML::VERSION)
+  require 'rexml/rexml'
+  REXML::VERSION = REXML::Version
+end
+
+require 'active_support'
+require 'active_record'
+require 'adapter_extensions'
+require 'faster_csv'
+
+$:.unshift(File.dirname(__FILE__))
+
+require 'etl/core_ext'
+require 'etl/util'
+require 'etl/http_tools'
+require 'etl/builder'
+require 'etl/version'
+require 'etl/engine'
+require 'etl/control'
+require 'etl/batch'
+require 'etl/row'
+require 'etl/parser'
+require 'etl/transform'
+require 'etl/processor'
+require 'etl/generator'
+require 'etl/screen'
+
+module ETL #:nodoc:
+  class ETLError < StandardError #:nodoc:
+  end
+  class ControlError < ETLError #:nodoc:
+  end
+  class DefinitionError < ControlError #:nodoc:
+  end
+  class ConfigurationError < ControlError #:nodoc:
+  end
+  class MismatchError < ETLError #:nodoc:
+  end
+  class ResolverError < ETLError #:nodoc:
+  end
+  class ScreenError < ETLError #:nodoc:
+  end
+  class FatalScreenError < ScreenError #:nodoc:
+  end
+end