py2docfx 0.1.15rc2025477__py3-none-any.whl → 0.1.16.dev2052678__py3-none-any.whl

py2docfx/venv/venv1/Lib/site-packages/win32comext/propsys/test/testpropsys.py

@@ -1,5 +0,0 @@
-from win32com.propsys import propsys, pscon  # nopycln: import
-
-print("propsys was imported (sorry - that is the extent of the tests,")
-print("but see the shell folder_view demo, which uses this module)")
-# that's all folks!

py2docfx/venv/venv1/Lib/site-packages/win32comext/shell/__init__.py

@@ -1,4 +0,0 @@
-# See if we have a special directory for the binaries (for developers)
-import win32com
-
-win32com.__PackageSupportBuildPath__(__path__)

py2docfx/venv/venv1/Lib/site-packages/win32comext/shell/demos/IActiveDesktop.py

@@ -1,83 +0,0 @@
-import time
-
-import pythoncom
-from win32com.shell import shell, shellcon
-
-website = "https://github.com/mhammond/pywin32/"
-iad = pythoncom.CoCreateInstance(
-    shell.CLSID_ActiveDesktop,
-    None,
-    pythoncom.CLSCTX_INPROC_SERVER,
-    shell.IID_IActiveDesktop,
-)
-opts = iad.GetDesktopItemOptions()
-if not (opts["ActiveDesktop"] and opts["EnableComponents"]):
-    print("Warning: Enabling Active Desktop")
-    opts["ActiveDesktop"] = True
-    opts["EnableComponents"] = True
-    iad.SetDesktopItemOptions(opts)
-    iad.ApplyChanges(0xFFFF)
-    iad = None
-    ## apparently takes a short while for it to become active
-    time.sleep(2)
-    iad = pythoncom.CoCreateInstance(
-        shell.CLSID_ActiveDesktop,
-        None,
-        pythoncom.CLSCTX_INPROC_SERVER,
-        shell.IID_IActiveDesktop,
-    )
-
-cnt = iad.GetDesktopItemCount()
-print("Count:", cnt)
-for i in range(cnt):
-    print(iad.GetDesktopItem(i))
-
-component = {
-    "ID": cnt + 1,
-    "ComponentType": shellcon.COMP_TYPE_WEBSITE,
-    "CurItemState": shellcon.IS_NORMAL,
-    "SubscribedURL": website,
-    "Source": website,
-    "FriendlyName": "Pywin32 on SF",
-    "Checked": True,  ## this controls whether item is currently displayed
-    "NoScroll": False,
-    "Dirty": False,
-    "Pos": {
-        "Top": 69,
-        "Left": 69,
-        "Height": 400,
-        "Width": 400,
-        "zIndex": 1002,
-        "CanResize": True,
-        "CanResizeX": True,
-        "CanResizeY": True,
-        "PreferredLeftPercent": 0,
-        "PreferredTopPercent": 0,
-    },
-    "Original": {
-        "Top": 33,
-        "Left": 304,
-        "Height": 362,
-        "Width": 372,
-        "ItemState": shellcon.IS_NORMAL,
-    },
-    "Restored": {
-        "Top": 33,
-        "Left": 304,
-        "Height": 362,
-        "Width": 372,
-        "ItemState": shellcon.IS_NORMAL,
-    },
-}
-
-
-try:
-    existing_item = iad.GetDesktopItemBySource(website)
-except pythoncom.com_error:
-    pass
-else:
-    iad.RemoveDesktopItem(existing_item)
-    iad.ApplyChanges(0xFFFF)
-
-iad.AddDesktopItem(component)
-iad.ApplyChanges(0xFFFF)  ## need to check which AD_APPLY constants are actually needed

py2docfx/venv/venv1/Lib/site-packages/win32comext/shell/demos/IFileOperationProgressSink.py

@@ -1,179 +0,0 @@
-# Sample implementation of IFileOperationProgressSink that just prints
-# some basic info
-
-import pythoncom
-from win32com.server.policy import DesignatedWrapPolicy
-from win32com.shell import shell, shellcon
-
-tsf_flags = [(k, v) for k, v in shellcon.__dict__.items() if k.startswith("TSF_")]
-
-
-def decode_flags(flags):
-    if flags == 0:
-        return "TSF_NORMAL"
-    flag_txt = ""
-    for k, v in tsf_flags:
-        if flags & v:
-            if flag_txt:
-                flag_txt += "|" + k
-            else:
-                flag_txt = k
-    return flag_txt
-
-
-class FileOperationProgressSink(DesignatedWrapPolicy):
-    _com_interfaces_ = [shell.IID_IFileOperationProgressSink]
-    _public_methods_ = [
-        "StartOperations",
-        "FinishOperations",
-        "PreRenameItem",
-        "PostRenameItem",
-        "PreMoveItem",
-        "PostMoveItem",
-        "PreCopyItem",
-        "PostCopyItem",
-        "PreDeleteItem",
-        "PostDeleteItem",
-        "PreNewItem",
-        "PostNewItem",
-        "UpdateProgress",
-        "ResetTimer",
-        "PauseTimer",
-        "ResumeTimer",
-    ]
-
-    def __init__(self):
-        self._wrap_(self)
-
-    def StartOperations(self):
-        print("StartOperations")
-
-    def FinishOperations(self, Result):
-        print("FinishOperations: HRESULT ", Result)
-
-    def PreRenameItem(self, Flags, Item, NewName):
-        print(
-            "PreRenameItem: Renaming "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + NewName
-        )
-
-    def PostRenameItem(self, Flags, Item, NewName, hrRename, NewlyCreated):
-        if NewlyCreated is not None:
-            newfile = NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        else:
-            newfile = "not renamed, HRESULT " + str(hrRename)
-        print(
-            "PostRenameItem: renamed "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + newfile
-        )
-
-    def PreMoveItem(self, Flags, Item, DestinationFolder, NewName):
-        print(
-            "PreMoveItem: Moving "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + DestinationFolder.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + "\\"
-            + str(NewName)
-        )
-
-    def PostMoveItem(
-        self, Flags, Item, DestinationFolder, NewName, hrMove, NewlyCreated
-    ):
-        if NewlyCreated is not None:
-            newfile = NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        else:
-            newfile = "not copied, HRESULT " + str(hrMove)
-        print(
-            "PostMoveItem: Moved "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + newfile
-        )
-
-    def PreCopyItem(self, Flags, Item, DestinationFolder, NewName):
-        if not NewName:
-            NewName = ""
-        print(
-            "PreCopyItem: Copying "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + DestinationFolder.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + "\\"
-            + NewName
-        )
-        print("Flags: ", decode_flags(Flags))
-
-    def PostCopyItem(
-        self, Flags, Item, DestinationFolder, NewName, hrCopy, NewlyCreated
-    ):
-        if NewlyCreated is not None:
-            newfile = NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        else:
-            newfile = "not copied, HRESULT " + str(hrCopy)
-        print(
-            "PostCopyItem: Copied "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + newfile
-        )
-        print("Flags: ", decode_flags(Flags))
-
-    def PreDeleteItem(self, Flags, Item):
-        print(
-            "PreDeleteItem: Deleting " + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        )
-
-    def PostDeleteItem(self, Flags, Item, hrDelete, NewlyCreated):
-        print(
-            "PostDeleteItem: Deleted " + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        )
-        if NewlyCreated:
-            print(
-                "    Moved to recycle bin - "
-                + NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            )
-
-    def PreNewItem(self, Flags, DestinationFolder, NewName):
-        print(
-            "PreNewItem: Creating "
-            + DestinationFolder.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + "\\"
-            + NewName
-        )
-
-    def PostNewItem(
-        self,
-        Flags,
-        DestinationFolder,
-        NewName,
-        TemplateName,
-        FileAttributes,
-        hrNew,
-        NewItem,
-    ):
-        print(
-            "PostNewItem: Created " + NewItem.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        )
-
-    def UpdateProgress(self, WorkTotal, WorkSoFar):
-        print("UpdateProgress: ", WorkSoFar, WorkTotal)
-
-    def ResetTimer(self):
-        print("ResetTimer")
-
-    def PauseTimer(self):
-        print("PauseTimer")
-
-    def ResumeTimer(self):
-        print("ResumeTimer")
-
-
-def CreateSink():
-    return pythoncom.WrapObject(
-        FileOperationProgressSink(), shell.IID_IFileOperationProgressSink
-    )

py2docfx/venv/venv1/Lib/site-packages/win32comext/shell/demos/IShellLinkDataList.py

@@ -1,67 +0,0 @@
-import os
-import sys
-
-import pythoncom
-import win32api
-from win32com.shell import shell, shellcon
-
-temp_dir = win32api.GetTempPath()
-linkname = win32api.GetTempFileName(temp_dir, "cmd")[0]
-os.remove(linkname)
-linkname += ".lnk"
-print("Link name:", linkname)
-ish = pythoncom.CoCreateInstance(
-    shell.CLSID_ShellLink, None, pythoncom.CLSCTX_INPROC_SERVER, shell.IID_IShellLink
-)
-ish.SetPath(os.environ["cOMSPEC"])
-ish.SetWorkingDirectory(os.path.split(sys.executable)[0])
-ish.SetDescription("shortcut made by python")
-
-console_props = {
-    "Signature": shellcon.NT_CONSOLE_PROPS_SIG,
-    "InsertMode": True,
-    "FullScreen": False,  ## True looks like "DOS Mode" from win98!
-    "FontFamily": 54,
-    "CursorSize": 75,  ## pct of character size
-    "ScreenBufferSize": (152, 256),
-    "AutoPosition": False,
-    "FontSize": (4, 5),
-    "FaceName": "",
-    "HistoryBufferSize": 32,
-    "InputBufferSize": 0,
-    "QuickEdit": True,
-    "Font": 0,  ## 0 should always be present, use win32console.GetNumberOfConsoleFonts() to find how many available
-    "FillAttribute": 7,
-    "PopupFillAttribute": 245,
-    "WindowSize": (128, 32),
-    "WindowOrigin": (0, 0),
-    "FontWeight": 400,
-    "HistoryNoDup": False,
-    "NumberOfHistoryBuffers": 32,
-    ## ColorTable copied from a 'normal' console shortcut, with some obvious changes
-    ## These do not appear to be documented.  From experimentation, [0] is background, [7] is foreground text
-    "ColorTable": (
-        255,
-        8388608,
-        32768,
-        8421376,
-        128,
-        8388736,
-        32896,
-        12582912,
-        8421504,
-        16711680,
-        65280,
-        16776960,
-        255,
-        16711935,
-        65535,
-        16777215,
-    ),
-}
-
-ishdl = ish.QueryInterface(shell.IID_IShellLinkDataList)
-ishdl.AddDataBlock(console_props)
-ipf = ish.QueryInterface(pythoncom.IID_IPersistFile)
-ipf.Save(linkname, 1)
-os.startfile(linkname)

py2docfx/venv/venv1/Lib/site-packages/win32comext/shell/demos/ITransferAdviseSink.py

@@ -1,93 +0,0 @@
-# ITransferAdviseSink implementation template
-
-import pythoncom
-from win32com.server.policy import DesignatedWrapPolicy
-from win32com.shell import shell, shellcon
-
-tsf_flags = []
-TRANSFER_ADVISE_STATES = {}
-
-for k, v in shellcon.__dict__.items():
-    if k.startswith("TS_"):
-        TRANSFER_ADVISE_STATES[v] = k
-    elif k.startswith("TSF_"):
-        tsf_flags.append((k, v))
-
-
-def decode_flags(flags):
-    if flags == 0:
-        return "TSF_NORMAL"
-    flag_txt = ""
-    for k, v in tsf_flags:
-        if flags & v:
-            if flag_txt:
-                flag_txt += "|" + k
-            else:
-                flag_txt = k
-    return flag_txt
-
-
-class TransferAdviseSink(DesignatedWrapPolicy):
-    _com_interfaces_ = [shell.IID_ITransferAdviseSink]
-    _public_methods_ = [
-        "UpdateProgress",
-        "UpdateTransferState",
-        "ConfirmOverwrite",
-        "ConfirmEncryptionLoss",
-        "FileFailure",
-        "SubStreamFailure",
-        "PropertyFailure",
-    ]
-
-    def __init__(self):
-        self._wrap_(self)
-
-    def UpdateProgress(
-        self,
-        SizeCurrent,
-        SizeTotal,
-        FilesCurrent,
-        FilesTotal,
-        FoldersCurrent,
-        FoldersTotal,
-    ):
-        print("UpdateProgress - processed so far:")
-        print(f"\t {SizeCurrent} out of {SizeTotal} bytes")
-        print(f"\t {FilesCurrent} out of {FilesTotal} files")
-        print(f"\t {FoldersCurrent} out of {FoldersTotal} folders")
-
-    def UpdateTransferState(self, State):
-        print(
-            "Current state: ",
-            TRANSFER_ADVISE_STATES.get(State, "??? Unknown state %s ???" % State),
-        )
-
-    def ConfirmOverwrite(self, Source, DestParent, Name):
-        print(
-            "ConfirmOverwrite: ",
-            Source.GetDisplayName(shellcon.SHGDN_FORPARSING),
-            DestParent.GetDisplayName(shellcon.SHGDN_FORPARSING),
-            Name,
-        )
-
-    def ConfirmEncryptionLoss(self, Source):
-        print(
-            "ConfirmEncryptionLoss:", Source.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        )
-
-    def FileFailure(self, Item, ItemName, Error):
-        print("FileFailure:", Item.GetDisplayName(shellcon.SHGDN_FORPARSING), ItemName)
-
-    def SubStreamFailure(self, Item, StreamName, Error):
-        print("SubStreamFailure:\n")
-
-    def PropertyFailure(self, Item, key, Error):
-        print("PropertyFailure:\n")
-
-
-def CreateSink():
-    return pythoncom.WrapObject(
-        TransferAdviseSink(),
-        shell.IID_ITransferAdviseSink,
-        shell.IID_ITransferAdviseSink,
-    )

py2docfx/venv/venv1/Lib/site-packages/win32comext/shell/demos/IUniformResourceLocator.py

@@ -1,56 +0,0 @@
-import os
-
-import pythoncom
-import win32api
-from win32com.shell import shell, shellcon
-
-
-class InternetShortcut:
-    def __init__(self):
-        self._base = pythoncom.CoCreateInstance(
-            shell.CLSID_InternetShortcut,
-            None,
-            pythoncom.CLSCTX_INPROC_SERVER,
-            shell.IID_IUniformResourceLocator,
-        )
-
-    def load(self, filename):
-        # Get an IPersist interface
-        # which allows save/restore of object to/from files
-        self._base.QueryInterface(pythoncom.IID_IPersistFile).Load(filename)
-
-    def save(self, filename):
-        self._base.QueryInterface(pythoncom.IID_IPersistFile).Save(filename, 1)
-
-    def __getattr__(self, name):
-        if name != "_base":
-            return getattr(self._base, name)
-
-
-temp_dir = win32api.GetTempPath()
-linkname = win32api.GetTempFileName(temp_dir, "ish")[0]
-print("Link:", linkname)
-os.remove(linkname)
-linkname += ".url"
-
-ish = InternetShortcut()
-ish.SetURL("https://github.com/mhammond/pywin32")
-ish.save(linkname)
-
-## IUniformResourceLocator also give access to IPropertySetStorage
-pss = ish.QueryInterface(pythoncom.IID_IPropertySetStorage)
-ps = pss.Open(shell.FMTID_InternetSite)
-property_ids = [
-    (k, v) for k, v in shellcon.__dict__.items() if k.startswith("PID_INTSITE_")
-]
-for pname, pval in property_ids:
-    print(pname, ps.ReadMultiple((pval,))[0])
-
-ps = pss.Open(shell.FMTID_Intshcut)
-property_ids = [(k, v) for k, v in shellcon.__dict__.items() if k.startswith("PID_IS_")]
-for pname, pval in property_ids:
-    print(pname, ps.ReadMultiple((pval,))[0])
-
-new_sh = InternetShortcut()
-new_sh.load(linkname)
-new_sh.InvokeCommand("Open")

py2docfx/venv/venv1/Lib/site-packages/win32comext/shell/demos/browse_for_folder.py

@@ -1,45 +0,0 @@
-# A couple of samples using SHBrowseForFolder
-
-import os
-
-import win32gui
-from win32com.shell import shell, shellcon
-
-
-# A callback procedure - called by SHBrowseForFolder
-def BrowseCallbackProc(hwnd, msg, lp, data):
-    if msg == shellcon.BFFM_INITIALIZED:
-        win32gui.SendMessage(hwnd, shellcon.BFFM_SETSELECTION, 1, data)
-    elif msg == shellcon.BFFM_SELCHANGED:
-        # Set the status text of the
-        # For this message, 'lp' is the address of the PIDL.
-        pidl = shell.AddressAsPIDL(lp)
-        try:
-            path = shell.SHGetPathFromIDList(pidl)
-            win32gui.SendMessage(hwnd, shellcon.BFFM_SETSTATUSTEXT, 0, path)
-        except shell.error:
-            # No path for this PIDL
-            pass
-
-
-if __name__ == "__main__":
-    # Demonstrate a dialog with the cwd selected as the default - this
-    # must be done via a callback function.
-    flags = shellcon.BIF_STATUSTEXT
-    shell.SHBrowseForFolder(
-        0,  # parent HWND
-        None,  # root PIDL.
-        "Default of %s" % os.getcwd(),  # title
-        flags,  # flags
-        BrowseCallbackProc,  # callback function
-        os.getcwd(),  # 'data' param for the callback
-    )
-    # Browse from this directory down only.
-    # Get the PIDL for the cwd.
-    desktop = shell.SHGetDesktopFolder()
-    cb, pidl, extra = desktop.ParseDisplayName(0, None, os.getcwd())
-    shell.SHBrowseForFolder(
-        0,  # parent HWND
-        pidl,  # root PIDL.
-        "From %s down only" % os.getcwd(),  # title
-    )

py2docfx/venv/venv1/Lib/site-packages/win32comext/shell/demos/create_link.py

@@ -1,73 +0,0 @@
-# link.py
-# From a demo by Mark Hammond, corrupted by Mike Fletcher
-# (and re-corrupted by Mark Hammond :-)
-import os
-
-import pythoncom
-from win32com.shell import shell
-
-
-class PyShortcut:
-    def __init__(self):
-        self._base = pythoncom.CoCreateInstance(
-            shell.CLSID_ShellLink,
-            None,
-            pythoncom.CLSCTX_INPROC_SERVER,
-            shell.IID_IShellLink,
-        )
-
-    def load(self, filename):
-        # Get an IPersist interface
-        # which allows save/restore of object to/from files
-        self._base.QueryInterface(pythoncom.IID_IPersistFile).Load(filename)
-
-    def save(self, filename):
-        self._base.QueryInterface(pythoncom.IID_IPersistFile).Save(filename, 0)
-
-    def __getattr__(self, name):
-        if name != "_base":
-            return getattr(self._base, name)
-
-
-if __name__ == "__main__":
-    import sys
-
-    if len(sys.argv) < 2:
-        print(
-            "Usage: %s LinkFile [path [, args[, description[, working_dir]]]]\n\nIf LinkFile does not exist, it will be created using the other args"
-        )
-        sys.exit(1)
-    file = sys.argv[1]
-    shortcut = PyShortcut()
-    if os.path.exists(file):
-        # load and dump info from file...
-        shortcut.load(file)
-        # now print data...
-        print(
-            "Shortcut in file %s to file:\n\t%s\nArguments:\n\t%s\nDescription:\n\t%s\nWorking Directory:\n\t%s\nItemIDs:\n\t<skipped>"
-            % (
-                file,
-                shortcut.GetPath(shell.SLGP_SHORTPATH)[0],
-                shortcut.GetArguments(),
-                shortcut.GetDescription(),
-                shortcut.GetWorkingDirectory(),
-                # shortcut.GetIDList(),
-            )
-        )
-    else:
-        if len(sys.argv) < 3:
-            print(
-                "Link file does not exist\nYou must supply the path, args, description and working_dir as args"
-            )
-            sys.exit(1)
-        # create the shortcut using rest of args...
-        data = map(
-            None,
-            sys.argv[2:],
-            ("SetPath", "SetArguments", "SetDescription", "SetWorkingDirectory"),
-        )
-        for value, function in data:
-            if value and function:
-                # call function on each non-null value
-                getattr(shortcut, function)(value)
-        shortcut.save(file)

py2docfx/venv/venv1/Lib/site-packages/win32comext/shell/demos/dump_link.py

@@ -1,58 +0,0 @@
-# dump_link.py - dumps information about shell shortcuts
-#
-import glob
-import os
-import sys
-
-import pythoncom
-from win32com.shell import shell, shellcon
-from win32com.storagecon import *
-
-
-def DumpLink(fname):
-    shellLink = pythoncom.CoCreateInstance(
-        shell.CLSID_ShellLink,
-        None,
-        pythoncom.CLSCTX_INPROC_SERVER,
-        shell.IID_IShellLink,
-    )
-    persistFile = shellLink.QueryInterface(pythoncom.IID_IPersistFile)
-    persistFile.Load(fname, STGM_READ)
-    shellLink.Resolve(0, shell.SLR_ANY_MATCH | shell.SLR_NO_UI)
-    fname, findData = shellLink.GetPath(0)
-    print("Filename:", fname, ", UNC=", shellLink.GetPath(shell.SLGP_UNCPRIORITY)[0])
-    print("Description:", shellLink.GetDescription())
-    print("Working Directory:", shellLink.GetWorkingDirectory())
-    print("Icon:", shellLink.GetIconLocation())
-
-
-def FavDumper(nothing, path, names):
-    # called by os.path.walk
-    for name in names:
-        print(name, end=" ")
-        try:
-            DumpLink(name)
-        except pythoncom.com_error:
-            print(" - not a link")
-
-
-def DumpFavorites():
-    favfold = str(shell.SHGetSpecialFolderPath(0, shellcon.CSIDL_FAVORITES))
-    print("Your favourites are at", favfold)
-    os.path.walk(favfold, FavDumper, None)
-
-
-if __name__ == "__main__":
-    if len(sys.argv) > 1:
-        for fspec in sys.argv[1:]:
-            files = glob.glob(fspec)
-            if files:
-                for file in files:
-                    print(file)
-                    DumpLink(file)
-                    print()
-            else:
-                print("Can not find", fspec)
-    else:
-        print("Dumping your favorites folder!")
-        DumpFavorites()