k^k,dZddlmZddlZddlZddlZddlmZddlm Z ddl m Z Gdd e Z ed dd Z ed dd Zed dd Zed ddZed ddZed ddZd gZy)zAndroid.) annotationsN) lru_cache)cast)PlatformDirsABCc0eZdZdZeddZeddZeddZeddZeddZ eddZ eddZ edd Z edd Z edd Zedd Zedd ZeddZeddZeddZeddZy)Androida$ Follows the guidance `from here `_. Makes use of the `appname `, `version `, `ensure_exists `. cR|jtttdS)zd:return: data directory tied to the user, e.g. ``/data/user///files/``files_append_app_name_and_versionrstr_android_folderselfs 9/usr/lib/python3.12/site-packages/platformdirs/android.py user_data_dirzAndroid.user_data_dir!00c?;L1MwWWc|jS)z@:return: data directory shared by users, same as `user_data_dir`rrs r site_data_dirzAndroid.site_data_dir!!!rcR|jtttdS)z :return: config directory tied to the user, e.g. ``/data/user///shared_prefs/`` shared_prefsr rs ruser_config_dirzAndroid.user_config_dir s! 00c?;L1M~^^rc|jS)zH:return: config directory shared by the users, same as `user_config_dir`)rrs rsite_config_dirzAndroid.site_config_dir(s###rcR|jtttdS)zj:return: cache directory tied to the user, e.g. e.g. ``/data/user///cache/``cacher rs ruser_cache_dirzAndroid.user_cache_dir-rrc|jS)zB:return: cache directory shared by users, same as `user_cache_dir`)r!rs rsite_cache_dirzAndroid.site_cache_dir2s"""rc|jS)zB:return: state directory tied to the user, same as `user_data_dir`rrs ruser_state_dirzAndroid.user_state_dir7rrcv|j}|jr tjj |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`` logr!opinionospathjoinrr+s r user_log_dirzAndroid.user_log_dir</ "" <<77<<e,D rctS)zT:return: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``)_android_documents_folderrs ruser_documents_dirzAndroid.user_documents_dirG )**rctS)zT:return: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``)_android_downloads_folderrs ruser_downloads_dirzAndroid.user_downloads_dirLr3rctS)zR:return: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``)_android_pictures_folderrs ruser_pictures_dirzAndroid.user_pictures_dirQs ())rctS)zS:return: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``)_android_videos_folderrs ruser_videos_dirzAndroid.user_videos_dirVs &''rctS)zL:return: music directory tied to the user e.g. ``/storage/emulated/0/Music``)_android_music_folderrs ruser_music_dirzAndroid.user_music_dir[s %&&rcy)zP:return: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``z/storage/emulated/0/Desktoprs ruser_desktop_dirzAndroid.user_desktop_dir`s-rcv|j}|jr tjj |d}|S)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-s ruser_runtime_dirzAndroid.user_runtime_direr/rc|jS)zF:return: runtime directory shared by users, same as `user_runtime_dir`)rErs rsite_runtime_dirzAndroid.site_runtime_dirps$$$rNreturnr)__name__ __module__ __qualname____doc__propertyrrrrr!r#r%r.r2r6r9r<r?rBrErGrArrr r sMXX""__$$XX##""++++**((''--%%rr )maxsizecF ddlm}|d}|jjj }|S#t $rYt jd}tjD]+}|j|s|jdd}Y|Sd}Y|SwxYw)zE:return: base folder for the Android OS or None if it cannot be foundr autoclassandroid.content.Contextz /data/(data|user/\d+)/(.+)/filesz/filesN) jniusrR getFilesDir getParentFilegetAbsolutePath Exceptionrecompilesysr+matchsplit)rRcontextresultpatternr+s rrrvs#56$002@@BRRT M **@AHHD}}T"H-a0 M  F Ms:>AB B B B c ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z,:return: documents folder for the Android OSrrQrSandroid.os.Environmentz/storage/emulated/0/Documents)rTrRgetExternalFilesDirDIRECTORY_DOCUMENTSrWrX)rRr^ environment documents_dirs rr1r1c8#56 89 $889X9XYiik   87 8?A AAc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z,:return: downloads folder for the Android OSrrQrSrbz/storage/emulated/0/Downloads)rTrRrcDIRECTORY_DOWNLOADSrWrX)rRr^re downloads_dirs rr5r5rgrhc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z+:return: pictures folder for the Android OSrrQrSrbz/storage/emulated/0/Pictures)rTrRrcDIRECTORY_PICTURESrWrX)rRr^re pictures_dirs rr8r8sc6#56 89 #77 8V8VWggi   65 6rhc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z):return: videos folder for the Android OSrrQrSrbz/storage/emulated/0/DCIM/Camera)rTrRrcDIRECTORY_DCIMrWrX)rRr^re videos_dirs rr;r;sc7#56 89 !55k6P6PQaac   76 7rhc ddlm}|d}|d}|j|jj }|S#t $rd}Y|SwxYw)z(:return: music folder for the Android OSrrQrSrbz/storage/emulated/0/Music)rTrRrcDIRECTORY_MUSICrWrX)rRr^re music_dirs rr>r>sc0#56 89  44[5P5PQaac   0/ 0rh)rIz str | NonerH)rM __future__rr*rYr[ functoolsrtypingrapirr rr1r5r8r;r>__all__rArrrzs"  e%oe%P 1( 1   1   1   1   1    r