Version 0.32
[gitmo/MooseX-Storage.git] / lib / MooseX / Storage / Engine / IO / File.pm
index d6f9854..3f03d55 100644 (file)
@@ -2,24 +2,86 @@
 package MooseX::Storage::Engine::IO::File;
 use Moose;
 
+use utf8 ();
 use IO::File;
 
-has file => (
-       isa => 'Str',
-       is  => 'ro',
+our $VERSION   = '0.32';
+our $AUTHORITY = 'cpan:STEVAN';
+
+has 'file' => (
+       is       => 'ro',
+       isa      => 'Str',      
        required => 1,
 );
 
 sub load { 
        my ($self) = @_;
-       my $fh = IO::File->new($self->file, 'r');
+       my $fh = IO::File->new($self->file, 'r')
+           || confess "Unable to open file (" . $self->file . ") for loading : $!";
        return do { local $/; <$fh>; };
 }
 
 sub store {
        my ($self, $data) = @_;
-       my $fh = IO::File->new($self->file, 'w');
+       my $fh = IO::File->new($self->file, 'w')
+               || confess "Unable to open file (" . $self->file . ") for storing : $!";
+       $fh->binmode(':utf8') if utf8::is_utf8($data);
        print $fh $data;
 }
 
-1;
\ No newline at end of file
+1;
+
+__END__
+
+=pod
+
+=head1 NAME
+
+MooseX::Storage::Engine::IO::File - The actually file storage mechanism.
+
+=head1 DESCRIPTION
+
+This provides the actual means to store data to a file.
+
+=head1 METHODS
+
+=over 4
+
+=item B<file>
+
+=item B<load>
+
+=item B<store ($data)>
+
+=back
+
+=head2 Introspection
+
+=over 4
+
+=item B<meta>
+
+=back
+
+=head1 BUGS
+
+All complex software has bugs lurking in it, and this module is no 
+exception. If you find a bug please either email me, or add the bug
+to cpan-RT.
+
+=head1 AUTHOR
+
+Chris Prather E<lt>chris.prather@iinteractive.comE<gt>
+
+Stevan Little E<lt>stevan.little@iinteractive.comE<gt>
+
+=head1 COPYRIGHT AND LICENSE
+
+Copyright 2007-2008 by Infinity Interactive, Inc.
+
+L<http://www.iinteractive.com>
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+=cut