# 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 py3to2
from .normalizing import NormalizedDict
from .robottypes import is_string
[docs]@py3to2
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 __bool__(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(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]@py3to2
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 __bool__(self):
return False