ܖi(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 X/var/www/html/content-pipeline/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%rcv|j}|jr tjj |d}|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"opinionospathjoinrr/s r user_log_dirzAndroid.user_log_dirB/"" <<77<<e,D rc|jS)z?:returns: log directory shared by users, same as `user_log_dir`)r2rs r site_log_dirzAndroid.site_log_dirJ   rctS)zU:returns: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``)_android_documents_folderrs ruser_documents_dirzAndroid.user_documents_dirO )**rctS)zU:returns: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``)_android_downloads_folderrs ruser_downloads_dirzAndroid.user_downloads_dirTr:rctS)zS:returns: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``)_android_pictures_folderrs ruser_pictures_dirzAndroid.user_pictures_dirYs ())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_dircs %&&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_dirhs-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_dirms%ww||D(9:GUKKrc|jS)z?:returns: bin directory shared by users, same as `user_bin_dir`)rLrs r site_bin_dirzAndroid.site_bin_dirrr6rc|jS)zJ:returns: applications directory tied to the user, same as `user_data_dir`rrs ruser_applications_dirzAndroid.user_applications_dirwrrc|jS)zQ:returns: applications directory shared by users, same as `user_applications_dir`)rPrs rsite_applications_dirzAndroid.site_applications_dir|s)))rcv|j}|jr tjj |d}|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,r1s ruser_runtime_dirzAndroid.user_runtime_dirr3rc|jS)zG:returns: runtime directory shared by users, same as `user_runtime_dir`)rUrs rsite_runtime_dirzAndroid.site_runtime_dirs$$$rNreturnr )__name__ __module__ __qualname____doc__propertyrrrrr"r$r'r)r2r5r9r=r@rCrFrIrLrNrPrRrUrWrHrrr 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)randroidrargetApplicationContext getFilesDir getParentFilegetAbsolutePath Exceptionjniusrdrecompilesysr/matchsplit)resultracontextrdpatternr/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 OSrrcrbandroid.os.Environmentz/storage/emulated/0/Documents)rkrdgetExternalFilesDirDIRECTORY_DOCUMENTSrirj)rdrr environment documents_dirs rr8r8c8#56 89 $889X9XYiik   87 8?A AAc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z-:returns: downloads folder for the Android OSrrcrbruz/storage/emulated/0/Downloads)rkrdrvDIRECTORY_DOWNLOADSrirj)rdrrrx downloads_dirs rr<r<rzr{c ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z,:returns: pictures folder for the Android OSrrcrbruz/storage/emulated/0/Pictures)rkrdrvDIRECTORY_PICTURESrirj)rdrrrx 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 OSrrcrbruz/storage/emulated/0/DCIM/Camera)rkrdrvDIRECTORY_DCIMrirj)rdrrrx videos_dirs rrBrBsc7#56 89 !55k6P6PQaac   76 7r{c ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z):returns: music folder for the Android OSrrcrbruz/storage/emulated/0/Music)rkrdrvDIRECTORY_MUSICrirj)rdrrrx music_dirs rrErEsc0#56 89  44[5P5PQaac   0/ 0r{)rYz str | NonerX)r] __future__rr.rlrn functoolsrtypingrrapirr rr8r<r?rBrE__all__rHrrrs" & ~%o~%B 1,,^ 1   1   1   1   1    r