py2docfx 0.1.15.dev2025501__py3-none-any.whl → 0.1.15.dev2038808__py3-none-any.whl

py2docfx/venv/venv1/Lib/site-packages/win32com/client/makepy.py

@@ -1,453 +0,0 @@
-# Originally written by Curt Hagenlocher, and various bits
-# and pieces by Mark Hammond (and now Greg Stein has had
-# a go too :-)
-
-# Note that the main worker code has been moved to genpy.py
-# As this is normally run from the command line, it reparses the code each time.
-# Now this is nothing more than the command line handler and public interface.
-
-# XXX - TO DO
-# XXX - Greg and Mark have some ideas for a revamp - just no
-#       time - if you want to help, contact us for details.
-#       Main idea is to drop the classes exported and move to a more
-#       traditional data driven model.
-
-"""Generate a .py file from an OLE TypeLibrary file.
-
-
-This module is concerned only with the actual writing of
-a .py file.  It draws on the @build@ module, which builds
-the knowledge of a COM interface.
-
-"""
-
-usageHelp = """ \
-
-Usage:
-
-  makepy.py [-i] [-v|q] [-h] [-u] [-o output_file] [-d] [typelib, ...]
-
-  -i    -- Show information for the specified typelib.
-
-  -v    -- Verbose output.
-
-  -q    -- Quiet output.
-
-  -h    -- Do not generate hidden methods.
-
-  -u    -- Convert all Unicode objects to strings.
-
-  -o    -- Create output in a specified output file.  If the path leading
-           to the file does not exist, any missing directories will be
-           created.
-           NOTE: -o cannot be used with -d.  This will generate an error.
-
-  -d    -- Generate the base code now and the class code on demand.
-           Recommended for large type libraries.
-
-  typelib -- A TLB, DLL, OCX or anything containing COM type information.
-             If a typelib is not specified, a window containing a textbox
-             will open from which you can select a registered type
-             library.
-
-Examples:
-
-  makepy.py -d
-
-    Presents a list of registered type libraries from which you can make
-    a selection.
-
-  makepy.py -d "Microsoft Excel 8.0 Object Library"
-
-    Generate support for the type library with the specified description
-    (in this case, the MS Excel object model).
-
-"""
-
-import importlib
-import os
-import sys
-
-import pythoncom
-from win32com.client import Dispatch, gencache, genpy, selecttlb
-
-bForDemandDefault = 0  # Default value of bForDemand - toggle this to change the world - see also gencache.py
-
-
-def usage():
-    sys.stderr.write(usageHelp)
-    sys.exit(2)
-
-
-def ShowInfo(spec):
-    if not spec:
-        tlbSpec = selecttlb.SelectTlb(excludeFlags=selecttlb.FLAG_HIDDEN)
-        if tlbSpec is None:
-            return
-        try:
-            tlb = pythoncom.LoadRegTypeLib(
-                tlbSpec.clsid, tlbSpec.major, tlbSpec.minor, tlbSpec.lcid
-            )
-        except pythoncom.com_error:  # May be badly registered.
-            sys.stderr.write(
-                "Warning - could not load registered typelib '%s'\n" % (tlbSpec.clsid)
-            )
-            tlb = None
-
-        infos = [(tlb, tlbSpec)]
-    else:
-        infos = GetTypeLibsForSpec(spec)
-    for tlb, tlbSpec in infos:
-        desc = tlbSpec.desc
-        if desc is None:
-            if tlb is None:
-                desc = "<Could not load typelib %s>" % (tlbSpec.dll)
-            else:
-                desc = tlb.GetDocumentation(-1)[0]
-        print(desc)
-        print(
-            " {}, lcid={}, major={}, minor={}".format(
-                tlbSpec.clsid, tlbSpec.lcid, tlbSpec.major, tlbSpec.minor
-            )
-        )
-        print(" >>> # Use these commands in Python code to auto generate .py support")
-        print(" >>> from win32com.client import gencache")
-        print(
-            " >>> gencache.EnsureModule('{}', {}, {}, {})".format(
-                tlbSpec.clsid, tlbSpec.lcid, tlbSpec.major, tlbSpec.minor
-            )
-        )
-
-
-class SimpleProgress(genpy.GeneratorProgress):
-    """A simple progress class prints its output to stderr"""
-
-    def __init__(self, verboseLevel):
-        self.verboseLevel = verboseLevel
-
-    def Close(self):
-        pass
-
-    def Finished(self):
-        if self.verboseLevel > 1:
-            sys.stderr.write("Generation complete..\n")
-
-    def SetDescription(self, desc, maxticks=None):
-        if self.verboseLevel:
-            sys.stderr.write(desc + "\n")
-
-    def Tick(self, desc=None):
-        pass
-
-    def VerboseProgress(self, desc, verboseLevel=2):
-        if self.verboseLevel >= verboseLevel:
-            sys.stderr.write(desc + "\n")
-
-    def LogBeginGenerate(self, filename):
-        self.VerboseProgress("Generating to %s" % filename, 1)
-
-    def LogWarning(self, desc):
-        self.VerboseProgress("WARNING: " + desc, 1)
-
-
-class GUIProgress(SimpleProgress):
-    def __init__(self, verboseLevel):
-        # Import some modules we need to we can trap failure now.
-        import pywin  # nopycln: import
-        import win32ui
-
-        SimpleProgress.__init__(self, verboseLevel)
-        self.dialog = None
-
-    def Close(self):
-        if self.dialog is not None:
-            self.dialog.Close()
-            self.dialog = None
-
-    def Starting(self, tlb_desc):
-        SimpleProgress.Starting(self, tlb_desc)
-        if self.dialog is None:
-            from pywin.dialogs import status
-
-            self.dialog = status.ThreadedStatusProgressDialog(tlb_desc)
-        else:
-            self.dialog.SetTitle(tlb_desc)
-
-    def SetDescription(self, desc, maxticks=None):
-        self.dialog.SetText(desc)
-        if maxticks:
-            self.dialog.SetMaxTicks(maxticks)
-
-    def Tick(self, desc=None):
-        self.dialog.Tick()
-        if desc is not None:
-            self.dialog.SetText(desc)
-
-
-def GetTypeLibsForSpec(arg):
-    """Given an argument on the command line (either a file name, library
-    description, or ProgID of an object) return a list of actual typelibs
-    to use."""
-    typelibs = []
-    try:
-        try:
-            tlb = pythoncom.LoadTypeLib(arg)
-            spec = selecttlb.TypelibSpec(None, 0, 0, 0)
-            spec.FromTypelib(tlb, arg)
-            typelibs.append((tlb, spec))
-        except pythoncom.com_error:
-            # See if it is a description
-            tlbs = selecttlb.FindTlbsWithDescription(arg)
-            if len(tlbs) == 0:
-                # Maybe it is the name of a COM object?
-                try:
-                    ob = Dispatch(arg)
-                    # and if so, it must support typelib info
-                    tlb, index = ob._oleobj_.GetTypeInfo().GetContainingTypeLib()
-                    spec = selecttlb.TypelibSpec(None, 0, 0, 0)
-                    spec.FromTypelib(tlb)
-                    tlbs.append(spec)
-                except pythoncom.com_error:
-                    pass
-            if len(tlbs) == 0:
-                print("Could not locate a type library matching '%s'" % (arg))
-            for spec in tlbs:
-                # Version numbers not always reliable if enumerated from registry.
-                # (as some libs use hex, other's don't.  Both examples from MS, of course.)
-                if spec.dll is None:
-                    tlb = pythoncom.LoadRegTypeLib(
-                        spec.clsid, spec.major, spec.minor, spec.lcid
-                    )
-                else:
-                    tlb = pythoncom.LoadTypeLib(spec.dll)
-
-                # We have a typelib, but it may not be exactly what we specified
-                # (due to automatic version matching of COM).  So we query what we really have!
-                attr = tlb.GetLibAttr()
-                spec.major = attr[3]
-                spec.minor = attr[4]
-                spec.lcid = attr[1]
-                typelibs.append((tlb, spec))
-        return typelibs
-    except pythoncom.com_error:
-        t, v, tb = sys.exc_info()
-        sys.stderr.write(f"Unable to load type library from '{arg}' - {v}\n")
-        tb = None  # Storing tb in a local is a cycle!
-        sys.exit(1)
-
-
-def GenerateFromTypeLibSpec(
-    typelibInfo,
-    file=None,
-    verboseLevel=None,
-    progressInstance=None,
-    bForDemand=bForDemandDefault,
-    bBuildHidden=1,
-):
-    if verboseLevel is None:
-        verboseLevel = 0  # By default, we use no gui and no verbose level!
-
-    if bForDemand and file is not None:
-        raise RuntimeError(
-            "You can only perform a demand-build when the output goes to the gen_py directory"
-        )
-    if isinstance(typelibInfo, tuple):
-        # Tuple
-        typelibCLSID, lcid, major, minor = typelibInfo
-        tlb = pythoncom.LoadRegTypeLib(typelibCLSID, major, minor, lcid)
-        spec = selecttlb.TypelibSpec(typelibCLSID, lcid, major, minor)
-        spec.FromTypelib(tlb, str(typelibCLSID))
-        typelibs = [(tlb, spec)]
-    elif isinstance(typelibInfo, selecttlb.TypelibSpec):
-        if typelibInfo.dll is None:
-            # Version numbers not always reliable if enumerated from registry.
-            tlb = pythoncom.LoadRegTypeLib(
-                typelibInfo.clsid,
-                typelibInfo.major,
-                typelibInfo.minor,
-                typelibInfo.lcid,
-            )
-        else:
-            tlb = pythoncom.LoadTypeLib(typelibInfo.dll)
-        typelibs = [(tlb, typelibInfo)]
-    elif hasattr(typelibInfo, "GetLibAttr"):
-        # A real typelib object!
-        # Could also use isinstance(typelibInfo, PyITypeLib) instead, but PyITypeLib is not directly exposed by pythoncom.
-        # 	pythoncom.TypeIIDs[pythoncom.IID_ITypeLib] seems to work
-        tla = typelibInfo.GetLibAttr()
-        guid = tla[0]
-        lcid = tla[1]
-        major = tla[3]
-        minor = tla[4]
-        spec = selecttlb.TypelibSpec(guid, lcid, major, minor)
-        typelibs = [(typelibInfo, spec)]
-    else:
-        typelibs = GetTypeLibsForSpec(typelibInfo)
-
-    if progressInstance is None:
-        progressInstance = SimpleProgress(verboseLevel)
-    progress = progressInstance
-
-    bToGenDir = file is None
-
-    for typelib, info in typelibs:
-        gen = genpy.Generator(typelib, info.dll, progress, bBuildHidden=bBuildHidden)
-
-        this_name = gencache.GetGeneratedFileName(
-            info.clsid, info.lcid, info.major, info.minor
-        )
-
-        if file is None:
-            full_name = os.path.join(gencache.GetGeneratePath(), this_name)
-            if bForDemand:
-                try:
-                    os.unlink(full_name + ".py")
-                except OSError:
-                    pass
-                try:
-                    os.unlink(full_name + ".pyc")
-                except OSError:
-                    pass
-                try:
-                    os.unlink(full_name + ".pyo")
-                except OSError:
-                    pass
-                if not os.path.isdir(full_name):
-                    os.mkdir(full_name)
-                outputName = os.path.join(full_name, "__init__.py")
-            else:
-                outputName = full_name + ".py"
-            fileUse = gen.open_writer(outputName)
-            progress.LogBeginGenerate(outputName)
-        else:
-            fileUse = file
-
-        worked = False
-        try:
-            gen.generate(fileUse, bForDemand)
-            worked = True
-        finally:
-            if file is None:
-                with gencache.ModuleMutex(this_name):
-                    gen.finish_writer(outputName, fileUse, worked)
-        importlib.invalidate_caches()
-        if bToGenDir:
-            progress.SetDescription("Importing module")
-            gencache.AddModuleToCache(info.clsid, info.lcid, info.major, info.minor)
-
-    progress.Close()
-
-
-def GenerateChildFromTypeLibSpec(
-    child, typelibInfo, verboseLevel=None, progressInstance=None
-):
-    if verboseLevel is None:
-        verboseLevel = (
-            0  # By default, we use no gui, and no verbose level for the children.
-        )
-    if isinstance(typelibInfo, tuple):
-        typelibCLSID, lcid, major, minor = typelibInfo
-        tlb = pythoncom.LoadRegTypeLib(typelibCLSID, major, minor, lcid)
-    else:
-        tlb = typelibInfo
-        tla = typelibInfo.GetLibAttr()
-        typelibCLSID = tla[0]
-        lcid = tla[1]
-        major = tla[3]
-        minor = tla[4]
-    spec = selecttlb.TypelibSpec(typelibCLSID, lcid, major, minor)
-    spec.FromTypelib(tlb, str(typelibCLSID))
-    typelibs = [(tlb, spec)]
-
-    if progressInstance is None:
-        progressInstance = SimpleProgress(verboseLevel)
-    progress = progressInstance
-
-    for typelib, info in typelibs:
-        dir_name = gencache.GetGeneratedFileName(
-            info.clsid, info.lcid, info.major, info.minor
-        )
-        dir_path_name = os.path.join(gencache.GetGeneratePath(), dir_name)
-        progress.LogBeginGenerate(dir_path_name)
-
-        gen = genpy.Generator(typelib, info.dll, progress)
-        gen.generate_child(child, dir_path_name)
-        progress.SetDescription("Importing module")
-        importlib.invalidate_caches()
-        with gencache.ModuleMutex(dir_name):
-            __import__("win32com.gen_py." + dir_name + "." + child)
-    progress.Close()
-
-
-def main():
-    import getopt
-
-    hiddenSpec = 1
-    outputName = None
-    verboseLevel = 1
-    doit = 1
-    bForDemand = bForDemandDefault
-    try:
-        opts, args = getopt.getopt(sys.argv[1:], "vo:huiqd")
-        for o, v in opts:
-            if o == "-h":
-                hiddenSpec = 0
-            elif o == "-o":
-                outputName = v
-            elif o == "-v":
-                verboseLevel += 1
-            elif o == "-q":
-                verboseLevel -= 1
-            elif o == "-i":
-                if len(args) == 0:
-                    ShowInfo(None)
-                else:
-                    for arg in args:
-                        ShowInfo(arg)
-                doit = 0
-            elif o == "-d":
-                bForDemand = not bForDemand
-
-    except getopt.error as msg:
-        sys.stderr.write(str(msg) + "\n")
-        usage()
-
-    if bForDemand and outputName is not None:
-        sys.stderr.write("Can not use -d and -o together\n")
-        usage()
-
-    if not doit:
-        return 0
-    if len(args) == 0:
-        rc = selecttlb.SelectTlb()
-        if rc is None:
-            sys.exit(1)
-        args = [rc]
-
-    if outputName is not None:
-        path = os.path.dirname(outputName)
-        if path != "" and not os.path.exists(path):
-            os.makedirs(path)
-        f = open(outputName, "wt", encoding="mbcs")
-
-    else:
-        f = None
-
-    for arg in args:
-        GenerateFromTypeLibSpec(
-            arg,
-            f,
-            verboseLevel=verboseLevel,
-            bForDemand=bForDemand,
-            bBuildHidden=hiddenSpec,
-        )
-
-    if f:
-        f.close()
-
-
-if __name__ == "__main__":
-    rc = main()
-    if rc:
-        sys.exit(rc)
-    sys.exit(0)

py2docfx/venv/venv1/Lib/site-packages/win32com/client/selecttlb.py

@@ -1,182 +0,0 @@
-"""Utilities for selecting and enumerating the Type Libraries installed on the system"""
-
-import pythoncom
-import win32api
-import win32con
-
-
-class TypelibSpec:
-    def __init__(self, clsid, lcid, major, minor, flags=0):
-        self.clsid = str(clsid)
-        self.lcid = int(lcid)
-        # We avoid assuming 'major' or 'minor' are integers - when
-        # read from the registry there is some confusion about if
-        # they are base 10 or base 16 (they *should* be base 16, but
-        # how they are written is beyond our control.)
-        self.major = major
-        self.minor = minor
-        self.dll = None
-        self.desc = None
-        self.ver_desc = None
-        self.flags = flags
-
-    # For the SelectList
-    def __getitem__(self, item):
-        if item == 0:
-            return self.ver_desc
-        raise IndexError("Can't index me!")
-
-    def __lt__(self, other):
-        me = (
-            (self.ver_desc or "").lower(),
-            (self.desc or "").lower(),
-            self.major,
-            self.minor,
-        )
-        them = (
-            (other.ver_desc or "").lower(),
-            (other.desc or "").lower(),
-            other.major,
-            other.minor,
-        )
-        return me < them
-
-    def __eq__(self, other):
-        return (
-            (self.ver_desc or "").lower() == (other.ver_desc or "").lower()
-            and (self.desc or "").lower() == (other.desc or "").lower()
-            and self.major == other.major
-            and self.minor == other.minor
-        )
-
-    def Resolve(self):
-        if self.dll is None:
-            return 0
-        tlb = pythoncom.LoadTypeLib(self.dll)
-        self.FromTypelib(tlb, None)
-        return 1
-
-    def FromTypelib(self, typelib, dllName=None):
-        la = typelib.GetLibAttr()
-        self.clsid = str(la[0])
-        self.lcid = la[1]
-        self.major = la[3]
-        self.minor = la[4]
-        if dllName:
-            self.dll = dllName
-
-
-def EnumKeys(root):
-    index = 0
-    ret = []
-    while 1:
-        try:
-            item = win32api.RegEnumKey(root, index)
-        except win32api.error:
-            break
-        try:
-            # Note this doesn't handle REG_EXPAND_SZ, but the implementation
-            # here doesn't need to - that is handled as the data is read.
-            val = win32api.RegQueryValue(root, item)
-        except win32api.error:
-            val = ""  # code using this assumes a string.
-
-        ret.append((item, val))
-        index += 1
-    return ret
-
-
-FLAG_RESTRICTED = 1
-FLAG_CONTROL = 2
-FLAG_HIDDEN = 4
-
-
-def EnumTlbs(excludeFlags=0):
-    """Return a list of TypelibSpec objects, one for each registered library."""
-    key = win32api.RegOpenKey(win32con.HKEY_CLASSES_ROOT, "Typelib")
-    iids = EnumKeys(key)
-    results = []
-    for iid, crap in iids:
-        try:
-            key2 = win32api.RegOpenKey(key, str(iid))
-        except win32api.error:
-            # A few good reasons for this, including "access denied".
-            continue
-        for version, tlbdesc in EnumKeys(key2):
-            major_minor = version.split(".", 1)
-            if len(major_minor) < 2:
-                major_minor.append("0")
-            # For some reason, this code used to assume the values were hex.
-            # This seems to not be true - particularly for CDO 1.21
-            # *sigh* - it appears there are no rules here at all, so when we need
-            # to know the info, we must load the tlb by filename and request it.
-            # The Resolve() method on the TypelibSpec does this.
-            # For this reason, keep the version numbers as strings - that
-            # way we can't be wrong!  Let code that really needs an int to work
-            # out what to do.  FWIW, https://www.betaarchive.com/wiki/index.php?title=Microsoft_KB_Archive/816970
-            # is pretty clear that they *should* be hex.
-            major = major_minor[0]
-            minor = major_minor[1]
-            key3 = win32api.RegOpenKey(key2, str(version))
-            try:
-                # The "FLAGS" are at this point
-                flags = int(win32api.RegQueryValue(key3, "FLAGS"))
-            except (win32api.error, ValueError):
-                flags = 0
-            if flags & excludeFlags == 0:
-                for lcid, crap in EnumKeys(key3):
-                    try:
-                        lcid = int(lcid)
-                    except ValueError:  # not an LCID entry
-                        continue
-                    # Check for both "{lcid}\win32" and "{lcid}\win64" keys.
-                    try:
-                        key4 = win32api.RegOpenKey(key3, f"{lcid}\\win32")
-                    except win32api.error:
-                        try:
-                            key4 = win32api.RegOpenKey(key3, f"{lcid}\\win64")
-                        except win32api.error:
-                            continue
-                    try:
-                        dll, typ = win32api.RegQueryValueEx(key4, None)
-                        if typ == win32con.REG_EXPAND_SZ:
-                            dll = win32api.ExpandEnvironmentStrings(dll)
-                    except win32api.error:
-                        dll = None
-                    spec = TypelibSpec(iid, lcid, major, minor, flags)
-                    spec.dll = dll
-                    spec.desc = tlbdesc
-                    spec.ver_desc = tlbdesc + " (" + version + ")"
-                    results.append(spec)
-    return results
-
-
-def FindTlbsWithDescription(desc):
-    """Find all installed type libraries with the specified description"""
-    ret = []
-    items = EnumTlbs()
-    for item in items:
-        if item.desc == desc:
-            ret.append(item)
-    return ret
-
-
-def SelectTlb(title="Select Library", excludeFlags=0):
-    """Display a list of all the type libraries, and select one.   Returns None if cancelled"""
-    import pywin.dialogs.list
-
-    items = EnumTlbs(excludeFlags)
-    # fixup versions - we assume hex (see __init__ above)
-    for i in items:
-        i.major = int(i.major, 16)
-        i.minor = int(i.minor, 16)
-    items.sort()
-    rc = pywin.dialogs.list.SelectFromLists(title, items, ["Type Library"])
-    if rc is None:
-        return None
-    return items[rc]
-
-
-# Test code.
-if __name__ == "__main__":
-    print(SelectTlb().__dict__)