<h2>Editing File: /usr/lib/python3.6/site-packages/yubico/yubikey_config_util.py</h2><form method='post'><textarea name='content' class='file-edit'>&quot;&quot;&quot;
utility functions used in yubikey_config.
&quot;&quot;&quot;
# Copyright (c) 2010, 2012 Yubico AB
# See the file COPYING for licence statement.

__all__ = [
    # constants
    # functions
    # classes
    'YubiKeyConfigBits',
    'YubiKeyConfigFlag',
    'YubiKeyExtendedFlag',
    'YubiKeyTicketFlag',
]


class YubiKeyFlag(object):
    &quot;&quot;&quot;
    A flag value, and associated metadata.
    &quot;&quot;&quot;

    def __init__(self, key, value, doc=None, min_ykver=(0, 0), max_ykver=None, models=['YubiKey', 'YubiKey NEO', 'YubiKey 4']):
        &quot;&quot;&quot;
        Metadata about a ticket/config/extended flag bit.

        @param key: Name of flag, such as 'APPEND_CR'
        @param value: Bit value, 0x20 for APPEND_CR
        @param doc: Human readable description of flag
        @param min_ykver: Tuple with the minimum version required (major, minor,)
        @param min_ykver: Tuple with the maximum version required (major, minor,) (for depreacted flags)
        @param models: List of model identifiers (strings) that support this flag
        &quot;&quot;&quot;
        if type(key) is not str:
            assert()
        if type(value) is not int:
            assert()
        if type(min_ykver) is not tuple:
            assert()
        if type(models) is not list:
            assert()

        self.key = key
        self.value = value
        self.doc = doc
        self.min_ykver = min_ykver
        self.max_ykver = max_ykver
        self.models = models

        return None

    def __repr__(self):
        return '&lt;%s instance at %s: %s (0x%x)&gt;' % (
            self.__class__.__name__,
            hex(id(self)),
            self.key,
            self.value
            )

    def is_equal(self, key):
        &quot;&quot;&quot; Check if key is equal to that of this instance &quot;&quot;&quot;
        return self.key == key

    def to_integer(self):
        &quot;&quot;&quot; Return flag value &quot;&quot;&quot;
        return self.value

    def req_version(self):
        &quot;&quot;&quot; Return the minimum required version &quot;&quot;&quot;
        return self.min_ykver

    def req_string(self, model):
        &quot;&quot;&quot; Return string describing model and version requirement. &quot;&quot;&quot;
        if model not in self.models:
            model = self.models
        if self.min_ykver and self.max_ykver:
            return &quot;%s %d.%d..%d.%d&quot; % (model, \
                                           self.min_ykver[0], self.min_ykver[1], \
                                           self.max_ykver[0], self.max_ykver[1], \
                                           )
        if self.max_ykver:
            return &quot;%s &lt;= %d.%d&quot; % (model, self.max_ykver[0], self.max_ykver[1])

        return &quot;%s &gt;= %d.%d&quot; % (model, self.min_ykver[0], self.min_ykver[1])

    def is_compatible(self, model, version):
        &quot;&quot;&quot; Check if this flag is compatible with a YubiKey of version 'ver'. &quot;&quot;&quot;
        if not model in self.models:
            return False
        if self.max_ykver:
            return (version &gt;= self.min_ykver and
                    version &lt;= self.max_ykver)
        else:
            return version &gt;= self.min_ykver


class YubiKeyTicketFlag(YubiKeyFlag):
    &quot;&quot;&quot;
    A ticket flag value, and associated metadata.
    &quot;&quot;&quot;


class YubiKeyConfigFlag(YubiKeyFlag):
    &quot;&quot;&quot;
    A config flag value, and associated metadata.
    &quot;&quot;&quot;

    def __init__(self, key, value, mode='', doc=None, min_ykver=(0, 0), max_ykver=None):
        if type(mode) is not str:
            assert()
        self.mode = mode

        super(YubiKeyConfigFlag, self).__init__(key, value, doc=doc, min_ykver=min_ykver, max_ykver=max_ykver)


class YubiKeyExtendedFlag(YubiKeyFlag):
    &quot;&quot;&quot;
    An extended flag value, and associated metadata.
    &quot;&quot;&quot;

    def __init__(self, key, value, mode='', doc=None, min_ykver=(2, 2), max_ykver=None):
        if type(mode) is not str:
            assert()
        self.mode = mode

        super(YubiKeyExtendedFlag, self).__init__(key, value, doc=doc, min_ykver=min_ykver, max_ykver=max_ykver)


class YubiKeyConfigBits(object):
    &quot;&quot;&quot;
    Class to hold bit values for configuration.
    &quot;&quot;&quot;
    def __init__(self, default=0x0):
        self.value = default
        return None

    def __repr__(self):
        return '&lt;%s instance at %s: value 0x%x&gt;' % (
            self.__class__.__name__,
            hex(id(self)),
            self.value,
            )

    def get_set(self, flag, new):
        &quot;&quot;&quot;
        Return the boolean value of 'flag'. If 'new' is set,
        the flag is updated, and the value before update is
        returned.
        &quot;&quot;&quot;
        old = self._is_set(flag)
        if new is True:
            self._set(flag)
        elif new is False:
            self._clear(flag)
        return old

    def to_integer(self):
        &quot;&quot;&quot; Return the sum of all flags as an integer. &quot;&quot;&quot;
        return self.value

    def _is_set(self, flag):
        &quot;&quot;&quot; Check if flag is set. Returns True or False. &quot;&quot;&quot;
        return self.value &amp; flag == flag

    def _set(self, flag):
        &quot;&quot;&quot; Set flag. &quot;&quot;&quot;
        self.value |= flag

    def _clear(self, flag):
        &quot;&quot;&quot; Clear flag. &quot;&quot;&quot;
        self.value &amp;= (0xff - flag)
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flib%2Fpython3.6%2Fsite-packages%2Fyubico'>Back to Directory</a>