The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
Nile-0.49
River stage zero No dependents
/ Nile::Lang

NAME

Nile::Lang - Language file manager.

SYNOPSIS

    $lang = $self->app->lang;
    
    # load language file from the current active or default language, file extension is xml.
    $lang->load("general");

    # load and append another language file
    $lang->load("accounts");
    
    # load language file of specific language.
    $lang->load($file, $lang);

    # get language variables from the active langauge
    say $lang->get("site_name");
    say $lang->get("first_name");
    say $lang->get("last_name");
        
    # get language variables of specific installed language.
    say $lang->get("site_name", 'en-US');

    # automatic getter support
    say $lang->email; # same as $lang->get('email');

    # get a group of language variables.
    @text = $lang->list(@names);

    # set language variables.
    $lang->set("email_label", 'Email:');
    $lang->set(%vars);

    # automatic setter support
    $lang->email('ahmed@mewsoft.com'); # same as $lang->set('email', 'ahmed@mewsoft.com');

DESCRIPTION

Nile::Lang - Language file manager.

file()

    # set output file name for saving
    $lang->file($file);

    # get output file name
    $file = $lang->file();

Get and set the output language file name used when saving or updating. The default file extension is xml.

encoding()

    # get encoding used to read/write the language files, default is 'UTF-8'.
    $encoding = $lang->encoding();
    
    # set encoding used to read/write the langauge files, default is 'UTF-8'.
    $lang->encoding('UTF-8');

Get and set encoding used to read/write the language files. The default encoding is 'UTF-8'.

load()

    # load language file from the current active or default language, file extension is xml.
    $lang->load("general");

    # load and append another language file
    $lang->load("accounts");
    
    # load language file of specific language.
    $lang->load($file, $lang);

Load language files from the current active or specific language. The default file extension is xml. This method can be chained $lang-load($file)->load($register)>;

add()

    # load a list of language files from the current active or default language, file extension is xml.
    $lang->add("general", "register", "contact");

Load a list of language files from the current active or specific language. The default file extension is xml. This method can be chained $lang-load($file, $lang)->add(@files)>;

reload()

    # reload a list of language files from the current active or default language, file extension is xml.
    $lang->reload("general", "register");

Reload a list of language files from the current active or specific language. The default file extension is xml. This method can be chained.

lang()

    # get active language for the language object.
    $lang = $lang->lang();

    # set active language for the language object.
    $lang->lang("en-US");

Get and set active language used when loading or writing the language files.

clear()

    # clear all loaded language data.
    $lang = $lang->clear();

    # clear all loaded language data of sepcific language.
    $lang->clear("en-US");

Clear all loaded language data or sepcific language or all languages. This does not delete the data from files.

vars()

    # get all loaded language data as hash or hash ref.
    %data = $lang->vars();
    $data_ref = $lang->vars();

    # get all loaded language data of sepcific language as hash or hash ref.
    %data = $lang->vars("en-US");
    $data_ref = $lang->vars("en-US");

Returns all loaded language data as a hash or hash reference of sepcific language or all languages.

get()

    # get language variables from the active langauge
    say $lang->get("site_name");
    say $lang->get("first_name");
    say $lang->get("last_name");
        
    # get language variables of specific installed language.
    say $lang->get("site_name", 'en-US');

    # automatic getter support
    say $lang->email; # same as $lang->get('email');

Returns language variables from the active or specific installed language.

set()

    # set language variables.
    $lang->set("email_label", 'Email:');
    $lang->set(%vars);

    # automatic setter support
    $lang->email('ahmed@mewsoft.com'); # same as $lang->set('email', 'ahmed@mewsoft.com');

Set language variables of the active language.

list()

    # get a list of language variables.
    @text = $lang->list(@names);

Set a list of language variables from the active language.

keys()

    # returns all language variables names.
    @names = $lang->keys($);

Returns all language variables names.

exists()

    # check if a langugage variable exist or not.
    $found = $lang->exists($name);

Check if a langugage variable exist or not.

delete()

    # delete langugage variables.
    $lang->delete(@names);

Delete a list of language variables.

get_file()

    # returns language file data from the active or default language, default file extension is xml.
    %data = $lang->get_file("contacts");
    $data_ref = $lang->get_file("contacts");

    # returns language file data from specific language, default file extension is xml.
    %data = $lang->get_file("contacts", "en-US");
    $data_ref = $lang->get_file("contacts", "en-US");

Returns language file data as a hash or hash reference from the active or specific language. The default file extension is xml.

save()

    # write the output file.
    $lang->save($file);

Save changes to the output file. If no file name it will update the loaded file name.

translate()

    # scan and replace the language variables $passes times in language $lang
    $content = $lang->translate($content, $lang, $passes) 
    
    # pass content by ref for better speed
    $lang->translate(\$content, $lang, $passes) 
    
    # use current language and default passes
    $content = $lang->translate($content);
    $lang->translate(\$content);

    # use specific language and passes
    $lang->translate($content, "en-US", 3);

Translate language variables inside contents to their language values. It scans the content for the langauge variables surrounded by the curly braces {var_name} and replaces them with their values from the loaded language files.

translate_file()

    $content = $lang->translate_file($file, $lang, $passes);
    
    # use current langauge and default passes
    $content = $lang->translate_file($file);
    $content = $lang->translate_file($file, $lang);

Loads and translates a file. The $file argument must be the full system file path.

Bugs

This project is available on github at https://github.com/mewsoft/Nile.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Nile.

SOURCE

Source repository is at https://github.com/mewsoft/Nile.

SEE ALSO

See Nile for details about the complete framework.

AUTHOR

Ahmed Amin Elsheshtawy, احمد امين الششتاوى <mewsoft@cpan.org> Website: http://www.mewsoft.com

COPYRIGHT AND LICENSE

Copyright (C) 2014-2015 by Dr. Ahmed Amin Elsheshtawy احمد امين الششتاوى mewsoft@cpan.org, support@mewsoft.com, https://github.com/mewsoft/Nile, http://www.mewsoft.com

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