robot.parsing.model package

Submodules

robot.parsing.model.blocks module

class robot.parsing.model.blocks.Block

Bases: _ast.AST

errors = ()

lineno

col_offset

end_lineno

end_col_offset

validate_model()

validate()

class robot.parsing.model.blocks.File(sections=None, source=None)

Bases: robot.parsing.model.blocks.Block

save(output=None)

Save model to the given output or to the original source file.

The output can be a path to a file or an already opened file object. If output is not given, the original source file will be overwritten.

col_offset

end_col_offset

end_lineno

errors = ()

lineno

validate()

validate_model()

class robot.parsing.model.blocks.Section(header=None, body=None)

Bases: robot.parsing.model.blocks.Block

col_offset

end_col_offset

end_lineno

errors = ()

lineno

validate()

validate_model()

class robot.parsing.model.blocks.SettingSection(header=None, body=None)

Bases: robot.parsing.model.blocks.Section

col_offset

end_col_offset

end_lineno

errors = ()

lineno

validate()

validate_model()

class robot.parsing.model.blocks.VariableSection(header=None, body=None)

Bases: robot.parsing.model.blocks.Section

col_offset

end_col_offset

end_lineno

errors = ()

lineno

validate()

validate_model()

class robot.parsing.model.blocks.TestCaseSection(header=None, body=None)

Bases: robot.parsing.model.blocks.Section

tasks

col_offset

end_col_offset

end_lineno

errors = ()

lineno

validate()

validate_model()

class robot.parsing.model.blocks.KeywordSection(header=None, body=None)

Bases: robot.parsing.model.blocks.Section

col_offset

end_col_offset

end_lineno

errors = ()

lineno

validate()

validate_model()

class robot.parsing.model.blocks.CommentSection(header=None, body=None)

Bases: robot.parsing.model.blocks.Section

col_offset

end_col_offset

end_lineno

errors = ()

lineno

validate()

validate_model()

class robot.parsing.model.blocks.TestCase(header, body=None)

Bases: robot.parsing.model.blocks.Block

name

col_offset

end_col_offset

end_lineno

errors = ()

lineno

validate()

validate_model()

class robot.parsing.model.blocks.Keyword(header, body=None)

Bases: robot.parsing.model.blocks.Block

name

col_offset

end_col_offset

end_lineno

errors = ()

lineno

validate()

validate_model()

class robot.parsing.model.blocks.If(header, body=None, orelse=None, end=None, errors=())

Bases: robot.parsing.model.blocks.Block

Represents IF structures in the model.

Used with IF, ELSE_IF and ELSE nodes. The type attribute specifies the type.

errors = ()

type

condition

validate()

col_offset

end_col_offset

end_lineno

lineno

validate_model()

class robot.parsing.model.blocks.For(header, body=None, end=None, errors=())

Bases: robot.parsing.model.blocks.Block

errors = ()

variables

values

flavor

validate()

col_offset

end_col_offset

end_lineno

lineno

validate_model()

class robot.parsing.model.blocks.ModelWriter(output)

Bases: robot.parsing.model.visitor.ModelVisitor

write(model)

visit_Statement(statement)

generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

class robot.parsing.model.blocks.ModelValidator

Bases: robot.parsing.model.visitor.ModelVisitor

visit_Block(node)

visit_Statement(node)

generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

class robot.parsing.model.blocks.FirstStatementFinder

Bases: robot.parsing.model.visitor.ModelVisitor

classmethod find_from(model)

visit_Statement(statement)

generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

class robot.parsing.model.blocks.LastStatementFinder

Bases: robot.parsing.model.visitor.ModelVisitor

classmethod find_from(model)

generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

visit_Statement(statement)

robot.parsing.model.statements module

class robot.parsing.model.statements.Statement(tokens, errors=())

Bases: _ast.AST

type = None

handles_types = ()

lineno

col_offset

end_lineno

end_col_offset

classmethod register(subcls)

classmethod from_tokens(tokens)

classmethod from_params(*args, **kwargs)

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

data_tokens

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

lines

validate()

class robot.parsing.model.statements.DocumentationOrMetadata(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_params(*args, **kwargs)

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

type = None

validate()

class robot.parsing.model.statements.SingleValue(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

value

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_params(*args, **kwargs)

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

type = None

validate()

class robot.parsing.model.statements.MultiValue(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

values

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_params(*args, **kwargs)

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

type = None

validate()

class robot.parsing.model.statements.Fixture(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

name

args

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_params(*args, **kwargs)

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

type = None

validate()

class robot.parsing.model.statements.SectionHeader(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

handles_types = ('SETTING HEADER', 'VARIABLE HEADER', 'TESTCASE HEADER', 'KEYWORD HEADER', 'COMMENT HEADER')

classmethod from_params(type, name=None, eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

type

name

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.LibraryImport(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'LIBRARY'

classmethod from_params(name, args=(), alias=None, separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

name

args

alias

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.ResourceImport(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'RESOURCE'

classmethod from_params(name, separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

name

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.VariablesImport(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'VARIABLES'

classmethod from_params(name, args=(), separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

name

args

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.Documentation(tokens, errors=())

Bases: robot.parsing.model.statements.DocumentationOrMetadata

type = 'DOCUMENTATION'

classmethod from_params(value, indent=' ', separator=' ', eol='\n', settings_section=True)

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

value

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.Metadata(tokens, errors=())

Bases: robot.parsing.model.statements.DocumentationOrMetadata

type = 'METADATA'

classmethod from_params(name, value, separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

name

value

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.ForceTags(tokens, errors=())

Bases: robot.parsing.model.statements.MultiValue

type = 'FORCE TAGS'

classmethod from_params(values, separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

values

class robot.parsing.model.statements.DefaultTags(tokens, errors=())

Bases: robot.parsing.model.statements.MultiValue

type = 'DEFAULT TAGS'

classmethod from_params(values, separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

values

class robot.parsing.model.statements.SuiteSetup(tokens, errors=())

Bases: robot.parsing.model.statements.Fixture

type = 'SUITE SETUP'

classmethod from_params(name, args=(), separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

args

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

name

classmethod register(subcls)

validate()

class robot.parsing.model.statements.SuiteTeardown(tokens, errors=())

Bases: robot.parsing.model.statements.Fixture

type = 'SUITE TEARDOWN'

classmethod from_params(name, args=(), separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

args

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

name

classmethod register(subcls)

validate()

class robot.parsing.model.statements.TestSetup(tokens, errors=())

Bases: robot.parsing.model.statements.Fixture

type = 'TEST SETUP'

classmethod from_params(name, args=(), separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

args

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

name

classmethod register(subcls)

validate()

class robot.parsing.model.statements.TestTeardown(tokens, errors=())

Bases: robot.parsing.model.statements.Fixture

type = 'TEST TEARDOWN'

classmethod from_params(name, args=(), separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

args

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

name

classmethod register(subcls)

validate()

class robot.parsing.model.statements.TestTemplate(tokens, errors=())

Bases: robot.parsing.model.statements.SingleValue

type = 'TEST TEMPLATE'

classmethod from_params(value, separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

value

class robot.parsing.model.statements.TestTimeout(tokens, errors=())

Bases: robot.parsing.model.statements.SingleValue

type = 'TEST TIMEOUT'

classmethod from_params(value, separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

value

class robot.parsing.model.statements.Variable(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'VARIABLE'

classmethod from_params(name, value, separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

name

value

validate()

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

class robot.parsing.model.statements.TestCaseName(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'TESTCASE NAME'

classmethod from_params(name, eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

name

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.KeywordName(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'KEYWORD NAME'

classmethod from_params(name, eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

name

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.Setup(tokens, errors=())

Bases: robot.parsing.model.statements.Fixture

type = 'SETUP'

classmethod from_params(name, args=(), indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

args

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

name

classmethod register(subcls)

validate()

class robot.parsing.model.statements.Teardown(tokens, errors=())

Bases: robot.parsing.model.statements.Fixture

type = 'TEARDOWN'

classmethod from_params(name, args=(), indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

args

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

name

classmethod register(subcls)

validate()

class robot.parsing.model.statements.Tags(tokens, errors=())

Bases: robot.parsing.model.statements.MultiValue

type = 'TAGS'

classmethod from_params(values, indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

values

class robot.parsing.model.statements.Template(tokens, errors=())

Bases: robot.parsing.model.statements.SingleValue

type = 'TEMPLATE'

classmethod from_params(value, indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

value

class robot.parsing.model.statements.Timeout(tokens, errors=())

Bases: robot.parsing.model.statements.SingleValue

type = 'TIMEOUT'

classmethod from_params(value, indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

value

class robot.parsing.model.statements.Arguments(tokens, errors=())

Bases: robot.parsing.model.statements.MultiValue

type = 'ARGUMENTS'

classmethod from_params(args, indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

validate()

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

values

class robot.parsing.model.statements.Return(tokens, errors=())

Bases: robot.parsing.model.statements.MultiValue

type = 'RETURN'

classmethod from_params(args, indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

values

class robot.parsing.model.statements.KeywordCall(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'KEYWORD'

handles_types = ('KEYWORD', 'ASSIGN')

classmethod from_params(name, assign=(), args=(), indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

keyword

args

assign

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.TemplateArguments(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'ARGUMENT'

classmethod from_params(args, indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

args

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.ForHeader(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'FOR'

classmethod from_params(variables, values, flavor='IN', indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

variables

values

flavor

validate()

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

class robot.parsing.model.statements.IfHeader(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'IF'

classmethod from_params(condition, indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

condition

validate()

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

class robot.parsing.model.statements.ElseIfHeader(tokens, errors=())

Bases: robot.parsing.model.statements.IfHeader

type = 'ELSE IF'

classmethod from_params(condition, indent=' ', separator=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

col_offset

condition

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.ElseHeader(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'ELSE'

classmethod from_params(indent=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

condition

validate()

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

class robot.parsing.model.statements.End(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'END'

classmethod from_params(indent=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

validate()

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

class robot.parsing.model.statements.Comment(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'COMMENT'

classmethod from_params(comment, indent=' ', eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.Error(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'ERROR'

handles_types = ('ERROR', 'FATAL ERROR')

errors

Errors got from the underlying ERROR and FATAL_ERROR tokens.

Errors can be set also explicitly. When accessing errors, they are returned along with errors got from tokens.

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_params(*args, **kwargs)

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

lineno

lines

classmethod register(subcls)

validate()

class robot.parsing.model.statements.EmptyLine(tokens, errors=())

Bases: robot.parsing.model.statements.Statement

type = 'EOL'

col_offset

data_tokens

end_col_offset

end_lineno

classmethod from_params(eol='\n')

Create statement from passed parameters.

Required and optional arguments should match class properties. Values are used to create matching tokens.

There is one notable difference for Documentation statement where settings_header flag is used to determine if statement belongs to settings header or test/keyword.

Most implementations support following general properties: - separator whitespace inserted between each token. Default is four spaces. - indent whitespace inserted before first token. Default is four spaces. - eol end of line sign. Default is '\n'.

classmethod from_tokens(tokens)

get_token(*types)

Return a token with the given type.

If there are no matches, return None. If there are multiple matches, return the first match.

get_tokens(*types)

Return tokens having any of the given types.

get_value(type, default=None)

Return value of a token with the given type.

If there are no matches, return default. If there are multiple matches, return the value of the first match.

get_values(*types)

Return values of tokens having any of the given types.

handles_types = ()

lineno

lines

classmethod register(subcls)

validate()

robot.parsing.model.visitor module

class robot.parsing.model.visitor.VisitorFinder

Bases: object

class robot.parsing.model.visitor.ModelVisitor

Bases: ast.NodeVisitor, robot.parsing.model.visitor.VisitorFinder

NodeVisitor that supports matching nodes based on their base classes.

Otherwise identical to the standard ast.NodeVisitor, but allows creating visit_ClassName methods so that the ClassName is one of the base classes of the node. For example, this visitor method matches all statements:

def visit_Statement(self, node):
    # ...

visit(node)

Visit a node.

generic_visit(node)

Called if no explicit visitor function exists for a node.

class robot.parsing.model.visitor.ModelTransformer

Bases: ast.NodeTransformer, robot.parsing.model.visitor.VisitorFinder

NodeTransformer that supports matching nodes based on their base classes.

See ModelVisitor for explanation how this is different compared to the standard ast.NodeTransformer.

visit(node)

Visit a node.

generic_visit(node)

Called if no explicit visitor function exists for a node.