Создание документации Robot Framework для тестовых случаев

Question

Есть ли способ генерировать документацию Robot Framework для тестовых случаев ?

Я могу успешно сгенерировать документацию для ключевых слов и библиотек, используя libdoc, но когда я пытаюсь сделать то же самое для .robot файлов, которые содержат только контрольные примеры, я получаю ошибки ниже.

Файл теста:

*** Settings ***
Documentation   Suite documentation to appear on top of the html doc.
Resource        ../Root.robot

Suite Setup     Create Data
Suite Teardown  Delete Data
Test Setup      Go To Homepage
Test Teardown   Close All Browsers

*** Test Cases ***
Test A
    [Documentation]  The test case documentation.
    Do Something

Ошибки при использовании libdoc в этом файле:

Try --help for usage information.
[ ERROR ] Error in file '/<path>Test.robot': Non-existing setting 'Test Setup'.
[ ERROR ] Error in file '/<path>Test.robot': Non-existing setting 'Test Teardown'.
[ ERROR ] Error in file '/<path>Test.robot': Non-existing setting 'Suite Setup'.
[ ERROR ] Error in file '/<path>Test.robot': Non-existing setting 'Suite Teardown'.
Resource file '/<path>Test.robot' contains a test case table which is not allowed.

Это из-за того, что настройки и разрывы не поддерживаются в libdoc?

Answer 1

Следует использовать TestDoc, а не LibDoc для документации тестового примера.

Оба инструмента здесь: http://robotframework.org/robotframework/#built-in-tools