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 executableTestSuite
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 andFalse
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 aLanguages
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 argumentFalse
value.
- Execute the created suite by using its
-
class
robot.running.builder.builders.
SuiteStructureParser
(included_extensions, rpa=None, lang=None, process_curdir=True)[source]¶ Bases:
robot.parsing.suitestructure.SuiteStructureVisitor
-
visit_directory
(structure)¶
-
robot.running.builder.parsers module¶
-
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_resource_file
(source)¶
-
parse_suite_file
(source, defaults=None)¶
-
robot.running.builder.settings module¶
robot.running.builder.transformers module¶
-
class
robot.running.builder.transformers.
SettingsBuilder
(suite, defaults)[source]¶ Bases:
ast.NodeVisitor
-
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
-
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
-
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
-
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
-
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
-
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
-
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
-
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
-
generic_visit
(node)¶ Called if no explicit visitor function exists for a node.
-
visit
(node)¶ Visit a node.
-