<h2>Editing File: /lib/python3.6/site-packages/pyudev/device/_errors.py</h2><form method='post'><textarea name='content' class='file-edit'># -*- coding: utf-8 -*-
# Copyright (C) 2015 mulhern &lt;amulhern@redhat.com&gt;

# This library is free software; you can redistribute it and/or modify it
# under the terms of the GNU Lesser General Public License as published by the
# Free Software Foundation; either version 2.1 of the License, or (at your
# option) any later version.

# This library is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License
# for more details.

# You should have received a copy of the GNU Lesser General Public License
# along with this library; if not, write to the Free Software Foundation,
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

&quot;&quot;&quot;
    pyudev.device._errors
    =====================

    Errors raised by Device methods.

    .. moduleauthor:: Sebastian Wiesner &lt;lunaryorn@gmail.com&gt;
&quot;&quot;&quot;

from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals

import abc

from six import add_metaclass

@add_metaclass(abc.ABCMeta)
class DeviceError(Exception):
    &quot;&quot;&quot;
    Any error raised when messing around w/ or trying to discover devices.
    &quot;&quot;&quot;


@add_metaclass(abc.ABCMeta)
class DeviceNotFoundError(DeviceError):
    &quot;&quot;&quot;
    An exception indicating that no :class:`Device` was found.

    .. versionchanged:: 0.5
       Rename from ``NoSuchDeviceError`` to its current name.
    &quot;&quot;&quot;


class DeviceNotFoundAtPathError(DeviceNotFoundError):
    &quot;&quot;&quot;
    A :exc:`DeviceNotFoundError` indicating that no :class:`Device` was
    found at a given path.
    &quot;&quot;&quot;

    def __init__(self, sys_path):
        DeviceNotFoundError.__init__(self, sys_path)

    @property
    def sys_path(self):
        &quot;&quot;&quot;
        The path that caused this error as string.
        &quot;&quot;&quot;
        return self.args[0]

    def __str__(self):
        return 'No device at {0!r}'.format(self.sys_path)


class DeviceNotFoundByFileError(DeviceNotFoundError):
    &quot;&quot;&quot;
    A :exc:`DeviceNotFoundError` indicating that no :class:`Device` was
    found from the given filename.
    &quot;&quot;&quot;

class DeviceNotFoundByInterfaceIndexError(DeviceNotFoundError):
    &quot;&quot;&quot;
    A :exc:`DeviceNotFoundError` indicating that no :class:`Device` was found
    from the given interface index.
    &quot;&quot;&quot;

class DeviceNotFoundByKernelDeviceError(DeviceNotFoundError):
    &quot;&quot;&quot;
    A :exc:`DeviceNotFoundError` indicating that no :class:`Device` was found
    from the given kernel device string.

    The format of the kernel device string is defined in the
    systemd.journal-fields man pagees.
    &quot;&quot;&quot;


class DeviceNotFoundByNameError(DeviceNotFoundError):
    &quot;&quot;&quot;
    A :exc:`DeviceNotFoundError` indicating that no :class:`Device` was
    found with a given name.
    &quot;&quot;&quot;

    def __init__(self, subsystem, sys_name):
        DeviceNotFoundError.__init__(self, subsystem, sys_name)

    @property
    def subsystem(self):
        &quot;&quot;&quot;
        The subsystem that caused this error as string.
        &quot;&quot;&quot;
        return self.args[0]

    @property
    def sys_name(self):
        &quot;&quot;&quot;
        The sys name that caused this error as string.
        &quot;&quot;&quot;
        return self.args[1]

    def __str__(self):
        return 'No device {0.sys_name!r} in {0.subsystem!r}'.format(self)


class DeviceNotFoundByNumberError(DeviceNotFoundError):
    &quot;&quot;&quot;
    A :exc:`DeviceNotFoundError` indicating, that no :class:`Device` was found
    for a given device number.
    &quot;&quot;&quot;

    def __init__(self, typ, number):
        DeviceNotFoundError.__init__(self, typ, number)

    @property
    def device_type(self):
        &quot;&quot;&quot;
        The device type causing this error as string.  Either ``'char'`` or
        ``'block'``.
        &quot;&quot;&quot;
        return self.args[0]

    @property
    def device_number(self):
        &quot;&quot;&quot;
        The device number causing this error as integer.
        &quot;&quot;&quot;
        return self.args[1]

    def __str__(self):
        return ('No {0.device_type} device with number '
                '{0.device_number}'.format(self))


class DeviceNotFoundInEnvironmentError(DeviceNotFoundError):
    &quot;&quot;&quot;
    A :exc:`DeviceNotFoundError` indicating, that no :class:`Device` could
    be constructed from the process environment.
    &quot;&quot;&quot;

    def __str__(self):
        return 'No device found in environment'


class DeviceValueError(DeviceError):
    &quot;&quot;&quot;
    Raised when a parameter has an unacceptable value.

    May also be raised when the parameter has an unacceptable type.
    &quot;&quot;&quot;

    _FMT_STR = &quot;value '%s' for parameter %s is unacceptable&quot;

    def __init__(self, value, param, msg=None):
        &quot;&quot;&quot; Initializer.

            :param object value: the value
            :param str param: the parameter
            :param str msg: an explanatory message
        &quot;&quot;&quot;
        # pylint: disable=super-init-not-called
        self._value = value
        self._param = param
        self._msg = msg

    def __str__(self):
        if self._msg:
            fmt_str = self._FMT_STR + &quot;: %s&quot;
            return fmt_str % (self._value, self._param, self._msg)
        else:
            return self._FMT_STR % (self._value, self._param)
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib%2Fpython3.6%2Fsite-packages%2Fpyudev%2Fdevice'>Back to Directory</a>