/ 
Scrappy-0.94112090
River stage one • 1 direct dependent • 1 total dependent
/ Scrappy::Session

NAME

Scrappy::Session - Scrappy Scraper Session Handling

VERSION

version 0.94112090

SYNOPSIS

#!/usr/bin/perl
use Scrappy::Session;

my  $session = Scrappy::Session->new;

    -f 'scraper.sess' ?
    $session->load('scraper.sess');
    $session->write('scraper.sess');
    
    $session->stash('foo' => 'bar');
    $session->stash('abc' => [('a'..'z')]);

DESCRIPTION

Scrappy::Session provides YAML-Based session file handling for saving recorded data across multiple execution using the Scrappy framework.

ATTRIBUTES

The following is a list of object attributes available with every Scrappy::Session instance.

auto_save

The auto_save attribute is a boolean that determines whether stash data is automatically saved to the session file on update.

my  $session = Scrappy::Session->new;
    
    $session->load('scraper.sess');
    $session->stash('foo' => 'bar');
    
    # turn auto-saving off
    $session->auto_save(0);
    $session->stash('foo' => 'bar');
    $session->write; # explicit write

file

The file attribute gets/sets the filename of the current session file.

my  $session = Scrappy::Session->new;
    
    $session->load('scraper.sess');
    $session->write('scraper.sess.bak');
    $session->file('scraper.sess');

METHODS

load

The load method is used to read-in a session file, it returns its data in the structure it was saved-in.

my  $session = Scrappy::Session->new;
my  $data = $session->load('scraper.sess');

stash

The stash method accesses the stash object which is used to store data to be written to the session file.

my  $session = Scrappy::Session->new;
    $session->load('scraper.sess');
    
    $session->stash('foo' => 'bar');
    $session->stash('abc' => [('a'..'z')]);
    $session->stash->{123} = [(1..9)];

write

The write method is used to write-out a session file, it saves the data stored in the session stash and it returns the data written upon completion.

my  $session = Scrappy::Session->new;

    $session->stash('foo' => 'bar');
    $session->stash('abc' => [('a'..'z')]);
    $session->stash->{123} = [(1..9)];

my  $data = $session->write('scraper.sess');

AUTHOR

Al Newkirk <awncorp@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by awncorp.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.