Ë
|
Añúh) ã ó¸ d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m
|
Z
|
m Z ddl m Z ej d k( rdd
|
Zndd lmZ G d d e « ZddZddZd gZy)zUnix.é )Ú annotationsN)Ú ConfigParser)ÚPath)ÚIteratorÚNoReturné )ÚPlatformDirsABCÚwin32c ó d} t | « )Nzshould only be used on Unix)Ú RuntimeError)Úmsgs úWH:\Change_password\venv_build\Lib\site-packages\setuptools/_vendor/platformdirs/unix.pyÚgetuidr s Ø+Ü3Ó Ð ó )r c ó¢ e Zd ZdZedd« Zed d« Zedd« Zedd« Zed d« Z edd« Z
|
edd« Z edd « Z edd
|
« Z edd « Zedd « Zedd « Zedd« Zedd« Zedd« Zedd« Zedd« Zedd« Zed d« Zed d« Zed d« Zd dZd dZd dZ y) ÚUnixa
|
On Unix/Linux, we follow the `XDG Basedir Spec <https://specifications.freedesktop.org/basedir-spec/basedir-spec-
|
latest.html>`_.
|
|
The spec allows overriding directories with environment variables. The examples shown are the default values,
|
alongside the name of the environment variable that overrides them. Makes use of the `appname
|
<platformdirs.api.PlatformDirsABC.appname>`, `version <platformdirs.api.PlatformDirsABC.version>`, `multipath
|
<platformdirs.api.PlatformDirsABC.multipath>`, `opinion <platformdirs.api.PlatformDirsABC.opinion>`, `ensure_exists
|
<platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
c óÂ t j j dd« }|j « s t j j d« }| j |« S )z
|
:return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or
|
``$XDG_DATA_HOME/$appname/$version``
|
Ú XDG_DATA_HOMEÚ z~/.local/share©ÚosÚenvironÚgetÚstripÚpathÚ
|
expanduserÚ _append_app_name_and_version©Úselfr s r Ú user_data_dirzUnix.user_data_dir$ sG ô zz~~o¨rÓ2Øzz|Ü77×%Ñ%Ð&6Ó7DØ×0Ñ0°Ó6Ð6r c ó t j j dd« }|j « sdt j d}|j t j « D cg c] }| j |« c}S c c}w )NÚ XDG_DATA_DIRSr z/usr/local/sharez
|
/usr/share)r r r r ÚpathsepÚsplitr ©r r Úps r Ú_site_data_dirszUnix._site_data_dirs/ s] äzz~~o¨rÓ2Øzz|Ø%¤b§j¡j \°Ð<DØ>B¿j¹jÌÏÉÓ>TÖU¸×1Ñ1°!Õ4ÒUÐUùÒUs Á&Bc óz | j }| j s|d S t j j |« S )aZ
|
:return: data directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>` is
|
enabled and ``XDG_DATA_DIRS`` 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``
|
r )r' Ú multipathr r# Újoin©r Údirss r Ú site_data_dirzUnix.site_data_dir6 s2 ð ×#Ñ#Ø~~Ø7NÜzztÓ$Ð$r c óÂ t j j dd« }|j « s t j j d« }| j |« S )z
|
:return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or
|
``$XDG_CONFIG_HOME/$appname/$version``
|
ÚXDG_CONFIG_HOMEr z ~/.configr r s r Úuser_config_dirzUnix.user_config_dirC sG ô zz~~Ð /°Ó4Øzz|Ü77×%Ñ% kÓ2DØ×0Ñ0°Ó6Ð6r c óè t j j dd« }|j « sd}|j t j
|
« D cg c] }| j |« c}S c c}w )NÚXDG_CONFIG_DIRSr z/etc/xdg)r r r r r$ r# r r% s r Ú_site_config_dirszUnix._site_config_dirsN sQ äzz~~Ð /°Ó4Øzz|Ø DØ>B¿j¹jÌÏÉÓ>TÖU¸×1Ñ1°!Õ4ÒUÐUùÒUs ÁA/c óz | j }| j s|d S t j j |« S )a2
|
:return: config directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>`
|
is enabled and ``XDG_CONFIG_DIRS`` 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``
|
r )r3 r) r r# r* r+ s r Úsite_config_dirzUnix.site_config_dirU s2 ð ×%Ñ%Ø~~Ø7NÜzztÓ$Ð$r c óÂ t j j dd« }|j « s t j j d« }| j |« S )z
|
:return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or
|
``~/$XDG_CACHE_HOME/$appname/$version``
|
ÚXDG_CACHE_HOMEr z~/.cacher r s r Úuser_cache_dirzUnix.user_cache_dirb sG ô zz~~Ð .°Ó3Øzz|Ü77×%Ñ% jÓ1DØ×0Ñ0°Ó6Ð6r c ó$ | j d« S )zO:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z
|
/var/cache)r ©r s r Úsite_cache_dirzUnix.site_cache_dirm s ð ×0Ñ0° Ó>Ð>r c óÂ t j j dd« }|j « s t j j d« }| j |« S )z
|
:return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or
|
``$XDG_STATE_HOME/$appname/$version``
|
ÚXDG_STATE_HOMEr z~/.local/stater r s r Úuser_state_dirzUnix.user_state_dirr sH ô zz~~Ð .°Ó3Øzz|Ü77×%Ñ%Ð&6Ó7DØ×0Ñ0°Ó6Ð6r c ó | j }| j r1t j j |d« }| j |« |S )zg:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in itÚlog)r> Úopinionr r r* Ú _optionally_create_directoryr s r Ú user_log_dirzUnix.user_log_dir} s= ð ×"Ñ"Ø <<Ü77<< eÓ,DØ × -Ñ -¨dÔ 3Ø r c ó t dd« S )zC:return: documents directory tied to the user, e.g. ``~/Documents``ÚXDG_DOCUMENTS_DIRz ~/Documents©Ú_get_user_media_dirr: s r Úuser_documents_dirzUnix.user_documents_dir s ô #Ð#6¸ ÓFÐFr c ó t dd« S )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``ÚXDG_DOWNLOAD_DIRz ~/DownloadsrF r: s r Úuser_downloads_dirzUnix.user_downloads_dir s ô #Ð#5°}ÓEÐEr c ó t dd« S )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``ÚXDG_PICTURES_DIRz
|
~/PicturesrF r: s r Úuser_pictures_dirzUnix.user_pictures_dir s ô #Ð#5°|ÓDÐDr c ó t dd« S )z=:return: videos directory tied to the user, e.g. ``~/Videos``ÚXDG_VIDEOS_DIRz~/VideosrF r: s r Úuser_videos_dirzUnix.user_videos_dir s ô #Ð#3°ZÓ@Ð@r c ó t dd« S )z;:return: music directory tied to the user, e.g. ``~/Music``Ú XDG_MUSIC_DIRz~/MusicrF r: s r Úuser_music_dirzUnix.user_music_dir s ô # ?°IÓ>Ð>r c ó t dd« S )z?:return: desktop directory tied to the user, e.g. ``~/Desktop``ÚXDG_DESKTOP_DIRz ~/DesktoprF r: s r Úuser_desktop_dirzUnix.user_desktop_dir s ô #Ð#4°kÓBÐBr c óD t j j dd« }|j « s`t j
|
j d« r4dt « }t |« j « sdt « }n dt « }| j |« S )az
|
:return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or
|
``$XDG_RUNTIME_DIR/$appname/$version``.
|
|
For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/user/$(id -u)/$appname/$version`` if
|
exists, otherwise ``/tmp/runtime-$(id -u)/$appname/$version``, if``$XDG_RUNTIME_DIR``
|
is not set.
|
ÚXDG_RUNTIME_DIRr ©ÚfreebsdÚopenbsdÚnetbsdz/var/run/user/z /tmp/runtime-z
|
/run/user/) r r r r ÚsysÚplatformÚ
|
startswithr r Úexistsr r s r Úuser_runtime_dirzUnix.user_runtime_dir¤ s ô zz~~Ð /°Ó4Øzz|Ü||×&Ñ&Ð'GÔHØ'¬« zÐ2ÜDz×(Ñ(Ô*Ø *¬6«8¨*Ð5Dà#¤F£H :Ð.Ø×0Ñ0°Ó6Ð6r c óÌ t j j dd« }|j « s$t j
|
j d« rd}nd}| j |« S )am
|
:return: runtime directory shared by users, e.g. ``/run/$appname/$version`` or ``$XDG_RUNTIME_DIR/$appname/$version``.
|
|
Note that this behaves almost exactly like `user_runtime_dir` if ``$XDG_RUNTIME_DIR`` is set, but will
|
fall back to paths associated to the root user instead of a regular logged-in user if it's not set.
|
|
If you wish to ensure that a logged-in root user path is returned e.g. ``/run/user/0``, use `user_runtime_dir`
|
instead.
|
|
For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/$appname/$version`` if ``$XDG_RUNTIME_DIR`` is not set.
|
rY r rZ z/var/runz/run)r r r r r^ r_ r` r r s r Úsite_runtime_dirzUnix.site_runtime_dir¸ sP ô zz~~Ð /°Ó4Øzz|Ü||×&Ñ&Ð'GÔHØ!à Ø×0Ñ0°Ó6Ð6r c ó8 | j | j « S )zh:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)Ú _first_item_as_path_if_multipathr- r: s r Úsite_data_pathzUnix.site_data_pathÎ s ð ×4Ñ4°T×5GÑ5GÓHÐHr c ó8 | j | j « S )zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)rf r5 r: s r Úsite_config_pathzUnix.site_config_pathÓ s ð ×4Ñ4°T×5IÑ5IÓJÐJr c ó8 | j | j « S )zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rf r; r: s r Úsite_cache_pathzUnix.site_cache_pathØ s ð ×4Ñ4°T×5HÑ5HÓIÐIr c ót | j r"|j t j « d }t |« S )Nr )r) r$ r r# r )r Ú directorys r rf z%Unix._first_item_as_path_if_multipathÝ s* Ø >>à!¬¯
|
©
|
Ó3°AÑ6IÜIÐ r c # óT K | j | j E d{ y7 w)z4:yield: all user and site configuration directories.N)r0 r3 r: s r Úiter_config_dirszUnix.iter_config_dirsã s! è ø à×"Ñ"Ò"Ø×)Ñ)×)Ò)úó ( &¡(c # óT K | j | j E d{ y7 w)z+:yield: all user and site data directories.N)r r' r: s r Úiter_data_dirszUnix.iter_data_dirsè s! è ø à× Ñ Ò Ø×'Ñ'×'Ò'úrp N)ÚreturnÚstr)rs z list[str])rs r )rm rt rs r )rs z Iterator[str]) Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__Úpropertyr r' r- r0 r3 r5 r8 r; r> rC rH rK rN rQ rT rW rb rd rg ri rk rf ro rr © r r r r sÎ ñ
|
ð ò7ó ð7ð òVó ðVð ò
|
%ó ð
|
%ð ò7ó ð7ð òVó ðVð ò
|
%ó ð
|
%ð ò7ó ð7ð ò?ó ð?ð ò7ó ð7ð òó ðð òGó ðGð òFó ðFð òEó ðEð òAó ðAð ò?ó ð?ð òCó ðCð ò7ó ð7ð& ò7ó ð7ð* òIó ðIð òKó ðKð òJó ðJó ó *ô
|
(r r c ó¾ t | « }|Ot j j | d« j « }|s t j
|
j |« }|S )Nr )Ú_get_user_dirs_folderr r r r r r )Úenv_varÚfallback_tilde_pathÚ media_dirs r rG rG î sM Ü% gÓ.IØÐÜJJNN 7¨BÓ/×5Ñ5Ó7 ÙÜ×*Ñ*Ð+>Ó?Ià Ðr c ó¢ t t « j « dz }|j « rt « }|j « 5 }|j d|j « « ddd« | |d vry|d | j d« }|j dt j j d« « S y# 1 sw Y XxY w)z{
|
Return directory from user-dirs.dirs config file.
|
|
See https://freedesktop.org/wiki/Software/xdg-user-dirs/.
|
|
zuser-dirs.dirsz[top]
|
NÚtopú"z$HOMEú~) r r r0 ra r ÚopenÚ read_stringÚreadr Úreplacer r r )ÚkeyÚuser_dirs_config_pathÚparserÚstreamr s r r| r| ø s» ô !¤£×!7Ñ!7Ó 8Ð;KÑ KÐØ ×#Ñ#Ô%Ü à "× 'Ñ 'Ó )ð :¨Và × Ñ ¨¯©« ¨Ð 8Ô 9÷ :ð fUmÑ #Øàe}SÑ!×'Ñ'¨Ó,à||G¤R§W¡W×%7Ñ%7¸Ó%<Ó=Ð=à ÷ :ð :ús Á #CÃC)rs r )r} rt r~ rt rs rt )r rt rs z
|
str | None)rx Ú
|
__future__r r r^ Ú configparserr Úpathlibr Útypingr r Úapir r_ r r rG r| Ú__all__rz r r ú<module>r sX ðÙ å "ã Û
|
Ý %Ý ß %å à<<7Òô õ
|
ôT(?ô T(ónóð4 ð r
|
