9i*SrSSKrSSKrSSKJr SSKJr \"\5rSS.Sjr SS jr SS jr SS jr SS jr \RS4S jrSrg)a Utilities for Windows Registry manipulation Notes: winreg.SetValue -> sets _keys_ with default ("") values winreg.SetValueEx -> sets values with named contents This is important when the argument has backslashes. SetValue will process the backslashes into a path of keys SetValueEx will create a value with name "path\with\keys" Mnemonic: SetValueEx for "excalars" (scalars, named values) N) getLogger logged_runTcheckc [S/UQSPUS9$)Nzreg.exez/frr)rargss Elib/python3.13/site-packages/menuinst/platforms/win_utils/registry.py_reg_exer s y.4..e <<cUS:XaSnOSn[USUSU3S5 [USUS3USUS 35 [USUS 3U5 U(a6[USUS 3U5 [USUS 3U5 [USUS 3U5 U(a[USUS3U5 U(a$[USUS3U5 [USUS3U5 U(a[USUS3U5 gg)a We want to achieve this. Entries ending in / denote keys; no trailing / means named value. If the item has a value attached to it, it's written after the : symbol. HKEY_*/ # current user or local machine Software/ Classes/ ./ OpenWithProgids/ ... /: "a description of the file being handled" DefaultIcon/: "path to the app icon" FriendlyAppName/: "Name of the program" AppUserModelID: "AUMI string" shell/ open/: "Name of the program" icon: "path to the app icon" FriendlyAppName: "name of the program" command/: "the command to be executed when opening a file with this extension" systemz#HKEY_LOCAL_MACHINE/Software/Classesz"HKEY_CURRENT_USER/Software/Classes/z/OpenWithProgids//@ z file/shell/open/command/@ /shell/open/@/FriendlyAppName/@/shell/open/FriendlyAppNamez/AppUserModelID/DefaultIcon/@/shell/open/Iconz/FriendlyTypeNameN)regvalue) extension identifiercommandiconapp_namefriendly_type_nameapp_user_model_idmodekeys r register_file_extensionr$s0> x32 uAi[ 1* >C uAj\ $ 1ZL&FG uAj\!6 7AC5*]3X>C5*%78(CC5*%@A8LC5*_57HI  C5*^4d;C5*%56= C5*%679KL r cUS:Xa[RS4O[RS4up4[SUSU3SS9 [R"USUS 3S [R 5n[R "XQ5 SSS5 g!,(df  g=f![a [RS X5 g[an[RS XS 9 SnAgSnAff=f)NrHKLMHKCUdeletez\Software\Classes\FrSoftware\Classes\z\OpenWithProgidsrz2Handler '%s' is not associated with extension '%s'z%Could not check key '%s' for deletionexc_info) winregHKEY_LOCAL_MACHINEHKEY_CURRENT_USERr OpenKeyKEY_ALL_ACCESS DeleteValueFileNotFoundErrorlogdebug Exception)rrr"rootroot_strr#excs r unregister_file_extensionr9bs 8   " "F+&& /D  X8*$6zlC5Q  ^^ &yk1ABAvG\G\    s /    _ F ^  99 Ss;+B)B B BBB C#< C#CC#cUS:XaSU3nOSU3n[US3SUR535 [US3S5 [US3U5 U(a-[US 3U5 [US 3U5 [US 3U5 U(a[US 3U5 [US 3U5 U(a[US3U5 U(a[US3U5 gg)NrzHKEY_CLASSES_ROOT/z#HKEY_CURRENT_USER/Software/Classes/rzURL:z /URL Protocolrrrrrrrz/AppUserModelIdz /_menuinst)rtitle)protocolrrrrr!r"r#s r register_url_protocolr=vs x"8*-3H:> uBZ4 0123 uM "B' u) *G4C5 &1C5*+X6C534h? C5'.C5()40C5(*;<C5 #Z0r cUS:Xa[RU4nSU3nO[RSU34nSU3n[R"U6n[R"US5upgUSL=(d Xa:HnSSS5 W(a [SUS S 9 gg!,(df  N"=f![ an [ RSX S9 Sn A gSn A ff=f) NrzHKCR\r)zHKCU\Software\Classes\ _menuinstz#Could not check key %s for deletionr*r(Fr) r,HKEY_CLASSES_ROOTr.r/ QueryValueExOSErrorr3 exceptionr ) r<rr" key_tuplekey_strr#value_r(r8s r unregister_url_protocolrHs x,,h6 8*%,,1B8*.MM +H:6 ^^Y '3**3 5+>F(7%0( '  ;X Ts5B# )B6B# B B# B## C -CC cd[RSX5 URSS5RS5=pUR S5GtpVpx[ [ U5n [ Rn US:XasU(a&[ R"U SRU55 [ R"U SRU5U S9n[ R"XX!5 SSS5 g[ R"U SR/UQUP55 [ R"U SR/UQUP5U S9n[ R"XSX!5 SSS5 g!,(df  g=f!,(df  g=f![a'n U(ae[RSXAU S 9 Sn A gSn A ff=f) ax Convenience wrapper to set different types of registry values. For practical purposes we distinguish between three cases: - A key with no value (think of a directory with no contents). Use value = "". - A key with an unnamed value (think of a directory with a file 'index.html') Use a key with '@' as the last component. - A key with named values (think of non-index.html files in the directory) The first component of the key is the root, and must be one of the winreg.HKEY_* variable _names_ (their actual value will be fetched from winreg). Key must be at least three components long (root key, *key, @ or named value). z Setting registry value %s = '%s'\r@)accessNrzCould not set %s to %sr*)r3r4replacestripsplitgetattrr, KEY_SET_VALUE CreateKeyjoinr/SetValue SetValueExrBwarning) r#rF value_typeraise_on_errors original_keyr6midkeysubkey named_valuerootkeyrLr8s r rrs\"II0#=T3/55c::C),3&D6fd#G  ! !F Q #   $))F*;<6):6JcZ?KJ   Wdii0A&0A&0A&B C3DV3DV3D)EfUY\!!#AzIVU KJVU Q   ,lC PQs\.AE>EE>'AE>:E-E> E*&E>*E>- E;7E>;E>> F/F**F/c[R"S5nSURlSnSnURXSS5 g)z Needed to propagate registry changes without having to reboot. https://discuss.python.org/t/is-there-a-library-to-change-windows-10-default-program-icon/5846/2 shell32Nir)ctypesOleDLLSHChangeNotifyrestype)r_eventflagss r notify_shell_changesrfs< mmI&G%)G" E E 5t4r )NNNNuser)rg)Nrg)__doc__r`r,loggingrutilsr__name__r3r r$r9r=rHREG_SZrrfr r rns{  =   >MH.  1<1&%+MM4#QL 5r