Source code for robot.utils.connectioncache

#  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.

import warnings

from .compat import py2to3
from .normalizing import NormalizedDict
from .robottypes import is_string


[docs]@py2to3 class ConnectionCache(object): """Cache for test libs to use with concurrent connections, processes, etc. The cache stores the registered connections (or other objects) and allows switching between them using generated indices or user given aliases. This is useful with any test library where there's need for multiple concurrent connections, processes, etc. This class can, and is, used also outside the core framework by SSHLibrary, Selenium(2)Library, etc. Backwards compatibility is thus important when doing changes. """ def __init__(self, no_current_msg='No open connection.'): self._no_current = NoConnection(no_current_msg) self.current = self._no_current #: Current active connection. self._connections = [] self._aliases = NormalizedDict() @property def current_index(self): if not self: return None for index, conn in enumerate(self): if conn is self.current: return index + 1 @current_index.setter def current_index(self, index): self.current = self._connections[index - 1] \ if index is not None else self._no_current
[docs] def register(self, connection, alias=None): """Registers given connection with optional alias and returns its index. Given connection is set to be the :attr:`current` connection. If alias is given, it must be a string. Aliases are case and space insensitive. The index of the first connection after initialization, and after :meth:`close_all` or :meth:`empty_cache`, is 1, second is 2, etc. """ self.current = connection self._connections.append(connection) index = len(self._connections) if is_string(alias): self._aliases[alias] = index return index
[docs] def switch(self, alias_or_index): """Switches to the connection specified by the given alias or index. Updates :attr:`current` and also returns its new value. Alias is whatever was given to :meth:`register` method and indices are returned by it. Index can be given either as an integer or as a string that can be converted to an integer. Raises an error if no connection with the given index or alias found. """ self.current = self.get_connection(alias_or_index) return self.current
[docs] def get_connection(self, alias_or_index=None): """Get the connection specified by the given alias or index.. If ``alias_or_index`` is ``None``, returns the current connection if it is active, or raises an error if it is not. Alias is whatever was given to :meth:`register` method and indices are returned by it. Index can be given either as an integer or as a string that can be converted to an integer. Raises an error if no connection with the given index or alias found. """ if alias_or_index is None: if not self: self.current.raise_error() return self.current try: index = self.resolve_alias_or_index(alias_or_index) except ValueError as err: raise RuntimeError(err.args[0]) return self._connections[index-1]
__getitem__ = get_connection
[docs] def close_all(self, closer_method='close'): """Closes connections using given closer method and empties cache. If simply calling the closer method is not adequate for closing connections, clients should close connections themselves and use :meth:`empty_cache` afterwards. """ for conn in self._connections: getattr(conn, closer_method)() self.empty_cache() return self.current
[docs] def empty_cache(self): """Empties the connection cache. Indexes of the new connections starts from 1 after this. """ self.current = self._no_current self._connections = [] self._aliases = NormalizedDict()
def __iter__(self): return iter(self._connections) def __len__(self): return len(self._connections) def __nonzero__(self): return self.current is not self._no_current
[docs] def resolve_alias_or_index(self, alias_or_index): for resolver in self._resolve_alias, self._resolve_index: try: return resolver(alias_or_index) except ValueError: pass raise ValueError("Non-existing index or alias '%s'." % alias_or_index)
def _resolve_alias_or_index(self, alias_or_index): # TODO: Remove this function for good in RF 3.3. # See https://github.com/robotframework/robotframework/issues/3125 warnings.warn("'ConnectionCache._resolve_alias_or_index' is " "deprecated. Use 'resolve_alias_or_index' instead.", UserWarning) return self.resolve_alias_or_index(alias_or_index) def _resolve_alias(self, alias): if is_string(alias) and alias in self._aliases: return self._aliases[alias] raise ValueError def _resolve_index(self, index): try: index = int(index) except TypeError: raise ValueError if not 0 < index <= len(self._connections): raise ValueError return index
[docs]@py2to3 class NoConnection(object): def __init__(self, message): self.message = message def __getattr__(self, name): if name.startswith('__') and name.endswith('__'): raise AttributeError self.raise_error()
[docs] def raise_error(self): raise RuntimeError(self.message)
def __nonzero__(self): return False