Source code for robot.variables.store

#  Copyright 2008-2015 Nokia Networks
#  Copyright 2016-     Robot Framework Foundation
#
#  Licensed under the Apache License, Version 2.0 (the "License");
#  you may not use this file except in compliance with the License.
#  You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
#  Unless required by applicable law or agreed to in writing, software
#  distributed under the License is distributed on an "AS IS" BASIS,
#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#  See the License for the specific language governing permissions and
#  limitations under the License.

from robot.errors import DataError, VariableError
from robot.utils import (DotDict, is_dict_like, is_list_like, NormalizedDict,
                         type_name)

from .notfound import variable_not_found
from .search import is_assign
from .tablesetter import VariableTableValueBase


[docs]class VariableStore(object): def __init__(self, variables): self.data = NormalizedDict(ignore='_') self._variables = variables
[docs] def resolve_delayed(self, item=None): if item: return self._resolve_delayed(*item) for name, value in list(self.data.items()): try: self._resolve_delayed(name, value) except DataError: pass
def _resolve_delayed(self, name, value): if not self._is_resolvable(value): return value try: self.data[name] = value.resolve(self._variables) except DataError as err: # Recursive resolving may have already removed variable. if name in self: self.remove(name) value.report_error(err) variable_not_found('${%s}' % name, self.data, "Variable '${%s}' not found." % name) return self.data[name] def _is_resolvable(self, value): try: # isinstance can throw an exception in ironpython and jython return isinstance(value, VariableTableValueBase) except Exception: return False def __getitem__(self, name): return self._resolve_delayed(name, self.data[name])
[docs] def update(self, store): self.data.update(store.data)
[docs] def clear(self): self.data.clear()
[docs] def add(self, name, value, overwrite=True, decorated=True): if decorated: name, value = self._undecorate(name, value) if overwrite or name not in self.data: self.data[name] = value
def _undecorate(self, name, value): if not is_assign(name): raise DataError("Invalid variable name '%s'." % name) if name[0] == '@': if not is_list_like(value): self._raise_cannot_set_type(name, value, 'list') value = list(value) if name[0] == '&': if not is_dict_like(value): self._raise_cannot_set_type(name, value, 'dictionary') value = DotDict(value) return name[2:-1], value def _raise_cannot_set_type(self, name, value, expected): raise VariableError("Cannot set variable '%s': Expected %s-like value, " "got %s." % (name, expected, type_name(value)))
[docs] def remove(self, name): if name in self.data: self.data.pop(name)
def __len__(self): return len(self.data) def __iter__(self): return iter(self.data) def __contains__(self, name): return name in self.data
[docs] def as_dict(self, decoration=True): if decoration: variables = (self._decorate(name, self[name]) for name in self) else: variables = self.data return NormalizedDict(variables, ignore='_')
def _decorate(self, name, value): if is_dict_like(value): name = '&{%s}' % name elif is_list_like(value): name = '@{%s}' % name else: name = '${%s}' % name return name, value