
    d:'                        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dS )zUnix.    )annotationsN)ConfigParser)Path   )PlatformDirsABCwin32returnintc                 $    d} t          |           )Nzshould only be used on Unix)RuntimeError)msgs    U/home/feoh/.local/pipx/venvs/poetry/lib/python3.11/site-packages/platformdirs/unix.pygetuidr      s    +3    )r   c                     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edd            Zedd            Zd dZdS )!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>`.
    r	   strc                    t           j                            dd          }|                                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   s     r   user_data_dirzUnix.user_data_dir"   sS     z~~or22zz|| 	87%%&677D00666r   c                    t           j                            dd          }|                                sdt           j         d}|                     |          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-   sO     z~~or22zz|| 	=<bj<<<D$$T***r   r   c                     |                     t          j                  } j        s
|dd         } fd|D             }t          j                            |          S )Nr   r   c                t    g | ]4}                     t          j                            |                    5S  )r   r   r   r   ).0pr    s     r   
<listcomp>z)Unix._with_multi_path.<locals>.<listcomp>>   s8    aaaRST66rw7I7I!7L7LMMaaar   )splitr   r$   	multipathjoin)r    r   	path_lists   `  r   r%   zUnix._with_multi_path:   s[    JJrz**	~ 	'!!A#IaaaaW`aaa	zy)))r   c                    t           j                            dd          }|                                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   s     r   user_config_dirzUnix.user_config_dirA   sS     z~~/44zz|| 	37%%k22D00666r   c                    t           j                            dd          }|                                sd}|                     |          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   sC     z~~/44zz|| 	D$$T***r   c                    t           j                            dd          }|                                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   s     r   user_cache_dirzUnix.user_cache_dirY   sS     z~~.33zz|| 	27%%j11D00666r   c                ,    |                      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                            dd          }|                                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   s     r   user_state_dirzUnix.user_state_diri   sT     z~~.33zz|| 	87%%&677D00666r   c                    | j         }| j        r5t          j                            |d          }|                     |           |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_dirzUnix.user_log_dirt   sD     "< 	47<<e,,D--d333r   c                "    t          dd          S )zC:return: documents directory tied to the user, e.g. ``~/Documents``XDG_DOCUMENTS_DIRz~/Documents_get_user_media_dirr;   s    r   user_documents_dirzUnix.user_documents_dir}   s     ##6FFFr   c                "    t          dd          S )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``XDG_DOWNLOAD_DIRz~/DownloadsrG   r;   s    r   user_downloads_dirzUnix.user_downloads_dir   s     ##5}EEEr   c                "    t          dd          S )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``XDG_PICTURES_DIRz
~/PicturesrG   r;   s    r   user_pictures_dirzUnix.user_pictures_dir   s     ##5|DDDr   c                "    t          dd          S )z=:return: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/VideosrG   r;   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~/MusicrG   r;   s    r   user_music_dirzUnix.user_music_dir   s     #?I>>>r   c                "    t          dd          S )z?:return: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz	~/DesktoprG   r;   s    r   user_desktop_dirzUnix.user_desktop_dir   s     ##4kBBBr   c                |   t           j                            dd          }|                                stt          j                            d          rDdt                       }t          |          	                                sdt                       }ndt                       }| 
                    |          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     z~~/44zz|| 	/|&&'GHH /222Dzz((** 6568855D.FHH..00666r   c                    t           j                            dd          }|                                s$t          j                            d          rd}nd}|                     |          S )al  
        :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
        fallback 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.
        rZ   r   r[   z/var/runz/run)r   r   r   r   r_   r`   ra   r   r   s     r   site_runtime_dirzUnix.site_runtime_dir   sc     z~~/44zz|| 	|&&'GHH !00666r   r   c                6    |                      | 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&   r;   s    r   site_data_pathzUnix.site_data_path   s     44T5GHHHr   c                6    |                      | j                  S )zj:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``)rg   r6   r;   s    r   site_config_pathzUnix.site_config_path   s     44T5IJJJr   c                6    |                      | j                  S )ze:return: cache path shared by users. Only return first item, even if ``multipath`` is set to ``True``)rg   r<   r;   s    r   site_cache_pathzUnix.site_cache_path   s     44T5HIIIr   	directoryc                x    | j         r%|                    t          j                  d         }t	          |          S )Nr   )r.   r-   r   r$   r   )r    rm   s     r   rg   z%Unix._first_item_as_path_if_multipath   s0    > 	7!
33A6IIr   N)r	   r   )r   r   r	   r   )r	   r   )rm   r   r	   r   )__name__
__module____qualname____doc__propertyr!   r&   r%   r3   r6   r9   r<   r?   rD   rI   rL   rO   rR   rU   rX   rc   re   rh   rj   rl   rg   r)   r   r   r   r      s       
 
 7 7 7 X7 
+ 
+ 
+ X
+* * * * 7 7 7 X7 
+ 
+ 
+ X
+ 7 7 7 X7 = = = X= 7 7 7 X7    X G G G XG F F F XF E E E XE A A A XA ? ? ? X? C C C XC 7 7 7 X7& 7 7 7 X7* I I I XI K K K XK J J J XJ     r   r   env_varr   fallback_tilde_pathc                    t          |           }|St          j                            | d                                          }|st          j                            |          }|S )Nr   )_get_user_dirs_folderr   r   r   r   r   r   )rt   ru   	media_dirs      r   rH   rH      s[    %g..IJNN7B//5577	 	@**+>??Ir   key
str | Nonec                   t          t                      j                  dz  }|                                rt	                      }|                                5 }|                    d|                                            ddd           n# 1 swxY w Y   | |d         vrdS |d         |                              d          }|	                    dt          j                            d                    S dS )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   r3   rb   r   openread_stringreadr   replacer   r   r   )ry   user_dirs_config_pathparserstreamr   s        r   rw   rw      s    !788;KK##%% >"'')) 	:V888999	: 	: 	: 	: 	: 	: 	: 	: 	: 	: 	: 	: 	: 	: 	: fUm##4e}S!'',,||GRW%7%7%<%<===4s   +BBB)r	   r
   )rt   r   ru   r   r	   r   )ry   r   r	   rz   )rr   
__future__r   r   r_   configparserr   pathlibr   apir   r`   r   r   rH   rw   __all__r)   r   r   <module>r      s	    " " " " " " 				 



 % % % % % %                  <7         
 C C C C C? C C CL      * r   