data::phrasebook::loader::base(3pm) [debian man page]

Data::Phrasebook::Loader::Base(3pm)			User Contributed Perl Documentation		       Data::Phrasebook::Loader::Base(3pm)

NAME

       Data::Phrasebook::Loader::Base - Base loader plugin class.

SYNOPSIS

	 $class->new( %attributes );

DESCRIPTION

       "Data::Phrasebook::Loader::Base" acts as a base class for phrasebook plugins.

CONSTRUCTOR

   new
       "new" instantiates the plugin object, creating a blessed hash of any attributes passed as arguments.

INHERITABLE METHODS

   load
       "load" is an abstract method here. You must define your own in your subclass. Loads the phrasebook.

   get
       "get" is an abstract method here. You must define your own in your subclass. Gets the phrase.

   dicts
       "dicts" is an abstract method here. You must define your own in your subclass. Returns the list of dictionaries available.

   keywords
       "keywords" is an abstract method here. You must define your own in your subclass. Returns the list of keywords available.

   class
       Returns the current "class" of loader.

SEE ALSO

       Data::Phrasebook, Data::Phrasebook::Loader.

SUPPORT

       Please see the README file.

AUTHOR

	 Barbie, <barbie@cpan.org>
	 for Miss Barbell Productions <http://www.missbarbell.co.uk>.

COPYRIGHT AND LICENSE

	 Copyright (C) 2004-2010 Barbie for Miss Barbell Productions.

	 This module is free software; you can redistribute it and/or
	 modify it under the Artistic Licence v2.

perl v5.10.1							    2010-08-31				       Data::Phrasebook::Loader::Base(3pm)

Data::Phrasebook::Plain(3pm)				User Contributed Perl Documentation			      Data::Phrasebook::Plain(3pm)

NAME

       Data::Phrasebook::Plain - The Simple Phrasebook Model.

SYNOPSIS

	   use Data::Phrasebook;

	   my $q = Data::Phrasebook->new(
	       class  => 'Plain',
	       loader => 'Text',
	       file   => 'phrases.txt',
	   );

	   my $r = Data::Phrasebook->new( file => 'phrases.txt' );

	   # simple keyword to phrase mapping
	   my $phrase = $q->fetch($keyword);

	   # keyword to phrase mapping with parameters
	   $q->delimiters( qr{ [% s* (w+) s* %] }x );
	   my $phrase = $q->fetch($keyword,{this => 'that'});

DESCRIPTION

       This module is the fallback or default phrasebook class. It doesn't do much except act as a very simple templating facility.

METHODS

   fetch
       Retrieves the specified "template" and substitutes any "keywords" for "values".

       Thus, given:

	   hello=Hello [% where %]!

       And code:

	   my $text = $q->fetch( 'hello', {
	       where => 'world'
	   } );

       Return value is:

	   Hello world!

       The delimiters are deliberately taken from Template Toolkit.

SEE ALSO

       Data::Phrasebook, Data::Phrasebook::Generic.

SUPPORT

       Please see the README file.

AUTHOR

	 Original author: Iain Campbell Truskett (16.07.1979 - 29.12.2003)
	 Maintainer: Barbie <barbie@cpan.org> since January 2004.
	 for Miss Barbell Productions <http://www.missbarbell.co.uk>.

COPYRIGHT AND LICENSE

	 Copyright (C) 2003 Iain Truskett.
	 Copyright (C) 2004-2010 Barbie for Miss Barbell Productions.

	 This module is free software; you can redistribute it and/or
	 modify it under the Artistic Licence v2.

perl v5.10.1							    2010-08-31					      Data::Phrasebook::Plain(3pm)