File manager - Edit - /home/newsbmcs.com/public_html/static/img/logo/platformdirs.tar
Back
__pycache__/version.cpython-310.pyc 0000644 00000000403 15030163624 0013137 0 ustar 00 o �7]hP � @ s d Z dZdZdS )z Version information z2.4.1)� � � N)�__doc__� __version__�__version_info__� r r �B/usr/lib/python3/dist-packages/pip/_vendor/platformdirs/version.py�<module> s __pycache__/__init__.cpython-310.pyc 0000644 00000024310 15030163624 0013214 0 ustar 00 o �7]h�1 � @ s� d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z e r(ddl m Z ddl m Z dd lmZmZ d@d d �Ze� ZeZ dAdBdd�Z dAdCdd�Z dAdBd d �Z dAdCd d �Z dDdEd"d#�Z dAdBd$d%�Z dDdEd&d'�ZdFd(d)�Z dDdEd*d+�Z dAdGd-d.�Z dAdHd/d0�Z dAdGd1d2�Z dAdHd3d4�Z dDdId5d6�Z! dAdGd7d8�Z" dDdId9d:�Z#dJd;d<�Z$ dDdId=d>�Z%g d?�Z&dS )Kz� Utilities for determining application-specific dirs. See <https://github.com/platformdirs/platformdirs> for details and usage. � )� annotationsN)�Path)� TYPE_CHECKING)�Literal� )�PlatformDirsABC)� __version__�__version_info__�return�type[PlatformDirsABC]c C sj t �d�dkrt �d�dkrd\} }ntjdkr d\} }ntjdkr'd \} }nd \} }tt�| �|�}|S ) N� ANDROID_DATAz/data� ANDROID_ROOTz/system)z pip._vendor.platformdirs.android�Android�win32)z pip._vendor.platformdirs.windows�Windows�darwin)z pip._vendor.platformdirs.macos�MacOS)z pip._vendor.platformdirs.unix�Unix)�os�getenv�sys�platform�getattr� importlib� import_module)�module�name�result� r �C/usr/lib/python3/dist-packages/pip/_vendor/platformdirs/__init__.py�_set_platform_dir_class s r F�appname� str | None� appauthor�str | None | Literal[False]�version�roaming�bool�strc C � t | |||d�jS )aq :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: data directory tied to the user �r! r# r% r& )� PlatformDirs� user_data_dirr* r r r r, % � r, � multipathc C r) )at :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :returns: data directory shared by users �r! r# r% r. )r+ � site_data_dirr/ r r r r0 5 r- r0 c C r) )as :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: config directory tied to the user r* )r+ �user_config_dirr* r r r r1 E r- r1 c C r) )az :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :returns: config directory shared by the users r/ )r+ �site_config_dirr/ r r r r2 U r- r2 T�opinionc C r) )ar :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :returns: cache directory tied to the user �r! r# r% r3 )r+ �user_cache_dirr4 r r r r5 e r- r5 c C r) )ar :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: state directory tied to the user r* )r+ �user_state_dirr* r r r r6 u r- r6 c C r) )ap :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :returns: log directory tied to the user r4 )r+ � user_log_dirr4 r r r r7 � r- r7 c C � t � jS )z8 :returns: documents directory tied to the user )r+ �user_documents_dirr r r r r9 � � r9 c C r) )at :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :returns: runtime directory tied to the user r4 )r+ �user_runtime_dirr4 r r r r; � r- r; r c C r) )al :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: data path tied to the user r* )r+ �user_data_pathr* r r r r< � r- r< c C r) )aq :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `multipath <platformdirs.api.PlatformDirsABC.multipath>`. :returns: data path shared by users r/ )r+ �site_data_pathr/ r r r r= � r- r= c C r) )an :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: config path tied to the user r* )r+ �user_config_pathr* r r r r> � r- r> c C r) )au :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :returns: config path shared by the users r/ )r+ �site_config_pathr/ r r r r? � r- r? c C r) )am :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :returns: cache path tied to the user r4 )r+ �user_cache_pathr4 r r r r@ � r- r@ c C r) )am :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: state path tied to the user r* )r+ �user_state_pathr* r r r rA � r- rA c C r) )ak :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :returns: log path tied to the user r4 )r+ � user_log_pathr4 r r r rB r- rB c C r8 )z3 :returns: documents path tied to the user )r+ �user_documents_pathr r r r rC r: rC c C r) )ao :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :returns: runtime path tied to the user r4 )r+ �user_runtime_pathr4 r r r rD # r- rD )r r r+ �AppDirsr r, r1 r5 r6 r7 r9 r; r0 r2 r< r> r@ rA rB rC rD r= r? )r r )NNNF) r! r" r# r$ r% r" r& r' r r( ) r! r" r# r$ r% r" r. r' r r( )NNNT) r! r" r# r$ r% r" r3 r' r r( )r r( ) r! r" r# r$ r% r" r& r' r r ) r! r" r# r$ r% r" r. r' r r ) r! r" r# r$ r% r" r3 r' r r )r r )'�__doc__� __future__r r r r �pathlibr �typingr � pip._vendor.typing_extensionsr �apir r% r r r r+ rE r, r0 r1 r2 r5 r6 r7 r9 r; r< r= r> r? r@ rA rB rC rD �__all__r r r r �<module> s� � � � � � � � � � � � � � � � � __pycache__/macos.cpython-310.pyc 0000644 00000006122 15030163624 0012560 0 ustar 00 o �7]h_ � @ s: d dl mZ d dlZddlmZ G dd� de�ZdgZdS )� )� annotationsN� )�PlatformDirsABCc @ s� e Zd ZdZeddd��Zeddd��Zeddd ��Zedd d ��Zedd d ��Z eddd��Z eddd��Z eddd��Z eddd��Z dS )�MacOSa� Platform directories for the macOS operating system. Follows the guidance from `Apple documentation <https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/MacOSXDirectories/MacOSXDirectories.html>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>` and `version <platformdirs.api.PlatformDirsABC.version>`. �return�strc C � | � tj�d��S )zb:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``z ~/Library/Application Support/�� _append_app_name_and_version�os�path� expanduser��self� r �@/usr/lib/python3/dist-packages/pip/_vendor/platformdirs/macos.py� user_data_dir � zMacOS.user_data_dirc C � | � d�S )z`:return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``z /Library/Application Support�r r r r r � site_data_dir � zMacOS.site_data_dirc C r )z\:return: config directory tied to the user, e.g. ``~/Library/Preferences/$appname/$version``z~/Library/Preferences/r r r r r �user_config_dir r zMacOS.user_config_dirc C r )zU:return: config directory shared by the users, e.g. ``/Library/Preferences/$appname``z/Library/Preferencesr r r r r �site_config_dir r zMacOS.site_config_dirc C r )zV:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``z~/Library/Cachesr r r r r �user_cache_dir$ r zMacOS.user_cache_dirc C s | j S )zB:return: state directory tied to the user, same as `user_data_dir`)r r r r r �user_state_dir) s zMacOS.user_state_dirc C r )zR:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``z~/Library/Logsr r r r r � user_log_dir. r zMacOS.user_log_dirc C s t j�d�S )zC:return: documents directory tied to the user, e.g. ``~/Documents``z ~/Documents)r r r r r r r �user_documents_dir3 s zMacOS.user_documents_dirc C r )zg:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``z ~/Library/Caches/TemporaryItemsr r r r r �user_runtime_dir8 r zMacOS.user_runtime_dirN)r r )�__name__� __module__� __qualname__�__doc__�propertyr r r r r r r r r r r r r r s( r )� __future__r r �apir r �__all__r r r r �<module> s 7� __pycache__/windows.cpython-310.pyc 0000644 00000014376 15030163624 0013162 0 ustar 00 o �7]h' � @ s� d dl mZ d dlZd dlZd dlmZ d dlmZ ddlm Z G dd� de �Z dd d �Z ddd�Z ddd�Z ddd�Zedd�e� �ZdgZdS )� )� annotationsN)� lru_cache)�Callable� )�PlatformDirsABCc @ s� e Zd ZdZed dd��Zdd�d d d �Zed d d��Zed dd��Zed dd��Z ed dd��Z ed dd��Z ed dd��Z ed dd��Z ed dd ��ZdS ) �Windowsa� `MSDN on where to store app data files <http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`, `version <platformdirs.api.PlatformDirsABC.version>`, `roaming <platformdirs.api.PlatformDirsABC.roaming>`, `opinion <platformdirs.api.PlatformDirsABC.opinion>`.�return�strc C s( | j rdnd}tj�t|��}| �|�S )z� :return: data directory tied to the user, e.g. ``%USERPROFILE%\AppData\Local\$appauthor\$appname`` (not roaming) or ``%USERPROFILE%\AppData\Roaming\$appauthor\$appname`` (roaming) � CSIDL_APPDATA�CSIDL_LOCAL_APPDATA)�roaming�os�path�normpath�get_win_folder� _append_parts)�self�constr � r �B/usr/lib/python3/dist-packages/pip/_vendor/platformdirs/windows.py� user_data_dir s zWindows.user_data_dirN�� opinion_valuer r � str | Nonec C st g }| j r0| jdur| jp| j }|�|� |�| j � |d ur'| jr'|�|� | jr0|�| j� tjj|g|�R � S )NF)�appname� appauthor�append�opinion�versionr r �join)r r r �params�authorr r r r s zWindows._append_partsc C s t j�td��}| �|�S )zT:return: data directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``�CSIDL_COMMON_APPDATA�r r r r r �r r r r r � site_data_dir- s zWindows.site_data_dirc C � | j S )zC:return: config directory tied to the user, same as `user_data_dir`�r �r r r r �user_config_dir3 � zWindows.user_config_dirc C r& )zF:return: config directory shared by the users, same as `site_data_dir`)r% r( r r r �site_config_dir8 r* zWindows.site_config_dirc C s t j�td��}| j|dd�S )z� :return: cache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g. ``%USERPROFILE%\AppData\Local\$appauthor\$appname\Cache\$version`` r �Cacher r# r$ r r r �user_cache_dir= s zWindows.user_cache_dirc C r& )zB:return: state directory tied to the user, same as `user_data_dir`r' r( r r r �user_state_dirF r* zWindows.user_state_dirc C s | j }| jr tj�|d�}|S )zy :return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it �Logs)r r r r r r$ r r r � user_log_dirK s zWindows.user_log_dirc C s t j�td��S )z` :return: documents directory tied to the user e.g. ``%USERPROFILE%\Documents`` �CSIDL_PERSONAL)r r r r r( r r r �user_documents_dirU s zWindows.user_documents_dirc C s$ t j�t j�td�d��}| �|�S )z� :return: runtime directory tied to the user, e.g. ``%USERPROFILE%\AppData\Local\Temp\$appauthor\$appname`` r �Temp)r r r r r r r$ r r r �user_runtime_dir\ s zWindows.user_runtime_dir)r r )r r r r r r )�__name__� __module__� __qualname__�__doc__�propertyr r r% r) r+ r- r. r0 r2 r4 r r r r r s* r � csidl_namer r c C sr | dkrt j�t j�t jd �d�S dddd��| �}|du r&td | � ���t j�|�}|du r7td |� ���|S ) z&Get folder from environment variables.r1 � USERPROFILE� Documents�APPDATA�ALLUSERSPROFILE� LOCALAPPDATA)r r" r N�Unknown CSIDL name: z Unset environment variable: )r r r r �environ�get� ValueError)r: � env_var_name�resultr r r � get_win_folder_from_env_varsf s �� rF c C sX ddddd�� | �}|du rtd| � ���ddl}|�|jd �}|�||�\}}t|�S ) z�Get folder from the registry. This is a fallback technique at best. I'm not sure if using the registry for this guarantees us the correct answer for all CSIDL_* names. �AppDatazCommon AppDataz Local AppData�Personal�r r" r r1 Nr@ r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)rB rC �winreg�OpenKey�HKEY_CURRENT_USER� QueryValueExr )r: �shell_folder_namerJ �key� directory�_r r r � get_win_folder_from_registryx s ��rR c C s� ddddd�� | �}|du rtd| � ���t�d�}ttd �}|j�d|dd |� td d � |D ��rBt�d�}|j� |j |d�rB|}|j S ) zGet folder with ctypes.� �# � � rI Nr@ i �windllr c s s � | ] }t |�d kV qdS )� N)�ord)�.0�cr r r � <genexpr>� s � z,get_win_folder_via_ctypes.<locals>.<genexpr>) rB rC �ctypes�create_unicode_buffer�getattr�shell32�SHGetFolderPathW�any�kernel32�GetShortPathNameW�value)r: � csidl_const�bufrW �buf2r r r �get_win_folder_via_ctypes� s" �� ri �Callable[[str], str]c C s4 t td�rtS zdd l} W tS ty t Y S w )NrW r )�hasattrr] ri rJ � ImportErrorrF rR )rJ r r r �_pick_get_win_folder� s ��rm )�maxsize)r: r r r )r rj )� __future__r r] r � functoolsr �typingr �apir r rF rR ri rm r �__all__r r r r �<module> s [ � __pycache__/__main__.cpython-310.pyc 0000644 00000002260 15030163624 0013175 0 ustar 00 o �7]h� � @ s@ d dl mZ d dlmZmZ dZd dd�Zedkr e� d S d S ) � )� annotations)� PlatformDirs� __version__) � user_data_dir�user_config_dir�user_cache_dir�user_state_dir� user_log_dir�user_documents_dir�user_runtime_dir� site_data_dir�site_config_dir�return�Nonec C s� d} d}t dt� d�� t d� t| |dd�}tD ]}t |� dt||�� �� qt d � t| |�}tD ]}t |� dt||�� �� q3t d � t| �}tD ]}t |� dt||�� �� qLt d � t| d d �}tD ]}t |� dt||�� �� qgd S )N�MyApp� MyCompanyz-- platformdirs z --z%-- app dirs (with optional 'version')z1.0)�versionz: z) -- app dirs (without optional 'version')z+ -- app dirs (without optional 'appauthor')z( -- app dirs (with disabled 'appauthor')F)� appauthor)�printr r �PROPS�getattr)�app_name� app_author�dirs�prop� r �C/usr/lib/python3/dist-packages/pip/_vendor/platformdirs/__main__.py�main s( �r �__main__N)r r )� __future__r �pip._vendor.platformdirsr r r r �__name__r r r r �<module> s � __pycache__/api.cpython-310.pyc 0000644 00000012056 15030163624 0012232 0 ustar 00 o �7]h. � @ sb d dl mZ d dlZd dlZd dlmZmZ d dlmZ ej dkr'd dl m Z G dd� de�Z dS ) � )� annotationsN)�ABC�abstractmethod)�Path)� � )�Literalc @ sR e Zd ZdZ d:d;dd�Zd<dd�Zeed=dd���Zeed=dd���Z eed=dd���Z eed=dd ���Z eed=d d ���Z eed=d d ���Z eed=d!d"���Zeed=d#d$���Zeed=d%d&���Zed>d(d)��Zed>d*d+��Zed>d,d-��Zed>d.d/��Zed>d0d1��Zed>d2d3��Zed>d4d5��Zed>d6d7��Zed>d8d9��ZdS )?�PlatformDirsABCz7 Abstract base class for platform directories. NFT�appname� str | None� appauthor�str | None | Literal[False]�version�roaming�bool� multipath�opinionc C s0 || _ || _ || _ || _ || _ || _dS )a% Create a new platform directory. :param appname: See `appname`. :param appauthor: See `appauthor`. :param version: See `version`. :param roaming: See `roaming`. :param multipath: See `multipath`. :param opinion: See `opinion`. N)r r r r r r )�selfr r r r r r � r �>/usr/lib/python3/dist-packages/pip/_vendor/platformdirs/api.py�__init__ s zPlatformDirsABC.__init__�base�str�returnc G sL t |dd � �}| jr|�| j� | jr|�| j� tjj|d g|�R � S )N� r )�listr �appendr �os�path�join)r r �paramsr r r � _append_app_name_and_version< s z,PlatformDirsABC._append_app_name_and_versionc C � dS )z(:return: data directory tied to the userNr �r r r r � user_data_dirD � z PlatformDirsABC.user_data_dirc C r" )z':return: data directory shared by usersNr r# r r r � site_data_dirI r% z PlatformDirsABC.site_data_dirc C r" )z*:return: config directory tied to the userNr r# r r r �user_config_dirN r% z PlatformDirsABC.user_config_dirc C r" )z-:return: config directory shared by the usersNr r# r r r �site_config_dirS r% z PlatformDirsABC.site_config_dirc C r" )z):return: cache directory tied to the userNr r# r r r �user_cache_dirX r% z PlatformDirsABC.user_cache_dirc C r" )z):return: state directory tied to the userNr r# r r r �user_state_dir] r% z PlatformDirsABC.user_state_dirc C r" )z':return: log directory tied to the userNr r# r r r � user_log_dirb r% z PlatformDirsABC.user_log_dirc C r" )z-:return: documents directory tied to the userNr r# r r r �user_documents_dirg r% z"PlatformDirsABC.user_documents_dirc C r" )z+:return: runtime directory tied to the userNr r# r r r �user_runtime_dirl r% z PlatformDirsABC.user_runtime_dirr c C � t | j�S )z#:return: data path tied to the user)r r$ r# r r r �user_data_pathq � z PlatformDirsABC.user_data_pathc C r. )z":return: data path shared by users)r r& r# r r r �site_data_pathv r0 z PlatformDirsABC.site_data_pathc C r. )z%:return: config path tied to the user)r r' r# r r r �user_config_path{ r0 z PlatformDirsABC.user_config_pathc C r. )z(:return: config path shared by the users)r r( r# r r r �site_config_path� r0 z PlatformDirsABC.site_config_pathc C r. )z$:return: cache path tied to the user)r r) r# r r r �user_cache_path� r0 z PlatformDirsABC.user_cache_pathc C r. )z$:return: state path tied to the user)r r* r# r r r �user_state_path� r0 z PlatformDirsABC.user_state_pathc C r. )z":return: log path tied to the user)r r+ r# r r r � user_log_path� r0 z PlatformDirsABC.user_log_pathc C r. )z(:return: documents path tied to the user)r r, r# r r r �user_documents_path� r0 z#PlatformDirsABC.user_documents_pathc C r. )z&:return: runtime path tied to the user)r r- r# r r r �user_runtime_path� r0 z!PlatformDirsABC.user_runtime_path)NNNFFT) r r r r r r r r r r r r )r r r r )r r )r r )�__name__� __module__� __qualname__�__doc__r r! �propertyr r$ r& r' r( r) r* r+ r, r- r/ r1 r2 r3 r4 r5 r6 r7 r8 r r r r r sn � + r ) � __future__r r �sys�abcr r �pathlibr � version_info�typingr r r r r r �<module> s __pycache__/unix.cpython-310.pyc 0000644 00000015307 15030163624 0012446 0 ustar 00 o �7]h� � @ s� d dl mZ d dlZd dlZd dlmZ d dlmZ ddlm Z ej � d�r-d dlm Z ndd d �Z G d d� de �Z ddd�ZdgZdS )� )� annotationsN)� ConfigParser)�Path� )�PlatformDirsABC�linux)�getuid�return�intc C s t d��)Nz should only be used on Linux)� RuntimeError� r r �?/usr/lib/python3/dist-packages/pip/_vendor/platformdirs/unix.pyr s r c @ s� e Zd ZdZed"dd��Zed"dd��Zd#d d �Zed"d d ��Zed"d d��Z ed"dd��Z ed"dd��Z ed"dd��Z ed"dd��Z ed"dd��Zed$dd��Zed$d d ��Zd%d d �Zd!S )&�UnixaD 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>`. r �strc C �, t j�dd�}|�� st 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 � zUnix.user_data_dirc C s. t j�dd�}|�� sdt 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 r r r � site_data_dir) s zUnix.site_data_dirr c s< |� tj�}� js|dd� }� fdd�|D �}tj�|�S )Nr r c s g | ] }� � tj�|���qS r )r r r r )�.0�p�r r r � <listcomp>: s z)Unix._with_multi_path.<locals>.<listcomp>)�splitr r � multipath�join)r r � path_listr r% r r! 6 s zUnix._with_multi_pathc C r )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_dir= r zUnix.user_config_dirc C s$ t j�dd�}|�� 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 r r r �site_config_dirH s zUnix.site_config_dirc C r )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_dirU r zUnix.user_cache_dirc C r )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_dir` r zUnix.user_state_dirc C s | 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)r0 �opinionr r r) r r r r � user_log_dirk s zUnix.user_log_dirc C s6 t d�}|du rtj�dd��� }|stj�d�}|S )zU :return: documents directory tied to the user, e.g. ``~/Documents`` �XDG_DOCUMENTS_DIRNr z ~/Documents)�_get_user_dirs_folderr r r r r r )r � documents_dirr r r �user_documents_diru s zUnix.user_documents_dirc C s, t j�dd�}|�� 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_DIRr z /run/user/)r r r r r r r r r r �user_runtime_dir� r zUnix.user_runtime_dirr c C � | � | 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% r r r �site_data_path� � zUnix.site_data_pathc C r< )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_path� r? zUnix.site_config_path� directoryc C s | j r |�tj�d }t|�S )Nr )r( r' r r r )r rA r r r r= � s z%Unix._first_item_as_path_if_multipathN)r r )r r r r )r r )rA r r r )�__name__� __module__� __qualname__�__doc__�propertyr r" r! r, r. r0 r2 r5 r9 r; r> r@ r= r r r r r s4 r �keyr � str | Nonec C s� t j�t� jd�}t j�|�rMt� }t|��}|�d|� � � �� W d � n1 s+w Y | |d vr8dS |d | � d�}|� dt j� d��}|S dS )zjReturn 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 r) r r, �existsr �open� read_string�readr �replacer )rG �user_dirs_config_path�parser�streamr r r r r7 � s � r7 )r r )rG r r rH )� __future__r r �sys� configparserr �pathlibr �apir �platform� startswithr r r7 �__all__r r r r �<module> s � __pycache__/android.cpython-310.pyc 0000644 00000010210 15030163624 0013067 0 ustar 00 o �7]h� � @ s~ d dl mZ d dlZd dlZd dlZd dlmZ ddlmZ G dd� de�Z edd�dd d ��Z edd�dd d��Z dgZ dS )� )� annotationsN)� lru_cache� )�PlatformDirsABCc @ s� e Zd ZdZeddd��Zeddd��Zeddd ��Zedd d ��Zedd d ��Z eddd��Z eddd��Z eddd��Z eddd��Z dS )�Androidz� Follows the guidance `from here <https://android.stackexchange.com/a/216132>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>` and `version <platformdirs.api.PlatformDirsABC.version>`. �return�strc C � | � t� d�S )zd:return: data directory tied to the user, e.g. ``/data/user/<userid>/<packagename>/files/<AppName>``�files�� _append_app_name_and_version�_android_folder��self� r �B/usr/lib/python3/dist-packages/pip/_vendor/platformdirs/android.py� user_data_dir � zAndroid.user_data_dirc C � | j S )z@:return: data directory shared by users, same as `user_data_dir`�r r r r r � site_data_dir � zAndroid.site_data_dirc C r )z :return: config directory tied to the user, e.g. ``/data/user/<userid>/<packagename>/shared_prefs/<AppName>`` � shared_prefsr r r r r �user_config_dir s zAndroid.user_config_dirc C r )zH:return: config directory shared by the users, same as `user_config_dir`)r r r r r �site_config_dir# r zAndroid.site_config_dirc C r )zj:return: cache directory tied to the user, e.g. e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>``�cacher r r r r �user_cache_dir( r zAndroid.user_cache_dirc C r )zB:return: state directory tied to the user, same as `user_data_dir`r r r r r �user_state_dir- r zAndroid.user_state_dirc C � | j }| jr tj�|d�}|S )z� :return: log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it, e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>/log`` �log�r �opinion�os�path�join�r r# r r r � user_log_dir2 � zAndroid.user_log_dirc C s t � S )zf :return: documents directory tied to the user e.g. ``/storage/emulated/0/Documents`` )�_android_documents_folderr r r r �user_documents_dir= s zAndroid.user_documents_dirc C r )z� :return: runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it, e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>/tmp`` �tmpr r% r r r �user_runtime_dirD r' zAndroid.user_runtime_dirN�r r )�__name__� __module__� __qualname__�__doc__�propertyr r r r r r r& r) r+ r r r r r s( r )�maxsizer r c C sx zddl m} | d�}|�� �� �� }W |S ty; t�d�}tj D ]}|� |�r6|� d�d } Y |S q$t d��w )z':return: base folder for the Android OSr �� autoclass�android.content.Contextz /data/(data|user/\d+)/(.+)/filesz/filesz&Cannot find path to android app folder) �jniusr4 � getFilesDir� getParentFile�getAbsolutePath� Exception�re�compile�sysr# �match�split�OSError)r4 �Context�result�patternr# r r r r P s � ��r c C sL zddl m} | d�}| d�}|�|j��� }W |S ty% d}Y |S w )z,:return: documents folder for the Android OSr r3 r5 zandroid.os.Environmentz /storage/emulated/0/Documents)r6 r4 �getExternalFilesDir�DIRECTORY_DOCUMENTSr9 r: )r4 rA � Environment� documents_dirr r r r( e s ��r( r, ) � __future__r r" r; r= � functoolsr �apir r r r( �__all__r r r r �<module> s E � macos.py 0000644 00000005137 15030163624 0006226 0 ustar 00 from __future__ import annotations import os from .api import PlatformDirsABC class MacOS(PlatformDirsABC): """ Platform directories for the macOS operating system. Follows the guidance from `Apple documentation <https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/MacOSXDirectories/MacOSXDirectories.html>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>` and `version <platformdirs.api.PlatformDirsABC.version>`. """ @property def user_data_dir(self) -> str: """:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``""" return self._append_app_name_and_version(os.path.expanduser("~/Library/Application Support/")) @property def site_data_dir(self) -> str: """:return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``""" return self._append_app_name_and_version("/Library/Application Support") @property def user_config_dir(self) -> str: """:return: config directory tied to the user, e.g. ``~/Library/Preferences/$appname/$version``""" return self._append_app_name_and_version(os.path.expanduser("~/Library/Preferences/")) @property def site_config_dir(self) -> str: """:return: config directory shared by the users, e.g. ``/Library/Preferences/$appname``""" return self._append_app_name_and_version("/Library/Preferences") @property def user_cache_dir(self) -> str: """:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``""" return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches")) @property def user_state_dir(self) -> str: """:return: state directory tied to the user, same as `user_data_dir`""" return self.user_data_dir @property def user_log_dir(self) -> str: """:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``""" return self._append_app_name_and_version(os.path.expanduser("~/Library/Logs")) @property def user_documents_dir(self) -> str: """:return: documents directory tied to the user, e.g. ``~/Documents``""" return os.path.expanduser("~/Documents") @property def user_runtime_dir(self) -> str: """:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``""" return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches/TemporaryItems")) __all__ = [ "MacOS", ] version.py 0000644 00000000120 15030163624 0006574 0 ustar 00 """ Version information """ __version__ = "2.4.1" __version_info__ = (2, 4, 1) __main__.py 0000644 00000002230 15030163624 0006633 0 ustar 00 from __future__ import annotations from pip._vendor.platformdirs import PlatformDirs, __version__ PROPS = ( "user_data_dir", "user_config_dir", "user_cache_dir", "user_state_dir", "user_log_dir", "user_documents_dir", "user_runtime_dir", "site_data_dir", "site_config_dir", ) def main() -> None: app_name = "MyApp" app_author = "MyCompany" print(f"-- platformdirs {__version__} --") print("-- app dirs (with optional 'version')") dirs = PlatformDirs(app_name, app_author, version="1.0") for prop in PROPS: print(f"{prop}: {getattr(dirs, prop)}") print("\n-- app dirs (without optional 'version')") dirs = PlatformDirs(app_name, app_author) for prop in PROPS: print(f"{prop}: {getattr(dirs, prop)}") print("\n-- app dirs (without optional 'appauthor')") dirs = PlatformDirs(app_name) for prop in PROPS: print(f"{prop}: {getattr(dirs, prop)}") print("\n-- app dirs (with disabled 'appauthor')") dirs = PlatformDirs(app_name, appauthor=False) for prop in PROPS: print(f"{prop}: {getattr(dirs, prop)}") if __name__ == "__main__": main() unix.py 0000644 00000015376 15030163624 0006115 0 ustar 00 from __future__ import annotations import os import sys from configparser import ConfigParser from pathlib import Path from .api import PlatformDirsABC if sys.platform.startswith("linux"): # pragma: no branch # no op check, only to please the type checker from os import getuid else: def getuid() -> int: raise RuntimeError("should only be used on Linux") class Unix(PlatformDirsABC): """ 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>`. """ @property def user_data_dir(self) -> str: """ :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version`` """ path = os.environ.get("XDG_DATA_HOME", "") if not path.strip(): path = os.path.expanduser("~/.local/share") return self._append_app_name_and_version(path) @property def site_data_dir(self) -> str: """ :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 default for $XDG_DATA_DIRS; only first, if multipath is False path = os.environ.get("XDG_DATA_DIRS", "") if not path.strip(): path = f"/usr/local/share{os.pathsep}/usr/share" return self._with_multi_path(path) def _with_multi_path(self, path: str) -> str: path_list = path.split(os.pathsep) if not self.multipath: path_list = path_list[0:1] path_list = [self._append_app_name_and_version(os.path.expanduser(p)) for p in path_list] return os.pathsep.join(path_list) @property def user_config_dir(self) -> str: """ :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` """ path = os.environ.get("XDG_CONFIG_HOME", "") if not path.strip(): path = os.path.expanduser("~/.config") return self._append_app_name_and_version(path) @property def site_config_dir(self) -> str: """ :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 default for $XDG_CONFIG_DIRS only first, if multipath is False path = os.environ.get("XDG_CONFIG_DIRS", "") if not path.strip(): path = "/etc/xdg" return self._with_multi_path(path) @property def user_cache_dir(self) -> str: """ :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``~/$XDG_CACHE_HOME/$appname/$version`` """ path = os.environ.get("XDG_CACHE_HOME", "") if not path.strip(): path = os.path.expanduser("~/.cache") return self._append_app_name_and_version(path) @property def user_state_dir(self) -> str: """ :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version`` """ path = os.environ.get("XDG_STATE_HOME", "") if not path.strip(): path = os.path.expanduser("~/.local/state") return self._append_app_name_and_version(path) @property def user_log_dir(self) -> str: """ :return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``log`` in it """ path = self.user_cache_dir if self.opinion: path = os.path.join(path, "log") return path @property def user_documents_dir(self) -> str: """ :return: documents directory tied to the user, e.g. ``~/Documents`` """ documents_dir = _get_user_dirs_folder("XDG_DOCUMENTS_DIR") if documents_dir is None: documents_dir = os.environ.get("XDG_DOCUMENTS_DIR", "").strip() if not documents_dir: documents_dir = os.path.expanduser("~/Documents") return documents_dir @property def user_runtime_dir(self) -> str: """ :return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or ``$XDG_RUNTIME_DIR/$appname/$version`` """ path = os.environ.get("XDG_RUNTIME_DIR", "") if not path.strip(): path = f"/run/user/{getuid()}" return self._append_app_name_and_version(path) @property def site_data_path(self) -> Path: """:return: data path shared by users. Only return first item, even if ``multipath`` is set to ``True``""" return self._first_item_as_path_if_multipath(self.site_data_dir) @property def site_config_path(self) -> Path: """:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``""" return self._first_item_as_path_if_multipath(self.site_config_dir) def _first_item_as_path_if_multipath(self, directory: str) -> Path: if self.multipath: # If multipath is True, the first path is returned. directory = directory.split(os.pathsep)[0] return Path(directory) def _get_user_dirs_folder(key: str) -> str | None: """Return directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/""" user_dirs_config_path = os.path.join(Unix().user_config_dir, "user-dirs.dirs") if os.path.exists(user_dirs_config_path): parser = ConfigParser() with open(user_dirs_config_path) as stream: # Add fake section header, so ConfigParser doesn't complain parser.read_string(f"[top]\n{stream.read()}") if key not in parser["top"]: return None path = parser["top"][key].strip('"') # Handle relative home paths path = path.replace("$HOME", os.path.expanduser("~")) return path return None __all__ = [ "Unix", ] api.py 0000644 00000011456 15030163624 0005676 0 ustar 00 from __future__ import annotations import os import sys from abc import ABC, abstractmethod from pathlib import Path if sys.version_info >= (3, 8): # pragma: no branch from typing import Literal # pragma: no cover class PlatformDirsABC(ABC): """ Abstract base class for platform directories. """ def __init__( self, appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, multipath: bool = False, opinion: bool = True, ): """ Create a new platform directory. :param appname: See `appname`. :param appauthor: See `appauthor`. :param version: See `version`. :param roaming: See `roaming`. :param multipath: See `multipath`. :param opinion: See `opinion`. """ self.appname = appname #: The name of application. self.appauthor = appauthor """ The name of the app author or distributing body for this application. Typically, it is the owning company name. Defaults to `appname`. You may pass ``False`` to disable it. """ self.version = version """ An optional version path element to append to the path. You might want to use this if you want multiple versions of your app to be able to run independently. If used, this would typically be ``<major>.<minor>``. """ self.roaming = roaming """ Whether to use the roaming appdata directory on Windows. That means that for users on a Windows network setup for roaming profiles, this user data will be synced on login (see `here <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>`_). """ self.multipath = multipath """ An optional parameter only applicable to Unix/Linux which indicates that the entire list of data dirs should be returned. By default, the first item would only be returned. """ self.opinion = opinion #: A flag to indicating to use opinionated values. def _append_app_name_and_version(self, *base: str) -> str: params = list(base[1:]) if self.appname: params.append(self.appname) if self.version: params.append(self.version) return os.path.join(base[0], *params) @property @abstractmethod def user_data_dir(self) -> str: """:return: data directory tied to the user""" @property @abstractmethod def site_data_dir(self) -> str: """:return: data directory shared by users""" @property @abstractmethod def user_config_dir(self) -> str: """:return: config directory tied to the user""" @property @abstractmethod def site_config_dir(self) -> str: """:return: config directory shared by the users""" @property @abstractmethod def user_cache_dir(self) -> str: """:return: cache directory tied to the user""" @property @abstractmethod def user_state_dir(self) -> str: """:return: state directory tied to the user""" @property @abstractmethod def user_log_dir(self) -> str: """:return: log directory tied to the user""" @property @abstractmethod def user_documents_dir(self) -> str: """:return: documents directory tied to the user""" @property @abstractmethod def user_runtime_dir(self) -> str: """:return: runtime directory tied to the user""" @property def user_data_path(self) -> Path: """:return: data path tied to the user""" return Path(self.user_data_dir) @property def site_data_path(self) -> Path: """:return: data path shared by users""" return Path(self.site_data_dir) @property def user_config_path(self) -> Path: """:return: config path tied to the user""" return Path(self.user_config_dir) @property def site_config_path(self) -> Path: """:return: config path shared by the users""" return Path(self.site_config_dir) @property def user_cache_path(self) -> Path: """:return: cache path tied to the user""" return Path(self.user_cache_dir) @property def user_state_path(self) -> Path: """:return: state path tied to the user""" return Path(self.user_state_dir) @property def user_log_path(self) -> Path: """:return: log path tied to the user""" return Path(self.user_log_dir) @property def user_documents_path(self) -> Path: """:return: documents path tied to the user""" return Path(self.user_documents_dir) @property def user_runtime_path(self) -> Path: """:return: runtime path tied to the user""" return Path(self.user_runtime_dir) windows.py 0000644 00000014447 15030163624 0006622 0 ustar 00 from __future__ import annotations import ctypes import os from functools import lru_cache from typing import Callable from .api import PlatformDirsABC class Windows(PlatformDirsABC): """`MSDN on where to store app data files <http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`, `version <platformdirs.api.PlatformDirsABC.version>`, `roaming <platformdirs.api.PlatformDirsABC.roaming>`, `opinion <platformdirs.api.PlatformDirsABC.opinion>`.""" @property def user_data_dir(self) -> str: """ :return: data directory tied to the user, e.g. ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname`` (not roaming) or ``%USERPROFILE%\\AppData\\Roaming\\$appauthor\\$appname`` (roaming) """ const = "CSIDL_APPDATA" if self.roaming else "CSIDL_LOCAL_APPDATA" path = os.path.normpath(get_win_folder(const)) return self._append_parts(path) def _append_parts(self, path: str, *, opinion_value: str | None = None) -> str: params = [] if self.appname: if self.appauthor is not False: author = self.appauthor or self.appname params.append(author) params.append(self.appname) if opinion_value is not None and self.opinion: params.append(opinion_value) if self.version: params.append(self.version) return os.path.join(path, *params) @property def site_data_dir(self) -> str: """:return: data directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname``""" path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA")) return self._append_parts(path) @property def user_config_dir(self) -> str: """:return: config directory tied to the user, same as `user_data_dir`""" return self.user_data_dir @property def site_config_dir(self) -> str: """:return: config directory shared by the users, same as `site_data_dir`""" return self.site_data_dir @property def user_cache_dir(self) -> str: """ :return: cache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g. ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname\\Cache\\$version`` """ path = os.path.normpath(get_win_folder("CSIDL_LOCAL_APPDATA")) return self._append_parts(path, opinion_value="Cache") @property def user_state_dir(self) -> str: """:return: state directory tied to the user, same as `user_data_dir`""" return self.user_data_dir @property def user_log_dir(self) -> str: """ :return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it """ path = self.user_data_dir if self.opinion: path = os.path.join(path, "Logs") return path @property def user_documents_dir(self) -> str: """ :return: documents directory tied to the user e.g. ``%USERPROFILE%\\Documents`` """ return os.path.normpath(get_win_folder("CSIDL_PERSONAL")) @property def user_runtime_dir(self) -> str: """ :return: runtime directory tied to the user, e.g. ``%USERPROFILE%\\AppData\\Local\\Temp\\$appauthor\\$appname`` """ path = os.path.normpath(os.path.join(get_win_folder("CSIDL_LOCAL_APPDATA"), "Temp")) return self._append_parts(path) def get_win_folder_from_env_vars(csidl_name: str) -> str: """Get folder from environment variables.""" if csidl_name == "CSIDL_PERSONAL": # does not have an environment name return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Documents") env_var_name = { "CSIDL_APPDATA": "APPDATA", "CSIDL_COMMON_APPDATA": "ALLUSERSPROFILE", "CSIDL_LOCAL_APPDATA": "LOCALAPPDATA", }.get(csidl_name) if env_var_name is None: raise ValueError(f"Unknown CSIDL name: {csidl_name}") result = os.environ.get(env_var_name) if result is None: raise ValueError(f"Unset environment variable: {env_var_name}") return result def get_win_folder_from_registry(csidl_name: str) -> str: """Get folder from the registry. This is a fallback technique at best. I'm not sure if using the registry for this guarantees us the correct answer for all CSIDL_* names. """ shell_folder_name = { "CSIDL_APPDATA": "AppData", "CSIDL_COMMON_APPDATA": "Common AppData", "CSIDL_LOCAL_APPDATA": "Local AppData", "CSIDL_PERSONAL": "Personal", }.get(csidl_name) if shell_folder_name is None: raise ValueError(f"Unknown CSIDL name: {csidl_name}") import winreg key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders") directory, _ = winreg.QueryValueEx(key, shell_folder_name) return str(directory) def get_win_folder_via_ctypes(csidl_name: str) -> str: """Get folder with ctypes.""" csidl_const = { "CSIDL_APPDATA": 26, "CSIDL_COMMON_APPDATA": 35, "CSIDL_LOCAL_APPDATA": 28, "CSIDL_PERSONAL": 5, }.get(csidl_name) if csidl_const is None: raise ValueError(f"Unknown CSIDL name: {csidl_name}") buf = ctypes.create_unicode_buffer(1024) windll = getattr(ctypes, "windll") # noqa: B009 # using getattr to avoid false positive with mypy type checker windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf) # Downgrade to short path name if it has highbit chars. if any(ord(c) > 255 for c in buf): buf2 = ctypes.create_unicode_buffer(1024) if windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024): buf = buf2 return buf.value def _pick_get_win_folder() -> Callable[[str], str]: if hasattr(ctypes, "windll"): return get_win_folder_via_ctypes try: import winreg # noqa: F401 except ImportError: return get_win_folder_from_env_vars else: return get_win_folder_from_registry get_win_folder = lru_cache(maxsize=None)(_pick_get_win_folder()) __all__ = [ "Windows", ] android.py 0000644 00000007654 15030163624 0006552 0 ustar 00 from __future__ import annotations import os import re import sys from functools import lru_cache from .api import PlatformDirsABC class Android(PlatformDirsABC): """ Follows the guidance `from here <https://android.stackexchange.com/a/216132>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>` and `version <platformdirs.api.PlatformDirsABC.version>`. """ @property def user_data_dir(self) -> str: """:return: data directory tied to the user, e.g. ``/data/user/<userid>/<packagename>/files/<AppName>``""" return self._append_app_name_and_version(_android_folder(), "files") @property def site_data_dir(self) -> str: """:return: data directory shared by users, same as `user_data_dir`""" return self.user_data_dir @property def user_config_dir(self) -> str: """ :return: config directory tied to the user, e.g. ``/data/user/<userid>/<packagename>/shared_prefs/<AppName>`` """ return self._append_app_name_and_version(_android_folder(), "shared_prefs") @property def site_config_dir(self) -> str: """:return: config directory shared by the users, same as `user_config_dir`""" return self.user_config_dir @property def user_cache_dir(self) -> str: """:return: cache directory tied to the user, e.g. e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>``""" return self._append_app_name_and_version(_android_folder(), "cache") @property def user_state_dir(self) -> str: """:return: state directory tied to the user, same as `user_data_dir`""" return self.user_data_dir @property def user_log_dir(self) -> str: """ :return: log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it, e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>/log`` """ path = self.user_cache_dir if self.opinion: path = os.path.join(path, "log") return path @property def user_documents_dir(self) -> str: """ :return: documents directory tied to the user e.g. ``/storage/emulated/0/Documents`` """ return _android_documents_folder() @property def user_runtime_dir(self) -> str: """ :return: runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it, e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>/tmp`` """ path = self.user_cache_dir if self.opinion: path = os.path.join(path, "tmp") return path @lru_cache(maxsize=1) def _android_folder() -> str: """:return: base folder for the Android OS""" try: # First try to get path to android app via pyjnius from jnius import autoclass Context = autoclass("android.content.Context") # noqa: N806 result: str = Context.getFilesDir().getParentFile().getAbsolutePath() except Exception: # if fails find an android folder looking path on the sys.path pattern = re.compile(r"/data/(data|user/\d+)/(.+)/files") for path in sys.path: if pattern.match(path): result = path.split("/files")[0] break else: raise OSError("Cannot find path to android app folder") return result @lru_cache(maxsize=1) def _android_documents_folder() -> str: """:return: documents folder for the Android OS""" # Get directories with pyjnius try: from jnius import autoclass Context = autoclass("android.content.Context") # noqa: N806 Environment = autoclass("android.os.Environment") # noqa: N806 documents_dir: str = Context.getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS).getAbsolutePath() except Exception: documents_dir = "/storage/emulated/0/Documents" return documents_dir __all__ = [ "Android", ] __init__.py 0000644 00000030604 15030163624 0006660 0 ustar 00 """ Utilities for determining application-specific dirs. See <https://github.com/platformdirs/platformdirs> for details and usage. """ from __future__ import annotations import importlib import os import sys from pathlib import Path from typing import TYPE_CHECKING if TYPE_CHECKING: from pip._vendor.typing_extensions import Literal # pragma: no cover from .api import PlatformDirsABC from .version import __version__, __version_info__ def _set_platform_dir_class() -> type[PlatformDirsABC]: if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system": module, name = "pip._vendor.platformdirs.android", "Android" elif sys.platform == "win32": module, name = "pip._vendor.platformdirs.windows", "Windows" elif sys.platform == "darwin": module, name = "pip._vendor.platformdirs.macos", "MacOS" else: module, name = "pip._vendor.platformdirs.unix", "Unix" result: type[PlatformDirsABC] = getattr(importlib.import_module(module), name) return result PlatformDirs = _set_platform_dir_class() #: Currently active platform AppDirs = PlatformDirs #: Backwards compatibility with appdirs def user_data_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: data directory tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_data_dir def site_data_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, multipath: bool = False, ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :returns: data directory shared by users """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, multipath=multipath).site_data_dir def user_config_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: config directory tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_config_dir def site_config_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, multipath: bool = False, ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :returns: config directory shared by the users """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, multipath=multipath).site_config_dir def user_cache_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :returns: cache directory tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_cache_dir def user_state_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: state directory tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_state_dir def user_log_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :returns: log directory tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_log_dir def user_documents_dir() -> str: """ :returns: documents directory tied to the user """ return PlatformDirs().user_documents_dir def user_runtime_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :returns: runtime directory tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_runtime_dir def user_data_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: data path tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_data_path def site_data_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, multipath: bool = False, ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `multipath <platformdirs.api.PlatformDirsABC.multipath>`. :returns: data path shared by users """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, multipath=multipath).site_data_path def user_config_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: config path tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_config_path def site_config_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, multipath: bool = False, ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :returns: config path shared by the users """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, multipath=multipath).site_config_path def user_cache_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :returns: cache path tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_cache_path def user_state_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`. :returns: state path tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_state_path def user_log_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :returns: log path tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_log_path def user_documents_path() -> Path: """ :returns: documents path tied to the user """ return PlatformDirs().user_documents_path def user_runtime_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :returns: runtime path tied to the user """ return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_runtime_path __all__ = [ "__version__", "__version_info__", "PlatformDirs", "AppDirs", "PlatformDirsABC", "user_data_dir", "user_config_dir", "user_cache_dir", "user_state_dir", "user_log_dir", "user_documents_dir", "user_runtime_dir", "site_data_dir", "site_config_dir", "user_data_path", "user_config_path", "user_cache_path", "user_state_path", "user_log_path", "user_documents_path", "user_runtime_path", "site_data_path", "site_config_path", ]
| ver. 1.4 |
Github
|
.
| PHP 8.2.28 | Generation time: 0.02 |
proxy
|
phpinfo
|
Settings