o 1b@sddlmZddlZddlZddlmZddlmZddlm Z ej dr-ddlm Z ndd d Z Gd dde Z dddZdgZdS)) annotationsN) ConfigParser)Path)PlatformDirsABClinux)getuidreturnintcCstd)Nzshould only be used on Linux) RuntimeErrorr r 3/usr/lib/python3/dist-packages/platformdirs/unix.pyrsrc@seZdZdZed"ddZed"ddZd#d d Zed"d d Zed"d dZ ed"ddZ ed"ddZ ed"ddZ ed"ddZ ed"ddZed$ddZed$ddZd%dd Zd!S)&UnixaD On Unix/Linux, we follow the `XDG Basedir Spec `_. The spec allows overriding directories with environment variables. The examples show are the default values, alongside the name of the environment variable that overrides them. Makes use of the `appname `, `version `, `multipath `, `opinion `. r strcC,tjdd}|stjd}||S)z :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version`` XDG_DATA_HOMEz~/.local/shareosenvirongetstrippath expanduser_append_app_name_and_versionselfrr r r user_data_dir  zUnix.user_data_dircCs.tjdd}|sdtjd}||S)aY :return: data directories shared by users (if `multipath ` is enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version`` XDG_DATA_DIRSrz/usr/local/sharez /usr/share)rrrrpathsep_with_multi_pathrr r r site_data_dir)s zUnix.site_data_dirrcs<|tj}js|dd}fdd|D}tj|S)Nrrcsg|] }tj|qSr )rrrr).0prr r :sz)Unix._with_multi_path..)splitrr multipathjoin)rr path_listr r%r r!6s   zUnix._with_multi_pathcCr)z :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` XDG_CONFIG_HOMErz ~/.configrrr r r user_config_dir=rzUnix.user_config_dircCs$tjdd}|s d}||S)a/ :return: config directories shared by users (if `multipath ` is enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS path separator), e.g. ``/etc/xdg/$appname/$version`` XDG_CONFIG_DIRSrz/etc/xdg)rrrrr!rr r r site_config_dirHs zUnix.site_config_dircCr)z :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``~/$XDG_CACHE_HOME/$appname/$version`` XDG_CACHE_HOMErz~/.cacherrr r r user_cache_dirUrzUnix.user_cache_dircCr)z :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version`` XDG_STATE_HOMErz~/.local/staterrr r r user_state_dir`rzUnix.user_state_dircCs|j}|jr tj|d}|S)zx :return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``log`` in it log)r0opinionrrr)rr r r user_log_dirkszUnix.user_log_dircCs6td}|durtjdd}|stjd}|S)zU :return: documents directory tied to the user, e.g. ``~/Documents`` XDG_DOCUMENTS_DIRNrz ~/Documents)_get_user_dirs_folderrrrrrr)r documents_dirr r r user_documents_dirus  zUnix.user_documents_dircCs,tjdd}|sdt}||S)z :return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or ``$XDG_RUNTIME_DIR/$appname/$version`` XDG_RUNTIME_DIRrz /run/user/)rrrrrrrr r r user_runtime_dirrzUnix.user_runtime_dirrcC ||jS)zd:return: data path shared by users. Only return first item, even if ``multipath`` is set to ``True``) _first_item_as_path_if_multipathr"r%r r r site_data_path zUnix.site_data_pathcCr<)zj:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``)r=r.r%r r r site_config_pathr?zUnix.site_config_path directorycCs|jr |tjd}t|S)Nr)r(r'rr r)rrAr r r r=sz%Unix._first_item_as_path_if_multipathN)r r)rrr r)r r)rArr r)__name__ __module__ __qualname____doc__propertyrr"r!r,r.r0r2r5r9r;r>r@r=r r r r rs4            rkeyr str | NonecCstjtjd}tj|rMt}t|}|d| Wdn1s+wY||dvr8dS|d| d}| dtj d}|SdS)zjReturn directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/zuser-dirs.dirsz[top] Ntop"z$HOME~) rrr)rr,existsropen read_stringreadrreplacer)rGuser_dirs_config_pathparserstreamrr r r r7s   r7)r r )rGrr rH) __future__rrsys configparserrpathlibrapirplatform startswithrrr7__all__r r r r s