/ 
Locale-TextDomain-OO-1.036
River stage one • 2 direct dependents • 2 total dependents
/ Locale::TextDomain::OO::Lexicon::Hash

NAME

Locale::TextDomain::OO::Lexicon::Hash - Lexicon from data structure

$Id: Hash.pm 698 2017-09-28 05:21:05Z steffenw $

$HeadURL: svn+ssh://steffenw@svn.code.sf.net/p/perl-gettext-oo/code/module/trunk/lib/Locale/TextDomain/OO/Lexicon/Hash.pm $

VERSION

1.031

DESCRIPTION

This module allows to create a lexicon from data structure.

SYNOPSIS

require Locale::TextDomain::OO::Lexicon::Hash;
use Log::Any qw($log);

$logger = Locale::TextDomain::OO::Lexicon::Hash
    ->new(
        # all parameters are optional
        logger => sub {
            my ($message, $arg_ref) = @_;
            my $type = $arg_ref->{type}; # debug
            $log->$type($message);
            return;
        },
    )
    ->lexicon_ref({ ... })
    ->logger;

SUBROUTINES/METHODS

method new

see SYNOPSIS

method lexicon_ref

Fill in lexicon data from Perl data structure.

For language "de-de", no category (default) and no domain (default) the lexicon name is "de-de::".

For language "en", category "LC_MESSAGES" and domain "test" the lexicon name is "en:LC_MESSAGES:test".

The keys of each item are stolen from PO file. Except the keys "msgstr_plural[0]", "msgstr_plural[1]", ... "msgstr_plural[N]" are written as key "msgstr_plural" with an array reference as value.

$self->lexicon_ref({
    'de:MyCategory:MyDomain' . ':OptionalProject' => [
        # header in a very minimalistic form
        {
            msgid  => "",
            msgstr => ""
                . "Content-Type: text/plain; charset=UTF-8\n"
                . "Plural-Forms: nplurals=2; plural=n != 1;",
        },
        # single translation
        {
            msgid  => "help",
            msgstr => "Hilfe",
        },
        # with context
        {
            msgctxt => "datetime",
            msgid   => "date",
            msgstr  => "Datum",
        },
        # plural
        {
            msgid         => "person",
            msgid_plural  => "persons",
            msgstr_plural => [
                "Person",
                "Personen",
            ],
        },
        # plural with context
        {
            msgctxt       => "appointment",
            msgid         => "date",
            msgid_plural  => "dates",
            msgstr_plural => [
                "Date",
                "Dates",
            ],
        },
    ],
});

method logger

Set the logger and get back them

$lexicon_hash->logger(
    sub {
        my ($message, $arg_ref) = @_;
        my $type = $arg_ref->{type};
        $log->$type($message);
        return;
    },
);
$logger = $lexicon_hash->logger;

$arg_ref contains

object => $lexicon_hash, # the object itself
type   => 'debug',
event  => 'lexicon,load', # The logger will be copied to
                          # Locale::TextDomain::OO::Singleton::Lexicon
                          # so more events are possible.

EXAMPLE

Inside of this distribution is a directory named example. Run this *.pl files.

DIAGNOSTICS

confess

CONFIGURATION AND ENVIRONMENT

none

DEPENDENCIES

Carp

Locale::TextDomain::OO::Singleton::Lexicon

Locale::TextDomain::OO::Util::ExtractHeader

Locale::TextDomain::OO::Util::JoinSplitLexiconKeys

Moo

MooX::StrictConstructor

namespace::autoclean

Locale::TextDomain::OO::Role::Logger

INCOMPATIBILITIES

not known

BUGS AND LIMITATIONS

none

SEE ALSO

Locale::TextDoamin::OO

AUTHOR

Steffen Winkler

LICENSE AND COPYRIGHT

Copyright (c) 2013 - 2017, Steffen Winkler <steffenw at cpan.org>. All rights reserved.

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