+
    }iW                       R t ^ RIHt ^ RIt^ RIt^ RIHt ^RIHt ^RI	H
t
 ^RI	Ht ]'       d   ^ RIHt ^ RIHt ]P                   R	8X  d   ^ R
IHt M]P                   R8X  d   ^ RIHt M^ RIHt R R lt]'       d   ]tM]! 4       t]tRuR R lltRuR R lltRuR R lltRuR R lltRvR R lltRvR R llt RuR R llt!RvR R llt"R  R! lt#R" R# lt$R$ R% lt%R& R' lt&R( R) lt'R* R+ lt(RvR, R- llt)RvR. R/ llt*RuR0 R1 llt+RuR2 R3 llt,RuR4 R5 llt-RuR6 R7 llt.RvR8 R9 llt/RvR: R; llt0RuR< R= llt1RvR> R? llt2R@ RA lt3RB RC lt4RD RE lt5RF RG lt6RH RI lt7RJ RK lt8RvRL RM llt9RvRN RO llt:. RPNRQNRRNRSNRTNRUNRVNRWNRXNRYNRZNR[NR\NR]NR^NR_NR`NRaNRbNRcNRdNReNRfNRgNRhNRiNRjNRkNRlNRmNRnNRoNRpNRqNRrNRsNRtNt;R# )wa^  
Utilities for determining application-specific dirs.

Provides convenience functions (e.g. :func:`user_data_dir`, :func:`user_config_path`), a :data:`PlatformDirs` class
that auto-detects the current platform, and the :class:`~platformdirs.api.PlatformDirsABC` base class.

See <https://github.com/platformdirs/platformdirs> for details and usage.

)annotationsN)TYPE_CHECKING)PlatformDirsABC)__version__)__version_tuple__)Path)Literalwin32)Windowsdarwin)MacOS)Unixc                   V ^8  d   QhRR/# )   returnztype[PlatformDirsABC] )formats   "g/Users/ahmad/.openclaw/workspace/my-crawler/.venv/lib/python3.14/site-packages/platformdirs/__init__.py__annotate__r   !   s      !6     c                 $   \         P                  ! R 4      R8X  dq   \         P                  ! R4      R8X  dV   \         P                  ! R4      '       g   \         P                  ! R4      '       d   \        # ^ RIHp  V ! 4       e	   ^ RIHp V# \        # )ANDROID_DATAz/dataANDROID_ROOTz/systemSHELLPREFIX)_android_folder)Android)osgetenv_Resultplatformdirs.androidr   r   )r   r   s     r   _set_platform_dir_classr!   !   s^    	yy G+		.0IY0V99W8!4!4N8(4NNr   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r   appname
str | None	appauthorstr | Literal[False] | Noneversionroamingboolensure_existsr   strr   )r   s   "r   r   r   8   sD      *  	
  	r   c                6    \        V VVVVR7      P                  # )a  
: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.roaming>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: data directory tied to the user
r$   r&   r(   r)   r+   )PlatformDirsuser_data_dirr.   s   &&&&&r   r0   r0   8   '     # mr   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r   r$   r%   r&   r'   r(   	multipathr*   r+   r   r,   r   )r   s   "r   r   r   P   sD      *  	
  	r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: data directory shared by users
r$   r&   r(   r4   r+   )r/   site_data_dirr6   s   &&&&&r   r7   r7   P   s'     # mr   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r#   r   )r   s   "r   r   r   h   sD      *  	
  	r   c                6    \        V VVVVR7      P                  # )a  
: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.roaming>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: config directory tied to the user
r.   )r/   user_config_dirr.   s   &&&&&r   r:   r:   h   '     # or   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r3   r   )r   s   "r   r   r      sD      *  	
  	r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: config directory shared by users
r6   )r/   site_config_dirr6   s   &&&&&r   r>   r>      s'     # or   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r   r$   r%   r&   r'   r(   opinionr*   r+   r   r,   r   )r   s   "r   r   r      D      *  	
  	r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: cache directory tied to the user
r$   r&   r(   rA   r+   )r/   user_cache_dirrD   s   &&&&&r   rE   rE      '     # nr   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r@   r   )r   s   "r   r   r      rB   r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: cache directory shared by users
rD   )r/   site_cache_dirrD   s   &&&&&r   rI   rI      rF   r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r#   r   )r   s   "r   r   r      rB   r   c                6    \        V VVVVR7      P                  # )a  
: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.roaming>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: state directory tied to the user
r.   )r/   user_state_dirr.   s   &&&&&r   rL   rL      rF   r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r@   r   )r   s   "r   r   r      sD      *  	
  	r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: log directory tied to the user
rD   )r/   user_log_dirrD   s   &&&&&r   rO   rO      s'     # lr   c                   V ^8  d   QhRR/# r   r   r,   r   )r   s   "r   r   r           - -C -r   c                 *    \        4       P                  # )z.:returns: documents directory tied to the user)r/   user_documents_dirr   r   r   rT   rT          >,,,r   c                   V ^8  d   QhRR/# rQ   r   )r   s   "r   r   r      rR   r   c                 *    \        4       P                  # )z.:returns: downloads directory tied to the user)r/   user_downloads_dirr   r   r   rX   rX      rU   r   c                   V ^8  d   QhRR/# rQ   r   )r   s   "r   r   r     s     , ,3 ,r   c                 *    \        4       P                  # )z-:returns: pictures directory tied to the user)r/   user_pictures_dirr   r   r   r[   r[         >+++r   c                   V ^8  d   QhRR/# rQ   r   )r   s   "r   r   r     s     * * *r   c                 *    \        4       P                  # )z+:returns: videos directory tied to the user)r/   user_videos_dirr   r   r   r_   r_         >)))r   c                   V ^8  d   QhRR/# rQ   r   )r   s   "r   r   r     s     ) ) )r   c                 *    \        4       P                  # )z*:returns: music directory tied to the user)r/   user_music_dirr   r   r   rc   rc     s    >(((r   c                   V ^8  d   QhRR/# rQ   r   )r   s   "r   r   r     s     + +# +r   c                 *    \        4       P                  # )z,:returns: desktop directory tied to the user)r/   user_desktop_dirr   r   r   rf   rf         >***r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r@   r   )r   s   "r   r   r     D      *  	
  	r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: runtime directory tied to the user
rD   )r/   user_runtime_dirrD   s   &&&&&r   rk   rk     (     # r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r@   r   )r   s   "r   r   r   .  ri   r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: runtime directory shared by users
rD   )r/   site_runtime_dirrD   s   &&&&&r   ro   ro   .  rl   r   c               0    V ^8  d   Qh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   s   "r   r   r   F  sD      *  	
  
r   c                6    \        V VVVVR7      P                  # )a  
: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.roaming>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: data path tied to the user
r.   )r/   user_data_pathr.   s   &&&&&r   rs   rs   F  rF   r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r   r$   r%   r&   r'   r(   r4   r*   r+   r   r   r   )r   s   "r   r   r   ^  sD      *  	
  
r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: data path shared by users
r6   )r/   site_data_pathr6   s   &&&&&r   rw   rw   ^  s'     # nr   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# rq   r   )r   s   "r   r   r   v  sD      *  	
  
r   c                6    \        V VVVVR7      P                  # )a  
: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.roaming>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: config path tied to the user
r.   )r/   user_config_pathr.   s   &&&&&r   rz   rz   v  rl   r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# ru   r   )r   s   "r   r   r     sD      *  	
  
r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: config path shared by users
r6   )r/   site_config_pathr6   s   &&&&&r   r}   r}     s(     # r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r   r$   r%   r&   r'   r(   rA   r*   r+   r   r   r   )r   s   "r   r   r     D      *  	
  
r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: cache path shared by users
rD   )r/   site_cache_pathrD   s   &&&&&r   r   r     r;   r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r   r   )r   s   "r   r   r     r   r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: cache path tied to the user
rD   )r/   user_cache_pathrD   s   &&&&&r   r   r     r;   r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# rq   r   )r   s   "r   r   r     r   r   c                6    \        V VVVVR7      P                  # )a  
: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.roaming>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: state path tied to the user
r.   )r/   user_state_pathr.   s   &&&&&r   r   r     r;   r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r   r   )r   s   "r   r   r     sD      *  	
  
r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: log path tied to the user
rD   )r/   user_log_pathrD   s   &&&&&r   r   r     r1   r   c                   V ^8  d   QhRR/# r   r   r   r   )r   s   "r   r   r          . .T .r   c                 *    \        4       P                  # )z):returns: documents path tied to the user)r/   user_documents_pathr   r   r   r   r         >---r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r     r   r   c                 *    \        4       P                  # )z):returns: downloads path tied to the user)r/   user_downloads_pathr   r   r   r   r     r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r     s     - -D -r   c                 *    \        4       P                  # )z(:returns: pictures path tied to the user)r/   user_pictures_pathr   r   r   r   r     rU   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r     s     + +$ +r   c                 *    \        4       P                  # )z&:returns: videos path tied to the user)r/   user_videos_pathr   r   r   r   r     rg   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r     s     * * *r   c                 *    \        4       P                  # )z%:returns: music path tied to the user)r/   user_music_pathr   r   r   r   r     r`   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r     s     , ,4 ,r   c                 *    \        4       P                  # )z':returns: desktop path tied to the user)r/   user_desktop_pathr   r   r   r   r     r\   r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r   r   )r   s   "r   r   r   $  D      *  	
  
r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: runtime path tied to the user
rD   )r/   user_runtime_pathrD   s   &&&&&r   r   r   $  (     # r   c               0    V ^8  d   QhRRRRRRRRRRR	R
/# r   r   )r   s   "r   r   r   <  r   r   c                6    \        V VVVVR7      P                  # )a  
: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>`.
:param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
:returns: runtime path shared by users
rD   )r/   site_runtime_pathrD   s   &&&&&r   r   r   <  r   r   AppDirsr/   r   r   __version_info__rI   r   r>   r}   r7   rw   ro   r   rE   r   r:   rz   r0   rs   rf   r   rT   r   rX   r   rO   r   rc   r   r[   r   rk   r   rL   r   r_   r   )NNNFF)NNNTF)<__doc__
__future__r   r   systypingr   apir   r(   r   r   r   pathlibr   r   platformplatformdirs.windowsr
   r   platformdirs.macosr   platformdirs.unixr   r!   r/   r   r0   r7   r:   r>   rE   rI   rL   rO   rT   rX   r[   r_   rc   rf   rk   ro   rs   rw   rz   r}   r   r   r   r   r   r   r   r   r   r   r   r   __all__r   r   r   <module>r      s   # 	 
       :<<77\\X31 L*,L
00000000-
-
,
*
)
+
0000000000.
.
-
+
*
,
00&&& & 	&
 & & & & & & & & & & &  !&" #&$ %&& '&( )&* +&, -&. /&0 1&2 3&4 5&6 7&8 9&: ;&< =&> ?&@ A&B C&D E&F G&H I&J K&r   