File Coverage

lib/Spreadsheet/XLSX/Reader/LibXML/Types.pm

Criterion	Covered	Total	%
statement	19	19	100.0
branch			n/a
condition			n/a
subroutine	7	7	100.0
pod			n/a
total	26	26	100.0

package Spreadsheet::XLSX::Reader::LibXML::Types;
our $AUTHORITY = 'cpan:JANDREW';
use version; our $VERSION = qv('v0.38.18');
###LogSD	warn "You uncovered internal logging statements for Spreadsheet::XLSX::Reader::LibXML::Types-$VERSION";

use strict;
use warnings;
use Type::Utils -all;
use Type::Library 1.000
	-base,
	-declare => qw(
		XMLFile						XLSXFile					ParserType
		NegativeNum					ZeroOrUndef					NotNegativeNum
		IOFileType					ErrorString					SubString
		CellID						PositiveNum					Excel_number_0
		SpecialZeroScientific		SpecialOneScientific		SpecialTwoScientific
		SpecialThreeScientific		SpecialFourScientific		SpecialFiveScientific
		SpecialDecimal
	);#
use IO::File;
BEGIN{ extends "Types::Standard" };
my $try_xs =
		exists($ENV{PERL_TYPE_TINY_XS}) ? !!$ENV{PERL_TYPE_TINY_XS} :
		exists($ENV{PERL_ONLY})         ?  !$ENV{PERL_ONLY} :
		1;
if( $try_xs and exists $INC{'Type/Tiny/XS.pm'} ){
	eval "use Type::Tiny::XS 0.010";
	if( $@ ){
		die "You have loaded Type::Tiny::XS but versions prior to 0.010 will cause this module to fail";
	}
}

#########1 Package Variables  3#########4#########5#########6#########7#########8#########9



#########1 Type Library       3#########4#########5#########6#########7#########8#########9

declare XMLFile,
	as Str,
	where{ $_ =~ /\.xml$/i and -r $_},
	message{
		( $_ !~ /\.xml$/i ) ?
			"The string -$_- does not have an xml file extension" :
		( !-r $_ ) ?
			"Could not find / read the file: $_" :
			'No value passed to the XMLFile test';
    };

declare XLSXFile,
	as Str,
	where{ $_ =~ /\.xls(x|m)$/i and -r $_ },
	message{
		my $test = $_;
		my $return =
			( !defined $test ) ?
				"Empty filename" :
			( ref $test ) ?
				"'" . $test . "' is not a string value" :
			( $test !~ /\.xls(x|m)$/i ) ?
				"The string -$test- does not have an xlsx file extension" :
			( -r $test) ?
				"Could not find / read the file: $test" :
				"Unmanageable value '" . ($test ? $test : '' ) . "' passed" ;
		return $return;
    };

declare IOFileType,
	as InstanceOf[ 'IO::File' ];

coerce IOFileType,
	from GlobRef,
	via{  bless $_, 'IO::File' };

coerce IOFileType,
	from XLSXFile,
	via{  IO::File->new( $_, 'r' ); };

coerce IOFileType,
	from XMLFile,
	via{  IO::File->new( $_, 'r' ); };

declare ParserType,
	as Enum[qw( reader )];#dom  sax

coerce ParserType,
	from Str,
	via{ lc( $_ ) };

declare CellID,
	as StrMatch[ qr/^[A-Z]{1,3}[1-9]\d*$/ ];

declare PositiveNum,
	as Num,
	where{ $_ > 0 };

declare NegativeNum,
	as Num,
	where{ $_ < 0 };

declare ZeroOrUndef,
	as Maybe[Num],
	where{ !$_ };

declare NotNegativeNum,
	as Num,
	where{ $_ > -1 };

declare SubString,
	as Str;

declare ErrorString,
	as SubString,
	where{ $_ !~ /\)\n;/ };

coerce SubString,
	from Object,
	via{
	my	$object = $_;
		if( $object->can( 'as_string' ) ){
			return $object->as_string;
		}elsif( $object->can( 'message' ) ){
			return $object->message;
		}
		return $object;
	};

coerce ErrorString,
	from SubString->coercibles,
	via{
	my	$tmp = to_SubString($_);
		$tmp =~ s/\)\n;/\);/g;
		return $tmp;
	};

declare SpecialZeroScientific,
	as Str,
	where{ return $_ =~ /^\-?[0-9]+E-?\d{2,50}/i };#print "--$_\n";

coerce SpecialZeroScientific,
	from Str,
	via{
		my	$string = $_;
		$string =~ /([\-\d\.]+)[Ee](-)?(\d+)/i;#
		#~ print "$1\n";
		#~ print "$2\n";
		#~ print "$3\n";
		my	$return = sprintf '%.0f', $1;
		#~ print "$return\n";
			$return .= 'E' . sprintf '%s%02d', $2, $3;
		#~ print "$return\n";
		return $return;
	};

declare SpecialOneScientific,
	as Str,
	where{ return $_ =~ /^\-?[0-9]+\.\dE-?\d{2,50}/i };#print "--$_\n";

coerce SpecialOneScientific,
	from Str,
	via{
		my	$string = $_;
		$string =~ /([\-\d\.]+)[Ee](-)?(\d+)/i;#
		#~ print "$1\n";
		#~ print "$2\n";
		#~ print "$3\n";
		my	$return = sprintf '%.1f', $1;
		#~ print "$return\n";
			$return .= 'E' . sprintf '%s%02d', $2, $3;
		#~ print "$return\n";
		return $return;
	};

declare SpecialTwoScientific,
	as Str,
	where{ return $_ =~ /^\-?[0-9]+\.\d{2}E-?\d{2,50}/i };#print "--$_\n";

coerce SpecialTwoScientific,
	from Str,
	via{
		my	$string = $_;
		$string =~ /([\-\d\.]+)[Ee](-)?(\d+)/i;#
		#~ print "$1\n";
		#~ print "$2\n";
		#~ print "$3\n";
		my	$return = sprintf '%.2f', $1;
		#~ print "$return\n";
			$return .= 'E' . sprintf '%s%02d', $2, $3;
		#~ print "$return\n";
		return $return;
	};

declare SpecialThreeScientific,
	as Str,
	where{ return $_ =~ /^\-?[0-9]+\.\d{3}E-?\d{2,50}/i };#print "--$_\n";

coerce SpecialThreeScientific,
	from Str,
	via{
		my	$string = $_;
		$string =~ /([\-\d\.]+)[Ee](-)?(\d+)/i;#
		#~ print "$1\n";
		#~ print "$2\n";
		#~ print "$3\n";
		my	$return = sprintf '%.3f', $1;
		#~ print "$return\n";
			$return .= 'E' . sprintf '%s%02d', $2, $3;
		#~ print "$return\n";
		return $return;
	};

declare SpecialFourScientific,
	as Str,
	where{ return $_ =~ /^\-?[0-9]+\.\d{4}E-?\d{2,50}/i };#print "--$_\n";

coerce SpecialFourScientific,
	from Str,
	via{
		my	$string = $_;
		$string =~ /([\-\d\.]+)[Ee](-)?(\d+)/i;#
		#~ print "$1\n";
		#~ print "$2\n";
		#~ print "$3\n";
		my	$return = sprintf '%.4f', $1;
		#~ print "$return\n";
			$return .= 'E' . sprintf '%s%02d', $2, $3;
		#~ print "$return\n";
		return $return;
	};

declare SpecialFiveScientific,
	as Str,
	where{ return $_ =~ /^\-?[0-9]+\.\d{5}E-?\d{2,50}/i };#print "--$_\n";

coerce SpecialFiveScientific,
	from Str,
	via{
		my	$string = $_;
		$string =~ /([\-\d\.]+)[Ee](-)?(\d+)/i;#
		#~ print "$1\n";
		#~ print "$2\n";
		#~ print "$3\n";
		my	$return = sprintf '%.5f', $1;
		#~ print "$return\n";
			$return .= 'E' . sprintf '%s%02d', $2, $3;
		#~ print "$return\n";
		return $return;
	};

declare SpecialDecimal,
	as Str,
	where{ return $_ =~ /\.\d{1,9}$/i };#print "--$_\n";

coerce SpecialDecimal,
	from Str,
	via{
		my	$string = $_;
		my	$return = sprintf '%.9f', $string;
		#~ print "$return\n";
			$return =~ /(.*[1-9])(0*)$/;
		my	$significant_decimal = $1;
		#~ print "$significant_decimal\n";
		return $significant_decimal;
	};


#########1 Excel Defined Converions     4#########5#########6#########7#########8#########9

declare_coercion Excel_number_0,
	to_type Any, from Maybe[Any],
	via{ $_ };

#########1 Public Attributes  3#########4#########5#########6#########7#########8#########9



#########1 Private Methods    3#########4#########5#########6#########7#########8#########9


#########1 Phinish            3#########4#########5#########6#########7#########8#########9

__PACKAGE__->meta->make_immutable;
1;

#########1 Documentation      3#########4#########5#########6#########7#########8#########9
__END__

=head1 NAME

Spreadsheet::XLSX::Reader::LibXML::Types - A type library for the LibXML xlsx reader

=head1 DESCRIPTION

This documentation is written to explain ways to use this module.  To use the general
package for excel parsing out of the box please review the documentation for L<Workbooks
|Spreadsheet::XLSX::Reader::LibXML>, L<Worksheets
|Spreadsheet::XLSX::Reader::LibXML::Worksheet>, and
L<Cells|Spreadsheet::XLSX::Reader::LibXML::Cell>.

This is a L<Type::Library|Type::Tiny::Manual::Libraries> for this package.  There are no
real tricks here outside of the standard Type::Tiny stuf.  For the cool number and date
formatting implementation see L<Spreadsheet::XLSX::Reader::LibXML::ParseExcelFormatStrings>.

=head1 TYPES

=head2 XMLFile

This type checks that the value is a readable file (full path - no file find magic
used) with an \.xml extention

=head3 coercions

none

=head2 XLSXFile

This type checks that the value is a readable file (full path - no file find magic
used)  with an \.xlsx or \.xlsm extention

=head3 coercions

none

=head2 IOFileType

This is set as an L<instance of|Types::Standard/InstanceOf[`a]> 'IO::File'

=head3 coercions

=over

B<GlobRef:>  by blessing it into an IO::File instance 'via{  bless $_, 'IO::File' }'

B<XLSXFile:>  by opening it as an IO::File instance 'via{  IO::File->new( $_, 'r' ); }'

B<XMLFile:>  by opening it as an IO::File instance 'via{  IO::File->new( $_, 'r' ); }'

=back

=head2 ParserType

For now this type checks that the parser type string == 'reader'.  As future parser
types are added to the package I will update this type.

=head3 coercions

=over

B<Str:> this will lower case any other version of the string 'reader' (Reader| READER)
to get it to pass

=back

=head2 PositiveNum

This type checks that the value is a number and is greater than 0

=head3 coercions

none

=head2 NegativeNum

This type checks that the value is a number and is less than 0

=head3 coercions

none

=head2 ZeroOrUndef

This type allows the value to be the number 0 or undef

=head3 coercions

none

=head2 NotNegativeNum

This type checks that the value is a number and that the number is greater than
or equal to 0

=head3 coercions

none

=head2 CellID

this is a value that passes the following regular expression test; qr/^[A-Z]{1,3}[1-9]\d*$/

=head3 coercions

none

=head2 SubString

This is a precurser type to ErrorString.  It is used to perform the first layer of coersions
so that error objects can be consumed as-is in this package when a subcomponent throws an
object rather than a string as an error.

=head3 coercions

=over

B<Object:>  it will test the object for two methods and if either one is present it will use
the results of that method as the string.  The methods in order are; 'as_string' and 'message'

=back

=head2 ErrorString

This is a string that can't match the following sequence /\)\n;/
#I don't even remember why that sequence is bad but it is

=head3 coercions

=over

B<SubString:> by using the following substitution on the string; s/\)\n;/\);/g

=back

=head1 NAMED COERCIONS

=head2 Excel_number_0

This is essentially a pass through coercion used as a convenience rather than writing the
pass through each time a coercion is needed but no actual work should be performed on the
value

=head1 SUPPORT

=over

L<github Spreadsheet::XLSX::Reader::LibXML/issues
|https://github.com/jandrew/Spreadsheet-XLSX-Reader-LibXML/issues>

=back

=head1 TODO

=over

B<1.> The ErrorString type tests still needs a 'fail' case

=back

=head1 AUTHOR

=over

=item Jed Lund

=item [e-mail]

=back

=head1 COPYRIGHT

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

The full text of the license can be found in the
LICENSE file included with this module.

This software is copyrighted (c) 2014, 2015 by Jed Lund

=head1 DEPENDENCIES

=over

L<Spreadsheet::XLSX::Reader::LibXML>

=back

=head1 SEE ALSO

=over

L<Spreadsheet::ParseExcel> - Excel 2003 and earlier

L<Spreadsheet::XLSX> - 2007+

L<Spreadsheet::ParseXLSX> - 2007+

L<Log::Shiras|https://github.com/jandrew/Log-Shiras>

=over

All lines in this package that use Log::Shiras are commented out

=back

=back

=cut

#########1#########2 main pod documentation end  5#########6#########7#########8#########9