O3j.-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 ZeddZeddZeddZeddZeddZeddZeddZeddZeddZeddZeddZeddZeddZeddZeddZy)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 A/DATA/.local/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)###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_directoryrr1s 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`)r5rs 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-rcy)zS:returns: projects directory tied to the user e.g. ``/storage/emulated/0/Projects``z/storage/emulated/0/ProjectsrKrs ruser_projects_dirzAndroid.user_projects_dirns.rcy)zU:returns: public share directory tied to the user e.g. ``/storage/emulated/0/Public``z/storage/emulated/0/PublicrKrs ruser_publicshare_dirzAndroid.user_publicshare_dirss,rcy)zU:returns: templates directory tied to the user e.g. ``/storage/emulated/0/Templates``z/storage/emulated/0/TemplatesrKrs ruser_templates_dirzAndroid.user_templates_dirxs/rcy)zM:returns: fonts directory tied to the user e.g. ``/storage/emulated/0/fonts``z/storage/emulated/0/fontsrKrs ruser_fonts_dirzAndroid.user_fonts_dir}s+rc|jS)zL:returns: preference directory tied to the user, same as ``user_config_dir``rrs ruser_preference_dirzAndroid.user_preference_dirr!rchtjjtdt ddS)z^:returns: bin directory tied to the user, e.g. ``/data/user///files/bin``r r bin)r0r1r2rrrs r user_bin_dirzAndroid.user_bin_dirs%ww||D(9:GUKKrc|jS)z?:returns: bin directory shared by users, same as `user_bin_dir`)rYrs r site_bin_dirzAndroid.site_bin_dirr9rc|jS)zJ:returns: applications directory tied to the user, same as `user_data_dir`rrs ruser_applications_dirzAndroid.user_applications_dirrrc|jS)zQ:returns: applications directory shared by users, same as `user_applications_dir`)r]rs rsite_applications_dirzAndroid.site_applications_dirs)))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.r4s ruser_runtime_dirzAndroid.user_runtime_dirr6rc|jS)zG:returns: runtime directory shared by users, same as `user_runtime_dir`)rbrs rsite_runtime_dirzAndroid.site_runtime_dirs$$$rNreturnr ) __name__ __module__ __qualname____doc__propertyrrrr r$r&r)r+r5r8r<r@rCrFrIrLrNrPrRrTrVrYr[r]r_rbrdrKrrr 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)randroidrnrgetApplicationContext getFilesDir getParentFilegetAbsolutePath Exceptionjniusrqrecompilesysr1matchsplit)resultrncontextrqpatternr1s rrrs\F   )4i6U6U6WXG((*88:JJLF~  ( 9:G((*88:JJLF~**@AHHD}}T"H-a0 F ~**WXHHD}}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 OSrrproandroid.os.Environmentz/storage/emulated/0/Documents)rxrqgetExternalFilesDirDIRECTORY_DOCUMENTSrvrw)rqr environment documents_dirs rr;r;c8#56 89 $889X9XYiik   87 8?A AAc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z-:returns: downloads folder for the Android OSrrprorz/storage/emulated/0/Downloads)rxrqrDIRECTORY_DOWNLOADSrvrw)rqrr downloads_dirs rr?r?rrc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z,:returns: pictures folder for the Android OSrrprorz/storage/emulated/0/Pictures)rxrqrDIRECTORY_PICTURESrvrw)rqrr pictures_dirs rrBrBsc6#56 89 #77 8V8VWggi   65 6rc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z*:returns: videos folder for the Android OSrrprorz/storage/emulated/0/DCIM/Camera)rxrqrDIRECTORY_DCIMrvrw)rqrr videos_dirs rrErE sc7#56 89 !55k6P6PQaac   76 7rc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z):returns: music folder for the Android OSrrprorz/storage/emulated/0/Music)rxrqrDIRECTORY_MUSICrvrw)rqrr music_dirs rrHrHsc0#56 89  44[5P5PQaac   0/ 0r)rfz str | Nonere)rj __future__rr0ryr{ functoolsrtypingrrapirr rr;r?rBrErH__all__rKrrrs" & Y%oY%x 1,,^ 1   1   1   1   1    r