j!dZddlmZddlZddlZddlmZddlmZm Z ddl m Z ddl m Z er dd lmZdd lmZejd krdd lmZn*ejd krddlmZnejdkrddlmZnddlmZdadZereZn eZeZ dbdcd Z ddded"Z dbdcd#Z ddded$Z! dfdgd'Z" dhdd(did)Z# dbdcd*Z$ djdkd+Z% dfdd,dld-Z& dhdmd.Z'dnd/Z(dnd0Z)dnd1Z*dnd2Z+dnd3Z,dnd4Z-dnd5Z.dnd6Z/dnd7Z0dnd8Z1 dodddd9dcd:Z2dd;dpd<Z3dnd=Z4 doddd>dqd?Z5 drdddd@dsdAZ6 dfdgdBZ7 dhdmdCZ8 dbdtdEZ9 dddudFZ: dbdtdGZ; dddudHZ< dhdd(dvdIZ= dfdwdJZ> dbdtdKZ? djdxdLZ@ dfdd,dydMZA dhdzdNZBd{dOZCd{dPZDd{dQZEd{dRZFd{dSZGd{dTZHd{dUZId{dVZJd{dWZKd{dXZL dodddd9dtdYZMdd;d|dZZNd{d[ZO doddd>d}d\ZP drdddd@d~d]ZQ dfdwd^ZR dhdzd_ZSgd`ZTdS)aUtilities 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 for details and usage. PYTEST_DONT_REWRITE: Applications may import platformdirs before starting pytest. ) annotationsN) TYPE_CHECKING)PlatformDirsABCRuntimeDirWarning) __version__)__version_tuple__)Path)Literalwin32)Windowsdarwin)MacOSios)IOS)Unixreturntype[PlatformDirsABC]c(ttds0tjddkr_tjddkrGtjdstjdrtSdd lm}|dd lm}|StS) Ngetandroidapilevel ANDROID_DATAz/data ANDROID_ROOTz/systemSHELLPREFIXr)_android_folder)Android)hasattrsysosgetenv_Resultplatformdirs.androidrr)rrs FC:\Projects\Historical\venv\Lib\site-packages\platformdirs/__init__.py_set_platform_dir_classr$$ss())  .!!W,,>1J1Ji1W1W 9W   8!4!4 N888888 ?   ( 4 4 4 4 4 4N NFappname str | None appauthorstr | Literal[False] | Noneversionroamingbool ensure_existsuse_site_for_rootstrc6t||||||jS)a::param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param roaming: See `roaming `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: data directory tied to the user r&r(r*r+r-r.) PlatformDirs user_data_dirr1s r#r3r3>s2$ #+    r% multipathc4t|||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param multipath: See `multipath `. :param ensure_exists: See `ensure_exists `. :returns: data directory shared by users r&r(r*r4r-)r2 site_data_dirr6s r#r7r7Zs/ #      r%c6t||||||jS)a<:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param roaming: See `roaming `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: config directory tied to the user r1)r2user_config_dirr1s r#r9r9s2$ #+    r%c4t|||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param multipath: See `multipath `. :param ensure_exists: See `ensure_exists `. :returns: config directory shared by users r6)r2site_config_dirr6s r#r<r<s/ #      r%Topinionc6t||||||jS)a;:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: cache directory tied to the user r&r(r*r=r-r.)r2user_cache_dirr?s r#r@r@2$ #+    r%)r4c6t||||||jS)a":param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :param multipath: See `multipath `. :returns: cache directory shared by users r&r(r*r4r=r-)r2site_cache_dirr&r(r*r=r-r4s r#rDrDs2& #    r%c6t||||||jS)a;:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param roaming: See `roaming `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: state directory tied to the user r1)r2user_state_dirr1s r#rGrGrAr%c2t||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param ensure_exists: See `ensure_exists `. :returns: state directory shared by users r&r(r*r-)r2site_state_dirrIs r#rJrJs, #      r%)r+c 8t|||||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :param roaming: See `roaming `. :returns: log directory tied to the user r&r(r*r+r=r-r.)r2 user_log_dirr&r(r*r=r-r.r+s r#rMrMs5* #+   r%c4t|||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :returns: log directory shared by users r&r(r*r=r-)r2 site_log_dirrPs r#rQrQ3s/ #      r%c(tjS)z.:returns: documents directory tied to the user)r2user_documents_dirr%r#rSrSL >> ,,r%c(tjS)z.:returns: downloads directory tied to the user)r2user_downloads_dirrTr%r#rWrWQrUr%c(tjS)z-:returns: pictures directory tied to the user)r2user_pictures_dirrTr%r#rYrYV >> ++r%c(tjS)z+:returns: videos directory tied to the user)r2user_videos_dirrTr%r#r\r\[ >> ))r%c(tjS)z*:returns: music directory tied to the user)r2user_music_dirrTr%r#r_r_` >> ((r%c(tjS)z,:returns: desktop directory tied to the user)r2user_desktop_dirrTr%r#rbrbe >> **r%c(tjS)z-:returns: projects directory tied to the user)r2user_projects_dirrTr%r#rerejrZr%c(tjS)z1:returns: public share directory tied to the user)r2user_publicshare_dirrTr%r#rgrgos >> ..r%c(tjS)z.:returns: templates directory tied to the user)r2user_templates_dirrTr%r#riritrUr%c(tjS)z*:returns: fonts directory tied to the user)r2user_fonts_dirrTr%r#rkrkyr`r%)r+r-r.c6t||||||jS)a@:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param roaming: See `roaming `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: preference directory tied to the user r1)r2user_preference_dirr1s r#rmrm~s2& #+    r%r.c,t|jS)z:param use_site_for_root: See `use_site_for_root `. :returns: bin directory tied to the user rn)r2 user_bin_dirrns r#rprps *; < < < IIr%c(tjS)z':returns: bin directory shared by users)r2 site_bin_dirrTr%r#rrrrs >> &&r%)r-r.c4t|||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: applications directory tied to the user r&r(r*r-r.)r2user_applications_dirrts r#rurus/" #+      r%)r&r(r*c4t|||||jS)a:param multipath: See `multipath `. :param ensure_exists: See `ensure_exists `. :param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :returns: applications directory shared by users r6)r2site_applications_dirr4r-r&r(r*s r#rwrws/" #      r%c6t||||||jS)a=:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: runtime directory tied to the user r?)r2user_runtime_dirr?s r#rzrz2$ #+    r%c4t|||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :returns: runtime directory shared by users rP)r2site_runtime_dirrPs r#r}r}s/ #      r%r c6t||||||jS)a5:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param roaming: See `roaming `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: data path tied to the user r1)r2user_data_pathr1s r#rrrAr%c4t|||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param multipath: See `multipath `. :param ensure_exists: See `ensure_exists `. :returns: data path shared by users r6)r2site_data_pathr6s r#rr.s/ #      r%c6t||||||jS)a7:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param roaming: See `roaming `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: config path tied to the user r1)r2user_config_pathr1s r#rrGr{r%c4t|||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param multipath: See `multipath `. :param ensure_exists: See `ensure_exists `. :returns: config path shared by users r6)r2site_config_pathr6s r#rrcs/ #      r%c6t||||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :param multipath: See `multipath `. :returns: cache path shared by users rC)r2site_cache_pathrEs r#rr|s2& #    r%c6t||||||jS)a6:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: cache path tied to the user r?)r2user_cache_pathr?s r#rrr:r%c6t||||||jS)a6:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param roaming: See `roaming `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: state path tied to the user r1)r2user_state_pathr1s r#rrr:r%c2t||||jS)a{:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param ensure_exists: See `ensure_exists `. :returns: state path shared by users rI)r2site_state_pathrIs r#rrs, #      r%c 8t|||||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :param roaming: See `roaming `. :returns: log path tied to the user rL)r2 user_log_pathrNs r#rrs5* #+   r%c4t|||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :returns: log path shared by users rP)r2 site_log_pathrPs r#rrs/ #      r%c(tjS)z):returns: documents path tied to the user)r2user_documents_pathrTr%r#rr  >> --r%c(tjS)z):returns: downloads path tied to the user)r2user_downloads_pathrTr%r#rr%rr%c(tjS)z(:returns: pictures path tied to the user)r2user_pictures_pathrTr%r#rr*rUr%c(tjS)z&:returns: videos path tied to the user)r2user_videos_pathrTr%r#rr/rcr%c(tjS)z%:returns: music path tied to the user)r2user_music_pathrTr%r#rr4r]r%c(tjS)z':returns: desktop path tied to the user)r2user_desktop_pathrTr%r#rr9rZr%c(tjS)z(:returns: projects path tied to the user)r2user_projects_pathrTr%r#rr>rUr%c(tjS)z,:returns: public share path tied to the user)r2user_publicshare_pathrTr%r#rrCs >> //r%c(tjS)z):returns: templates path tied to the user)r2user_templates_pathrTr%r#rrHrr%c(tjS)z%:returns: fonts path tied to the user)r2user_fonts_pathrTr%r#rrMr]r%c6t||||||jS)a;:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param roaming: See `roaming `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: preference path tied to the user r1)r2user_preference_pathr1s r#rrRs2& #+    r%c,t|jS)z:param use_site_for_root: See `use_site_for_root `. :returns: bin path tied to the user rn)r2 user_bin_pathrns r#rros *; < < < JJr%c(tjS)z":returns: bin path shared by users)r2 site_bin_pathrTr%r#rrxs >> ''r%c4t|||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: applications path tied to the user rt)r2user_applications_pathrts r#rr}s/" #+      r%c4t|||||jS)a:param multipath: See `multipath `. :param ensure_exists: See `ensure_exists `. :param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :returns: applications path shared by users r6)r2site_applications_pathrxs r#rrs/" #      r%c6t||||||jS)a8:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :param use_site_for_root: See `use_site_for_root `. :returns: runtime path tied to the user r?)r2user_runtime_pathr?s r#rrs2$ #+    r%c4t|||||jS)a:param appname: See `appname `. :param appauthor: See `appauthor `. :param version: See `version `. :param opinion: See `opinion `. :param ensure_exists: See `ensure_exists `. :returns: runtime path shared by users rP)r2site_runtime_pathrPs r#rrs/ #      r%)<AppDirsr2rrr__version_info__rwrrrrrDrr<rr7rrQrr}rrJrrurrprr@rr9rr3rrbrrSrrWrrkrrMrr_rrYrrmrrerrgrrzrrGrrirr\r)rr)NNNFFF)r&r'r(r)r*r'r+r,r-r,r.r,rr/)NNNFF) r&r'r(r)r*r'r4r,r-r,rr/)NNNTFF)r&r'r(r)r*r'r=r,r-r,r.r,rr/)NNNTF)r&r'r(r)r*r'r=r,r-r,r4r,rr/)NNNF) r&r'r(r)r*r'r-r,rr/)r&r'r(r)r*r'r=r,r-r,r.r,r+r,rr/) r&r'r(r)r*r'r=r,r-r,rr/)rr/)NNN)r.r,rr/) r&r'r(r)r*r'r-r,r.r,rr/)FF) r4r,r-r,r&r'r(r)r*r'rr/)r&r'r(r)r*r'r+r,r-r,r.r,rr ) r&r'r(r)r*r'r4r,r-r,rr )r&r'r(r)r*r'r=r,r-r,r4r,rr )r&r'r(r)r*r'r=r,r-r,r.r,rr ) r&r'r(r)r*r'r-r,rr )r&r'r(r)r*r'r=r,r-r,r.r,r+r,rr ) r&r'r(r)r*r'r=r,r-r,rr )rr )r.r,rr ) r&r'r(r)r*r'r-r,r.r,rr ) r4r,r-r,r&r'r(r)r*r'rr )U__doc__ __future__rrrtypingrapirrr*rr rpathlibr r platformplatformdirs.windowsr r!platformdirs.macosrplatformdirs.iosrplatformdirs.unixrr$r2rr3r7r9r<r@rDrGrJrMrQrSrWrYr\r_rbrergrirkrmrprrrurwrzr}rrrrrrrrrrrrrrrrrrrrrrrrrrr__all__rTr%r#rs   #""""" 33333333 ::::::<77777777\X3333333\U///////111111$-LL**,,L -1# :-1 4-1# :-1 4-1# :-1 <-1# :-1 .-1# B-1 2---- ---- ,,,, **** )))) ++++ ,,,, //// ---- )))) -1 #:/4JJJJJJ'''' -1  # 6-1 6-1# :-1 4-1# :-1 4-1# :-1 4-1 <-1# :-1# :-1 .-1# B-1 2.... .... ---- ++++ **** ,,,, ---- 0000 .... **** -1 #:05KKKKKK(((( -1  # 6-1 6-1# :-1 2= = = r%