NAME

Locale::Maketext::Lexicon::Slurp - One message per file Maketext lexicon.

SYNOPSIS

use Locale::Maketext::Lexicon {
    en => [ Slurp => [ "/my/dir/en", regex => qr{\.html$} ] ],
    de => [ Slurp => [ "/my/dir/de", files => [qw/blah.html foo.html/] ],
}; 

DESCRIPTION

This maketext lexicon module provides a file based lexicon format, with the file name (or relative path) acting as the message id, and the file contents being the message string.

This is useful for displaying large bits of text, like several paragraphs of instructions, or the answers to an FAQ, without needing to bother with formatting and escaping the text in some format.

This lexicon provider is also geared towards subclassing. Hooks are provided to make subclassing easy, so that you may add interpolation using a template module, for example. See the "METHODS" section for more details.

OPTIONS

The accepted options are:

dir

The base directory for the message files

If the directory does not exist it's treated like a glob pattern. See files for more details.

Used by get_files.

files

An array reference or a glob pattern of files to use as messages.

If dir is also specified then the files are considered relative and the relative paths are the IDs. If dir is not specified, then the files are assumed to be valid full paths (relative or absolute) and the file name becomes the ID.

If unspecified then all of the files in dir are used.

Used by get_files.

regex

An regex filter to apply to file names. Gets matched on the full path.

This is always applied if it exists, even if filter also exists, and if globbing was used.

Used by get_files.

filter

An optional code ref filter to apply to files. Gets the lexicon factory object as the invocant, and a Path::Class::File object as the argument.

This is always applied if it exists, even if regex also exists, and if globbing was used.

Used by get_files.

binmode

The binmode to apply after opening a file for reading.

Used by read_file.

readdir

A code reference (or method name) to use instead of readdir, for when something like recursion is needed and a subclass of this module is too daunting. See readdir (the method) for details.

Used by get_files.

If the argument list is odd sized, the first item is assumed to be the value of the dir argument.

METHODS

These methods are not generally exposed to the user, but are documented for subclassing.

parse (@args)

Called by Locale::Maketext::Lexicon. Used internally to set up the lexicon entries.

read_file (%args)

This base implementation of read_file reads the contents of the file specified by the path argument. Also takes an optional binmode argument, which can be set in the import statement. See "OPTIONS".

Additional, and currently unused arguments passed to this method are:

name

The ID of the message

args

The arguments given to maketext for interpolation.

get_files ($args)

Enumerate all the files (returns a hash reference of ID to path) in the specified source.

See "OPTIONS" for the parameters it supports and how they behave.

readdir ($dir)

Used to list the sub items of a directory. Mostly a convenience method.

meta

BUGS

All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to cpan-RT.

TODO

Consider caching options (the the OS page cache should be enough).

AUTHOR

Yuval Kogman

COPYRIGHT AND LICENSE

Copyright 2007 by Infinity Interactive, Inc.

http://www.iinteractive.com

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