robot.running.builder package

Submodules

robot.running.builder.builders module

class robot.running.builder.builders.TestSuiteBuilder(included_suites=None, included_extensions=('robot', ), rpa=None, allow_empty_suite=False, process_curdir=True)[source]

Bases: object

Builder to construct TestSuite objects based on data on the disk.

The build() method constructs executable TestSuite objects based on test data files or directories. There are two main use cases for this API:

  • Execute the created suite by using its run() method. The suite can be can be modified before execution if needed.
  • Inspect the suite to see, for example, what tests it has or what tags tests have. This can be more convenient than using the lower level parsing APIs but does not allow saving modified data back to the disk.

Both modifying the suite and inspecting what data it contains are easiest done by using the visitor interface.

This class is part of the public API and should be imported via the robot.api package.

Parameters:
  • include_suites – List of suite names to include. If None or an empty list, all suites are included. Same as using --suite on the command line.
  • included_extensions – List of extensions of files to parse. Same as --extension. This parameter was named extension before RF 3.2.
  • rpa – Explicit test execution mode. True for RPA and False for test automation. By default mode is got from test data headers and possible conflicting headers cause an error. Same as --rpa or --norpa.
  • allow_empty_suite – Specify is it an error if the built suite contains no tests. Same as --runemptysuite. New in RF 3.2.
  • process_curdir – Control processing the special ${CURDIR} variable. It is resolved already at parsing time by default, but that can be changed by giving this argument False value. New in RF 3.2.
build(*paths)[source]
Parameters:paths – Paths to test data files or directories.
Returns:TestSuite instance.
class robot.running.builder.builders.SuiteStructureParser(included_extensions, rpa=None, process_curdir=True)[source]

Bases: robot.parsing.suitestructure.SuiteStructureVisitor

parse(structure)[source]
visit_file(structure)[source]
start_directory(structure)[source]
end_directory(structure)[source]
visit_directory(structure)
class robot.running.builder.builders.ResourceFileBuilder(process_curdir=True)[source]

Bases: object

build(source)[source]

robot.running.builder.parsers module

class robot.running.builder.parsers.BaseParser[source]

Bases: object

parse_init_file(source, defaults=None)[source]
parse_suite_file(source, defaults=None)[source]
parse_resource_file(source)[source]
class robot.running.builder.parsers.RobotParser(process_curdir=True)[source]

Bases: robot.running.builder.parsers.BaseParser

parse_init_file(source, defaults=None)[source]
parse_suite_file(source, defaults=None)[source]
build_suite(model, name=None, defaults=None)[source]
parse_resource_file(source)[source]
class robot.running.builder.parsers.RestParser(process_curdir=True)[source]

Bases: robot.running.builder.parsers.RobotParser

build_suite(model, name=None, defaults=None)
parse_init_file(source, defaults=None)
parse_resource_file(source)
parse_suite_file(source, defaults=None)
class robot.running.builder.parsers.NoInitFileDirectoryParser[source]

Bases: robot.running.builder.parsers.BaseParser

parse_init_file(source, defaults=None)[source]
parse_resource_file(source)
parse_suite_file(source, defaults=None)
robot.running.builder.parsers.format_name(source)[source]
class robot.running.builder.parsers.ErrorReporter(source)[source]

Bases: ast.NodeVisitor

visit_Error(node)[source]
generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

robot.running.builder.testsettings module

class robot.running.builder.testsettings.TestDefaults(parent=None)[source]

Bases: object

setup
teardown
force_tags
timeout
class robot.running.builder.testsettings.TestSettings(defaults)[source]

Bases: object

setup
teardown
timeout
template
tags

robot.running.builder.transformers module

class robot.running.builder.transformers.SettingsBuilder(suite, test_defaults)[source]

Bases: ast.NodeVisitor

visit_Documentation(node)[source]
visit_Metadata(node)[source]
visit_SuiteSetup(node)[source]
visit_SuiteTeardown(node)[source]
visit_TestSetup(node)[source]
visit_TestTeardown(node)[source]
visit_TestTimeout(node)[source]
visit_DefaultTags(node)[source]
visit_ForceTags(node)[source]
visit_TestTemplate(node)[source]
visit_ResourceImport(node)[source]
visit_LibraryImport(node)[source]
visit_VariablesImport(node)[source]
visit_VariableSection(node)[source]
visit_TestCaseSection(node)[source]
visit_KeywordSection(node)[source]
generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

class robot.running.builder.transformers.SuiteBuilder(suite, test_defaults)[source]

Bases: ast.NodeVisitor

visit_SettingSection(node)[source]
visit_Variable(node)[source]
visit_TestCase(node)[source]
visit_Keyword(node)[source]
generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

class robot.running.builder.transformers.ResourceBuilder(resource)[source]

Bases: ast.NodeVisitor

visit_Documentation(node)[source]
visit_LibraryImport(node)[source]
visit_ResourceImport(node)[source]
visit_VariablesImport(node)[source]
visit_Variable(node)[source]
visit_Keyword(node)[source]
generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

class robot.running.builder.transformers.TestCaseBuilder(suite, defaults)[source]

Bases: ast.NodeVisitor

visit_TestCase(node)[source]
visit_For(node)[source]
visit_If(node)[source]
visit_TemplateArguments(node)[source]
visit_Documentation(node)[source]
visit_Setup(node)[source]
visit_Teardown(node)[source]
visit_Timeout(node)[source]
visit_Tags(node)[source]
visit_Template(node)[source]
visit_KeywordCall(node)[source]
generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

class robot.running.builder.transformers.KeywordBuilder(resource)[source]

Bases: ast.NodeVisitor

visit_Keyword(node)[source]
visit_Documentation(node)[source]
visit_Arguments(node)[source]
visit_Tags(node)[source]
visit_Return(node)[source]
visit_Timeout(node)[source]
visit_Teardown(node)[source]
visit_KeywordCall(node)[source]
visit_For(node)[source]
visit_If(node)[source]
generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

class robot.running.builder.transformers.ForBuilder(parent)[source]

Bases: ast.NodeVisitor

build(node)[source]
visit_KeywordCall(node)[source]
visit_TemplateArguments(node)[source]
visit_For(node)[source]
visit_If(node)[source]
generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

class robot.running.builder.transformers.IfBuilder(parent)[source]

Bases: ast.NodeVisitor

build(node)[source]
visit_KeywordCall(node)[source]
visit_TemplateArguments(node)[source]
visit_If(node)[source]
visit_For(node)[source]
generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

robot.running.builder.transformers.format_error(errors)[source]