Enhancement/29 add belarusian for logging (#77)

* Fix loc.text.masked_value usage in TextBox

* Add Belarusian localization, corrected English and Russian localizations

* Corrected logging for the method sendKeys(Keys key);

* Update package patch version to 2.0.1

Author: mialeska

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>com.github.aquality-automation</groupId>
     <artifactId>aquality-selenium</artifactId>
-    <version>2.0.0</version>
+    <version>2.0.1</version>
     <packaging>jar</packaging>
 
     <name>Aquality Selenium</name>

src/main/java/aquality/selenium/elements/Element.java

@@ -18,6 +18,7 @@
 import aquality.selenium.elements.interfaces.IElement;
 import aquality.selenium.elements.interfaces.IElementFactory;
 import org.openqa.selenium.By;
+import org.openqa.selenium.Keys;
 import org.openqa.selenium.NoSuchElementException;
 import org.openqa.selenium.remote.RemoteWebElement;
 
@@ -30,8 +31,8 @@ public abstract class Element extends aquality.selenium.core.elements.Element im
     /**
      * The main constructor
      *
-     * @param loc    By Locator
-     * @param nameOf Output in logs
+     * @param loc     By Locator
+     * @param nameOf  Output in logs
      * @param stateOf desired ElementState
      */
     protected Element(final By loc, final String nameOf, final ElementState stateOf) {
@@ -145,7 +146,7 @@ public void setInnerHtml(final String value) {
         getBrowser().executeScript(JavaScript.SET_INNER_HTML, getElement(), value);
     }
 
-    private Browser getBrowser(){
+    private Browser getBrowser() {
         return AqualityServices.getBrowser();
     }
 
@@ -163,4 +164,10 @@ public MouseActions getMouseActions() {
     public <T extends IElement> T findChildElement(By childLoc, String name, ElementType elementType, ElementState state) {
         return getElementFactory().findChildElement(this, childLoc, name, elementType, state);
     }
-}
+
+    @Override
+    public void sendKeys(Keys key) {
+        logElementAction("loc.text.sending.keys", Keys.class.getSimpleName().concat(".").concat(key.name()));
+        doWithRetry(() -> getElement().sendKeys(key));
+    }
+}

src/main/java/aquality/selenium/elements/TextBox.java

@@ -12,8 +12,7 @@ public class TextBox extends Element implements ITextBox {
 
     private static final String LOG_TYPING = "loc.text.typing";
     private static final String LOG_CLEARING = "loc.text.clearing";
-    private static final String LOG_SENDING_KEYS = "loc.text.sending.keys";
-    private static final String LOG_MASKED_VALUE = "loc.text.masked_value";
+    private final String logMaskedValue = getLocalizationManager().getLocalizedMessage("loc.text.masked_value");
 
     protected TextBox(final By locator, final String name, final ElementState state) {
         super(locator, name, state);
@@ -33,12 +32,6 @@ public void typeSecret(final String value) {
         type(value, true);
     }
 
-    @Override
-    public void sendKeys(final Keys keys) {
-        logElementAction(LOG_SENDING_KEYS, keys.toString());
-        super.sendKeys(keys);
-    }
-
     @Override
     public void clearAndType(final String value) {
         clearAndType(value, false);
@@ -70,14 +63,14 @@ public void unfocus() {
     }
 
     private void type(final String value, final boolean maskValueInLog) {
-        logElementAction(LOG_TYPING, maskValueInLog ? LOG_MASKED_VALUE : value);
+        logElementAction(LOG_TYPING, maskValueInLog ? logMaskedValue : value);
         getJsActions().highlightElement();
         doWithRetry(() -> getElement().sendKeys(value));
     }
 
     private void clearAndType(final String value, final boolean maskValueInLog) {
         logElementAction(LOG_CLEARING);
-        logElementAction(LOG_TYPING, maskValueInLog ? LOG_MASKED_VALUE : value);
+        logElementAction(LOG_TYPING, maskValueInLog ? logMaskedValue : value);
         getJsActions().highlightElement();
         doWithRetry(() -> {
             getElement().clear();

src/main/java/aquality/selenium/elements/interfaces/IElement.java

@@ -15,9 +15,7 @@ public interface IElement extends aquality.selenium.core.elements.interfaces.IEl
      *
      * @param key key for sending.
      */
-    default void sendKeys(Keys key) {
-        sendKeys(key.toString());
-    }
+    void sendKeys(Keys key);
 
     /**
      * Click on an item and wait for the page is loaded

src/main/resources/localization/be.json

@@ -0,0 +1,72 @@
+{
+  "loc.browser.arguments.setting" : "Задаем стартавыя аргументы браўзэра з JSON файла: %s",
+  "loc.browser.back" : "Вяртаемся да папярэдняй старонкі",
+  "loc.browser.forward" : "Пераходзім да наступнай старонкі",
+  "loc.browser.caps.setting" : "Задаем capabilities браўзэра з JSON файла: %s",
+  "loc.browser.config.setting" : "Задаем опцыі профіля браўзэра з JSON файла: %s",
+  "loc.browser.driver.quit" : "Закрываем браўзэр",
+  "loc.browser.getUrl" : "Атрымліваем адрас бягучай старонкі",
+  "loc.browser.grid" : "Усталёўваем драйвэр для браўзэра з Selenium Grid hub",
+  "loc.browser.grid.fail" : "Не ўдалося ўсталяваць драйвэр браўзэра з Selenium Grid hub",
+  "loc.browser.maximize" : "Разгортваем акно браўзэра на ўвесь экран",
+  "loc.browser.name.wrong" : "Няслушнае імя браўзэра.",
+  "loc.browser.navigate" : "Пераходзім па адрасу - '%s'",
+  "loc.browser.page.timeout" : "Таймаўт загрузкі старонкі",
+  "loc.browser.ready" : "Браўзэр '%1$s' гатовы...",
+  "loc.browser.refresh" : "Абнаўляем старонку",
+  "loc.browser.page.load.timeout" : "Задаем таймаўт загрузкі старонкі: '%1$s' сек.",
+  "loc.browser.implicit.timeout" : "Задаем implicit(няяўны) таймаўт: '%1$s' сек.",
+  "loc.browser.script.timeout" : "Задаем таймаўт на выкананне асінхронных javascript камандаў: '%1$s' сек.",
+  "loc.browser.alert.fail" : "Памылка пры ўзаемадзеянні з акном апавяшчэння",
+  "loc.button" : "Кнопка",
+  "loc.checkbox" : "Чэкбокс",
+  "loc.checkbox.get.state" : "Атрымліваем стан",
+  "loc.clicking" : "Націскаем",
+  "loc.clicking.double" : "Падвойна націскаем",
+  "loc.clicking.js" : "Націскаем праз Javascript",
+  "loc.clicking.right" : "Націскаем правай кнопкай",
+  "loc.combobox" : "Камбабокс",
+  "loc.combobox.select.by.text" : "Выбіраем значэнне з тэкстам '%s'",
+  "loc.combobox.select.by.text.js": "Выбіраем значэнне з тэкстам '%s' праз JavaScript",
+  "loc.combobox.get.texts": "Атрымліваем спіс тэкстаў опцыяў",
+  "loc.combobox.get.texts.js": "Атрымліваем спіс тэкстаў опцыяў праз JavaScript",
+  "loc.combobox.get.values" : "Атрымліваем спіс значэнняў",
+  "loc.combobox.get.text.js": "Атрымліваем выбраны тэкст праз JavaScript",
+  "loc.combobox.impossible.to.select.contain.value.or.text" : "Немагчыма выбраць опцыю, якая змяшчае значэнне/тэкст '%1$s' у камбабоксе '%2$s'",
+  "loc.el.getattr" : "Атрымліваем атрыбут '%1$s'",
+  "loc.el.cssvalue" : "Атрымліваем значэнне css '%1$s'",
+  "loc.file.reading_exception" : "Памылка пры чытанні файла: '%s'",
+  "loc.focusing" : "Факусуемся",
+  "loc.get.text" : "Атрымліваем тэкст элемента",
+  "loc.get.text.js" : "Атрымліваем тэкст элемента праз Javascript",
+  "loc.hover.js" : "Наводзім курсор мышы на элемент праз JavaScript",
+  "loc.is.present.js" : "Вызначаем, ці прысутны элемент на экране, праз JavaScript",
+  "loc.get.xpath.js": "Атрымліваем XPath лакатар элемента праз JavaScript",
+  "loc.label" : "Надпіс",
+  "loc.link" : "Спасылка",
+  "loc.moving" : "Наводзім курсор мышы на элемент",
+  "loc.movingFrom" : "Адводзім курсор мышы ад элемента",
+  "loc.radio" : "Радыёкнопка",
+  "loc.scrolling.center.js" : "Пракручваем старонку да цэнтра элемента праз JavaScript",
+  "loc.scrolling.js" : "Пракручваем старонку праз JavaScript",
+  "loc.selecting.value" : "Выбіраем значэнне",
+  "loc.send.text" : "Задаем тэкст - '%s'",
+  "loc.setting.value" : "Задаем значэнне '%s'",
+  "loc.text.clearing" : "Ачышчаем",
+  "loc.text.field" : "Тэкставае поле",
+  "loc.text.sending.keys" : "Націскаем клавішы '%1$s'",
+  "loc.text.typing" : "Уводзім '%s'",
+  "loc.text.masked_value" : "********",
+  "loc.wait.timeout.condition": "Не дачакаліся ўмовы '%2$s' цягам %1$s сек.",
+  "loc.waitexists" : "Чакаем прысутнасці элемента ў DOM па лакатару: %1$s",
+  "loc.waitinstate" : "Чакаем прысутнасці элемента ў стане %1$s па лакатару: %2$s",
+  "loc.waitinvisible" : "Чакаем адсутнасці элемента па лакатару: %1$s",
+  "loc.waitnotexists" : "Чакаем адсутнасці элемента ў DOM па лакатару: %1$s",
+  "loc.no.elements.found.in.state" : "Не знайшлі элементаў па лакатару '%1$s' у %2$s стане",
+  "loc.no.elements.found.by.locator" : "Не знайшлі элементаў па лакатару '%1$s'",
+  "loc.elements.were.found.but.not.in.state": "Знайшлі элементы па лакатару '%1$s', але яны не ў жаданым стане %2$s",
+  "loc.elements.found.but.should.not": "Не павінна быць знойдзена элементаў па лакатару '%1$s' у %2$s стане",
+  "loc.search.of.elements.failed": "Пошук элемента па лакатару '%1$s' прайшоў няўдала",
+  "loc.element.not.in.state": "Элемент %1$s не стаў %2$s пасля таймаўта %3$s",
+  "loc.get.page.source.failed": "Адбылася памылка ў час атрымання разметкі старонкі"
+}

src/main/resources/localization/en.json

@@ -27,7 +27,7 @@
   "loc.clicking.right" : "Clicking right",
   "loc.combobox" : "ComboBox",
   "loc.combobox.select.by.text" : "Selecting value by text '%s'",
-  "loc.combobox.select.by.text.js": "Selecting value by text '{0}' via JavaScript",
+  "loc.combobox.select.by.text.js": "Selecting value by text '%s' via JavaScript",
   "loc.combobox.get.texts": "Getting option texts array",
   "loc.combobox.get.texts.js": "Getting option texts array via JavaScript",
   "loc.combobox.get.values" : "Getting values array",
@@ -65,7 +65,7 @@
   "loc.no.elements.found.in.state" : "No elements with locator '%1$s' found in state '%2$s'",
   "loc.no.elements.found.by.locator" : "No elements were found by locator '%1$s'",
   "loc.elements.were.found.but.not.in.state" :  "Elements were found by locator '%1$s' but not in desired state. %2$s",
-  "loc.elements.found.but.should.not": "No elements should be found by locator '%1$s'",
+  "loc.elements.found.but.should.not": "No elements should be found by locator '%1$s' in %2$s state",
   "loc.search.of.elements.failed": "Search of element by locator '%1$s' failed",
   "loc.element.not.in.state": "Element %1$s has not become %2$s after timeout %3$s",
   "loc.get.page.source.failed": "An exception occurred while tried to save the page source"

src/main/resources/localization/ru.json

@@ -27,11 +27,11 @@
   "loc.clicking.right" : "Клик правой кнопкой",
   "loc.combobox" : "Комбобокс",
   "loc.combobox.select.by.text" : "Выбор значения с текстом '%s'",
-  "loc.combobox.select.by.text.js": "Выбор значения с текстом '{0}' посредством JavaScript",
+  "loc.combobox.select.by.text.js": "Выбор значения с текстом '%s' посредством JavaScript",
   "loc.combobox.get.texts": "Получение списка текстов опций",
   "loc.combobox.get.texts.js": "Получение списка текстов опций посредством JavaScript",
   "loc.combobox.get.values" : "Получение списка значений",
-  "loc.combobox.get.text.js": "Получение списка значений посредством JavaScript",
+  "loc.combobox.get.text.js": "Получение текста выбранного значения посредством JavaScript",
   "loc.combobox.impossible.to.select.contain.value.or.text" : "Не удаётся выбрать значение которое содержит значение/текст '%1$s' в выпадающем списке '%2$s'",
   "loc.el.getattr" : "Получение аттрибута '%1$s'",
   "loc.el.cssvalue" : "Получение значения css '%1$s'",
@@ -65,7 +65,7 @@
   "loc.no.elements.found.in.state" : "Не удалось найти элементов по локатору '%1$s' в состоянии '%2$s'",
   "loc.no.elements.found.by.locator" : "Не удалось найти элементов по локатору '%1$s'",
   "loc.elements.were.found.but.not.in.state" :  "Удалось найти элементы по локатору '%1$s',но они не в желаемом состоянии. %2$s",
-  "loc.elements.found.but.should.not": "Не должно быть найдено элементов по локатору '%1$s'",
+  "loc.elements.found.but.should.not": "Не должно быть найдено элементов по локатору '%1$s' в %2$s состоянии",
   "loc.search.of.elements.failed":  "Поиск элемента по локатору '%1$s' прошел неудачно",
   "loc.element.not.in.state": "Элемент %1$s не стал %2$s после таймаута %3$s",
   "loc.get.page.source.failed": "Произошла ошибка во время получения разметки страницы"

src/test/java/automationpractice/forms/AuthenticationForm.java

@@ -15,7 +15,7 @@ public AuthenticationForm() {
     }
 
     public void setEmail(String email){
-        txbEmail.type(email);
+        txbEmail.typeSecret(email);
         txbEmail.clearAndType(email);
     }