Source code for labgrid.resource.common

import attr

from ..binding import BindingMixin
from ..util.ssh import sshmanager

[docs]@attr.s(eq=False) class Resource(BindingMixin): """ Represents a resource which is used by drivers. It only stores information and does not implement any actual functionality. Resources can exist without a target, but they must be bound to one before use. Life cycle: - create - bind (n times) """ avail = attr.ib(default=True, init=False, validator=attr.validators.instance_of(bool))
[docs] def __attrs_post_init__(self): super().__attrs_post_init__() self._parent = None
@property def command_prefix(self): return [] @property def parent(self): return self._parent @parent.setter def parent(self, value): assert self._parent is None self._parent = value
[docs] def get_managed_parent(self): """ For Resources which have been created at runtime, return the ManagedResource resource which created it. Returns None otherwise. """ return self._parent.get_managed_parent() if self._parent else None
[docs] def poll(self): managed_parent = self.get_managed_parent() if managed_parent: managed_parent.poll()
[docs]@attr.s(eq=False) class NetworkResource(Resource): """ Represents a remote Resource available on another computer. This stores a command_prefix to describe how to connect to the remote computer. Args: host (str): remote host the resource is available on """ host = attr.ib(validator=attr.validators.instance_of(str)) @property def command_prefix(self): host = if hasattr(self, 'extra'): if self.extra.get('proxy_required'): host = self.extra.get('proxy') conn = sshmanager.get(host) prefix = conn.get_prefix() return prefix + ['--']
[docs]@attr.s(eq=False) class ResourceManager: instances = {}
[docs] @classmethod def get(cls): instance = ResourceManager.instances.get(cls) if instance is None: instance = cls() ResourceManager.instances[cls] = instance return instance
[docs] def __attrs_post_init__(self): self.resources = []
def _add_resource(self, resource): self.resources.append(resource) self.on_resource_added(resource)
[docs] def on_resource_added(self, resource): pass
[docs] def poll(self): pass
[docs]@attr.s(eq=False) class ManagedResource(Resource): """ Represents a resource which can appear and disappear at runtime. Every ManagedResource has a corresponding ResourceManager which handles these events. """ manager_cls = ResourceManager timeout = attr.ib(default=2.0, init=False, validator=attr.validators.instance_of(float))
[docs] def __attrs_post_init__(self): super().__attrs_post_init__() self.avail = False self.manager = self.manager_cls.get() self.manager._add_resource(self)
[docs] def poll(self): self.manager.poll()
[docs] def get_managed_parent(self): return self