1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324
|
# -*- coding: utf-8 -*-
# Pitivi video editor
# Copyright (c) 2005, Edward Hervey <bilboed@bilboed.com>
#
# This program 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 program 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 program; if not, write to the
# Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
# Boston, MA 02110-1301, USA.
import configparser
import os
from gi.repository import GLib
from gi.repository import GObject
from pitivi.utils.loggable import Loggable
from pitivi.utils.misc import unicode_error_dialog
def get_bool_env(var):
value = os.getenv(var)
if not value:
return False
value = value.lower()
if value == 'False':
return False
if value == '0':
return False
else:
return bool(value)
def get_env_by_type(type_, var):
"""Gets an environment variable.
Args:
type_ (type): The type of the variable.
var (str): The name of the environment variable.
Returns:
The contents of the environment variable, or None if it doesn't exist.
"""
if var is None:
return None
if type_ == bool:
return get_bool_env(var)
value = os.getenv(var)
if value:
return type_(os.getenv(var))
return None
def get_dir(path, autocreate=True):
if autocreate and not os.path.exists(path):
os.makedirs(path)
return path
def xdg_config_home(autocreate=True):
"""Gets the directory for storing the user's Pitivi configuration."""
default = os.path.join(GLib.get_user_config_dir(), "pitivi")
path = os.getenv("PITIVI_USER_CONFIG_DIR", default)
return get_dir(path, autocreate)
def xdg_data_home(autocreate=True):
"""Gets the directory for storing the user's data: presets, plugins, etc."""
default = os.path.join(GLib.get_user_data_dir(), "pitivi")
path = os.getenv("PITIVI_USER_DATA_DIR", default)
return get_dir(path, autocreate)
def xdg_cache_home(autocreate=True):
"""Gets the Pitivi cache directory."""
default = os.path.join(GLib.get_user_cache_dir(), "pitivi")
path = os.getenv("PITIVI_USER_CACHE_DIR", default)
return get_dir(path, autocreate)
class ConfigError(Exception):
pass
class Notification(object):
"""A descriptor which emits a signal when set."""
def __init__(self, attrname):
self.attrname = "_" + attrname
self.signame = self.signalName(attrname)
@staticmethod
def signalName(attrname):
return attrname + "Changed"
def __get__(self, instance, unused):
return getattr(instance, self.attrname)
def __set__(self, instance, value):
setattr(instance, self.attrname, value)
instance.emit(self.signame)
class GlobalSettings(GObject.Object, Loggable):
"""Pitivi app settings.
Loads settings from different sources, currently:
- the local configuration file,
- environment variables.
Modules declare which settings they wish to access by calling the
addConfigOption() class method during initialization.
Attributes:
options (dict): The available settings.
environment (set): The controlled environment variables.
"""
options = {}
environment = set()
defaults = {}
def __init__(self):
GObject.Object.__init__(self)
Loggable.__init__(self)
self.conf_file_path = os.path.join(xdg_config_home(), "pitivi.conf")
self._config = configparser.ConfigParser()
self._readSettingsFromConfigurationFile()
self._readSettingsFromEnvironmentVariables()
def _readSettingsFromConfigurationFile(self):
"""Reads the settings from the user configuration file."""
try:
self._config.read(self.conf_file_path)
except UnicodeDecodeError as e:
self.error("Failed to read %s: %s", self.conf_file_path, e)
unicode_error_dialog()
return
except configparser.ParsingError as e:
self.error("Failed to parse %s: %s", self.conf_file_path, e)
return
for (section, attrname, typ, key, env, value) in self.iterAllOptions():
if not self._config.has_section(section):
continue
if key and self._config.has_option(section, key):
if typ == int or typ == int:
try:
value = self._config.getint(section, key)
except ValueError:
# In previous configurations we incorrectly stored
# ints using float values.
value = int(self._config.getfloat(section, key))
elif typ == float:
value = self._config.getfloat(section, key)
elif typ == bool:
value = self._config.getboolean(section, key)
else:
value = self._config.get(section, key)
setattr(self, attrname, value)
@classmethod
def readSettingSectionFromFile(self, cls, section):
"""Reads a particular section of the settings file.
Use this if you dynamically determine settings sections/keys at runtime.
Otherwise, the settings file would be read only once, at the
initialization phase of your module, and your config sections would
never be read, thus values would be reset to defaults on every startup
because GlobalSettings would think they don't exist.
"""
if cls._config.has_section(section):
for option in cls._config.options(section):
# We don't know the value type in advance, just try them all.
try:
value = cls._config.getfloat(section, option)
except:
try:
value = cls._config.getint(section, option)
except:
try:
value = cls._config.getboolean(section, option)
except:
value = cls._config.get(section, option)
setattr(cls, section + option, value)
def _readSettingsFromEnvironmentVariables(self):
"""Reads settings from their registered environment variables."""
for section, attrname, typ, key, env, value in self.iterAllOptions():
if not env:
# This option does not have an environment variable name.
continue
var = get_env_by_type(typ, env)
if var is not None:
setattr(self, attrname, var)
def _writeSettingsToConfigurationFile(self):
for (section, attrname, typ, key, env_var, value) in self.iterAllOptions():
if not self._config.has_section(section):
self._config.add_section(section)
if key:
if value is not None:
self._config.set(section, key, str(value))
else:
self._config.remove_option(section, key)
try:
with open(self.conf_file_path, 'w') as file:
self._config.write(file)
except (IOError, OSError) as e:
self.error("Failed to write to %s: %s", self.conf_file_path, e)
def storeSettings(self):
"""Writes settings to the user's local configuration file.
Only those settings which were added with a section and a key value are
stored.
"""
self._writeSettingsToConfigurationFile()
def iterAllOptions(self):
"""Iterates over all registered options."""
for section, options in list(self.options.items()):
for attrname, (typ, key, environment) in list(options.items()):
yield section, attrname, typ, key, environment, getattr(self, attrname)
def isDefault(self, attrname):
return getattr(self, attrname) == self.defaults[attrname]
def setDefault(self, attrname):
"""Resets the specified setting to its default value."""
setattr(self, attrname, self.defaults[attrname])
@classmethod
def addConfigOption(cls, attrname, type_=None, section=None, key=None,
environment=None, default=None, notify=False,):
"""Adds a configuration option.
This function should be called during module initialization, before
the config file is actually read. By default, only options registered
beforehand will be loaded.
If you want to add configuration options after initialization,
use the `readSettingSectionFromFile` method to force reading later on.
Args:
attrname (str): The attribute of this class for accessing the option.
type_ (Optional[type]): The type of the attribute. Unnecessary if a
`default` value is specified.
section (Optional[str]): The section of the config file under which
this option is saved. This section must have been added with
addConfigSection(). Not necessary if `key` is not given.
key (Optional[str]): The key under which this option is to be saved.
By default the option will not be saved.
notify (Optional[bool]): Whether this attribute should emit
signals when modified. By default signals are not emitted.
"""
if section and section not in cls.options:
raise ConfigError("You must add the section `%s` first" % section)
if key and not section:
raise ConfigError("You must specify a section for key `%s`" % key)
if section and key in cls.options[section]:
raise ConfigError("Key `%s` is already in use" % key)
if hasattr(cls, attrname):
raise ConfigError("Attribute `%s` is already in use" % attrname)
if environment and environment in cls.environment:
raise ConfigError("Env var `%s` is already in use" % environment)
if not type_ and default is None:
raise ConfigError("Attribute `%s` must have a type or a default" %
attrname)
if not type_:
type_ = type(default)
if notify:
notification = Notification(attrname)
setattr(cls, attrname, notification)
setattr(cls, "_" + attrname, default)
GObject.signal_new(notification.signame,
cls,
GObject.SIGNAL_RUN_LAST,
None,
())
else:
setattr(cls, attrname, default)
if section and key:
cls.options[section][attrname] = type_, key, environment
cls.environment.add(environment)
cls.defaults[attrname] = default
@classmethod
def addConfigSection(cls, section):
"""Adds a section to the local config file.
Args:
section (str): The section name.
Raises:
ConfigError: If the section already exists.
"""
if section in cls.options:
raise ConfigError("Duplicate Section \"%s\"." % section)
cls.options[section] = {}
@classmethod
def notifiesConfigOption(cls, attrname):
"""Checks whether a signal is emitted when the setting is changed.
Args:
attrname (str): The attribute name used to access the setting.
Returns:
bool: True when the setting emits a signal when changed,
False otherwise.
"""
signal_name = Notification.signalName(attrname)
return bool(GObject.signal_lookup(signal_name, cls))
|