관리-도구
편집 파일: unix.cpython-38.pyc
U &?�f�) � @ s� d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m Z m Z ddl m Z ejd krnd d �d d �Zn ddlmZ G dd� de �Zdddd�dd�Zddd�dd�ZdgZdS )zUnix.� )� annotationsN)� ConfigParser)�Path)�Iterator�NoReturn� )�PlatformDirsABC�win32r ��returnc C s d} t | ��d S )Nzshould only be used on Unix)� RuntimeError)�msg� r �K/opt/hc_python/lib/python3.8/site-packages/pip/_vendor/platformdirs/unix.py�getuid s r )r c @ s� e Zd ZdZedd�dd��Zedd�dd��Zedd�d d ��Zedd�d d ��Zedd�d d��Z edd�dd��Z edd�dd��Z edd�dd��Z edd�dd��Z edd�dd��Zedd�dd��Zedd�dd ��Zedd�d d ��Zedd�d d ��Zedd�d!d"��Zedd�d#d$��Zedd�d%d&��Zedd�d'd(��Zed)d�d*d+��Zed)d�d,d-��Zed)d�d.d/��Zdd)d0�d1d2�Zd3d�d4d5�Zd3d�d6d7�Z d8S )9�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>`. �strr c C s, t j�dd�}|�� s"t j�d�}| �|�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 r r r � user_data_dir$ s zUnix.user_data_dirz list[str]c s> t j�dd�}|�� s$dt j� d�}� fdd�|�t j�D �S )N� XDG_DATA_DIRSr z/usr/local/sharez /usr/sharec s g | ]}� � |��qS r �r ��.0�p�r r r � <listcomp>4 s z(Unix._site_data_dirs.<locals>.<listcomp>)r r r r �pathsep�splitr r r% r �_site_data_dirs/ s zUnix._site_data_dirsc C s | j }| js|d S tj�|�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 �dirsr r r � site_data_dir6 s zUnix.site_data_dirc C s, t j�dd�}|�� s"t j�d�}| �|�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 r r r �user_config_dirC s zUnix.user_config_dirc s4 t j�dd�}|�� sd}� fdd�|�t j�D �S )N�XDG_CONFIG_DIRSr z/etc/xdgc s g | ]}� � |��qS r r! r" r% r r r& S s z*Unix._site_config_dirs.<locals>.<listcomp>)r r r r r( r' r r r% r �_site_config_dirsN s zUnix._site_config_dirsc C s | j }| js|d S tj�|�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 )r2 r* r r' r+ r, r r r �site_config_dirU s zUnix.site_config_dirc C s, t j�dd�}|�� s"t j�d�}| �|�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 r r r �user_cache_dirb s zUnix.user_cache_dirc C s | � d�S )zO:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z /var/cacher! r% r r r �site_cache_dirm s zUnix.site_cache_dirc C s, t j�dd�}|�� s"t j�d�}| �|�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 r r r �user_state_dirr s zUnix.user_state_dirc C s( | j }| jr$tj�|d�}| �|� |S )zg:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it�log)r8 �opinionr r r+ � _optionally_create_directoryr r r r � user_log_dir} s zUnix.user_log_dirc C s t dd�S )zC:return: documents directory tied to the user, e.g. ``~/Documents``�XDG_DOCUMENTS_DIRz ~/Documents��_get_user_media_dirr% r r r �user_documents_dir� s zUnix.user_documents_dirc C s t dd�S )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``�XDG_DOWNLOAD_DIRz ~/Downloadsr> r% r r r �user_downloads_dir� s zUnix.user_downloads_dirc C s t dd�S )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``�XDG_PICTURES_DIRz ~/Picturesr> r% r r r �user_pictures_dir� s zUnix.user_pictures_dirc C s t dd�S )z=:return: videos directory tied to the user, e.g. ``~/Videos``�XDG_VIDEOS_DIRz~/Videosr> r% r r r �user_videos_dir� s zUnix.user_videos_dirc C s t dd�S )z;:return: music directory tied to the user, e.g. ``~/Music``� XDG_MUSIC_DIRz~/Musicr> r% r r r �user_music_dir� s zUnix.user_music_dirc C s t dd�S )z?:return: desktop directory tied to the user, e.g. ``~/Desktop``ZXDG_DESKTOP_DIRz ~/Desktopr> r% r r r �user_desktop_dir� s zUnix.user_desktop_dirc C s^ t j�dd�}|�� sTtj�d�rHdt� � �}t|�� � sTdt� � �}n dt� � �}| � |�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 r r r �user_runtime_dir� s zUnix.user_runtime_dirc C s6 t j�dd�}|�� s,tj�d�r(d}nd}| �|�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. rJ r rK z/var/runz/run)r r r r rO rP rQ r r r r r �site_runtime_dir� s zUnix.site_runtime_dirr c C s | � | 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% r r r �site_data_path� s zUnix.site_data_pathc C s | � | j�S )zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)rU r3 r% r r r �site_config_path� s zUnix.site_config_pathc C s | � | j�S )zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rU r6 r% r r r �site_cache_path� s zUnix.site_cache_path)� directoryr c C s | j r|�tj�d }t|�S )Nr )r* r( r r' r )r rY r r r rU � s z%Unix._first_item_as_path_if_multipathz Iterator[str]c c s | j V | jE dH dS )z4:yield: all user and site configuration directories.N)r0 r2 r% r r r �iter_config_dirs� s zUnix.iter_config_dirsc c s | j V | jE dH dS )z+:yield: all user and site data directories.N)r r) r% r r r �iter_data_dirs� s zUnix.iter_data_dirsN) �__name__� __module__� __qualname__�__doc__�propertyr r) r. r0 r2 r3 r5 r6 r8 r< r@ rB rD rF rH rI rS rT rV rW rX rU rZ r[ r r r r r s\ r r )�env_var�fallback_tilde_pathr c C s6 t | �}|d kr2tj�| d��� }|s2tj�|�}|S )Nr )�_get_user_dirs_folderr r r r r r )ra rb � media_dirr r r r? � s r? z str | None)�keyr c C s� t t� j�d }|�� r|t� }|�� �}|�d|�� � �� W 5 Q R X | |d krVdS |d | �d�}|� dt j � d��S dS )z{ Return directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/. zuser-dirs.dirsz[top] �topN�"z$HOME�~) r r r0 rR r �open� read_string�readr �replacer r r )re �user_dirs_config_path�parser�streamr r r r rc � s rc )r_ � __future__r r rO � configparserr �pathlibr �typingr r �apir rP r r r? rc �__all__r r r r �<module> s X �