o wi_)@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_folderselfrQ/home/ubuntu/sommelier/.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}|jrtj|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``logropinionospathjoin_optionally_create_directoryrr'rrr user_log_dirB  zAndroid.user_log_dircCr)z?:returns: log directory shared by users, same as `user_log_dir`)r+rrrr site_log_dirKrzAndroid.site_log_dircCtS)zU:returns: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``)_android_documents_folderrrrruser_documents_dirPrzAndroid.user_documents_dircCr.)zU:returns: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``)_android_downloads_folderrrrruser_downloads_dirUrzAndroid.user_downloads_dircCr.)zS:returns: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``)_android_pictures_folderrrrruser_pictures_dirZrzAndroid.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_dirdrzAndroid.user_music_dircCsdS)zQ:returns: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``z/storage/emulated/0/Desktoprrrrruser_desktop_diriszAndroid.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_dirnszAndroid.user_bin_dircCr)z?:returns: bin directory shared by users, same as `user_bin_dir`)r;rrrr site_bin_dirsrzAndroid.site_bin_dircCr)zJ:returns: applications directory tied to the user, same as `user_data_dir`rrrrruser_applications_dirxrzAndroid.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-r0r2r4r6r8r9r;r<r=r>r@rArrrrrs\                     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)randroidrJrgetApplicationContext getFilesDir getParentFilegetAbsolutePath ExceptionjniusrMrecompilesysr'matchsplit)resultrJcontextrMpatternr'rrrrsF          rr cCLzddlm}|d}|d}||j}W|Sty%d}Y|Sw)z-:returns: documents folder for the Android OSrrLrKandroid.os.Environmentz/storage/emulated/0/Documents)rTrMgetExternalFilesDirDIRECTORY_DOCUMENTSrRrS)rMr[ environment documents_dirrrrr/  r/cCr])z-:returns: downloads folder for the Android OSrrLrKr^z/storage/emulated/0/Downloads)rTrMr_DIRECTORY_DOWNLOADSrRrS)rMr[ra downloads_dirrrrr1rcr1cCr])z,:returns: pictures folder for the Android OSrrLrKr^z/storage/emulated/0/Pictures)rTrMr_DIRECTORY_PICTURESrRrS)rMr[ra pictures_dirrrrr3rcr3cCr])z*:returns: videos folder for the Android OSrrLrKr^z/storage/emulated/0/DCIM/Camera)rTrMr_DIRECTORY_DCIMrRrS)rMr[ra videos_dirrrrr5rcr5cCr])z):returns: music folder for the Android OSrrLrKr^z/storage/emulated/0/Music)rTrMr_DIRECTORY_MUSICrRrS)rMr[ra music_dirrrrr7rcr7)r rIrB)rF __future__rr&rUrW functoolsrtypingrrapirrrr/r1r3r5r7__all__rrrrs0    /