pre-0.02 commit

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

diff --git a/lib/Plack/Session/Store/Null.pm b/lib/Plack/Session/Store/Null.pm
index 3ab6ccb..493143f 100644 (file)
--- a/lib/Plack/Session/Store/Null.pm
+++ b/lib/Plack/Session/Store/Null.pm
@@ -2,6 +2,9 @@ package Plack::Session::Store::Null;
 use strict;
 use warnings;
 
+our $VERSION   = '0.02';
+our $AUTHORITY = 'cpan:STEVAN';
+
 sub new     { bless {} => shift }
 sub fetch   {}
 sub store   {}
@@ -9,6 +12,8 @@ sub delete  {}
 sub cleanup {}
 sub persist {}
 
+sub dump_session { +{} }
+
 1;
 
 __END__
@@ -19,12 +24,31 @@ __END__
 
 Plack::Session::Store::Null - Null store
 
+=head1 SYNOPSIS
+
+  use Plack::Builder;
+  use Plack::Middleware::Session;
+  use Plack::Session::Store::Null;
+
+  my $app = sub {
+      return [ 200, [ 'Content-Type' => 'text/plain' ], [ 'Hello Foo' ] ];
+  };
+
+  builder {
+      enable 'Session',
+          store => Plack::Session::Store::Null->new;
+      $app;
+  };
+
 =head1 DESCRIPTION
 
 Sometimes you don't want to store anything in your sessions, but
 L<Plack::Session> requires a C<store> instance, so you can use this
 one and all methods will return null.
 
+This is a subclass of L<Plack::Session::Store> and implements
+it's full interface.
+
 =head1 BUGS
 
 All complex software has bugs lurking in it, and this module is no