+ )j*Rt^RIt^RIt^RIHt^RIHt]!]4tRR/Rlt R Rlt RRlt R R lt RR lt ]PR3R ltR tR#)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_runcheckTc&\R.VORNVR7#)zreg.exez/frr)rargss$*Elib/python3.14/site-packages/menuinst/platforms/win_utils/registry.py_reg_exer s y.4..e <<cVR8XdRpMRp\V RV RV 2R4\V RV R2V RV R 24\V RV R 2V4V'd7\V RV R 2V4\V RV R 2V4\V RV R 2V4V'd\V RV R2V4V'd%\V RV R2V4\V RV R2V4V'd\V RV R2V4R#R#)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 cVR8Xd\PR3M\PR3wr4\RV RV 2RR7\P!VRV R2^\P 4;_uu_4p\P !WQ4R R R 4R # +'giR #;i \d\PR Y4R #\d#p\PR YR 7R p?R#R p?ii;i) r HKLMHKCUdeletez\Software\Classes\FrSoftware\Classes\z\OpenWithProgidsNz2Handler '%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_extensionr7bs 8   " "F+&& /D  X8*$6zlC5Q  ^^ &yk1ABAvG\G\     s /     _ F ^  99 SsB3B*5B B* B' !B*'B**!C:C:C:C55C:cVR8XdRV 2pMRV 2p\V R2RVP4 24\V R2R4\V R2V4V'd.\V R2V4\V R 2V4\V R 2V4V'd\V R 2V4\V R 2V4V'd\V R 2V4V'd\V R2V4R#R#)r zHKEY_CLASSES_ROOT/z#HKEY_CURRENT_USER/Software/Classes/rzURL:z /URL Protocolrrrrrrrz/AppUserModelIdz /_menuinstN)rtitle)protocolrrrrrr r!s&&&&&&& r register_url_protocolr;vs x"8*-3H:> uBZ4 0123 uM "B' u) *G4C5 &1C5*+X6C534h? C5'.C5()40C5(*;<C5 #Z0r cVR8Xd\PV3pRV 2pM\PRV 23pRV 2p\P!V!;_uu_4p\P!VR4wrgVRJ;'gWa8HpRRR4X'd\RTR R 7R#R# +'giL*;i \ d#p \ PRY R7Rp ? R#Rp ? ii;i) r zHKCR\r'zHKCU\Software\Classes\ _menuinstNz#Could not check key %s for deletionr(r&Fr) r*HKEY_CLASSES_ROOTr,r- QueryValueExOSErrorr1 exceptionr ) r:rr key_tuplekey_strr!value_r&r6s &&& r unregister_url_protocolrFs x,,h6 8*%,,1B8*.MM +H:6 ^^Y ' '3**3 >5+>F(7%0( '  ;X Ts5B6*B#B6# B3 .B63B66 C#CC#c \PRW4VPRR4PR4;rVP R4EvrVrx\ \ V4p \ Pp VR8XdV'd'\ P!V RPV44\ P!V RPV4V R7;_uu_4p\ P!WW!4RRR4R#\ P!V RP.VOVN44\ P!V RP.VOVN4V R7;_uu_4p\ P!W^W!4RRR4R# +'giR#;i +'giR#;i \d-p T'dh\PRYAT R7Rp ? R#Rp ? ii;i) 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@)accessNzCould not set %s to %sr()r1r2replacestripsplitgetattrr* KEY_SET_VALUE CreateKeyjoinr-SetValue SetValueExr@warning) r!rD value_typeraise_on_errors original_keyr4midkeysubkey named_valuerootkeyrJr6s &&&& r rrsk"II0#=T3/55c::C),3&D6fd#G  ! !F Q #   $))F*;<6):6JJcZ?KJ   Wdii0A&0A&0A&B C3DV3DV3D)EfUUY\!!#AzIVU KJJVUU Q   ,lC PPQsb.F=AFE6+F5AFF ,F6 F FF F FF G)!GGc\P!R4pRVPnRp^pVPWRR4R#)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 shell32Ni)ctypesOleDLLSHChangeNotifyrestype)r]eventflagss r notify_shell_changesrds< mmI&G%)G" E E 5t4r )NNNNuser)re)Nre)__doc__r^r*loggingrutilsr__name__r1r r"r7r;rFREG_SZrrdr r rls[  =$=>MH(1<1&%+MM4#QL 5r