o i(@sdZddlmZddlZddlZddlZddlmZddlm Z m Z ddl m Z Gdd d e Z edd dd dZedd dddZedd dddZedd dddZedd dddZedd dddZd gZdS)zAndroid.) annotationsN) lru_cache) TYPE_CHECKINGcast)PlatformDirsABCc@sDeZdZdZed1ddZed1ddZed1dd Zed1d d Zed1d d Z ed1ddZ ed1ddZ ed1ddZ ed1ddZ ed1ddZed1ddZed1ddZed1ddZed1ddZed1d d!Zed1d"d#Zed1d$d%Zed1d&d'Zed1d(d)Zed1d*d+Zed1d,d-Zed1d.d/Zd0S)2AndroidaPlatform 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 `. returnstrcC|tdtdS)ze:returns: data directory tied to the user, e.g. ``/data/user///files/``r files_append_app_name_and_versionr_android_folderselfrR/home/ubuntu/transcripts/venv/lib/python3.10/site-packages/platformdirs/android.py user_data_dirzAndroid.user_data_dircC|jS)zA:returns: data directory shared by users, same as `user_data_dir`rrrrr site_data_dirzAndroid.site_data_dircCr )zn:returns: config directory tied to the user, e.g. ``/data/user///shared_prefs/``r shared_prefsr rrrruser_config_dir$rzAndroid.user_config_dircCr)zE:returns: config directory shared by users, same as `user_config_dir`)rrrrrsite_config_dir)rzAndroid.site_config_dircCr )zf:returns: cache directory tied to the user, e.g.,``/data/user///cache/``r cacher rrrruser_cache_dir.rzAndroid.user_cache_dircCr)zC:returns: cache directory shared by users, same as `user_cache_dir`)rrrrrsite_cache_dir3rzAndroid.site_cache_dircCr)zC:returns: state directory tied to the user, same as `user_data_dir`rrrrruser_state_dir8rzAndroid.user_state_dircCr)zC:returns: state directory shared by users, same as `user_state_dir`)r rrrrsite_state_dir=rzAndroid.site_state_dircC|j}|jr tj|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``logropinionospathjoinrr'rrr user_log_dirBzAndroid.user_log_dircCr)z?:returns: log directory shared by users, same as `user_log_dir`)r*rrrr site_log_dirJrzAndroid.site_log_dircCtS)zU:returns: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``)_android_documents_folderrrrruser_documents_dirOrzAndroid.user_documents_dircCr-)zU:returns: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``)_android_downloads_folderrrrruser_downloads_dirTrzAndroid.user_downloads_dircCr-)zS:returns: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``)_android_pictures_folderrrrruser_pictures_dirYrzAndroid.user_pictures_dircCr-)zT:returns: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``)_android_videos_folderrrrruser_videos_dir^rzAndroid.user_videos_dircCr-)zM:returns: music directory tied to the user e.g. ``/storage/emulated/0/Music``)_android_music_folderrrrruser_music_dircrzAndroid.user_music_dircCsdS)zQ:returns: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``z/storage/emulated/0/Desktoprrrrruser_desktop_dirhszAndroid.user_desktop_dircCstjtdtddS)z^:returns: bin directory tied to the user, e.g. ``/data/user///files/bin``r r bin)r&r'r(rrrrrr user_bin_dirmszAndroid.user_bin_dircCr)z?:returns: bin directory shared by users, same as `user_bin_dir`)r:rrrr site_bin_dirrrzAndroid.site_bin_dircCr)zJ:returns: applications directory tied to the user, same as `user_data_dir`rrrrruser_applications_dirwrzAndroid.user_applications_dircCr)zQ:returns: applications directory shared by users, same as `user_applications_dir`)r<rrrrsite_applications_dir|rzAndroid.site_applications_dircCr")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$r)rrruser_runtime_dirr+zAndroid.user_runtime_dircCr)zG:returns: runtime directory shared by users, same as `user_runtime_dir`)r?rrrrsite_runtime_dirrzAndroid.site_runtime_dirNr r )__name__ __module__ __qualname____doc__propertyrrrrrrr r!r*r,r/r1r3r5r7r8r:r;r<r=r?r@rrrrrs\                     r)maxsizer str | NonecCsd}ts'zddlm}td|}|}Wn ty&d}Ynw|durKzddl m }|d}|}Wn tyJd}Ynw|durjt d}t jD]}||rg|dd}nqWd}|durt d}t jD]}||r|dd}|Sqvd}|S) 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)randroidrIrgetApplicationContext getFilesDir getParentFilegetAbsolutePath ExceptionjniusrLrecompilesysr'matchsplit)resultrIcontextrLpatternr'rrrrsF          rr cCLzddlm}|d}|d}||j}W|Sty%d}Y|Sw)z-:returns: documents folder for the Android OSrrKrJandroid.os.Environmentz/storage/emulated/0/Documents)rSrLgetExternalFilesDirDIRECTORY_DOCUMENTSrQrR)rLrZ environment documents_dirrrrr.  r.cCr\)z-:returns: downloads folder for the Android OSrrKrJr]z/storage/emulated/0/Downloads)rSrLr^DIRECTORY_DOWNLOADSrQrR)rLrZr` downloads_dirrrrr0rbr0cCr\)z,:returns: pictures folder for the Android OSrrKrJr]z/storage/emulated/0/Pictures)rSrLr^DIRECTORY_PICTURESrQrR)rLrZr` pictures_dirrrrr2rbr2cCr\)z*:returns: videos folder for the Android OSrrKrJr]z/storage/emulated/0/DCIM/Camera)rSrLr^DIRECTORY_DCIMrQrR)rLrZr` videos_dirrrrr4rbr4cCr\)z):returns: music folder for the Android OSrrKrJr]z/storage/emulated/0/Music)rSrLr^DIRECTORY_MUSICrQrR)rLrZr` music_dirrrrr6rbr6)r rHrA)rE __future__rr&rTrV functoolsrtypingrrapirrrr.r0r2r4r6__all__rrrrs0    /