
    P'gi"                        d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl	m
Z
 ej                  dk(  rdd	Zndd
lmZ  G d de
      ZddZddZdgZy)zUnix.    )annotationsN)ConfigParser)Path   )PlatformDirsABCwin32c                     d} t        |       )Nzshould only be used on Unix)RuntimeError)msgs    U/var/www/html/knws/venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.pygetuidr      s    +3    )r   c                  R   e Zd ZdZedd       Zedd       ZddZedd       Zedd       Z	edd       Z
edd       Zedd	       Zedd
       Zedd       Zedd       Zedd       Zedd       Zedd       Zedd       Zedd       Zedd       Zedd       ZddZ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 show 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                  dd      }|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_dirzUnix.user_data_dir"   sG     zz~~or2zz|77%%&67D0066r   c                    t         j                  j                  dd      }|j                         sdt         j                   d}| j                  |      S )aY  
        :return: data directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.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_DIRSr   z/usr/local/sharez
/usr/share)r   r   r   r   pathsep_with_multi_pathr   s     r   site_data_dirzUnix.site_data_dir-   sD     zz~~or2zz|%bjj\<D$$T**r   c                    |j                  t        j                        }| j                  s|dd }|D cg c]0  }| j	                  t        j
                  j                  |            2 }}t        j                  j                  |      S c c}w )Nr   r   )splitr   r!   	multipathr   r   r   join)r   r   	path_listps       r   r"   zUnix._with_multi_path:   sm    JJrzz*	~~!!AIW`aRST66rww7I7I!7LMa	azzy)) bs   5Bc                    t         j                  j                  dd      }|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_dirzUnix.user_config_dirA   sG     zz~~/4zz|77%%k2D0066r   c                    t         j                  j                  dd      }|j                         sd}| j	                  |      S )a/  
        :return: config directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.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_DIRSr   z/etc/xdg)r   r   r   r   r"   r   s     r   site_config_dirzUnix.site_config_dirL   s8     zz~~/4zz|D$$T**r   c                    t         j                  j                  dd      }|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_dirzUnix.user_cache_dirY   sG     zz~~.3zz|77%%j1D0066r   c                $    | j                  d      S )zM:return: cache directory shared by users, e.g. ``/var/tmp/$appname/$version``z/var/tmp)r   r   s    r   site_cache_dirzUnix.site_cache_dird   s     00<<r   c                    t         j                  j                  dd      }|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_dirzUnix.user_state_diri   sH     zz~~.3zz|77%%&67D0066r   c                v    | j                   }| j                  r t        j                  j	                  |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'   r   s     r   user_log_dirzUnix.user_log_dirt   s/     ""<<77<<e,Dr   c                    t        dd      S )zC:return: documents directory tied to the user, e.g. ``~/Documents``XDG_DOCUMENTS_DIRz~/Documents_get_user_media_dirr4   s    r   user_documents_dirzUnix.user_documents_dir|   s     ##6FFr   c                    t        dd      S )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``XDG_DOWNLOAD_DIRz~/Downloadsr?   r4   s    r   user_downloads_dirzUnix.user_downloads_dir   s     ##5}EEr   c                    t        dd      S )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``XDG_PICTURES_DIRz
~/Picturesr?   r4   s    r   user_pictures_dirzUnix.user_pictures_dir   s     ##5|DDr   c                    t        dd      S )z=:return: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/Videosr?   r4   s    r   user_videos_dirzUnix.user_videos_dir   s     ##3Z@@r   c                    t        dd      S )z;:return: music directory tied to the user, e.g. ``~/Music``XDG_MUSIC_DIRz~/Musicr?   r4   s    r   user_music_dirzUnix.user_music_dir   s     #?I>>r   c                D   t         j                  j                  dd      }|j                         s`t        j
                  j                  d      r4dt                }t        |      j                         sdt                }ndt                }| 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_dirzUnix.user_runtime_dir   s     zz~~/4zz|||&&'GH'z2Dz((**68*5D#FH:.0066r   c                8    | j                  | j                        S )zd:return: data path shared by users. Only return first item, even if ``multipath`` is set to ``True``) _first_item_as_path_if_multipathr#   r4   s    r   site_data_pathzUnix.site_data_path   s     44T5G5GHHr   c                8    | j                  | j                        S )zj:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``)rY   r/   r4   s    r   site_config_pathzUnix.site_config_path   s     44T5I5IJJr   c                8    | j                  | j                        S )ze:return: cache path shared by users. Only return first item, even if ``multipath`` is set to ``True``)rY   r5   r4   s    r   site_cache_pathzUnix.site_cache_path   s     44T5H5HIIr   c                t    | j                   r"|j                  t        j                        d   }t	        |      S )Nr   )r&   r%   r   r!   r   )r   	directorys     r   rY   z%Unix._first_item_as_path_if_multipath   s*    >>!

3A6IIr   N)returnstr)r   rb   ra   rb   )ra   r   )r`   rb   ra   r   )__name__
__module____qualname____doc__propertyr   r#   r"   r,   r/   r2   r5   r8   r<   rA   rD   rG   rJ   rM   rW   rZ   r\   r^   rY    r   r   r   r      ss   
 7 7 
+ 
+* 7 7 
+ 
+ 7 7 = = 7 7   G G F F E E A A ? ? 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   r@   r@      sM    %g.IJJNN7B/557	**+>?Ir   c                   t        t               j                        dz  }|j                         rt	               }|j                         5 }|j                  d|j                                 ddd       | |d   vry|d   |    j                  d      }|j                  dt        j                  j                  d            S y# 1 sw Y   XxY w)zkReturn directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/.zuser-dirs.dirsz[top]
Ntop"z$HOME~)r   r   r,   rV   r   openread_stringreadr   replacer   r   r   )keyuser_dirs_config_pathparserstreamr   s        r   rj   rj      s     !7!78;KK##%"'') 	:V89	: fUm#e}S!'',||GRWW%7%7%<==	: 	:s   #CC)ra   int)rk   rb   rl   rb   ra   rb   )rv   rb   ra   z
str | None)rf   
__future__r   r   rS   configparserr   pathlibr   apir   rT   r   r   r@   rj   __all__rh   r   r   <module>r      sU     " 	 
 %   <<7 
 g? gT* r   