Основы мета-языка

• Описание тестов
• Селекторы
• Выражения и кванторы
• Кванторы и коллекции
• Проверка инвариантов
• Использование python кода в тестах

Для описания тестов платформа “Meta Test” использует специализированный мета-язык. По сути это декларативный, внутренний предметно-ориентированный язык предназначенный для описания автоматизированных QA тестов пользовательского интерфейса веб приложений.

Такой подход позволяет:

• Значительно сократить время описания тестов
• Повысить стабильность тестов
• Снизить порог вхождения в автоматизированное тестирование
• Получить эффективное многопоточное выполнение тестов (за счёт гарантированной атомарности на уровне теста)

Поскольку интерпретатор мета-языка работает поверх виртуальной машины python, то возможно комбинировать тесты описанные на мета-языке с программным кодом написанным на языке python. Но нужно учитывать что код на python-е будет работать только во время загрузки тестов, но не во время их выполнения.

Описание тестов

TEST[“Заголовок”](Последовательность команд , {атрибут=значение})({параметр=значение})

Этот объект используется для описания теста. Обязательно должен быть задан заголовок теста и последовательность команд которые будут выполнены при запуске теста. Для конкретизации свойств теста он может быть определён со следующими атрибутами. Если атрибут не задан явно, то будут использовано его значение по умолчанию или взято значение из параметров среды.

• tags - Множество текстовых тегов на которых определён тест. Если это множество не пересекается с множеством CONFIG.TAGS, то тест не будет запущен. Если множество пустое или аргумент явно не определён, то тест будет выполнен только в том случае если множество тегов CONFIG.TAGS не определено. Если имя тега начинается с символа **@*, то это означает что тест на этом теге не может быть определён. Например: если атрибут теги [“@Тег1”, “Тег2”], то тест не будет запущен если CONFIG.TAGS содержит тег “Тег1”. По умолчанию - {}*
• browser - Множество идентификаторов браузеров на которых определён тест. Если это множество не пересекается с множеством CONFIG.BROWSERS, то тест не будет запущен. Если множество пустое или аргумент явно не определён, то тест будет выполнен на всех браузерах из множества CONFIG.BROWSERS. По умолчанию - {}
• test_id - Идентификатор теста (см CONFIG.TEST_ID). Уникальная строка которая однозначно идентифицирует тест. Если аргумент не определён, то идентификатор генерируется автоматически.
• size - Размер окна браузера. Может быть определён как кортеж (длина, ширина) или как строковые константы. По умолчанию - CONFIG.PAGE_SIZE

• fatality - Завершать тестирование после первой ошибки. По умолчанию - CONFIG.TEST_FATALITY
• retries - Устанавливает максимальное количество перезапусков теста. По умолчанию - CONFIG.RETRIES
• retries_sleep - Устанавливает задержку в сек. перед перезапуском теста. По умолчанию - CONFIG.RETRIES_SLEEP
• repiated - Устанавливает количество запусков теста (игнорируется если установлен retries). По умолчанию - CONFIG.TEST_REPIATED
• active - Флаг, если он установлен в False то тест не выполняется. По умолчанию - True
• single_thread - Флаг указывающий что все экземпляры теста (т.е. параметризованные тесты и тесты для разных браузеров) должны выполняться последовательно. По умолчанию - CONFIG.SINGLE_THREADS
• negative - Если этот флаг установлен в True то тест негативный. По умолчанию - False
• trigger - Идентификатор триггера для текущего теста.
• description - Текстовое описания теста.
• severity - Строковая константа устанавливающая степень важности тестируемого дефекта. Может принимать значения: TRIVIAL | MINOR | NORMAL | CRITICAL | BLOCKER. По умолчанию - NORMAL
• flaky - Флаг, если он установлен в True то тест считается не стабильным. Может использоваться для перезапуска только нестабильных тестов см. CONFIG.RETRIES_MODE. По умолчанию False

По мимо этих значений в расширениях могут быть описаны пользовательский атрибуты тестов (см. Интеграция с системами отчётов )

Пример:

TEST["На хабр можно зайти"](
    URL("https://habr.com/")
    , "habr.com" > PAGE_URL
    
    , "Проверка наличия блока логотипа"
    , ONE("scope::habr/logo_locator")
    
    , "Проверка наличия блока поиска"
    , ONE("scope::habr/search_locator")
    
    , "Проверка наличия блока рекламы"
    , ONE("scope::habr/news_block_locator")
    
    , description = "Мы можем зайти на habr.com, нам виден логотип и некоторые блоки"
    , browser = ("chrome", "firefox")
    , tags = ("base", "habr")
)

Параметризованные тесты

Тесты можно запускать с различными параметрами. Для каждого набора параметров будет запущен отдельный экземпляр теста. После запуска теста текущие параметры записываются в пространство имён теста и могут быть получены командой ARG.

Параметры теста могут быть именованные и не именованные. Если параметр именованный, то его имя явно задаётся при описания теста, в противном случае значение параметра можно получить по его индексу.

Пример:

from faker import Faker

test = TEST["text-box"](
    URL("https://demoqa.com/text-box")
    
    , "Заполняем"
    , DATA("#userName", ARG(0))
    , DATA("#userEmail", ARG(1))
    , DATA("#currentAddress", ARG("address1"))
    , DATA("#permanentAddress", ARG("address2"))
    , CLICK("#submit")
    
    , "Проверяем"
    , ONE("#name") == "Name:" + ARG(0)
    , ONE("#email") == "Email:" + ARG(1)
    , ONE("p#currentAddress") == "Current Address :" + ARG("address1")
    , ONE("p#permanentAddress") == "Permananet Address :" + ARG("address2")
    
    , tags = "form"
)

# выполняем тест "text-box" 100 раз.
# каждый раз генерируется новый набор тестовых данных

fake = Faker("ru_RU")

for _ in range(100):
    test(
        fake.name(), fake.email()  # Не именованные параметры
        , address1=fake.address()  # Именованные параметры
        , address2=fake.address()
    )

Если во время выполнения параметризованного теста могут меняться данные на сайте, то возможно будет целесообразным установить атрибут single_thread в True. Это позволит гарантировать последовательное выполнение тестов при многопоточном запуске что позволит обеспечить их независимость от изменения данных другим экземплятор теста.

Субтесты

Иногда необходимо не завершая текущий тест открыть новый браузер и выполнить ряд действий на тестируемом сайте. Для этих целей используются субтесты. Они определяются как вложенный тест без указания заголовка.

Пример:

TEST["Основной тест"](
    URL
    , ...
    TEST(
        URL
        , ...
    )
    , ...
)

Субтест имеет общее пространство имён с основным тестом и наследует все его атрибуты.

ARG(“имя” [, значение ] [, default=значение ])

Перед запуском теста создаётся специальное пространство имён доступ к которому могут получить только команды выполняемые во время тестирования. Это пространство используется для обмена данными между скриптами, субтестами и основным тестом, а так же для параметризации тестов и скриптов. Непосредственный доступ к пространству внутри теста можно получить посредством команды ARG следующим образом:

• ARG(“имя”, значение) - Устанавливает ассоциацию имени со значением.
• ARG(“имя”) - Возвращает значение ассоциированное с именем. Если с именем не было ассоциировано никаких данных, то действие в котором использован аргумент будет пропущено. В режиме отладки пропущенные действия отображаются со статусом SCIP. Если необходимо пропустить не одно, а несколько действий, то можно воспользоваться условным оператором.
• ARG(“имя”, default=value) - Возвращает значение ассоциированное с именем. Если с именем не было ассоциировано никаких данных, то возвращается значение определённое в атрибуте default.

Пример:

# этот блок будет выполнен только если определён аргумент user

IF(ARG("user"), (
    DATA("pht::Username", ARG("user"))
    , CLICK("button")
))

Обратите внимание на то что аргументы не являются переменными. Одна команда должна установить определить ассоциацию с данными лишь единожды.

SCRIPT[“идентификатор”](Последовательность команд, {атрибут=значение})

Этот объект позволяет задать идентификатор последовательности команд что позволяет переиспользовать её в тестах.

Для скрипта может быть переопределён атрибут fatality.

Пример:

# Создаём скрипт
SCRIPT["login"](
    URL("/login")
    , DATA("pht::Username", "Admin")
    , DATA("pht::Password", "admin123")
    , CLICK("button")
    
    , fatality=True
)

SCRIPT[“идентификатор”] | SCRIPT(“идентификатор” {“идентификатор”}, {аргумент=значение})

Для того что бы выполнить ранее определённый скрипт нужно использовать команду SCRIPT[“Идентификатор”].

Пример:

SCRIPT["login"](
    URL("/login")
    , DATA("pht::Username", ARG("user"))
    , DATA("pht::Password", ARG("passwd"))
    , CLICK("button")
    , ~(PAGE_URL < "/login") # URL текущей страница не должен содержать подстроки /login
    
    , fatality=True
)

TEST["Проверка входа на сайт"](
    ARG("user", "Admin")
    , ARG("passwd", "admin123")
    , SCRIPT["login"]
)

Как видно при большом количестве аргументов не удобно использовать их явное определение. По этому для вызова параметризованного скрипта нужно использовать конструкцию SCRIPT(“Идентификатор” {“идентификатор”}, {аргумент=значение}). Так же с её помощью возможно вызвать последовательно несколько скриптов указав их идентификаторы через запятую.

Пример:

TEST["Проверка входа на сайт"](
    SCRIPT("login", user="Admin", passwd="admin123")
)

TEST["Без пароля не войдём"](
    SCRIPT("login", user="Admin")
    , negative=True
)

TEST["Без логина не войдём"](
    SCRIPT("login", passwd="admin123")
    , negative=True
)

TEST["Заходим и выходим"](
    SCRIPT("login", "logout", passwd="admin123", user="Admin")
)

STEP[“заголовок”](Последовательность команд, {атрибут=значение})

Логически связанную последовательность команд можно объединить вместе при помощи объекта STEP. Это позволит детализировать информацию выводимую в отчётах.

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

Пример:

...
, STEP["Логин"](
    DATA("pht::Username", ARG("user"))
    , DATA("pht::Password", ARG("passwd"))
    , CLICK("button")
)

# шаги могут быть вложенными:
...
, STEP["Логин"](
    STEP["заполняем"](
        DATA("pht::Username", ARG("user"))
        , DATA("pht::Password", ARG("passwd"))
    )
    , CLICK("button")
)

# Сокращённая запись (вложенность не поддерживается)
...
, "Логин"
, DATA("pht::Username", ARG("user"))
, DATA("pht::Password", ARG("passwd"))
, CLICK("button")

Для шага могут быть определены атрибуты description, step_id и fatality.

SCOPE([“идентификатор”])

Для передачи данных между тестами можно создавать пользовательские пространства имён. Вызов объекта SCOPE возвращает ссылку на пространство имён доступное всем тестам. Это полезно для хранения данных которые используют тесты из разных файлов.

Объект SCOPE может принимать имя скопа которое является идентификатором возвращаемого пространства имён.

Пример:

from faker import Faker

fake = Faker("ru_RU")

scp         = SCOPE("user")
scp.fio     = fake.name()
scp.email   = fake.email()
scp.address = fake.address()

TEST["..."](
    ...
    , DATA("#fio", scp.fio)
    , ...
)

Для доступа к SCOPE-пространству имён данным из теста кроме ссылки на само пространство можно использовать специальный локатор - “scope::space_id/name” или объект NP(“имя скопа”, “имя”)

Пример:

DATA("#fio", "scope::scp/fio")

DATA("#fio", NP("scp", "fio"))

Селекторы

Для определения пути к элементу страницы используются селекторы. Существует несколько типов селекторов, обычно платформа может автоматически определит его тип. Если тип определяется не верно или необходимо использовать селектор другого типа, то его можно явно указать при помощи префикса селектора с разделителем “::”. Правила определения типа селектора приведены в таблице.

Если ни одно из вышеприведённых правил не подходит, то происходит поиск элемента с видимым текстом соответствующим заданному селектору. Фактически поиск происходит по следующему XPATH селектору: //*[contains(normalize-space(text()), normalize-space(‘ТЕКСТ’))]

Селектор может указывать не на один, а на список элементов. В этом случае что бы выбрать конкретный элемент можно указать его индекс добавив его в конец префикса селектора - префикс[индекс]::селектор. Отсчёт индексов начинается с 1, индекс 0 будет указывать на последний элемент, индекс -1 на предпоследний и т.д.

# Кликнет на первый элемент который принадлежат классу react-datepicker-wrapper
CLICK("[1]::.react-datepicker-wrapper")

# То же, но с явным указанием типа селектора.
CLICK("css[1]::.react-datepicker-wrapper")

Составные селекторы

Иногда бывает проще определить путь к элементу страницы как список селекторов подчинённых элементов. Такие селекторы называются составными. Этот способ определения селектора удобен ещё тем что позволяет комбинировать селекторы разных типов.

Пример:

# На форме есть несколько полей с заполнителем "Адрес".
# По этому выбираем то которое находится в контейнере с идентификатором "adress_1"

ONE(["#adress_1", "pht::Адрес"])

Составными селекторами не стоит злоупотреблять т.к. скорость их работы может быть значительно меньше чем у обычных селекторов.

FP(“селектор фрейма” {“селектор фрейма”}, “селектор элемента” [, timeout ])

Для определения пути к элементу находящемуся в фрейме нужно использовать специальный объект FP (Frame Pointer). Сначала ему нужно передать селектор фрейма (или нескольких фреймов в порядке вложенности) в котором находится элемент, а затем селектор самого элемента.

timeout - Время явного ожидания элемента. По умолчанию - CONFIG.WAIT_TIMEOUT

Пример:

TEST["nestedframes"](
    URL("https://demoqa.com/nestedframes")
    , ONE(FP("#frame1", "body")) == "Parent frame"
    , ONE(FP("#frame1", "iframe", "body")) == "Child Iframe"
)

Этот способ удобен если нужно однократно обратится к элементу в фреме, если же нужно активно работать с такими элементами, то целесообразно полностью переключится на фрейм (см. описание команды FRAME)

SP(“селектор” {“селектор”}, “селектор элемента” [, timeout ])

Для элементов в теневом DOM тоже есть аналогичный объект, он называется SP (Shadow Pointer). Ему сначала передают селекторы контейнеров содержащих вложенный DOM, а затем селектор элемента.

timeout - Время явного ожидания элемента. По умолчанию - CONFIG.WAIT_TIMEOUT

Пример:

TEST["shadow DOM"](
    URL("http://watir.com/examples/shadow_dom.html")
    , DATA(SP("#shadow_host", "input[type=text]"), "file.jpeg")
    , UPLOAD(SP("#shadow_host", "input[type=file]"), "file.jpeg")
    , CLICK(SP("#shadow_host", "input[type=checkbox]"))
    , ONE(SP("#shadow_host", "#nested_shadow_host", "#nested_shadow_content")) == "nested text"
)

Выражения и кванторы со скалярными типами

Для проверки значений на страницы используются выражения. Выражения имеют смысл если являются предикатами т.е. возвращают логическое значение. Для проверки свойств веб-элементов используются объекты называемые кванторами они получили своё название из-за схожего поведения с одноимёнными абстракциями математической логики. Кроме кванторов в выражениях можно использовать константы, они подробно описаны в соответствующем разделе.

ONE(“селектор” [, propertie ] [, displayed ] [, strip ] [, timeout ])

Квантор единственности. Если селектор будет указывать более чем на один элемент или элемента вообще не будет обнаружено, то попытка выполнения квантора завершится с ошибкой. В противном случае квантор вернёт свойство элемента на который указывает селектор.

Какое именно свойство нужно вернуть указывается в необязательном атрибуте properties. Если атрибут не задан то:

• для элементов input, textarea, select, progress и param возвращается значение свойства value
• для элемента option возвращается значение свойства selected
• для всех других элементов значение свойства textContent

properties так же может ссылаться на css свойства элемента или на его атрибуты. Для этого нужно указать его префикс css:: или attr:: соответственно.

Кроме properties квантор может принимать следующие параметры:

• displayed - Если равен True, то ждём отображения элемента на страницы. По умолчанию - False
• strip - Если равен True, удаляются все пробельные символы в начале и конце возвращаемой строки. По умолчанию - True
• timeout - Время явного ожидания элемента. По умолчанию - CONFIG.WAIT_TIMEOUT

В выражениях с квантором ONE могут использоваться следующие операторы:

Пример:

# Существует только ОДИН элемент соответствующий селектору "div.passwd"
ONE("div.passwd")

# Существует только ОДИН элемент соответствующий селектору "div.passwd"
# Текст которого содержит подстроку "Пароль"
"Пароль" > ONE("div.passwd")

# Существует только ОДИН элемент соответствующий селектору "div.passwd"
# Цвет фона которого равен #f5f5f5
ONE("div.passwd", "css::background-color") == "#f5f5f5"

ALL(“селектор” [, properties ], [, displayed ] [, strip ] [, unique ] [, timeout ])

Квантор всеобщности Этот квантор возвращает не одно, а список свойств веб-элементов на которые указывает селектор. Его использование аналогично квантору ONE, за тем исключением что в выражение применяется не к одному значению, а их списку. Предикат с квантором ALL примет истину когда истину вернёт каждое значение переданное квантором.

Атрибуты:

• properties - Идентификатор возвращаемого свойства (см. описание квантора ONE)
• displayed - Если равен True, то ждём отображения элементов на страницы. По умолчанию - False
• strip - Если равен True, то удаляются все пробельные символы в начале и конце каждой возвращаемой строки. По умолчанию - True
• unique - Значения возвращаемые квантором будут уникальными (порядок значений сохраняется). По умолчанию - False
• timeout - Время явного ожидания ожидания элемента. По умолчанию - CONFIG.WAIT_TIMEOUT

Семантика операторов при операциях со скалярным значением:

Пример:

# Текст во ВСЕХ элементов соответствующих селектору "div.passwd" содержит подстроку "Пароль"
ALL("div.passwd") < "Пароль"

# Текст во ВСЕХ свойствах элементов соответствующих селектору "div.passwd" равен строке "Пароль"
ALL("div.passwd") == "Пароль"

ANY(“селектор” [, properties ] [, displayed ] [, strip ] [, unique ] [, timeout ])

Квантор существования. Этот квантор схож с квантором ALL, но в отличии от него предикат принимает истину когда любое из значений вернуло истину, а не все.

Атрибуты:

• properties - Идентификатор возвращаемого свойства (см. описание квантора ONE)
• displayed - Если равен True, то ждём отображения элемента на страницы. По умолчанию - False
• strip - Если равен True, удаляются все пробельные символы в начале и конце каждой возвращаемой строки. По умолчанию - True
• unique - Значения возвращаемые квантором будут уникальными (порядок значений сохраняется). По умолчанию - False
• timeout - Время явного ожидания ожидания элемента. По умолчанию - CONFIG.WAIT_TIMEOUT

Семантика операторов при операциях со скалярным значением:

Пример:

# СУЩЕСТВУЕТ элемент соответствующий селектору "div.passwd" текст которого содержит подстроку "Пароль"
ANY("div.passwd") < "Пароль"

# СУЩЕСТВУЕТ элемент соответствующий селектору "div.passwd" текст которого равен строке "Пароль"
ANY("div.passwd") == "Пароль"

Кванторы и коллекции

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

Семантика квантора ONE в выражениях с коллекциями:

Пример:

# Текст элемента с селектором "[1]::div" находится в списке ["Строка 1", "Строка 2"]

ONE("[1]::div") > ["Строка 1", "Строка 2"]

Операторы == и != сравнивают значение возвращаемое квантором ALL или ANY со значением списка, а операторы + и - позволяют объединить значение квантора и списка или получить их разность.

Семантика квантора ALL в выражениях с коллекциями:

Пример:

# Текст ВСЕХ элементов соответствующих селектору "div.passwd" содержат подстроку "Пароль" И "Passwd"

ALL("div.passwd") < ["Пароль", "Passwd"]

# проверка заполнения таблицы. Оператор == сравнивает списки :)

ALL("tr > td") == [
    "Student Name", "имя, фамилия"
    , "Student Email", "scope::data/email"
    , "Gender", "Male"
    , "Mobile", "scope::data/mobile"
    , "Date of Birth", "31 December,1999"
    , "Subjects", "Physics"
    , "Hobbies", "Sports"
    , "Picture", "scope::data/image_name"
    , "Address", "scope::data/address"
    , "State and City", "Haryana Panipat"
]

Семантика квантора ANY в выражениях с коллекциями:

Пример:

# СУЩЕСТВУЕТ элементов соответствующий селектору "div.passwd"
# Текст которого содержит подстроки "Пароль" ИЛИ "Passwd"

ANY("div.passwd") < ["Пароль", "Passwd"]

ANY_LIST(значение, {значение}) и ALL_LIST(значение, {значение})

Нетрудно заметить что действие квантора распространяется и на элементы коллекции. Например выражение ALL(“tr”) < [1,2,3] означает что текст внутри ВСЕХ элементов с селектором tr должен содержать ВСЕ подстроки “1”, “2” и “3”.

Если текст хотя бы одного из элементов не будет содержать одну из этих подстрок всё выражение будет ложным. Что бы ослабить это условие список подстрок нужно определить как коллекцию заданную при помощи объекта ANY_LIST: ALL(“tr”) < ANY_LIST(1,2,3). Такое выражение будет означать что текст КАЖДОГО из элементов соответствующих селектору должен содержать ЛЮБУЮ из подстрок коллекции.

Аналогичная ситуация и с выражениями образованными при помощи квантора ANY. Так выражение ANY(“tr”) < [1,2,3] означает что текст любого из элементов с селектором tr должен содержать ЛЮБУЮ из подстрок “1”, “2” и “3”.

Если необходимо проверить вхождение ВСЕХ подстрок в текст ЛЮБОГО из элементов, то выражение нужно переписать с использованием команды ALL_LIST: ANY(“tr”) < ALL_LIST(1,2,3).

Кроме того команды ANY_LIST и ALL_LIST могут использоваться вместе с квантором ONE что бы более точно определить его поведение в выражениях со списками. Например выражение ONE(“[1]::tr”) > ANY_LIST(1, 2, 3) означает что подстрока возвращаемая квантором ONE(“[1]::tr”) должна содержать ЛЮБУЮ из подстрок “1”, “2” или “3”. А выражение ONE(“[1]::tr”) > ALL_LIST(1, 2, 3) означает что это значение этого квантора должно содержать ВСЕ подстроки из ALL_LIST(1, 2, 3).

Проверка инвариантов

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

Если такое выражение окажется ложным, то тест или завершится со статусом FATAL или продолжится со статусом FAILED в зависимости от значения параметра CONFIG.TEST_FATALITY. Команды ASSERT и FATAL позволяют явно задать это поведение.

Пример:

# Тест завершится или выдаст ошибку, но продолжит работать 
# если текст в элементе с селектором "div.user" не будет равен "Admin"
, ONE("div.user") == "Admin"

ASSERT | ASSERT(выражение [, “сообщение” ])

Вычисляет выражение, если его значение False, то тест продолжится со статусом FAILED. К отчёту можно добавить текст сообщения об ошибки. Если выражение не содержит аргументов, то оно сразу переводит тест в статус FAILED.

Аргументы:

• выражение - Выражение в котором произошла ошибка
• сообщение - пользовательское описание ошибки

FATAL | FATAL(выражение [, “сообщение” ])

Вычисляет выражение, если его значение False, то тест завершится со статусом FATAL. К отчёту можно добавить текст сообщения об ошибки. Если выражение не содержит аргументов, то оно сразу переводит тест в статус FATAL.

Аргументы:

• выражение - Выражение в котором произошла ошибка
• сообщение - пользовательское описание ошибки

Пример:

# Завершает тест если текущий URL не содержит подстроки "/news"
, FATAL("/news" > PAGE_URL, "Не тот URL")

# Если в тексте заголовка страницы отсутствует подстрока "Новости",
# то переводим тест в FAILED, но продолжаем тестировать
, ASSERT("Новости" > PAGE_TITLE, "Не верный заголовок страницы")

Использование кода на языке python в тестах

Динамическое получение данных

В предыдущих примерах данные создавались перед выполнением теста. Но иногда необходимо получать их динамически во время его выполнение. Для этой цели можно в качестве данных использовать нульарную функцию (т.е. функцию не принимающую аргументов) которая будет их возвращать.

Примеры:

# pass_manager - гипотетическая функция которая выдаёт пароль пользователя во время выполнения команды DATA из теста.
# С её помощью можно гарантировать не пересечение данных между тестами.

test = TEST["Зачисление денег на счёт"](
    ...
    , DATA("#user", ARG("user_pass"))
    ...
    , test_id="123"
)
test(user_pass=lambda: pass_manager(test.test_id))

test = TEST["Списание денег с счёта"](
    ...
    , DATA("#user", ARG("user_pass"))
    ...
    , test_id="345"
)
test(user_pass=lambda: pass_manager(test.test_id))

import random

TEST["Заполнение случайными числами"](
    ...
    , DATA("#random_data", lambda: random.randint(1, 100))
    ...
)

Вызов python функции из теста

При описании теста на метаязыке вы полностью абстрагированы от объекта WebDriver-а. Но не исключено что может возникнуть необходимость в низкоуровневом доступе к управлению браузером. В этом случае можно получить объект-обёртку WebBrowser и вызвав его метод get_driver получить объект драйвера. Что бы получить WebBrowser нужно передать в тело теста унарную функцию (т.е. функцию с 1 аргументом) которая этот объект и будет принимать.

Пример:

def go_example(browser):
    driver = browser.get_driver()
    driver.get("https://example.com")

TEST["Пример перехода на URL через WebDriver"](
    go_example
    ...
)

Использовать эту возможность нужно очень аккуратно и только при крайней необходимости.

Декоратор command

Вызываемая из теста функция не является полноценной командой. Например результат который она возвращает нельзя использовать в выражениях. Для решения этой проблемы был создан декоратор @command. Функция которая передаётся декоратору как обычная функция в первом аргументе принимает объект WebBrowser-а. Но кроме него она может принять произвольное количество аргументов передаваемых ей из тела теста, а возвращаемое ей значение может быть использовано напрямую в выражениях.

Пример:

@command
def SORT_ASC(browser, data_list):
    return all(map(lambda x, y: x <= y, data_list[0::2], data_list[1::2]))

TEST["Проверка сортировки"](
    ...
    , SORT_ASC(ALL(".price")) == True
    ....
)

К объекту созданному при помощи декоратора command можно добавлять предупреждения, сообщения и скриншоты. Для этих целей нужно присвоить значение строковое значение методам warning или message. Скриншот должен представлять собой байтовую строку содержащую изображение в формате PNG (её можно получить вызвав browser.screenshot()), она присваивается методу screenshots.

Пример:

@command
def SORT_ASC(browser, data_list):
    SORT_ASC.message = "Проверка сортировки"
    try:
        if all(map(lambda x, y: x <= y, data_list[0::2], data_list[1::2])):
            return True
        else:
            SORT_ASC.warning = "Не отсортировано!"
            return False
    except:
        SORT_ASC.screenshots = browser.screenshot()