web::scraper::filter(3pm) [debian man page]

Web::Scraper::Filter(3pm)				User Contributed Perl Documentation				 Web::Scraper::Filter(3pm)

NAME

       Web::Scraper::Filter - Base class for Web::Scraper filters

SYNOPSIS

	 package Web::Scraper::Filter::YAML;
	 use base qw( Web::Scraper::Filter );
	 use YAML ();

	 sub filter {
	     my($self, $value) = @_;
	     YAML::Load($value);
	 }

	 1;

	 use Web::Scraper;

	 my $scraper = scraper {
	     process ".yaml-code", data => [ 'TEXT', 'YAML' ];
	 };

DESCRIPTION

       Web::Scraper::Filter is a base class for text filters in Web::Scraper. You can create your own text filter by subclassing this module.

       There are two ways to create and use your custom filter. If you name your filter Web::Scraper::Filter::Something, you just call:

	 process $exp, $key => [ 'TEXT', 'Something' ];

       If you declare your filter under your own namespace, like 'MyApp::Filter::Foo',

	 process $exp, $key => [ 'TEXT', '+MyApp::Filter::Foo' ];

       You can also inline your filter function without creating a filter class:

	 process $exp, $key => [ 'TEXT', sub { s/foo/bar/ } ];

       Note that this function munges $_ and returns the count of replacement. Filter code special cases if the return value of the callback is
       number and $_ value is updated.

       You can, of course, stack filters like:

	 process $exp, $key => [ '@href', 'Foo', '+MyApp::Filter::Bar', &baz ];

AUTHOR

       Tatsuhiko Miyagawa

perl v5.14.2							    2009-03-24						 Web::Scraper::Filter(3pm)

Jifty::DBI::Filter::YAML(3pm)				User Contributed Perl Documentation			     Jifty::DBI::Filter::YAML(3pm)

NAME

       Jifty::DBI::Filter::YAML - This filter stores arbitrary Perl via YAML

SYNOPSIS

	 use Jifty::DBI::Record schema {
	     column my_data =>
		 type is 'text',
		 filters are qw/ Jifty::DBI::Filter::YAML /;
	 };

	 my $thing = __PACKAGE__->new;
	 $thing->create( my_data => { foo => 'bar', baz => [ 1, 2, 3 ] } );

	 my $my_data = $thing->my_data;
	 while (my ($key, $value) = %$my_data) {
	     # do something...
	 }

DESCRIPTION

       This filter provides the ability to store arbitrary data structures into a database column using YAML. This is very similar to the
       Jifty::DBI::Filter::Storable filter except that the YAML format remains human-readable in the database. You can store virtually any Perl
       data, scalar, hash, array, or object into the database using this filter.

       In addition, YAML (at least the storage of scalars, hashes, and arrays) is compatible with data structures written in other languages, so
       you may store or read data between applications written in different languages.

METHODS

   encode
       This method is used to encode the Perl data structure into YAML formatted text.

   decode
       This method is used to decode the YAML formatted text from the database into the Perl data structure.

IMPLEMENTATION

       This class will attempt to use YAML::Syck if it is available and then fall back upon YAML. This has been done because the Syck library is
       written in C and is considerably faster.

SEE ALSO

       Jifty::DBI::Filter, YAML, YAML::Syck

AUTHOR

       Andrew Sterling Hanenkamp <hanenkamp@cpan.org>

LICENSE

       This program is free software and may be modified or distributed under the same terms as Perl itself.

perl v5.14.2							    2010-09-21					     Jifty::DBI::Filter::YAML(3pm)