[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