robot.running.builder package

Submodules

robot.running.builder.builders module

class robot.running.builder.builders.TestSuiteBuilder(included_suites=None, included_extensions=('robot', ), rpa=None, lang=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 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.
  • rpa – Explicit test execution mode. True for RPA and False for test automation. By default, mode is got from data file headers and possible conflicting headers cause an error. Same as –rpa or –norpa.
  • lang – Additional languages to be supported during parsing. Can be a string matching any of the supported language codes or names, an initialized Language subsclass, a list containing such strings or instances, or a Languages instance.
  • allow_empty_suite – Specify is it an error if the built suite contains no tests. Same as –runemptysuite.
  • 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.
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, lang=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(lang=None, 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(lang=None, 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(lang=None, 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.settings module

class robot.running.builder.settings.Defaults(parent=None)[source]

Bases: object

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

Bases: object

setup
teardown
timeout
template
tags

robot.running.builder.transformers module

class robot.running.builder.transformers.SettingsBuilder(suite, 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_KeywordTags(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, 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_KeywordTags(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_While(node)[source]
visit_If(node)[source]
visit_Try(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]
visit_ReturnStatement(node)[source]
visit_Continue(node)[source]
visit_Break(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, defaults)[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_ReturnStatement(node)[source]
visit_Continue(node)[source]
visit_Break(node)[source]
visit_For(node)[source]
visit_While(node)[source]
visit_If(node)[source]
visit_Try(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_While(node)[source]
visit_If(node)[source]
visit_Try(node)[source]
visit_ReturnStatement(node)[source]
visit_Continue(node)[source]
visit_Break(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_For(node)[source]
visit_While(node)[source]
visit_If(node)[source]
visit_Try(node)[source]
visit_ReturnStatement(node)[source]
visit_Continue(node)[source]
visit_Break(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.TryBuilder(parent)[source]

Bases: ast.NodeVisitor

build(node)[source]
visit_For(node)[source]
visit_While(node)[source]
visit_If(node)[source]
visit_Try(node)[source]
visit_ReturnStatement(node)[source]
visit_Continue(node)[source]
visit_Break(node)[source]
visit_KeywordCall(node)[source]
visit_TemplateArguments(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.WhileBuilder(parent)[source]

Bases: ast.NodeVisitor

build(node)[source]
visit_KeywordCall(node)[source]
visit_TemplateArguments(node)[source]
visit_For(node)[source]
visit_While(node)[source]
visit_If(node)[source]
visit_Try(node)[source]
visit_ReturnStatement(node)[source]
visit_Break(node)[source]
visit_Continue(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]
robot.running.builder.transformers.deprecate_tags_starting_with_hyphen(node, source)[source]