NAME

Business::Shipping::DataTools - Convert tables from original format into usable format.

VERSION

Version 1.01

SYNOPSIS

bin/update.pl

This is an optional module. It is used to update Business::Shipping::DataFiles. These tools convert the original source data obtained from shippers into a format that Business::Shipping can use. It is normally run only once per year when UPS releases new tables (which explains the poor quality of the source code).

It will unzip the data UPS data files and create .dat files. These .dat files are used by Business::Shipping, you can copy them to the data directory.

REQUIRED MODULES

Archive::Zip
Text::CSV::Simple

INSTALLATION

All that is necessary to begin using this module is to untar it. You do not need to 'perl Makefile.PL' or make or anything else.

• do_update

• download_to_file( $url, $file )

• _unzip_file( $zipName, $destination_directory )

• filename_only( $path )

  Was filename_only.

• split_dir_file( $path )

• remove_extension( $file )

• remove_windows_carriage_returns( $path )

* scrub_file( $filename )

Removes blank lines.

• do_download

• do_unzip

• get_files_to_process()

  * Find all *rate* csv files in the data directory (and sub-dirs)
  * Ignore zone files (because they can be used as-is) 
  * Ignore other files (zip files, extented area, residential, domestic, fuel surcharge, etc. files).

• do_convert_data()

  Find all data .csv files and convert them from the vanilla UPS CSV format into one that Business::Shipping can use.

remove_misc()

Removes dollar signs, some extra spaces, empty lines, and lines with just commas.

• rename_tables_that_start_with_numbers

• rename_tables_that_have_a_dash

• auto_update

• get_fh( $filename )

• close_fh( $file_handle )

AUTHOR

Dan Browning, <db@kavod.com>

BUGS

Please report any bugs or feature requests to bug-business-shipping-datatools@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT & LICENSE

Copyright 2004-2005 Daniel Browning <db@kavod.com>, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.