MooseX::Types::Locale::Language - Locale::Language related constraints and coercions for Moose
This document describes MooseX::Types::Locale::Language version 0.06.
0.06
{ package Foo; use Moose; use MooseX::Types::Locale::Language qw( LanguageCode LanguageName ); has 'code' => ( isa => LanguageCode, is => 'rw', coerce => 1 ); has 'name' => ( isa => LanguageName, is => 'rw', coerce => 1 ); __PACKAGE__->meta->make_immutable; } my $foo = Foo->new( code => 'JA', name => 'JAPANESE', ); print $foo->code; # 'ja' print $foo->name; # 'Japanese'
This module packages several Moose::Util::TypeConstraints with coercions, designed to work with the values of Locale::Language.
Alpha2Language
A subtype of Str, which should be defined in language code of ISO 639-1 alpha-2. If you turned coerce on, Str will be lower-case. For example, 'JA' will convert to 'ja'.
Str
coerce
'JA'
'ja'
LanguageCode
Alias of Alpha2Language.
BibliographicLanguage
A subtype of Str, which should be defined in language code of ISO 639-2/B alpha-3. If you turned coerce on, Str will be lower-case. For example, 'CHI' will convert to 'chi'.
'CHI'
'chi'
Alpha3Language
Alias of BibliographicLanguage.
TerminologicLanguage
A subtype of Str, which should be defined in language code of ISO 639-2/T alpha-3. If you turned coerce on, Str will be lower-case. For example, 'ZHO' will convert to 'zho'.
'ZHO'
'zho'
LanguageName
A subtype of Str, which should be defined in ISO 639-1 language name. If you turned coerce on, Str will be same case as canonical name. For example, 'JAPANESE' will convert to 'Japanese'.
'JAPANESE'
'Japanese'
These coercions is not support code conversion. For example, from Alpha2Language to LanguageName.
has language => ( is => 'rw', isa => LanguageName, coerce => 1 ); ... $foo->language('en'); # does not convert to 'English'
If you want conversion, could you implement an individual language class with several attributes?
See /examples/complex.pl in the distribution for more details.
/examples/complex.pl
This module provides you the optional type mapping of MooseX::Getopt when MooseX::Getopt was installed.
LanguageCode, Alpha2Language and LanguageName are String ("=s") type.
String
"=s"
Locale::Language
MooseX::Types::Locale::Language::Fast
MooseX::Types::Locale::Country
None reported.
I may add grammatical aliases of constraints/coercions. For example, LanguageAsAlpha2 as existent Alpha2Language.
LanguageAsAlpha2
I may add namespased types. For example, 'Locale::Language::Alpha2' as export type Alpha2Language.
'Locale::Language::Alpha2'
No bugs have been reported.
Please report any found bugs, feature requests, and ideas for improvements to bug-moosex-types-locale-language at rt.cpan.org, or through the web interface at http://rt.cpan.org/Public/Bug/Report.html?Queue=MooseX-Types-Locale-Language. I will be notified, and then you'll automatically be notified of progress on your bugs/requests as I make changes.
bug-moosex-types-locale-language at rt.cpan.org
When reporting bugs, if possible, please add as small a sample as you can make of the code that produces the bug. And of course, suggestions and patches are welcome.
You can find documentation for this module with the perldoc command.
perldoc
perldoc MooseX::Types::Locale::Language
You can also look for information at:
http://rt.cpan.org/Public/Dist/Display.html?Name=MooseX-Types-Locale-Language
http://annocpan.org/dist/MooseX-Types-Locale-Language
http://search.cpan.org/dist/MooseX-Types-Locale-Language
http://cpanratings.perl.org/dist/MooseX-Types-Locale-Language
This module is maintained using git. You can get the latest version from git://github.com/gardejo/p5-moosex-types-locale-language.git.
<moriya at cpan dot org>, http://gardejo.org/
<moriya at cpan dot org>
Copyright (c) 2009-2010 MORIYA Masaki, alias Gardejo
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlgpl and perlartistic.
The full text of the license can be found in the LICENSE file included with this distribution.
To install MooseX::Types::Locale::Language, copy and paste the appropriate command in to your terminal.
cpanm
cpanm MooseX::Types::Locale::Language
CPAN shell
perl -MCPAN -e shell install MooseX::Types::Locale::Language
For more information on module installation, please visit the detailed CPAN module installation guide.