[Catalyst-commits] r7393 - in trunk/Catalyst-Plugin-Session-Store-FastMmap: . lib/Catalyst/Plugin/Session/Store

karpet at dev.catalyst.perl.org karpet at dev.catalyst.perl.org
Wed Jan 16 16:31:43 GMT 2008


Author: karpet
Date: 2008-01-16 16:31:43 +0000 (Wed, 16 Jan 2008)
New Revision: 7393

Added:
   trunk/Catalyst-Plugin-Session-Store-FastMmap/MANIFEST
   trunk/Catalyst-Plugin-Session-Store-FastMmap/Makefile.PL
   trunk/Catalyst-Plugin-Session-Store-FastMmap/README
Removed:
   trunk/Catalyst-Plugin-Session-Store-FastMmap/Build.PL
Modified:
   trunk/Catalyst-Plugin-Session-Store-FastMmap/Changes
   trunk/Catalyst-Plugin-Session-Store-FastMmap/lib/Catalyst/Plugin/Session/Store/FastMmap.pm
Log:
clean up old MB stuff and instead use EUM

Deleted: trunk/Catalyst-Plugin-Session-Store-FastMmap/Build.PL
===================================================================
--- trunk/Catalyst-Plugin-Session-Store-FastMmap/Build.PL	2008-01-16 12:36:28 UTC (rev 7392)
+++ trunk/Catalyst-Plugin-Session-Store-FastMmap/Build.PL	2008-01-16 16:31:43 UTC (rev 7393)
@@ -1,22 +0,0 @@
-use strict;
-use Module::Build;
-
-my $build = Module::Build->new(
-    create_makefile_pl => 'traditional',
-    license            => 'perl',
-    module_name        => 'Catalyst::Plugin::Session::Store::FastMmap',
-    requires           => {
-        'Catalyst::Plugin::Session' => '0.09',
-        ($^O eq 'MSWin32' 
-            ? 'Cache::FastMmap::WithWin32'
-            : 'Cache::FastMmap'          
-        ) => 1.13,
-        'File::Temp'                => 0,
-        'File::Spec'                => 0,
-        'Path::Class'               => 0,
-    },
-    create_readme => 1,
-    sign          => 1,
-);
-$build->create_build_script;
-

Modified: trunk/Catalyst-Plugin-Session-Store-FastMmap/Changes
===================================================================
--- trunk/Catalyst-Plugin-Session-Store-FastMmap/Changes	2008-01-16 12:36:28 UTC (rev 7392)
+++ trunk/Catalyst-Plugin-Session-Store-FastMmap/Changes	2008-01-16 16:31:43 UTC (rev 7393)
@@ -1,3 +1,6 @@
+0.05    16 Jan 2008
+        - removed all Module::Build cruft - karman
+
 0.04    - patch for Class::C3 compatability - karman
 
 0.03

Added: trunk/Catalyst-Plugin-Session-Store-FastMmap/MANIFEST
===================================================================
--- trunk/Catalyst-Plugin-Session-Store-FastMmap/MANIFEST	                        (rev 0)
+++ trunk/Catalyst-Plugin-Session-Store-FastMmap/MANIFEST	2008-01-16 16:31:43 UTC (rev 7393)
@@ -0,0 +1,9 @@
+Changes
+lib/Catalyst/Plugin/Session/Store/FastMmap.pm
+MANIFEST			This list of files
+t/01use.t
+t/02pod.t
+t/03podcoverage.t
+t/basic.t
+Makefile.PL
+README

Added: trunk/Catalyst-Plugin-Session-Store-FastMmap/Makefile.PL
===================================================================
--- trunk/Catalyst-Plugin-Session-Store-FastMmap/Makefile.PL	                        (rev 0)
+++ trunk/Catalyst-Plugin-Session-Store-FastMmap/Makefile.PL	2008-01-16 16:31:43 UTC (rev 7393)
@@ -0,0 +1,17 @@
+use ExtUtils::MakeMaker;
+WriteMakefile
+(
+          'NAME' => 'Catalyst::Plugin::Session::Store::FastMmap',
+          'VERSION_FROM' => 'lib/Catalyst/Plugin/Session/Store/FastMmap.pm',
+          'PREREQ_PM' => {
+                           'Cache::FastMmap' => '1.13',
+                           'Catalyst::Plugin::Session' => '0.09',
+                           'File::Spec' => '0',
+                           'File::Temp' => '0',
+                           'Path::Class' => '0'
+                         },
+          'INSTALLDIRS' => 'site',
+          'EXE_FILES' => [],
+          'PL_FILES' => {}
+        )
+;

Added: trunk/Catalyst-Plugin-Session-Store-FastMmap/README
===================================================================
--- trunk/Catalyst-Plugin-Session-Store-FastMmap/README	                        (rev 0)
+++ trunk/Catalyst-Plugin-Session-Store-FastMmap/README	2008-01-16 16:31:43 UTC (rev 7393)
@@ -0,0 +1,83 @@
+NAME
+    Catalyst::Plugin::Session::Store::FastMmap - FastMmap session storage
+    backend.
+
+SYNOPSIS
+        use Catalyst qw/Session Session::Store::FastMmap Session::State::Foo/;
+    
+        MyApp->config->{session} = {
+            expires => 3600,
+            storage => '/tmp/session'
+        };
+
+        # ... in an action:
+        $c->session->{foo} = 'bar'; # will be saved
+
+DESCRIPTION
+    "Catalyst::Plugin::Session::Store::FastMmap" is a fast session storage
+    plugin for Catalyst that uses an mmap'ed file to act as a shared memory
+    interprocess cache. It is based on Cache::FastMmap.
+
+  METHODS
+    get_session_data
+    store_session_data
+    delete_session_data
+    delete_expired_sessions
+        These are implementations of the required methods for a store. See
+        Catalyst::Plugin::Session::Store.
+
+    get_and_set_session_data
+        This is the optional method for atomic write semantics. See
+        Catalyst::Plugin::Session::AtomicWrite.
+
+    setup_session
+        Sets up the session cache file.
+
+CAVEATS
+    Very loaded sites with lots of data in the session hash may have old
+    sessions expired prematurely, due to the LRU caching policy employed by
+    Cache::FastMmap. To get around this you can increase the "cache_size"
+    parameter, or switch session storage backends.
+
+    This is particularly inappropriate for use as a backend for e.g.
+    Catalyst::Plugin::Session::PerUser, for example.
+
+    Cache::FastMmap defaults to around 5mb (89 * 64k).
+
+CONFIGURATION
+    These parameters are placed in the hash under the "session" key in the
+    configuration hash.
+
+    storage
+        Specifies the file to be used for the sharing of session data. The
+        default value will use File::Spec to find the default tempdir, and
+        use a file named "MyApp_session_data", where "MyApp" is replaced
+        with the appname.
+
+        Note that the file will be created with mode 0640, which means that
+        it will only be writeable by processes running with the same uid as
+        the process that creates the file. If this may be a problem, for
+        example if you may try to debug the program as one user and run it
+        as another, specify a filename like "/tmp/session-$>", which
+        includes the UID of the process in the filename.
+
+    init_file
+    cache_size
+        See the Cache::FastMmap documentation for the meaning of these keys.
+        If these keys are not present Cache::FastMmap's defaults will be
+        used.
+
+SEE ALSO
+    Catalyst, Catalyst::Plugin::Session, Cache::FastMmap.
+
+AUTHORS
+    This module is derived from Catalyst::Plugin::Session::FastMmap code,
+    and has been heavily modified since.
+
+    Andrew Ford Andy Grundman Christian Hansen Yuval Kogman,
+    "nothingmuch at woobling.org" Marcus Ramberg Sebastian Riedel
+
+COPYRIGHT
+    This program is free software, you can redistribute it and/or modify it
+    under the same terms as Perl itself.
+

Modified: trunk/Catalyst-Plugin-Session-Store-FastMmap/lib/Catalyst/Plugin/Session/Store/FastMmap.pm
===================================================================
--- trunk/Catalyst-Plugin-Session-Store-FastMmap/lib/Catalyst/Plugin/Session/Store/FastMmap.pm	2008-01-16 12:36:28 UTC (rev 7392)
+++ trunk/Catalyst-Plugin-Session-Store-FastMmap/lib/Catalyst/Plugin/Session/Store/FastMmap.pm	2008-01-16 16:31:43 UTC (rev 7393)
@@ -16,7 +16,7 @@
 use File::Spec      ();
 use Catalyst::Utils ();
 
-our $VERSION = '0.04';
+our $VERSION = '0.05';
 
 __PACKAGE__->mk_classdata(qw/_session_fastmmap_storage/);
 




More information about the Catalyst-commits mailing list