102 lines
3.2 KiB
Python
102 lines
3.2 KiB
Python
# vim: ft=python fileencoding=utf-8 sts=4 sw=4 et:
|
|
|
|
# Copyright 2014-2016 Florian Bruhin (The Compiler) <mail@qutebrowser.org>
|
|
#
|
|
# This file is part of qutebrowser.
|
|
#
|
|
# qutebrowser is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# qutebrowser 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 General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with qutebrowser. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
"""A single value (with multiple layers possibly) in the config."""
|
|
|
|
import collections
|
|
|
|
|
|
class SettingValue:
|
|
|
|
"""Base class for setting values.
|
|
|
|
Intended to be sub-classed by config value "types".
|
|
|
|
Attributes:
|
|
typ: A BaseType subclass instance.
|
|
value: (readonly property) The currently valid, most important value.
|
|
values: An OrderedDict with the values on different layers, with the
|
|
most significant layer first.
|
|
"""
|
|
|
|
def __init__(self, typ, default=None, *, backends=None):
|
|
"""Constructor.
|
|
|
|
Args:
|
|
typ: The BaseType to use.
|
|
default: Raw value to set.
|
|
backend: A list of usertypes.Backend enum members to mark this
|
|
setting as unsupported with other backends.
|
|
"""
|
|
self.typ = typ
|
|
self.values = collections.OrderedDict.fromkeys(
|
|
['temp', 'conf', 'default'])
|
|
self.values['default'] = default
|
|
self.backends = backends
|
|
|
|
def __str__(self):
|
|
"""Get raw string value."""
|
|
return self.value()
|
|
|
|
def default(self):
|
|
"""Get the default value."""
|
|
return self.values['default']
|
|
|
|
def getlayers(self, startlayer):
|
|
"""Get a dict of values starting with startlayer.
|
|
|
|
Args:
|
|
startlayer: The first layer to include.
|
|
"""
|
|
idx = list(self.values.keys()).index(startlayer)
|
|
d = collections.OrderedDict(list(self.values.items())[idx:])
|
|
return d
|
|
|
|
def value(self, startlayer=None):
|
|
"""Get the first valid value starting from startlayer.
|
|
|
|
Args:
|
|
startlayer: The first layer to include.
|
|
"""
|
|
if startlayer is None:
|
|
d = self.values
|
|
else:
|
|
d = self.getlayers(startlayer)
|
|
for val in d.values():
|
|
if val is not None:
|
|
return val
|
|
raise ValueError("No valid config value found!")
|
|
|
|
def transformed(self):
|
|
"""Get the transformed value."""
|
|
return self.typ.transform(self.value())
|
|
|
|
def setv(self, layer, value, interpolated):
|
|
"""Set the value on a layer.
|
|
|
|
Args:
|
|
layer: The layer to set the value on, an element name of the
|
|
ValueLayers dict.
|
|
value: The value to set.
|
|
interpolated: The interpolated value, for typechecking (or None).
|
|
"""
|
|
if interpolated is not None:
|
|
self.typ.validate(interpolated)
|
|
self.values[layer] = value
|