T=j.-SrSSKJr SSKrSSKrSSKrSSKJr SSKJ r J r SSK J r "SS \ 5r \"SS 9SS j5r\"SS 9SS j5r\"SS 9SS j5r\"SS 9SSj5r\"SS 9SSj5r\"SS 9SSj5rS /rg)zAndroid.) annotationsN) lru_cache) TYPE_CHECKINGcast)PlatformDirsABCc4\rSrSrSr\S Sj5r\S Sj5r\S Sj5r\S Sj5r \S Sj5r \S Sj5r \S S j5r \S S j5r \S S j5r\S S j5r\S S j5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r\S Sj5r Sr!g)!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 `. cJUR[S[55S5$)ze:returns: data directory tied to the user, e.g. ``/data/user///files/``strfiles_append_app_name_and_versionr_android_folderselfs d/Users/stevendouglas/BidBrain/.venv/lib/python3.13/site-packages/pip/_vendor/platformdirs/android.py user_data_dirAndroid.user_data_dir"00e_=N1OQXYYcUR$)zA:returns: data directory shared by users, same as `user_data_dir`rrs r site_data_dirAndroid.site_data_dir!!!rcJUR[S[55S5$)zn:returns: config directory tied to the user, e.g. ``/data/user///shared_prefs/``r shared_prefsrrs ruser_config_dirAndroid.user_config_dir$s"00e_=N1OQ_``rcUR$)zE:returns: config directory shared by users, same as `user_config_dir`r rs rsite_config_dirAndroid.site_config_dir)###rcJUR[S[55S5$)zf:returns: cache directory tied to the user, e.g.,``/data/user///cache/``r cacherrs ruser_cache_dirAndroid.user_cache_dir.rrcUR$)zC:returns: cache directory shared by users, same as `user_cache_dir`)r)rs rsite_cache_dirAndroid.site_cache_dir3"""rcUR$)zC:returns: state directory tied to the user, same as `user_data_dir`rrs ruser_state_dirAndroid.user_state_dir8rrcUR$)zC:returns: state directory shared by users, same as `user_state_dir`)r0rs rsite_state_dirAndroid.site_state_dir=r.rcURnUR(a1[RR US5nUR U5 U$)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_directoryrr:s r user_log_dirAndroid.user_log_dirB="" <<77<<e,D  - -d 3 rcUR$)z?:returns: log directory shared by users, same as `user_log_dir`)r>rs r site_log_dirAndroid.site_log_dirK   rc[5$)zU:returns: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``)_android_documents_folderrs ruser_documents_dirAndroid.user_documents_dirP )**rc[5$)zU:returns: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``)_android_downloads_folderrs ruser_downloads_dirAndroid.user_downloads_dirUrIrc[5$)zS:returns: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``)_android_pictures_folderrs ruser_pictures_dirAndroid.user_pictures_dirZs ())rc[5$)zT:returns: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``)_android_videos_folderrs ruser_videos_dirAndroid.user_videos_dir_s &''rc[5$)zM:returns: music directory tied to the user e.g. ``/storage/emulated/0/Music``)_android_music_folderrs ruser_music_dirAndroid.user_music_dirds %&&rcg)zQ:returns: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``z/storage/emulated/0/Desktoprs ruser_desktop_dirAndroid.user_desktop_diris-rcg)zS:returns: projects directory tied to the user e.g. ``/storage/emulated/0/Projects``z/storage/emulated/0/Projectsr[rs ruser_projects_dirAndroid.user_projects_dirns.rcg)zU:returns: public share directory tied to the user e.g. ``/storage/emulated/0/Public``z/storage/emulated/0/Publicr[rs ruser_publicshare_dirAndroid.user_publicshare_dirss,rcg)zU:returns: templates directory tied to the user e.g. ``/storage/emulated/0/Templates``z/storage/emulated/0/Templatesr[rs ruser_templates_dirAndroid.user_templates_dirxs/rcg)zM:returns: fonts directory tied to the user e.g. ``/storage/emulated/0/fonts``z/storage/emulated/0/fontsr[rs ruser_fonts_dirAndroid.user_fonts_dir}s+rcUR$)zL:returns: preference directory tied to the user, same as ``user_config_dir``r#rs ruser_preference_dirAndroid.user_preference_dirr&rch[RR[S[ 55SS5$)z^:returns: bin directory tied to the user, e.g. ``/data/user///files/bin``r rbin)r9r:r;rrrs r user_bin_dirAndroid.user_bin_dirs%ww||D(9:GUKKrcUR$)z?:returns: bin directory shared by users, same as `user_bin_dir`)rors r site_bin_dirAndroid.site_bin_dirrDrcUR$)zJ:returns: applications directory tied to the user, same as `user_data_dir`rrs ruser_applications_dirAndroid.user_applications_dirrrcUR$)zQ:returns: applications directory shared by users, same as `user_applications_dir`)rurs rsite_applications_dirAndroid.site_applications_dirs)))rcURnUR(a1[RR US5nUR U5 U$)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``tmpr7r=s ruser_runtime_dirAndroid.user_runtime_dirr@rcUR$)zG:returns: runtime directory shared by users, same as `user_runtime_dir`)r|rs rsite_runtime_dirAndroid.site_runtime_dirs$$$rr[Nreturnr )"__name__ __module__ __qualname____firstlineno____doc__propertyrrr r$r)r,r0r3r>rBrGrLrPrTrXr\r_rbrerhrkrorrrurxr|r__static_attributes__r[rrr r s+ ZZ""aa$$ZZ##""##!!++++**((''--..,,//++$$LL!!""**%%rr )maxsizecSn[(dMSSKJn [SUR 55nUR 5R 5R5nUc;SSK J n U"S5nUR 5R 5R5nUc[[R"S5n[RH/nURU5(dMUR!S5Sn O SnUc\[R"S5n[RH0nURU5(dMUR!S5Sn U$ SnU$![a SnGN f=f![a SnNf=f) 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)randroidrrgetApplicationContext getFilesDir getParentFilegetAbsolutePath Exceptionjniusrrecompilesysr:matchsplit)resultrcontextrpatternr:s rrrsdF =  )4i6U6U6WXG((*88:JJLF~  ( 9:G((*88:JJLF~**@AHHD}}T""H-a0 F ~**WXHHD}}T""H-a0 M  F MA F  F s$A E:E+ E('E(+ E:9E:cSSKJn U"S5nU"S5nURUR5R 5nU$![ a SnU$f=f)z-:returns: documents folder for the Android OSrrrandroid.os.Environmentz/storage/emulated/0/Documents)rrgetExternalFilesDirDIRECTORY_DOCUMENTSrr)rr environment documents_dirs rrFrFc8#56 89 $889X9XYiik   87 8?A AAcSSKJn U"S5nU"S5nURUR5R 5nU$![ a SnU$f=f)z-:returns: downloads folder for the Android OSrrrrz/storage/emulated/0/Downloads)rrrDIRECTORY_DOWNLOADSrr)rrr downloads_dirs rrKrKrrcSSKJn U"S5nU"S5nURUR5R 5nU$![ a SnU$f=f)z,:returns: pictures folder for the Android OSrrrrz/storage/emulated/0/Pictures)rrrDIRECTORY_PICTURESrr)rrr pictures_dirs rrOrOsc6#56 89 #77 8V8VWggi   65 6rcSSKJn U"S5nU"S5nURUR5R 5nU$![ a SnU$f=f)z*:returns: videos folder for the Android OSrrrrz/storage/emulated/0/DCIM/Camera)rrrDIRECTORY_DCIMrr)rrr videos_dirs rrSrS sc7#56 89 !55k6P6PQaac   76 7rcSSKJn U"S5nU"S5nURUR5R 5nU$![ a SnU$f=f)z):returns: music folder for the Android OSrrrrz/storage/emulated/0/Music)rrrDIRECTORY_MUSICrr)rrr music_dirs rrWrWsc0#56 89  44[5P5PQaac   0/ 0r)rz str | Noner)r __future__rr9rr functoolsrtypingrrapirr rrFrKrOrSrW__all__r[rrrs" & Y%oY%x 1,,^ 1   1   1   1   1    r