NAME
    Dancer2::Session::Sereal - Dancer 2 session storage in files with Sereal

VERSION
    version 0.005

DESCRIPTION
    This module implements Dancer 2 session engine based on Sereal files.

    This backend can be used in single-machine production environments, but
    two things should be kept in mind: The content of the session files is
    not encrypted or protected in anyway and old session files should be
    purged by a CRON job.

  encoder_args
    Arguments to be passed to Sereal::Encoder. If these are not provided in
    the session configuration, sensible defaults are used.

  decoder_args
    Arguments to be passed to Sereal::Decoder. If these are not provided in
    the session configuration, sensible defaults are used.

CONFIGURATION
    The setting session should be set to "Sereal" in order to use this
    session engine in a Dancer2 application.

    Files will be stored to the value of the setting "session_dir", whose
    default value is "appdir/sessions".

    Arguments for the Sereal::Encoder and Sereal::Decoder objects can be
    given via the "encoder_args" and "decoder_args". If not provided, they
    default to "snappy => 1, croak_on_bless =>1" and "refuse_objects => 1,
    validate_utf8 => 1", respectively.

    Here is an example configuration that use this session engine and stores
    session files in /tmp/dancer-sessions

        session: "Sereal"

        engines:
          session:
            Sereal:
              session_dir: "/tmp/dancer-sessions"
              encoder_args:
                snappy:         1
                croak_on_bless: 1
              decoder_args:
                refuse_objects: 1
                validate_utf8:  1

SUPPORT
  Bugs / Feature Requests
    Please report any bugs or feature requests through the issue tracker at
    <https://github.com/PerlDancer/dancer2-session-sereal/issues>. You will
    be notified automatically of any progress on your issue.

  Source Code
    This is open source software. The code repository is available for
    public review and contribution under the terms of the license.

    <https://github.com/PerlDancer/dancer2-session-sereal>

      git clone https://github.com/PerlDancer/dancer2-session-sereal.git

AUTHOR
    David Golden <dagolden@cpan.org>

CONTRIBUTORS
    *   Jason A. Crome <jason@crome-plated.com>

    *   Peter Mottram <peter@sysnix.com>

    *   Yanick Champoux <yanick@babyl.dyndns.org>

COPYRIGHT AND LICENSE
    This software is Copyright (c) 2013 by David Golden.

    This is free software, licensed under:

      The Apache License, Version 2.0, January 2004