Понимание того, как писать тестовые данные в Robot Framework

Question

Я новичок в Robot Framework и изучаю его документацию. В общем синтаксисе тестовых данных Robot Framework они приводят следующий пример:

*** Settings ***
Documentation    Example using the space separated plain text format.
Library          OperatingSystem

*** Variables ***
${MESSAGE}       Hello, world!

*** Test Cases ***
My Test
    [Documentation]    Example test
    Log    ${MESSAGE}
    My Keyword    /tmp

Another Test
    Should Be Equal    ${MESSAGE}    Hello, world!

*** Keywords ***
My Keyword
    [Arguments]    ${path}
    Directory Should Exist    ${path}

Я не могу понять, что означает [Документация] / Пример теста и [Аргументы] $ {путь} в соответствующих разделах - кажется, нет четкого объяснения тому же?

Как узнать синтаксис этих основ, поскольку руководство не начинается с базовой "Hello World" программы?

Answer 1

Обзор

Значения в квадратных скобках в тестовом примере или определении ключевого слова называются settings .Они задокументированы в руководстве пользователя платформы роботов в разделах Настройки в таблице тестовых примеров и Настройки в таблице ключевых слов .

Робот поддерживает фиксированное количество настроек, поэтому вы не можете просто поместить любое слово в квадратные скобки.Все, что находится в первых словах строки в квадратных скобках, приведет к ошибке, если это не одна из поддерживаемых настроек.

Контрольные примеры поддерживают настройки [Documentation], [Tags], [Setup], [Teardown], [Template] и [Timeout]

Ключевые слова поддерживают настройки [Documentation], [Tags], [Arguments], [Return], [Teardown] и [Timeout]

[Документация]

Как вы и предполагали, [Documentation] предназначен для задания документации для тестового примераили ключевое слово.Дополнительную информацию можно найти в руководстве пользователя для каркаса робота, в разделе под названием Имя тестового набора и документация и Имя ключевого слова пользователя и документация

Преимущество использования [Documentation] вместо комментариев означает, что документация будет отображаться в отчетах и ​​журналах и будет включена в документацию, созданную libdoc и testdoc .

[Аргументы]

[Arguments] - это способ указания аргументов для ключевого слова.Вы не можете использовать этот параметр для тестовых случаев.Он доступен только для ключевых слов и задокументирован в разделе под названием Аргументы пользовательских ключевых слов

Например, если вы пишете ключевое слово, которое принимает аргументы "first_name" и "last_name", выбудет определять настройку [Arguments] следующим образом:

*** Keywords ***
Example Keyword
    [Arguments]  ${first_name}  ${last_name}
    log  Hello, my name is ${first_name} ${last_name}

Внутри ключевого слова первый аргумент будет присвоен локальной переменной ${first_name}, а второй аргумент будет присвоен ${last_name}.