b_wdZddlZddlZejdZejdpejeddZ e gejdpd d zZ ejd pejed Z e gejd pd d zZ ejdpejedZde DZ de DZ dZdZdZdZdZdZddZdS)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.cachecg|]}||Sr .0xs 1lib/python3.11/site-packages/xdg/BaseDirectory.py r.s///qQ////cg|]}||Sr r r s rrr/s33331333rc 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 1sn 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_homerrrs 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_homerrrs rsave_cache_pathr&Islw|X&H""3''''' 7<< 1 1D 7==   D Krc'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_pathsr+Tsa 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)r+)rrs rload_first_configr-^s& ) 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))rdata_dirrs rload_data_pathsr1esaw|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)strictr6fallbackcreatesterCs rget_runtime_dirrKnsW "z+,,       58I8II (##B< ++  (###)ry{{*** t| ;<+"""    LLLw%,&& "  & HXu % % %A s:+D#CBD# D"C?:D#?DD#"D#)T)__doc__rr9r expanduser_homer4getrr"splitr/rr(r%r r#r&r+r-r1rKr rrrQs6 3 //3 GLL' 2 2Z^^O$$E(ELLSQQR *..!233+ GLL * *##Z^^%&&4*;;C@@A 011* GLL ) )0/M/// 33o333         ,,,,,,222222r