preliminary docs added, improved support for subclassing and sid_generator callback...

[catagits/Web-Session.git] / lib / Plack / Session / Store.pm

diff --git a/lib/Plack/Session/Store.pm b/lib/Plack/Session/Store.pm
index 3f52679..e20c196 100644 (file)
--- a/lib/Plack/Session/Store.pm
+++ b/lib/Plack/Session/Store.pm
@@ -4,7 +4,11 @@ use warnings;
 
 use Plack::Util::Accessor qw[ _stash ];
 
-sub new { bless { _stash => {} } => shift }
+sub new {
+    my ($class, %params) = @_;
+    $params{'_stash'} ||= +{};
+    bless { %params } => $class;
+}
 
 sub fetch {
     my ($self, $session_id, $key) = @_;
@@ -21,14 +25,72 @@ sub delete {
     delete $self->_stash->{ $session_id }->{ $key };
 }
 
-sub persist {
-    my ($self, $session_id) = @_;
-    ()
-}
-
 sub cleanup {
     my ($self, $session_id) = @_;
     delete $self->_stash->{ $session_id }
 }
 
-1;
\ No newline at end of file
+sub persist {
+    my ($self, $session_id, $response) = @_;
+    ()
+}
+
+1;
+
+__END__
+
+=pod
+
+=head1 NAME
+
+Plack::Session::Store - Basic in-memory session store
+
+=head1 DESCRIPTION
+
+=head1 METHODS
+
+=over 4
+
+=item B<new ( %params )>
+
+=back
+
+=over 4
+
+=item B<fetch ( $session_id, $key )>
+
+=item B<store ( $session_id, $key, $data )>
+
+=item B<delete ( $session_id, $key )>
+
+=back
+
+=over 4
+
+=item B<persist ( $session_id, $response )>
+
+=item B<cleanup ( $session_id )>
+
+=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
+
+Stevan Little E<lt>stevan.little@iinteractive.comE<gt>
+
+=head1 COPYRIGHT AND LICENSE
+
+Copyright 2009 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
+