Uj.-dZddlmZddlZddlZddlZddlmZddlm Z m Z ddl m Z Gdd e Z ed dd Zed ddZed ddZed ddZed ddZed ddZd gZdS)zAndroid.) annotationsN) lru_cache) TYPE_CHECKINGcast)PlatformDirsABCceZdZdZed dZed dZed dZed dZed dZ ed d Z ed d Z ed d Z ed d Z ed d Zed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZdS)!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 `. returnstrcb|tdtdS)ze:returns: data directory tied to the user, e.g. ``/data/user///files/``r files_append_app_name_and_versionr_android_folderselfs X/var/www/app.qaans.com/backend/venv/lib/python3.11/site-packages/platformdirs/android.py user_data_dirzAndroid.user_data_dir+00e_=N=N1O1OQXYYYc|jS)zA:returns: data directory shared by users, same as `user_data_dir`rrs r site_data_dirzAndroid.site_data_dir !!rcb|tdtdS)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_=N=N1O1OQ_```rc|jS)zE:returns: config directory shared by users, same as `user_config_dir`rrs rsite_config_dirzAndroid.site_config_dir) ##rcb|tdtdS)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}|jr5tj|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%opinionospathjoin_optionally_create_directoryrr2s r user_log_dirzAndroid.user_log_dirBD" < 47<<e,,D  - -d 3 3 3 rc|jS)z?:returns: log directory shared by users, same as `user_log_dir`)r6rs 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%&&&rcdS)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 -,rcdS)zS:returns: projects directory tied to the user e.g. ``/storage/emulated/0/Projects``z/storage/emulated/0/ProjectsrLrs ruser_projects_dirzAndroid.user_projects_dirns .-rcdS)zU:returns: public share directory tied to the user e.g. ``/storage/emulated/0/Public``z/storage/emulated/0/PublicrLrs ruser_publicshare_dirzAndroid.user_publicshare_dirss ,+rcdS)zU:returns: templates directory tied to the user e.g. ``/storage/emulated/0/Templates``z/storage/emulated/0/TemplatesrLrs ruser_templates_dirzAndroid.user_templates_dirxs /.rcdS)zM:returns: fonts directory tied to the user e.g. ``/storage/emulated/0/fonts``z/storage/emulated/0/fontsrLrs ruser_fonts_dirzAndroid.user_fonts_dir}s +*rc|jS)zL:returns: preference directory tied to the user, same as ``user_config_dir``r rs ruser_preference_dirzAndroid.user_preference_dirr"rcxtjtdt ddS)z^:returns: bin directory tied to the user, e.g. ``/data/user///files/bin``r rbin)r1r2r3rrrs r user_bin_dirzAndroid.user_bin_dirs,w||D(9(9::GUKKKrc|jS)z?:returns: bin directory shared by users, same as `user_bin_dir`)rZrs r site_bin_dirzAndroid.site_bin_dirr:rc|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}|jr5tj|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/r5s ruser_runtime_dirzAndroid.user_runtime_dirr7rc|jS)zG:returns: runtime directory shared by users, same as `user_runtime_dir`)rcrs rsite_runtime_dirzAndroid.site_runtime_dirs $$rNr r ) __name__ __module__ __qualname____doc__propertyrrrr!r%r'r*r,r6r9r=rArDrGrJrMrOrQrSrUrWrZr\r^r`rcrerLrrr r s  ZZZXZ"""X"aaaXa$$$X$ZZZXZ###X#"""X"###X#X!!!X!+++X++++X+***X*(((X('''X'---X-...X.,,,X,///X/+++X+$$$X$LLLXL!!!X!"""X"***X*X%%%X%%%rr )maxsizer str | Nonec"d}tst ddlm}td|}|}n#t$rd}YnwxYw|] ddl m }|d}|}n#t$rd}YnwxYw|Wtj d}tjD]4}||r|dd}n5d}|Wtj d}tjD]4}||r|dd}n5d}|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)randroidrorgetApplicationContext getFilesDir getParentFilegetAbsolutePath Exceptionjniusrrrecompilesysr2matchsplit)resultrocontextrrpatternr2s rrrsF   ) ) ) ) ) )4i6U6U6W6WXXG((**88::JJLLFF   FFF  ~  ( ' ' ' ' 'i 9::G((**88::JJLLFF   FFF  ~*@AAH  D}}T"" H--a0 F ~*WXXH  D}}T"" H--a0 F Ms%A A,, A;:A;A C CCr c ddlm}|d}|d}||j}n#t $rd}YnwxYw|S)z-:returns: documents folder for the Android OSrrqrpandroid.os.Environmentz/storage/emulated/0/Documents)ryrrgetExternalFilesDirDIRECTORY_DOCUMENTSrwrx)rrr environment documents_dirs rr<r<8######)566i 899 $889XYYiikk 8887 8 AA AAc ddlm}|d}|d}||j}n#t $rd}YnwxYw|S)z-:returns: downloads folder for the Android OSrrqrprz/storage/emulated/0/Downloads)ryrrrDIRECTORY_DOWNLOADSrwrx)rrrr downloads_dirs rr@r@rrc ddlm}|d}|d}||j}n#t $rd}YnwxYw|S)z,:returns: pictures folder for the Android OSrrqrprz/storage/emulated/0/Pictures)ryrrrDIRECTORY_PICTURESrwrx)rrrr pictures_dirs rrCrCs6######)566i 899 #77 8VWWggii 6665 6 rc ddlm}|d}|d}||j}n#t $rd}YnwxYw|S)z*:returns: videos folder for the Android OSrrqrprz/storage/emulated/0/DCIM/Camera)ryrrrDIRECTORY_DCIMrwrx)rrrr videos_dirs rrFrF s7######)566i 899 !55k6PQQaacc 7776 7 rc ddlm}|d}|d}||j}n#t $rd}YnwxYw|S)z):returns: music folder for the Android OSrrqrprz/storage/emulated/0/Music)ryrrrDIRECTORY_MUSICrwrx)rrrr music_dirs rrIrIs0######)566i 899  44[5PQQaacc 000/ 0 r)r rmrf)rj __future__rr1rzr| functoolsrtypingrrapirr rr<r@rCrFrI__all__rLrrrs"""""" &&&&&&&& Y%Y%Y%Y%Y%oY%Y%Y%x 1,,,,^ 1     1     1     1     1      r