o 6f@sdZddlmZddlZddlZddlZddlmZddlm Z ddl m Z Gdd d e Z edd dd dZ edd dddZedd dddZedd dddZedd dddZedd dddZd gZdS)zAndroid.) annotationsN) lru_cache)cast)PlatformDirsABCc@seZdZdZed%ddZed%ddZed%dd Zed%d d Zed%d d Z ed%ddZ ed%ddZ ed%ddZ ed%ddZ ed%ddZed%ddZed%ddZed%ddZed%ddZed%d d!Zed%d"d#Zd$S)&Androida$ Follows the guidance `from here `_. Makes use of the `appname `, `version `, `ensure_exists `. returnstrcC|tttdS)zd:return: data directory tied to the user, e.g. ``/data/user///files/``files_append_app_name_and_versionrr _android_folderselfrM/home/ertert/spirit/venv/lib/python3.10/site-packages/platformdirs/android.py user_data_dirzAndroid.user_data_dircC|jS)z@:return: data directory shared by users, same as `user_data_dir`rrrrr site_data_dirzAndroid.site_data_dircCr )z :return: config directory tied to the user, e.g. ``/data/user///shared_prefs/`` shared_prefsr rrrruser_config_dir szAndroid.user_config_dircCr)zH:return: config directory shared by the users, same as `user_config_dir`)rrrrrsite_config_dir(rzAndroid.site_config_dircCr )zj:return: cache directory tied to the user, e.g. e.g. ``/data/user///cache/``cacher rrrruser_cache_dir-rzAndroid.user_cache_dircCr)zB:return: cache directory shared by users, same as `user_cache_dir`)rrrrrsite_cache_dir2rzAndroid.site_cache_dircCr)zB:return: state directory tied to the user, same as `user_data_dir`rrrrruser_state_dir7rzAndroid.user_state_dircC|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///cache//log`` logropinionospathjoinrr%rrr user_log_dir<zAndroid.user_log_dircCtS)zT:return: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``)_android_documents_folderrrrruser_documents_dirGrzAndroid.user_documents_dircCr*)zT:return: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``)_android_downloads_folderrrrruser_downloads_dirLrzAndroid.user_downloads_dircCr*)zR:return: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``)_android_pictures_folderrrrruser_pictures_dirQrzAndroid.user_pictures_dircCr*)zS:return: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``)_android_videos_folderrrrruser_videos_dirVrzAndroid.user_videos_dircCr*)zL:return: music directory tied to the user e.g. ``/storage/emulated/0/Music``)_android_music_folderrrrruser_music_dir[rzAndroid.user_music_dircCsdS)zP:return: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``z/storage/emulated/0/Desktoprrrrruser_desktop_dir`szAndroid.user_desktop_dircCr )z :return: runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it, e.g. ``/data/user///cache//tmp`` tmpr"r'rrruser_runtime_direr)zAndroid.user_runtime_dircCr)zF:return: runtime directory shared by users, same as `user_runtime_dir`)r7rrrrsite_runtime_dirprzAndroid.site_runtime_dirNrr )__name__ __module__ __qualname____doc__propertyrrrrrrrr(r,r.r0r2r4r5r7r8rrrrrsD                r)maxsizer str | NonecCszzddlm}|d}|}W|Sty<td}tj D]}| |r6| dd}Y|Sq$d}Y|Sw)zE:return: base folder for the Android OS or None if it cannot be foundr autoclassandroid.content.Contextz /data/(data|user/\d+)/(.+)/filesz/filesN) jniusrB getFilesDir getParentFilegetAbsolutePath Exceptionrecompilesysr%matchsplit)rBcontextresultpatternr%rrrrvs     rr cCLzddlm}|d}|d}||j}W|Sty%d}Y|Sw)z,:return: documents folder for the Android OSrrArCandroid.os.Environmentz/storage/emulated/0/Documents)rDrBgetExternalFilesDirDIRECTORY_DOCUMENTSrGrH)rBrN environment documents_dirrrrr+  r+cCrQ)z,:return: downloads folder for the Android OSrrArCrRz/storage/emulated/0/Downloads)rDrBrSDIRECTORY_DOWNLOADSrGrH)rBrNrU downloads_dirrrrr-rWr-cCrQ)z+:return: pictures folder for the Android OSrrArCrRz/storage/emulated/0/Pictures)rDrBrSDIRECTORY_PICTURESrGrH)rBrNrU pictures_dirrrrr/rWr/cCrQ)z):return: videos folder for the Android OSrrArCrRz/storage/emulated/0/DCIM/Camera)rDrBrSDIRECTORY_DCIMrGrH)rBrNrU videos_dirrrrr1rWr1cCrQ)z(:return: music folder for the Android OSrrArCrRz/storage/emulated/0/Music)rDrBrSDIRECTORY_MUSICrGrH)rBrNrU music_dirrrrr3rWr3)rr@r9)r= __future__rr$rIrK functoolsrtypingrapirrrr+r-r/r1r3__all__rrrrs.    h