NAME

       Catmandu::Exporter::XLS - Package that exports XLS files

SYNOPSIS

           # On the command line
           $ printf "a,b,c\n1,2,3" | catmandu convert CSV to XLS --file test.xls
           $ printf "a,b,c\n1,2,3" | catmandu convert CSV to XLS --file test.xls --header 0
           $ printf "a,b,c\n1,2,3" | catmandu convert CSV to XLS --file test.xls --fields a,c
           $ printf "a,b,c\n1,2,3" | catmandu convert CSV to XLS --file test.xls --fields a,c --columns ALPHA,CHARLIE

           # Or in Perl
           use Catmandu::Exporter::XLS;

           my $exporter = Catmandu::Exporter::XLS->new(
                       file => 'test.xls',
                       fields => 'a,b,c',
                       columns => 'ALPHA,BRAVO,CHARLIE',
                       header => 1);

           $exporter->add({a => 1, b => 2, c => 3});
           $exporter->add_many($arrayref);

           $exporter->commit;

           printf "exported %d objects\n" , $exporter->count;

DESCRIPTION

       Catmandu exporter for Excel XLS files.

METHODS

       See Catmandu::Exporter, Catmandu::Addable, Catmandu::Fixable, Catmandu::Counter, and
       Catmandu::Logger for a full list of methods.

CONFIGURATION

       In addition to the configuration provided by Catmandu::Exporter ("file", "fh", etc.) the
       importer can be configured with the following parameters:

       header
           Include a header line with column names, if set to 1 (default).

       fields
           List of fields to be used as columns, given as array reference or comma-separated
           string

       columns
           List of custom column names, given as array reference or comma-separated list.

       collect_fields
           This option will first read the complete stream to create a complete list of fields to
           export. When this option is not set, only the fields of the first record (or the ones
           provided in the "fields" option will be exported).

SEE ALSO

       Catmandu::Exporter::CSV, Catmandu::Exporter::XLSX.