1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203
|
# Copyrights 2007-2025 by [Mark Overmeer <markov@cpan.org>].
# For other contributors see ChangeLog.
# See the manual pages for details on the licensing terms.
# Pod stripped from pm file by OODoc 2.03.
# This code is part of distribution Log-Report. Meta-POD processed with
# OODoc into POD and HTML manual-pages. See README.md
# Copyright Mark Overmeer. Licensed under the same terms as Perl itself.
package Log::Report::Message;{
our $VERSION = '1.40';
}
use warnings;
use strict;
use Log::Report 'log-report';
use POSIX qw/locale_h/;
use List::Util qw/first/;
use Scalar::Util qw/blessed/;
use Log::Report::Util qw/to_html/;
# Work-around for missing LC_MESSAGES on old Perls and Windows
{ no warnings;
eval "&LC_MESSAGES";
*LC_MESSAGES = sub(){5} if $@;
}
use overload
'""' => 'toString'
, '&{}' => sub { my $obj = shift; sub{$obj->clone(@_)} }
, '.' => 'concat'
, fallback => 1;
sub new($@)
{ my ($class, %s) = @_;
if(ref $s{_count})
{ my $c = $s{_count};
$s{_count} = ref $c eq 'ARRAY' ? @$c : keys %$c;
}
defined $s{_join}
or $s{_join} = $";
if($s{_msgid})
{ $s{_append} = defined $s{_append} ? $1.$s{_append} : $1
if $s{_msgid} =~ s/(\s+)$//s;
$s{_prepend}.= $1
if $s{_msgid} =~ s/^(\s+)//s;
}
if($s{_plural})
{ s/\s+$//, s/^\s+// for $s{_plural};
}
bless \%s, $class;
}
# internal use only: to simplify __*p* functions
sub _msgctxt($) {$_[0]->{_msgctxt} = $_[1]; $_[0]}
sub clone(@)
{ my $self = shift;
(ref $self)->new(%$self, @_);
}
sub fromTemplateToolkit($$;@)
{ my ($class, $domain, $msgid) = splice @_, 0, 3;
my $plural = $msgid =~ s/\|(.*)// ? $1 : undef;
my $args = @_ && ref $_[-1] eq 'HASH' ? pop : {};
my $count;
if(defined $plural)
{ @_==1 or $msgid .= " (ERROR: missing count for plural)";
$count = shift || 0;
$count = @$count if ref $count eq 'ARRAY';
}
else
{ @_==0 or $msgid .= " (ERROR: only named parameters expected)";
}
$class->new
( _msgid => $msgid, _plural => $plural, _count => $count
, %$args, _expand => 1, _domain => $domain);
}
#----------------
sub prepend() { $_[0]->{_prepend}}
sub msgid() { $_[0]->{_msgid} }
sub append() { $_[0]->{_append} }
sub domain() { $_[0]->{_domain} }
sub count() { $_[0]->{_count} }
sub context() { $_[0]->{_context}}
sub msgctxt() { $_[0]->{_msgctxt}}
sub classes()
{ my $class = $_[0]->{_class} || $_[0]->{_classes} || [];
ref $class ? @$class : split(/[\s,]+/, $class);
}
sub to(;$)
{ my $self = shift;
@_ ? $self->{_to} = shift : $self->{_to};
}
sub errno(;$)
{ my $self = shift;
@_ ? $self->{_errno} = shift : $self->{_errno};
}
sub valueOf($) { $_[0]->{$_[1]} }
#--------------
sub inClass($)
{ my @classes = shift->classes;
ref $_[0] eq 'Regexp'
? (first { $_ =~ $_[0] } @classes)
: (first { $_ eq $_[0] } @classes);
}
sub toString(;$)
{ my ($self, $locale) = @_;
my $count = $self->{_count} || 0;
$locale = $self->{_lang} if $self->{_lang};
my $prepend = $self->{_prepend} // '';
my $append = $self->{_append} // '';
$prepend = $prepend->isa(__PACKAGE__) ? $prepend->toString($locale) : "$prepend"
if blessed $prepend;
$append = $append->isa(__PACKAGE__) ? $append->toString($locale) : "$append"
if blessed $append;
$self->{_msgid} # no translation, constant string
or return "$prepend$append";
# assumed is that switching locales is expensive
my $oldloc = setlocale(LC_MESSAGES);
setlocale(LC_MESSAGES, $locale)
if defined $locale && (!defined $oldloc || $locale ne $oldloc);
# translate the msgid
my $domain = $self->{_domain};
$domain = textdomain $domain
unless blessed $domain && $domain->isa('Log::Report::Minimal::Domain');
my $format = $domain->translate($self, $locale || $oldloc);
defined $format or return ();
# fill-in the fields
my $text = $self->{_expand}
? $domain->interpolate($format, $self)
: "$prepend$format$append";
setlocale(LC_MESSAGES, $oldloc)
if defined $oldloc && (!defined $locale || $oldloc ne $locale);
$text;
}
my %tohtml = qw/ > gt < lt " quot & amp /;
sub toHTML(;$) { to_html($_[0]->toString($_[1])) }
sub untranslated()
{ my $self = shift;
(defined $self->{_prepend} ? $self->{_prepend} : '')
. (defined $self->{_msgid} ? $self->{_msgid} : '')
. (defined $self->{_append} ? $self->{_append} : '');
}
sub concat($;$)
{ my ($self, $what, $reversed) = @_;
if($reversed)
{ $what .= $self->{_prepend} if defined $self->{_prepend};
return ref($self)->new(%$self, _prepend => $what);
}
$what = $self->{_append} . $what if defined $self->{_append};
ref($self)->new(%$self, _append => $what);
}
#----------------
1;
|