Version 0.32
[gitmo/MooseX-Storage.git] / lib / MooseX / Storage / IO / AtomicFile.pm
index 8d29e18..efd41dc 100644 (file)
@@ -1,16 +1,20 @@
-
 package MooseX::Storage::IO::AtomicFile;
 use Moose::Role;
 
 use MooseX::Storage::Engine::IO::AtomicFile;
 
+our $VERSION   = '0.32';
+our $AUTHORITY = 'cpan:STEVAN';
+
 with 'MooseX::Storage::IO::File';
 
 sub store {
-    my ( $self, $filename ) = @_;
-    MooseX::Storage::Engine::IO::AtomicFile->new( file => $filename )->store( $self->freeze() );
+    my ( $self, $filename, @args ) = @_;
+    MooseX::Storage::Engine::IO::AtomicFile->new( file => $filename )->store( $self->freeze(@args) );
 }
 
+no Moose::Role;
+
 1;
 
 __END__
@@ -19,11 +23,29 @@ __END__
 
 =head1 NAME
 
-MooseX::Storage::IO::AtomicFile
+MooseX::Storage::IO::AtomicFile - An Atomic File I/O role
 
 =head1 SYNOPSIS
 
-=head1 DESCRIPTION
+  package Point;
+  use Moose;
+  use MooseX::Storage;
+
+  with Storage('format' => 'JSON', 'io' => 'AtomicFile');
+
+  has 'x' => (is => 'rw', isa => 'Int');
+  has 'y' => (is => 'rw', isa => 'Int');
+
+  1;
+
+  my $p = Point->new(x => 10, y => 10);
+
+  ## methods to load/store a class
+  ## on the file system
+
+  $p->store('my_point.json');
+
+  my $p2 = Point->load('my_point.json');
 
 =head1 METHODS
 
@@ -45,7 +67,7 @@ MooseX::Storage::IO::AtomicFile
 
 =head1 BUGS
 
-All complex software has bugs lurking in it, and this module is no 
+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.
 
@@ -57,7 +79,7 @@ Stevan Little E<lt>stevan.little@iinteractive.comE<gt>
 
 =head1 COPYRIGHT AND LICENSE
 
-Copyright 2007 by Infinity Interactive, Inc.
+Copyright 2007-2008 by Infinity Interactive, Inc.
 
 L<http://www.iinteractive.com>