# -*- coding:utf-8 -*- ## src/common/configpaths.py ## ## Copyright (C) 2006 Jean-Marie Traissard ## Junglecow J ## Copyright (C) 2006-2013 Yann Leboulanger ## Copyright (C) 2007 Brendan Taylor ## Copyright (C) 2008 Jonathan Schleifer ## ## This file is part of Gajim. ## ## Gajim 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; version 3 only. ## ## Gajim 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 Gajim. If not, see . ## import os import sys import tempfile from common import defs HAVE_XDG = True try: __import__(xdg) except: HAVE_XDG = False ( TYPE_CONFIG, TYPE_CACHE, TYPE_DATA ) = range(3) # Note on path and filename encodings: # # In general it is very difficult to do this correctly. # We may pull information from environment variables, and what encoding that is # in is anyone's guess. Any information we request directly from the file # system will be in filesystemencoding, and (parts of) paths that we write in # this source code will be in whatever encoding the source is in. (I hereby # declare this file to be UTF-8 encoded.) # # To make things more complicated, modern Windows filesystems use UTF-16, but # the API tends to hide this from us. # # I tried to minimize problems by passing Unicode strings to OS functions as # much as possible. Hopefully this makes the function return an Unicode string # as well. If not, we get an 8-bit string in filesystemencoding, which we can # happily pass to functions that operate on files and directories, so we can # just leave it as is. Since these paths are meant to be internal to Gajim and # not displayed to the user, Unicode is not really necessary here. def fse(s): """ Convert from filesystem encoding if not already Unicode """ return s def windowsify(s): if os.name == 'nt': return s.capitalize() return s class ConfigPaths: def __init__(self): # {'name': (type, path), } type can be TYPE_CONFIG, TYPE_CACHE, TYPE_DATA # or None self.paths = {} if os.name == 'nt': try: # Documents and Settings\[User Name]\Application Data\Gajim # How are we supposed to know what encoding the environment # variable 'appdata' is in? Assuming it to be in filesystem # encoding. self.config_root = self.cache_root = self.data_root = \ os.path.join(fse(os.environ['appdata']), 'Gajim') except KeyError: # win9x, in cwd self.config_root = self.cache_root = self.data_root = '.' else: # Unices # Pass in an Unicode string, and hopefully get one back. if HAVE_XDG: self.config_root = xdg.BaseDirectory.load_first_config('gajim') if not self.config_root: # Folder doesn't exist yet. self.config_root = os.path.join(xdg.BaseDirectory.\ xdg_config_dirs[0], 'gajim') self.cache_root = os.path.join(xdg.BaseDirectory.xdg_cache_home, 'gajim') self.data_root = xdg.BaseDirectory.save_data_path('gajim') if not self.data_root: self.data_root = os.path.join(xdg.BaseDirectory.\ xdg_data_dirs[0], 'gajim') else: expand = os.path.expanduser base = os.getenv('XDG_CONFIG_HOME') or expand('~/.config') self.config_root = os.path.join(base, 'gajim') base = os.getenv('XDG_CACHE_HOME') or expand('~/.cache') self.cache_root = os.path.join(base, 'gajim') base = os.getenv('XDG_DATA_HOME') or expand('~/.local/share') self.data_root = os.path.join(base, 'gajim') def add(self, name, type_, path): self.paths[name] = (type_, path) def __getitem__(self, key): type_, path = self.paths[key] if type_ == TYPE_CONFIG: return os.path.join(self.config_root, path) elif type_ == TYPE_CACHE: return os.path.join(self.cache_root, path) elif type_ == TYPE_DATA: return os.path.join(self.data_root, path) return path def get(self, key, default=None): try: return self[key] except KeyError: return default def items(self): for key in self.paths.keys(): yield (key, self[key]) def init(self, root=None): if root is not None: self.config_root = self.cache_root = self.data_root = root d = {'MY_DATA': '', 'LOG_DB': 'logs.db', 'MY_CACERTS': 'cacerts.pem', 'MY_EMOTS': 'emoticons', 'MY_ICONSETS': 'iconsets', 'MY_MOOD_ICONSETS': 'moods', 'MY_ACTIVITY_ICONSETS': 'activities', 'PLUGINS_USER': 'plugins', 'MY_PEER_CERTS': 'certs', 'RNG_SEED': u'rng_seed'} for name in d: self.add(name, TYPE_DATA, windowsify(d[name])) d = {'MY_CACHE': '', 'CACHE_DB': 'cache.db', 'VCARD': 'vcards', 'AVATAR': 'avatars'} for name in d: self.add(name, TYPE_CACHE, windowsify(d[name])) self.add('MY_CONFIG', TYPE_CONFIG, '') self.add('MY_CERT', TYPE_CONFIG, '') basedir = fse(os.environ.get('GAJIM_BASEDIR', defs.basedir)) self.add('DATA', None, os.path.join(basedir, windowsify('data'))) self.add('ICONS', None, os.path.join(basedir, windowsify('icons'))) self.add('HOME', None, fse(os.path.expanduser('~'))) self.add('PLUGINS_BASE', None, os.path.join(basedir, windowsify('plugins'))) try: self.add('TMP', None, fse(tempfile.gettempdir())) except IOError as e: print('Error opening tmp folder: %s\nUsing %s' % (str(e), os.path.expanduser('~')), file=sys.stderr) self.add('TMP', None, fse(os.path.expanduser('~'))) try: import svn_config svn_config.configure(self) except (ImportError, AttributeError): pass def init_profile(self, profile=''): conffile = windowsify('config') pidfile = windowsify('gajim') secretsfile = windowsify('secrets') pluginsconfdir = windowsify('pluginsconfig') if len(profile) > 0: conffile += '.' + profile pidfile += '.' + profile secretsfile += '.' + profile pluginsconfdir += '.' + profile pidfile += '.pid' self.add('CONFIG_FILE', TYPE_CONFIG, conffile) self.add('PID_FILE', TYPE_CACHE, pidfile) self.add('SECRETS_FILE', TYPE_DATA, secretsfile) self.add('PLUGINS_CONFIG_DIR', TYPE_CONFIG, pluginsconfdir) gajimpaths = ConfigPaths()