*tdZddlZddlZejj dZej jdxsejjeddZ e gej jdxsdjd zZ ej jd xsejjed Z e gej jd xsd jd zZ ej jdxsejjedZej jdxsejjeddZe Dcgc]}|s| c}Z e Dcgc]}|s| c}Z dZdZdZdZdZdZdZddZycc}wcc}w)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_HOMEstatectjj|}|jdrJtjjt|}tjj |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 6/usr/lib/python3.12/site-packages/xdg/BaseDirectory.pysave_config_pathr4sa ww||X&H""3'' ' 77<< 2D 77==  D% Kctjj|}|jdrJtjjt|}tjj |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_homerrrs rsave_data_pathr@s_ ww||X&H""3'' ' 77<< x 0D 77==  D Krctjj|}|jdrJtjjt|}tjj |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_homerrrs rsave_cache_pathr!L_ww||X&H""3'' ' 77<< 1D 77==  D Krctjj|}|jdrJtjjt|}tjj |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_homerrrs rsave_state_pathr%Wr"rc'Ktjj|}tD]F}tjj||}tjj |sC|Hyw)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_pathsr*bsL ww||X&H% ww||J1 77>>$ t& A%A/(A/c$t|D]}|cSy)zYReturns the first result from load_config_paths, or None if there is nothing to load.N)r*)rxs rload_first_configr.ls )* rc'Ktjj|}tD]F}tjj||}tjj |sC|Hyw)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()rdata_dirrs rload_data_pathsr2ssLww||X&H!ww||Hh/ 77>>$ t"r+c tjdS#t$r$|rddl}d|j z}d} tj |}t j|jstj|d}n|jtjk7s.|jt jt jzzrOtj|d}n7#t$r+}ddl}|j |j"k(rd}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)strictr7fallbackcreatesterDs rget_runtime_dirrL|s "zz+,,    58II (#B<< + (#))ryy{*** t|| ;<"  ww%,,& "  HHXu %A s9&EC/BE/ D#8!DED##EE)T)__doc__rr:r expanduser_homer5getrrsplitr0rr'r r$rrr!r%r*r.r2rL)r-s0rrRs6 3 /3 GGLL' 2ZZ^^O$E(ELLSQR **..!23+ GGLL *##ZZ^^%&4*;;C@A 01* GGLL ) 013 GGLL' 2*/MqQM/ -3o1o3    ,,2W03s4F0<F0F5F5