3i_)0dZddlmZddlZddlZddlZddlmZddlm Z m Z ddl m Z Gdd e Z ed dd Zed dd Zed dd Zed ddZed ddZed ddZd gZy)zAndroid.) annotationsN) lru_cache) TYPE_CHECKINGcast)PlatformDirsABCceZdZdZeddZeddZeddZeddZeddZ eddZ eddZ edd Z edd Z edd Zedd Zedd ZeddZeddZeddZeddZeddZeddZeddZeddZeddZeddZy)AndroidaPlatform directories for Android. Follows the guidance `from here `_. Directories are typically located under the app's private storage (``/data/user///``). Makes use of the `appname `, `version `, `opinion `, `ensure_exists `. cJ|jtdtdS)ze:returns: data directory tied to the user, e.g. ``/data/user///files/``strfiles_append_app_name_and_versionr_android_folderselfs G/var/www/opsc/venv/lib/python3.12/site-packages/platformdirs/android.py user_data_dirzAndroid.user_data_dir"00e_=N1OQXYYc|jS)zA:returns: data directory shared by users, same as `user_data_dir`rrs r site_data_dirzAndroid.site_data_dir!!!rcJ|jtdtdS)zn:returns: config directory tied to the user, e.g. ``/data/user///shared_prefs/``r shared_prefsrrs ruser_config_dirzAndroid.user_config_dir$s"00e_=N1OQ_``rc|jS)zE:returns: config directory shared by users, same as `user_config_dir`)rrs rsite_config_dirzAndroid.site_config_dir)s###rcJ|jtdtdS)zf:returns: cache directory tied to the user, e.g.,``/data/user///cache/``r cacherrs ruser_cache_dirzAndroid.user_cache_dir.rrc|jS)zC:returns: cache directory shared by users, same as `user_cache_dir`)r"rs rsite_cache_dirzAndroid.site_cache_dir3"""rc|jS)zC:returns: state directory tied to the user, same as `user_data_dir`rrs ruser_state_dirzAndroid.user_state_dir8rrc|jS)zC:returns: state directory shared by users, same as `user_state_dir`)r'rs rsite_state_dirzAndroid.site_state_dir=r%rc|j}|jr1tjj |d}|j ||S)z:returns: log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it, e.g. ``/data/user///cache//log``logr"opinionospathjoin_optionally_create_directoryrr/s r user_log_dirzAndroid.user_log_dirB="" <<77<<e,D  - -d 3 rc|jS)z?:returns: log directory shared by users, same as `user_log_dir`)r3rs r site_log_dirzAndroid.site_log_dirK   rctS)zU:returns: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``)_android_documents_folderrs ruser_documents_dirzAndroid.user_documents_dirP )**rctS)zU:returns: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``)_android_downloads_folderrs ruser_downloads_dirzAndroid.user_downloads_dirUr;rctS)zS:returns: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``)_android_pictures_folderrs ruser_pictures_dirzAndroid.user_pictures_dirZs ())rctS)zT:returns: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``)_android_videos_folderrs ruser_videos_dirzAndroid.user_videos_dir_s &''rctS)zM:returns: music directory tied to the user e.g. ``/storage/emulated/0/Music``)_android_music_folderrs ruser_music_dirzAndroid.user_music_dirds %&&rcy)zQ:returns: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``z/storage/emulated/0/Desktoprs ruser_desktop_dirzAndroid.user_desktop_diris-rchtjjtdt ddS)z^:returns: bin directory tied to the user, e.g. ``/data/user///files/bin``r r bin)r.r/r0rrrs r user_bin_dirzAndroid.user_bin_dirns%ww||D(9:GUKKrc|jS)z?:returns: bin directory shared by users, same as `user_bin_dir`)rMrs r site_bin_dirzAndroid.site_bin_dirsr7rc|jS)zJ:returns: applications directory tied to the user, same as `user_data_dir`rrs ruser_applications_dirzAndroid.user_applications_dirxrrc|jS)zQ:returns: applications directory shared by users, same as `user_applications_dir`)rQrs rsite_applications_dirzAndroid.site_applications_dir}s)))rc|j}|jr1tjj |d}|j ||S)z:returns: 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,r2s ruser_runtime_dirzAndroid.user_runtime_dirr4rc|jS)zG:returns: runtime directory shared by users, same as `user_runtime_dir`)rVrs rsite_runtime_dirzAndroid.site_runtime_dirs$$$rNreturnr )__name__ __module__ __qualname____doc__propertyrrrrr"r$r'r)r3r6r:r>rArDrGrJrMrOrQrSrVrXrIrrr r s ZZ""aa$$ZZ##""##!!++++**((''--LL!!""**%%rr )maxsizecd}tsM ddlm}td|j }|j j j}|; ddl m }|d}|j j j}|Stjd}tjD])}|j|s|j!dd}nd}|Ttjd}tjD]*}|j|s|j!dd}|Sd}|S#t$rd}YwxYw#t$rd}YwxYw) zF:returns: base folder for the Android OS or None if it cannot be foundNr) mActivityandroid.content.Context autoclassz /data/(data|user/\d+)/(.+)/filesz/filesz7/mnt/expand/[a-fA-F0-9-]{36}/(data|user/\d+)/(.+)/files)randroidrbrgetApplicationContext getFilesDir getParentFilegetAbsolutePath Exceptionjniusrerecompilesysr/matchsplit)resultrbcontextrepatternr/s rrrsfF   )4i6U6U6WXG((*88:JJLF~  ( 9:G((*88:JJLF~**@AHH D}}T"H-a0  F ~**WXHH D}}T"H-a0 M   F MA F  F s$A E:E E E EEc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z-:returns: documents folder for the Android OSrrdrcandroid.os.Environmentz/storage/emulated/0/Documents)rlregetExternalFilesDirDIRECTORY_DOCUMENTSrjrk)rers environment documents_dirs rr9r9c8#56 89 $889X9XYiik   87 8?A AAc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z-:returns: downloads folder for the Android OSrrdrcrvz/storage/emulated/0/Downloads)rlrerwDIRECTORY_DOWNLOADSrjrk)rersry downloads_dirs rr=r=r{r|c ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z,:returns: pictures folder for the Android OSrrdrcrvz/storage/emulated/0/Pictures)rlrerwDIRECTORY_PICTURESrjrk)rersry pictures_dirs rr@r@sc6#56 89 #77 8V8VWggi   65 6r|c ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z*:returns: videos folder for the Android OSrrdrcrvz/storage/emulated/0/DCIM/Camera)rlrerwDIRECTORY_DCIMrjrk)rersry videos_dirs rrCrCsc7#56 89 !55k6P6PQaac   76 7r|c ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z):returns: music folder for the Android OSrrdrcrvz/storage/emulated/0/Music)rlrerwDIRECTORY_MUSICrjrk)rersry music_dirs rrFrFsc0#56 89  44[5P5PQaac   0/ 0r|)rZz str | NonerY)r^ __future__rr.rmro functoolsrtypingrrapirr rr9r=r@rCrF__all__rIrrrs" & @%o@%F 1,,^ 1   1   1   1   1    r