BDD steps library for test automation
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle DefaultSteps class Refactoring(#125) Jan 17, 2019
src Added english annotation for Dropdown steps (#134) Feb 19, 2019
.gitignore Add opposite checking steps part1 (#64) May 11, 2018
.travis.yml Update .travis.yml Sep 24, 2018
CONTRIBUTION.md feat: initial commit Oct 2, 2017
HEADER License header format fix (#127) Feb 4, 2019
LICENSE feat: initial commit Oct 2, 2017
README.md Update README.md Dec 8, 2018
akita.png feat: initial commit Oct 2, 2017
build.gradle To junit5 (#126) Jan 29, 2019
gradle.properties.enc chore: edited gradle.properties.enc and encription in .travis.yml Oct 5, 2017
gradlew upgrade to Gradle 4.10.2 (#111) Nov 12, 2018
gradlew.bat upgrade to Gradle 4.10.2 (#111) Nov 12, 2018
settings.gradle

README.md

Akita

Build Status Coverage Status Download

@akitaQA
⇧ Join us! ⇧

Akita - бери и тестируй

BDD библиотека шагов для тестирования на основе cucumber и selenide. Тесты пишутся на русском языке и представляют собой пользовательские сценарии, которые могут выступать в качестве пользовательской документации на приложение.

Для написания тестового сценария достаточно подключить библиотеку и воспользоваться любым готовым шагом из ru.alfabank.steps

Например:

Функционал: Страница депозитов
  Сценарий: Открытие депозита
    Допустим совершен переход на страницу "Депозиты" по ссылке "depositsUrl"
    Когда выполнено нажатие на кнопку "Открыть депозит"
    Тогда страница "Открытие депозита" загрузилась

application.properties

Для указания дополнительных параметров или тестовых данных создайте в своем проекте файл application.properties в main/java/resources

Работа со страницами

Для работы с элементами страницы ее необходимо задать как текущую. Таким образом можно получить доступ к методам взаимодействия с элементами, описанным в AkitaPage.

Новую текущую страницу можно установить шагом Когда страница "<Имя страницы>" загрузилась

Для страницы депозитов шаг может выглядеть так Когда страница "Депозиты" загрузилась

Каждая страница, с которой предполагается взаимодействие, должна быть описана в классе наследующемся от AkitaPage. Для страницы и ее элементов следует задать имя на русском, через аннотацию Name, чтобы искать можно было именно по русскому описанию. Элементы страницы ищутся по локаторам, указанным в аннотации FindBy и должны иметь тип SelenideElement или List.

Пример описания страницы:

    @Name("Депозиты")
    public class DepositsPage extends AkitaPage {

        @FindBy(css = ".deposit_open")
        @Name("Открыть депозит")
        private SelenideElement depositOpenButton;

        @FindBy(css = ".deposit_close")
        @Name("Закрыть депозит")
        private SelenideElement depositCloseButton;

        @FindBy(css = ".deposit_list")
        @Name("Список депозитов")
        private List<SelenideElement> depositList;
    }

Инициализация страницы Страница инициализируется каждый раз, когда вызываются методы initialize(<Имя класса страницы>.class)

Пример инициализации страницы "Депозиты":

DepositsPage page = (DepositsPage) getCurrentPage();
akitaScenario.setCurrentPage(page.initialize().appeared());

Пример получения конкретной страницы:

DepositsPage page = akitaScenario.getPage(DepositsPage.class);

Другой способ работы с методами страницы - это использование AkitaScenario.withPage Пример использования: withPage(TestPage.class, page -> { some actions with TestPage methods});

Для страницы инициализируется карта ее элементов - это те поля, что помечены аннотацией Name. Кроме того, осуществляется проверка, что загружена требуемая страница. Страница считается загруженной корректно, если за отведенное по умолчанию время были загружены основные ее элементы. Основными элементами являются поля класса страницы с аннотацией Name, но без аннотации Optional. Аннотация Optional указывает на то, что элемент является не обязательным для принятия решения о загрузке страницы. Например, если на странице есть список, который раскрывается после нажатия не него, т.е. видим не сразу после загрузки страницы, его можно пометить как Optional. Реализована возможность управления временем ожидания появления элемента на странице. Чтобы установить timeout, отличный от базового, нужно добавить в application.properties строку waitingAppearTimeout=150000

Доступ к элементам страницы

Данные строки позволяют по имени элемента найти его в карте элементов текущей страницы.

akitaScenario.getCurrentPage().getElement("Открыть депозит")
akitaScenario.getCurrentPage().getElementsList("Список депозитов")

Блоки на странице

Реализована возможность описывать блоки на странице (Page Element) Например:

@FindBy(className = "header")
@Name("Шапка страницы")
public HeaderBlock header;

При загрузке страницы будут учитываться элементы, описанные в блоке

Screenshots

Реализован кастомный StepFormatter. При подключении его к проеку с тестами, становится достуна опция снятия скриншотов после желаемого или каждого шага. @CucumberOptions(format = {"pretty", "ru.alfabank.tests.core.formatters.StepFormatter"})

Аннотация @Screenshot, указанная над кастомным тестовым шагом, позволит добавить скриншот после прохождения этого шага в отчет.

Есть также возможность получать скриншоты после каждого шага всех сценариев. Для этого необходимо задать системную переменную takeScreenshotAfterSteps=true.

Работа с REST запросами

В библиотеке реализована возможность отправки REST запросов и сохранения ответа в переменную.

Поддерживаются следующие типы запросов: GET, POST, PUT, DELETE.

    | type   | name          | value           |
    | header | applicationId | test            |
    | header | customerId    | <userCus>       |
    | body   | repayment     | <fileForCreate> |

В таблице переменных поддерживаются типы: header, parameter, body Для body-параметра сейчас поддерживается как работа с телом запроса, хранящимся в папке restBodies, так и с указанием текста body в самом шаге в соответствующей ячейке Значения параметров таблицы и частей url можно указывать в application.properties

Отображение в отчете справочной информации

Для того, чтобы в отчете появился блок Output с информацией, полезной для анализа отчета, можно воспользоваться следующим методом

akitaScenario.write("Текущий URL = " + currentUrl + " \nОжидаемый URL = " + expectedUrl);

Проверка логического выражения

У нас есть шаг, который например может выглядеть так:

Тогда верно что "amountToPay == amountMonthly + penalty + 100"

Важно отметить, что равенство проверяется использованием операнда "==", неравенство, как "!="

Использование переменных

Иногда есть необходимость использовать значения из одного шага в последующих. Для этого реализовано хранилище переменных в AkitaScenario. Для сохранения/изъятия переменных используются методы setVar/getVar.

Сохранение переменной в хранилище: akitaScenario.setVar(<имя переменной>, <значение переменной>);

Получение значения переменной из хранилища: akitaScenario.getVar(<имя переменной>)

Кастомный драйвер - CustomDriverProvider

Позволяет запускать тесты с кастомными настройками браузеров и на ремоуте. Параметры запуска можно задавать как системные переменные. Например, можно указать браузер, версию браузера, remote Url(где будут запущены тесты), ширину и высоту окна браузера:

./gradlew clean gCR -Pbrowser=chrome -PbrowserVersion=64.0 -PremoteUrl=http://remote/url -Pwidth=1200 -Pheight=800

Если параметр remoteUrl не указан - тесты будут запущены локально в заданном браузере последней версии (Пример настройки запуска тестов с кастомным браузером можно посмотреть в Akita-testing-template)

Если указан параметр headless -Pheadless=true, то браузеры chrome и firefox будут запускаться в headless режиме.

Blacklist

Иногда есть необходимость добавить определенные ресурсы в черный список. Для этого была реализована возможность создать файл без расширения blacklist . Его необходимо положить в src/main/java/resources/

blacklist предназначен для хранения нежелательных, указанных пользователем ресурсов, которые будут добавлены в черный список при запуске тестов через CustomDriverProvide.

Формат записи - каждый новый ресурс с новой строки, например:

 .*ru.fp.kaspersky-labs.com.*
 http://google.com/ 200

При необходимости можно указывать возвращаемый статус код через пробел, например: http://google.com/ 200

Если статус код не указан, по умолчанию будет присвоен 404

Краткое описание главных классов

ru.alfabank.alfatest.cucumber.api.AkitaEnvironment Используется для хранения страниц и переменных внутри сценария scenario - Сценарий из Cucumber.api, с которым связана среда

ru.alfabank.alfatest.cucumber.api.AkitaPage Класс для реализации паттерна PageObject. Тут описаны основные методы взаимодействия с элементами страницы

ru.alfabank.alfatest.cucumber.api.AkitaScenario Позволяет заполнить хранилище переменных, существующее в рамках одного сценария, значениями и читать эти значения при необходимости.

ru.alfabank.steps.DefaultApiSteps Шаги для тестирования API, доступные по умолчанию в каждом новом проекте

ru.alfabank.steps.DefaultSteps Шаги для тестирования UI, доступные по умолчанию в каждом новом проекте

ru.alfabank.steps.InitialSetupSteps Хуки предустановок, где происходит создание, закрытие браузера, получение скриншотов

ru.alfabank.tests.core.drivers.MobileChrome Класс, описывающий создание экземпляра мобильной версии Google Chrome драйвера

ru.alfabank.tests.core.helpers.PropertyLoader Класс для получения свойств

ru.alfabank.tests.core.drivers.CustomDriverProvider Провайдер кастомного драйвера

Testing Template

https://github.com/alfa-laboratory/akita-testing-template

Контакты

Telegram

Используемые зависимости:

nebula-release-plugin - Apache License Version 2.0 coveralls-gradle-plugin - The MIT License (MIT) com.codeborne.selenide - The MIT License (MIT) io.rest-assured.rest-assured - Apache License Version 2.0 com.google.inject.guice - Apache License Version 2.0 org.mockito.mockito-core - The MIT License com.github.tomakehurst:wiremock - Apache License Version 2.0 org.hamcrest.hamcrest-all - BSD License org.codehaus.groovy - Apache License Version 2.0 JUnit - Eclipse Public License org.slf4j.slf4j-simple - The MIT License (MIT) org.projectlombok.lombok - The MIT License (MIT) info.cukes.cucumber-java - The MIT License (MIT) info.cukes.cucumber-core - The MIT License (MIT) org.reflections.reflections