=encoding UTF-8

=head1 NAME

String::Locale - display text locally.

=head1 VERSION

Version 0.03

=cut

=head1 SYNOPSIS

Quick summary of what the module does:

	use String::Locale {
		as_keywords => 1
		stranger => {
			en_GB => 'Hello stranger',
			en_US => 'Howdy stranger',
			ja_JP => 'こんにちは見知らぬ人'
		},
	};

	say stranger;
	die locales->stranger;

=head1 SUBROUTINES/METHODS

=head2 new

Instantiate a new String::Locale object.

	String::Locale->new

=head2 import

When you use String::Locale it will always import a locales keyword which you can then use to access your String::Locale::Object. You can optionally pass as_keywords 
which will then import a keyword for each of the keys defined in your objects locales object. You can override system default locale and language by also passing these within the locales hashref.
	

	use String::Locale { 
		as_keywords => 1,
		locale => 'en_GB',
		language => 'ja',
		%locales
	};
	

=head2 new_object

Accepts a list of arguments that are used to build a new String::Locale::Object.
	

	String::Locale->new_object(
		locale => $locale,
		locales => {
			%locales
		}
	);
	

=head1 AUTHOR

LNATION, C<< <email at lnation.org> >>

=head1 BUGS

Please report any bugs or feature requests to C<bug-string::locale at rt.cpan.org>, or through
the web interface at L<https://rt.cpan.org/NoAuth/ReportBug.html?Queue=String-Locale>.  I will be notified, and then you'll
automatically be notified of progress on your bug as I make changes.

=head1 SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc String::Locale

You can also look for information at:

=over 4

=item * RT: CPAN's request tracker (report bugs here)

L<https://rt.cpan.org/NoAuth/Bugs.html?Dist=String-Locale>

=item * AnnoCPAN: Annotated CPAN documentation

L<http://annocpan.org/dist/String-Locale>

=item * CPAN Ratings

L<https://cpanratings.perl.org/d/String-Locale>

=item * Search CPAN

L<https://metacpan.org/release/String-Locale>

=back

=head1 ACKNOWLEDGEMENTS

=head1 LICENSE AND COPYRIGHT

This software is Copyright (c) 2020 by LNATION.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

=cut

 
