Package: robotframework-localization
Robot Framework Localization HelperA python library and CLI to help testers to internationalize and localize robot test cases.InstallationrobotLocalization can be installed with pip/pipenv:pipinstallrobotframework-localizationpipenvinstallrobotframework-localizationUsagerobotLocalization can be used in two modes as a get_variables function or a CLI.
The get_variables function can be used in the robot test case to load strings from
properpties files by providing a language fallback mechanism.
robotLocalization CLI provides functionalities to help testers to internationalize
test cases.#resources/sample.propertiesmsg=Hello,World!#resources/sample_ja.propertiesmsg=みなさん、こんにちは!#   sample.robot
#
#   $ robot --variable language:en sample.robot
#   $ robot --variable language:ja sample.robot
#*** Settings ***LibrarySeleniumLibraryVariablesrobotLocalization${LANGUAGE}resources/sample.propertiesverbose=True*** Variables ***${LANGUAGE}en# default LANGUAGE.  This can be replaced by --variable option.*** Test Cases ***Test Case 1[Documentation]robotLocalization SampleLog To Console${msg}Log VariablesGetting variables from get_variables functionrobotLocalization provides get_variabes function which can be specified
in the robot Variables statement.Syntax in robot testVariablesrobotLocalizationlocaleIdpath or file listpathOptionslocaleIdspecifies the locale or language of the properties being used.  It is used
to load strings from properties files in the properties files in the specified path list
or files.  If specified locale is not available, English propereties will be used.pathOptionsverbose=            True or False
filetype=           file typeExamplesVariablesrobotLocalizationen   ${PROJECT_REPO_PATH}Accessing variables from robot code.Internationalization Helper CLIThe xpt command helps testers to internationalize robot test cases.robotLocalizationoperandfile_patternslanguage-listAnalyze ModeIn the analyze mode, robotLocalization CLI reports the localizable strings in robot test and
cadicases of available strings in existing properties files from properties files in the
specified path list.robotLocalization[*pathlist()]--analyze[*robot_file*]–analyzeSpecifies a robot test case.  Typically, this robot file contains Xpath specifications
with UI elements or robot variable specifications used in other keywords.Extract ModeThe extract mode is used to extract strings from a specified robot file.
It also generates internationalized robot files by replacing localizable strings
with variables references.–extractSpecifies a robot test case to extract strings.–output_bundleSpecifies a bundle file which can be used to store product properties into a single file.
This options is only valid if–use_bundleoption is enaled.–output_propertiesSpecifies a properties file to store localizable strings. If–use_bundleis specified,
only strings not available in product properties files are stored.–output_robot|–outrSpecifies a robot file by internationalizing the robot file specifeid wit –extract option.
All localizable strings will be replaced by variable references.  A string with “# i18n:OK ”
comments are ignored.–use_bundle|–use_keys–use_bundle options checks the availablity of strings in the specified product properties files.
If found, it uses strings there.–multi_trans–multi_trans options checks the translated value for locales specified with –bundle_locale option
and checks the multiple translations.   If variant translation found, it extends the Xpath expression
to use “OR” condition to use all of the variant translations.–playwright–playwright options checks the css/xpath specification for Playwright when externalizing the robot
variables.  This option is useful when robot Framework is used with the Playwright for Python.Dump Mode–dump–dump option generates list all the variables loaded from properties files.