ucu(dZddlZddlZejdZejdpejeddZ e gejdpd d zZ ejd pejed Z e gejd pd d zZ ejdpejedZejdpejeddZde DZ de DZ dZdZdZdZdZdZdZddZdS)a  This module is based on a rox module (LGPL): http://cvs.sourceforge.net/viewcvs.py/rox/ROX-Lib2/python/rox/basedir.py?rev=1.9&view=log The freedesktop.org Base Directory specification provides a way for applications to locate shared data and configuration: http://standards.freedesktop.org/basedir-spec/ (based on version 0.6) This module can be used to load and save from and to these directories. Typical usage: from rox import basedir for dir in basedir.load_config_paths('mydomain.org', 'MyProg', 'Options'): print "Load settings from", dir dir = basedir.save_config_path('mydomain.org', 'MyProg') print >>file(os.path.join(dir, 'Options'), 'w'), "foo=2" Note: see the rox.Options module for a higher-level API for managing options. N~ XDG_DATA_HOMEz.localshare XDG_DATA_DIRSz/usr/local/share:/usr/share:XDG_CONFIG_HOMEz.configXDG_CONFIG_DIRSz/etc/xdgXDG_CACHE_HOMEz.cacheXDG_STATE_HOMEstatecg|]}||Sr.0xs 3/usr/lib/python3/dist-packages/xdg/BaseDirectory.py r1s///qQ////cg|]}||Srrrs rrr2s33331333rc tjj|}|drJtjt|}tj|stj|d|S)zEnsure ``$XDG_CONFIG_HOME//`` exists, and return its path. 'resource' should normally be the name of your application. Use this when saving configuration settings. /)ospathjoin startswithxdg_config_homeisdirmakedirsresourcers rsave_config_pathr"4sn w|X&H""3''''' 7<< 2 2D 7==  ! D%   Krc tjj|}|drJtjt|}tj|stj||S)zEnsure ``$XDG_DATA_HOME//`` exists, and return its path. 'resource' should normally be the name of your application or a shared resource. Use this when saving or updating application data. r)rrrr xdg_data_homerrr s rsave_data_pathr%@sl w|X&H""3''''' 7<< x 0 0D 7==   D Krc tjj|}|drJtjt|}tj|stj||S)zEnsure ``$XDG_CACHE_HOME//`` exists, and return its path. 'resource' should normally be the name of your application or a shared resource.r)rrrrxdg_cache_homerrr s rsave_cache_pathr(Llw|X&H""3''''' 7<< 1 1D 7==   D Krc tjj|}|drJtjt|}tj|stj||S)zEnsure ``$XDG_STATE_HOME//`` exists, and return its path. 'resource' should normally be the name of your application or a shared resource.r)rrrrxdg_state_homerrr s rsave_state_pathr,Wr)rc'Ktjj|}tD]E}tj||}tj|r|VFdS)zReturns an iterator which gives each directory named 'resource' in the configuration search path. Information provided by earlier directories should take precedence over later ones, and the user-specific config dir comes first.N)rrrxdg_config_dirsexists)r! config_dirrs rload_config_pathsr1bsa w|X&H%,, w||J11 7>>$  +t,,rc$t|D]}|cSdS)zYReturns the first result from load_config_paths, or None if there is nothing to load.N)r1)r!rs rload_first_configr3ls& ) 4rc'Ktjj|}tD]E}tj||}tj|r|VFdS)zReturns an iterator which gives each directory named 'resource' in the application data search path. Information provided by earlier directories should take precedence over later ones.N)rrr xdg_data_dirsr/)r!data_dirrs rload_data_pathsr7ssaw|X&H!,,w||Hh// 7>>$  +t,,rTcL tjdS#t$r|rddl}d|z}d} tj|}t j|jstj |d}n|j tj ks!|jt j t j zzrtj|d}n/#t$r"}ddl}|j|jkrd}nYd}~nd}~wwxYw|rtj|d|cYSwxYw)aReturns the value of $XDG_RUNTIME_DIR, a directory path. This directory is intended for 'user-specific non-essential runtime files and other file objects (such as sockets, named pipes, ...)', and 'communication and synchronization purposes'. As of late 2012, only quite new systems set $XDG_RUNTIME_DIR. If it is not set, with ``strict=True`` (the default), a KeyError is raised. With ``strict=False``, PyXDG will create a fallback under /tmp for the current user. This fallback does *not* provide the same guarantees as the specification requires for the runtime directory. The strict default is deliberately conservative, so that application developers can make a conscious decision to allow the fallback. XDG_RUNTIME_DIRrNz /tmp/pyxdg-runtime-dir-fallback-FTr)renvironKeyErrorgetpassgetuserlstatstatS_ISDIRst_modeunlinkst_uidgetuidS_IRWXGS_IRWXOrmdirOSErrorerrnoENOENTmkdir)strictr<fallbackcreatesterIs rget_runtime_dirrQ|sW "z+,,       58I8II (##B< ++  (###)ry{{*** t| ;<+"""    LLLw%,&& "  & HXu % % %A s:+D#CBD# D"C?:D#?DD#"D#)T)__doc__rr?r expanduser_homer:getrr$splitr5rr.r'r+r"r%r(r,r1r3r7rQrrrrWs6 3 //3 GLL' 2 2Z^^O$$E(ELLSQQR *..!233+ GLL * *##Z^^%&&4*;;C@@A 011* GLL ) ) 0113 GLL' 2 20/M/// 33o333            ,,,,,,222222r