Le module cfg permet d'interagir avec la configuration générale du système, et avec celle de l'application en cours en particulier (même s'il s'agit ici uniquement de la configuration de base, un module dédié sera ajouté prochainement pour la lecture des fichiers concernés).
La fonction open permet d'ouvrir automatiquement un fichier dont le chemin d'accès est passé en paramètre avec le programme par défaut.
La fonction edit devrait faire pariel, mais en choisissant plutôt l'éditeur par défaut. Sauf que comme je ne sais pas encore faire ça, elle déclenche pour l'instant une NotImplementedError. Donc, TODO.
La classe cache est un dictionnaire spécialisé utilisé par les deux objets ci-dessous. Il fonctionne en temps normal comme un dictionnaire ordinaire, mais est également un callable : appelé comme une fonction avec un chemin d'accès en premier paramètre suivie par une liste de clefs, il va noter la date de dernière modification du fichier passé, et retirera ces clefs du dictionnaire s'il s'avère que le fichier a été modifié sur le disque (il s'agit d'une vérification au moment de l'accès au contenu du dictionnaire, et non d'une surveillance continue du fichier sur le disque). Un nouvel appel avec le même chemin d'accès permet de changer la liste des clefs concernées, ou de retirer cette surveillance si aucune clef n'est fournie. Plusieurs fichiers peuvent être « surveillés » simultanément.
L'objet specialpath permet d'accéder aux répertoires particuliers du système. Il connaît les répertoires suivants :
PWD (lu depuis os.getcwd()),HOME (lu depuis la variable d'environnement habituelle),
CONFIG (lu depuis la variable d'environnement XDG_CONFIG_HOME, ou pointant vers $HOME/.config si elle n'est pas définie),CACHE (lu depuis la variable d'environnement XDG_CACHE_HOME, ou pointant vers $HOME/.cache si elle n'est pas définie),DATA (lu depuis la variable d'environnement XDG_DATA_HOME, ou pointant vers $HOME/.local/share si elle n'est pas définie),DESKTOP (lu depuis la variable d'environnement XDG_DESKTOP_DIR, ou depuis le fichier $CONFIG/.user-dirs.dirs si elle n'est pas définie),DOWNLOAD (lu depuis la variable d'environnement XDG_DOWNLOAD_DIR, ou depuis le fichier $CONFIG/.user-dirs.dirs si elle n'est pas définie),MUSIC (lu depuis la variable d'environnement XDG_MUSIC_DIR, ou depuis le fichier $CONFIG/.user-dirs.dirs si elle n'est pas définie),PICTURES (lu depuis la variable d'environnement XDG_PICTURES_DIR, ou depuis le fichier $CONFIG/.user-dirs.dirs si elle n'est pas définie),PUBLICSHARE (lu depuis la variable d'environnement XDG_PUBLICSHARE_DIR, ou depuis le fichier $CONFIG/.user-dirs.dirs si elle n'est pas définie),DOCUMENTS (lu depuis la variable d'environnement XDG_DOCUMENTS_DIR, ou depuis le fichier $CONFIG/.user-dirs.dirs si elle n'est pas définie),VIDEOS (lu depuis la variable d'environnement XDG_VIDEOS_DIR, ou depuis le fichier $CONFIG/.user-dirs.dirs si elle n'est pas définie),TEMPLATES (lu depuis la variable d'environnement XDG_TEMPLATES_DIR, ou depuis le fichier $CONFIG/.user-dirs.dirs si elle n'est pas définie),SHM (répertoire partagé, lu depuis la variable d'environnement TARGETSHM. Si celle-ci n'existe pas, on utilisera /dev/shm/$USER si le répertoire /dev/shm existe, sinon /tmp/shm-$USER. Ce répertoire est utilisé à diverses reprises dans le reste du projet.)L'accès à ces différents répertoires peut se faire (de façon insensible à la casse) comme des attributs ou comme des clefs de l'objet. L'objet peut également être appelé avec l'un de ces répertoires en premier paramètre suivi d'une adresse plus précise, auquel cas il renverra un chemin complet.
L'objet icontheme permet d'identifier le thème d'icône actuellement actif, ce qui sert notamment pour le module d'images. Comme il existe plusieurs moyens de définir un thème d'icônes et qu'ils ne contiennent pas forcément les mêmes informations, les thèmes suivants peuvent être accessibles, aussi bien comme des clefs que comme des attributs :
gtk3, depuis le fichier $CONFIG/gtk-3.0/settings.ini,gtk2, depuis le fichier ~/.gtkrc-2.0Appeler l'objet comme une fonction en lui passant un ou plusieurs thèmes comme paramètres renverra le premier thème trouvé dans cette liste (ou None sans déclencher d'erreur si aucun n'est dispo). Si la liste est vide, on passera tous les thèmes disponibles en revue dans l'ordre sus-mentionné. TODO : comment définit-on un thème d'icônes avec Qt ou d'autres bibliothèques graphiques ? Il faudrait également prendre en compte les gtk.ini spécifiques des différentes applications (voir ci-dessous).
TODO : Par défaut, les applications GTK utilisent toutes le thème général, mais il est possible de définit un thème GTK spécifique pour une application donnée. Ce module serait sans doute le meilleur endroit où placer le code destiné à chercher un « gtk.ini » et un « gtk.css » dans le répertoire de configuration de l'appli en cours et à les appliquer.