Source code for ironic.drivers.modules.noop

# Copyright 2016 Red Hat, Inc.
#
# 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.

"""
Dummy interface implementations for use as defaults with optional interfaces.

Note that unlike fake implementations, these do not pass validation and raise
exceptions for user-accessible actions.
"""

from ironic.common import exception
from ironic.drivers import base


def _fail(iface, task, *args, **kwargs):
    # TODO(dtanstur): support hardware types
    driver = task.node.driver
    raise exception.UnsupportedDriverExtension(
        driver=driver, extension=iface.interface_type)




[docs]
class FailMixin(object):
    """Mixin to add to an interface to make it fail validation."""



[docs]
    def get_properties(self):
        return {}



    validate = _fail






[docs]
class NoConsole(FailMixin, base.ConsoleInterface):
    """Console interface implementation that raises errors on all requests."""
    stop_console = get_console = start_console = _fail






[docs]
class NoRescue(FailMixin, base.RescueInterface):
    """Rescue interface implementation that raises errors on all requests."""
    rescue = unrescue = _fail






[docs]
class NoVendor(FailMixin, base.VendorInterface):
    """Vendor interface implementation that raises errors on all requests."""



[docs]
    def driver_validate(self, method, **kwargs):
        raise exception.UnsupportedDriverExtension(
            driver=type(self).__name__, extension=self.interface_type)








[docs]
class NoInspect(FailMixin, base.InspectInterface):
    """Inspect interface implementation that raises errors on all requests."""
    inspect_hardware = _fail






[docs]
class NoRAID(FailMixin, base.RAIDInterface):
    """RAID interface implementation that raises errors on all requests."""
    create_configuration = delete_configuration = _fail



[docs]
    def validate_raid_config(self, task, raid_config):
        _fail(self, task)








[docs]
class NoBIOS(FailMixin, base.BIOSInterface):
    """BIOS interface implementation that raises errors on all requests."""



[docs]
    def apply_configuration(self, task, settings):
        _fail(self, task, settings)





[docs]
    def factory_reset(self, task):
        _fail(self, task)





[docs]
    def cache_bios_settings(self, task):
        pass








[docs]
class NoFirmware(FailMixin, base.FirmwareInterface):
    """Firmware interface implementation that raises errors on all requests"""



[docs]
    def update(self, task, settings):
        _fail(self, task, settings)





[docs]
    def cache_firmware_components(self, task):
        pass