py2docfx 0.1.13.dev2016838__py3-none-any.whl → 0.1.13.dev2021865__py3-none-any.whl

py2docfx/venv/venv1/Lib/site-packages/win32com/makegw/makegwenum.py

@@ -191,9 +191,7 @@ PyComEnumTypeObject PyIEnum{enumtype}::type("PyIEnum{enumtype}",
         sizeof(PyIEnum{enumtype}),
         PyIEnum{enumtype}_methods,
         GET_PYCOM_CTOR(PyIEnum{enumtype}));
-""".format(
-            **locals()
-        )
+""".format(**locals())
     )
 
 
@@ -329,7 +327,5 @@ STDMETHODIMP PyGEnum{enumtype}::Clone(
 
     return PyCom_CheckIEnumNextResult(hr, IID_IEnum{enumtype});
 }}
-""".format(
-            **locals()
-        )
+""".format(**locals())
     )

py2docfx/venv/venv1/Lib/site-packages/win32com/makegw/makegwparse.py

@@ -1,15 +1,15 @@
 """Utilities for makegw - Parse a header file to build an interface
 
- This module contains the core code for parsing a header file describing a
- COM interface, and building it into an "Interface" structure.
+This module contains the core code for parsing a header file describing a
+COM interface, and building it into an "Interface" structure.
 
- Each Interface has methods, and each method has arguments.
+Each Interface has methods, and each method has arguments.
 
- Each argument knows how to use Py_BuildValue or Py_ParseTuple to
- exchange itself with Python.
+Each argument knows how to use Py_BuildValue or Py_ParseTuple to
+exchange itself with Python.
 
- See the @win32com.makegw@ module for information in building a COM
- interface
+See the @win32com.makegw@ module for information in building a COM
+interface
 """
 
 from __future__ import annotations
@@ -771,12 +771,10 @@ AllConverters: dict[
     "const PUITEMID_CHILD": (ArgFormatterIDLIST, 0),
     "PCUITEMID_CHILD_ARRAY": (ArgFormatterIDLIST, 2),
     "const PCUITEMID_CHILD_ARRAY": (ArgFormatterIDLIST, 2),
+    # Auto-add all the simple types
+    **{key: (ArgFormatterSimple, 0) for key in ConvertSimpleTypes},
 }
 
-# Auto-add all the simple types
-for key in ConvertSimpleTypes.keys():
-    AllConverters[key] = ArgFormatterSimple, 0
-
 
 def make_arg_converter(arg):
     try:

py2docfx/venv/venv1/Lib/site-packages/win32com/olectl.py

@@ -1,6 +1,6 @@
 """Constants used by COM Controls
 
-  Hand created version of OLECTL.H constants.
+Hand created version of olectl.h constants.
 """
 
 import winerror

py2docfx/venv/venv1/Lib/site-packages/win32com/server/connect.py

@@ -1,6 +1,6 @@
 """Utilities for Server Side connections.
 
-  A collection of helpers for server side connection points.
+A collection of helpers for server side connection points.
 """
 
 import pythoncom
@@ -82,4 +82,4 @@ class ConnectableServer:
                 self._OnNotifyFail(interface, details)
 
     def _OnNotifyFail(self, interface, details):
-        print("Ignoring COM error to connection - %s" % (repr(details)))
+        print(f"Ignoring COM error to connection - {details!r}")

py2docfx/venv/venv1/Lib/site-packages/win32com/server/dispatcher.py

@@ -6,6 +6,7 @@ Please see policy.py for a discussion on dispatchers and policies
 from __future__ import annotations
 
 import traceback
+from typing import NoReturn
 
 import pythoncom
 import win32api
@@ -31,51 +32,48 @@ class DispatcherBase:
         # default location (typically 'print')
         self.logger = getattr(win32com, "logger", None)
 
-    # Note the "return self._HandleException_()" is purely to stop pychecker
-    # complaining - _HandleException_ will itself raise an exception for the
-    # pythoncom framework, so the result will never be seen.
     def _CreateInstance_(self, clsid, reqIID):
         try:
             self.policy._CreateInstance_(clsid, reqIID)
             return pythoncom.WrapObject(self, reqIID)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _QueryInterface_(self, iid):
         try:
             return self.policy._QueryInterface_(iid)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _Invoke_(self, dispid, lcid, wFlags, args):
         try:
             return self.policy._Invoke_(dispid, lcid, wFlags, args)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _GetIDsOfNames_(self, names, lcid):
         try:
             return self.policy._GetIDsOfNames_(names, lcid)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _GetTypeInfo_(self, index, lcid):
         try:
             return self.policy._GetTypeInfo_(index, lcid)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _GetTypeInfoCount_(self):
         try:
             return self.policy._GetTypeInfoCount_()
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _GetDispID_(self, name, fdex):
         try:
             return self.policy._GetDispID_(name, fdex)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _InvokeEx_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
         try:
@@ -83,45 +81,45 @@ class DispatcherBase:
                 dispid, lcid, wFlags, args, kwargs, serviceProvider
             )
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _DeleteMemberByName_(self, name, fdex):
         try:
             return self.policy._DeleteMemberByName_(name, fdex)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _DeleteMemberByDispID_(self, id):
         try:
             return self.policy._DeleteMemberByDispID_(id)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _GetMemberProperties_(self, id, fdex):
         try:
             return self.policy._GetMemberProperties_(id, fdex)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _GetMemberName_(self, dispid):
         try:
             return self.policy._GetMemberName_(dispid)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _GetNextDispID_(self, fdex, flags):
         try:
             return self.policy._GetNextDispID_(fdex, flags)
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
     def _GetNameSpaceParent_(self):
         try:
             return self.policy._GetNameSpaceParent_()
         except:
-            return self._HandleException_()
+            self._HandleException_()
 
-    def _HandleException_(self):
+    def _HandleException_(self) -> NoReturn:
         """Called whenever an exception is raised.
 
         Default behaviour is to print the exception.
@@ -152,8 +150,8 @@ class DispatcherTrace(DispatcherBase):
         rc = DispatcherBase._QueryInterface_(self, iid)
         if not rc:
             self._trace_(
-                "in {}._QueryInterface_ with unsupported IID {} ({})".format(
-                    repr(self.policy._obj_), IIDToInterfaceName(iid), iid
+                "in {!r}._QueryInterface_ with unsupported IID {} ({})".format(
+                    self.policy._obj_, IIDToInterfaceName(iid), iid
                 )
             )
         return rc
@@ -221,9 +219,7 @@ class DispatcherWin32trace(DispatcherTrace):
         if self.logger is None:
             # If we have no logger, setup our output.
             import win32traceutil  # Sets up everything.
-        self._trace_(
-            "Object with win32trace dispatcher created (object=%s)" % repr(object)
-        )
+        self._trace_(f"Object with win32trace dispatcher created (object={object!r})")
 
 
 class DispatcherOutputDebugString(DispatcherTrace):
@@ -236,7 +232,7 @@ class DispatcherOutputDebugString(DispatcherTrace):
 
 
 try:
-    import win32trace
+    import win32trace  # nopycln: import # Check for win32traceutil w/o importing it
 
     DefaultDebugDispatcher: type[DispatcherTrace] = DispatcherWin32trace
 except ImportError:  # no win32trace module - just use a print based one.

py2docfx/venv/venv1/Lib/site-packages/win32com/server/exception.py

@@ -1,15 +1,15 @@
 """Exception Handling
 
- Exceptions
+Exceptions
 
-     To better support COM exceptions, the framework allows for an instance to be
-     raised.  This instance may have a certain number of known attributes, which are
-     translated into COM exception details.
+    To better support COM exceptions, the framework allows for an instance to be
+    raised.  This instance may have a certain number of known attributes, which are
+    translated into COM exception details.
 
-     This means, for example, that Python could raise a COM exception that includes details
-     on a Help file and location, and a description for the user.
+    This means, for example, that Python could raise a COM exception that includes details
+    on a Help file and location, and a description for the user.
 
-     This module provides a class which provides the necessary attributes.
+    This module provides a class which provides the necessary attributes.
 """
 
 import sys
@@ -19,7 +19,7 @@ import pythoncom
 
 # Note that we derive from com_error, which derives from builtin Exception
 # Also note that we don't support "self.args", as we don't support tuple-unpacking
-class COMException(pythoncom.com_error):
+class COMException(pythoncom.com_error):  # type: ignore[name-defined] # Dynamic module
     """An Exception object that is understood by the framework.
 
     If the framework is presented with an exception of type class,

py2docfx/venv/venv1/Lib/site-packages/win32com/server/policy.py

@@ -66,8 +66,6 @@ Error Handling
  problem, rather than a COM error.
 """
 
-__author__ = "Greg Stein and Mark Hammond"
-
 import sys
 import types
 
@@ -92,6 +90,8 @@ from pythoncom import (
 
 from .exception import COMException
 
+__author__ = "Greg Stein and Mark Hammond"
+
 S_OK = 0
 
 # Few more globals to speed things.
@@ -321,7 +321,7 @@ class BasicWrapPolicy:
 
     # IDispatchEx support for policies.  Most of the IDispathEx functionality
     # by default will raise E_NOTIMPL.  Thus it is not necessary for derived
-    # policies to explicitely implement all this functionality just to not implement it!
+    # policies to explicitly implement all this functionality just to not implement it!
 
     def _GetDispID_(self, name, fdex):
         return self._getdispid_(name, fdex)
@@ -385,10 +385,8 @@ class BasicWrapPolicy:
         return self._getnextdispid_(fdex, dispid)
 
     def _getnextdispid_(self, fdex, dispid):
-        ids = list(self._name_to_dispid_.values())
+        ids = [id for id in self._name_to_dispid_.values() if id != DISPID_STARTENUM]
         ids.sort()
-        if DISPID_STARTENUM in ids:
-            ids.remove(DISPID_STARTENUM)
         if dispid == DISPID_STARTENUM:
             return ids[0]
         else:
@@ -803,15 +801,3 @@ def _import_module(mname):
     # Eeek - result of _import_ is "win32com" - not "win32com.a.b.c"
     # Get the full module from sys.modules
     return sys.modules[mname]
-
-
-#######
-#
-# Temporary hacks until all old code moves.
-#
-# These have been moved to a new source file, but some code may
-# still reference them here.  These will end up being removed.
-try:
-    from .dispatcher import DispatcherTrace, DispatcherWin32trace
-except ImportError:  # Quite likely a frozen executable that doesn't need dispatchers
-    pass

py2docfx/venv/venv1/Lib/site-packages/win32com/server/register.py

@@ -272,7 +272,7 @@ def RegisterServer(
             exeName = _find_localserver_exe(1)
             exeName = win32api.GetShortPathName(exeName)
             pyfile = _find_localserver_module()
-            command = f'{exeName} "{pyfile}" {str(clsid)}'
+            command = f'{exeName} "{pyfile}" {clsid}'
         _set_string(keyNameRoot + "\\LocalServer32", command)
     else:  # Remove any old LocalServer32 registrations
         _remove_key(keyNameRoot + "\\LocalServer32")
@@ -304,7 +304,7 @@ def RegisterServer(
     if addPyComCat is None:
         addPyComCat = pythoncom.frozen == 0
     if addPyComCat:
-        catids.append(CATID_PythonCOMServer)
+        catids = catids + [CATID_PythonCOMServer]
 
     # Set up the implemented categories
     if catids:
@@ -383,7 +383,7 @@ def UnregisterServer(clsid, progID=None, verProgID=None, customKeys=None):
 
 def GetRegisteredServerOption(clsid, optionName):
     """Given a CLSID for a server and option name, return the option value"""
-    keyNameRoot = f"CLSID\\{str(clsid)}\\{str(optionName)}"
+    keyNameRoot = f"CLSID\\{clsid}\\{optionName}"
     return _get_string(keyNameRoot)
 
 
@@ -448,7 +448,7 @@ def RegisterClasses(*classes, **flags):
                         win32api.FindFiles(sys.argv[0])[0][8]
                     )[0]
                 except (IndexError, win32api.error):
-                    # Can't find the script file - the user must explicitely set the _reg_... attribute.
+                    # Can't find the script file - the user must explicitly set the _reg_... attribute.
                     raise TypeError(
                         "Can't locate the script hosting the COM object - please set _reg_class_spec_ in your object"
                     )
@@ -523,11 +523,10 @@ def UnregisterClasses(*classes, **flags):
         extra()
 
 
-#
 # Unregister info is for installers or external uninstallers.
 # The WISE installer, for example firstly registers the COM server,
 # then queries for the Unregister info, appending it to its
-# install log.  Uninstalling the package will the uninstall the server
+# install log.  Uninstalling the package will uninstall the server.
 def UnregisterInfoClasses(*classes, **flags):
     ret = []
     for cls in classes:

py2docfx/venv/venv1/Lib/site-packages/win32com/servers/dictionary.py

@@ -85,10 +85,7 @@ class DictionaryPolicy(policy.BasicWrapPolicy):
             if wFlags & (DISPATCH_METHOD | DISPATCH_PROPERTYGET):
                 if l > 1:
                     raise COMException(scode=winerror.DISP_E_BADPARAMCOUNT)
-                try:
-                    return self._obj_[key]
-                except KeyError:
-                    return None  # unknown keys return None (VT_NULL)
+                return self._obj_.get(key)  # unknown keys return None (VT_NULL)
 
             if l != 2:
                 raise COMException(scode=winerror.DISP_E_BADPARAMCOUNT)
@@ -110,7 +107,7 @@ class DictionaryPolicy(policy.BasicWrapPolicy):
             return len(self._obj_)
 
         if dispid == pythoncom.DISPID_NEWENUM:
-            return util.NewEnum(list(self._obj_.keys()))
+            return util.NewEnum(list(self._obj_))
 
         raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
 

py2docfx/venv/venv1/Lib/site-packages/win32com/servers/interp.py

@@ -1,14 +1,14 @@
 """Python.Interpreter COM Server
 
-  This module implements a very very simple COM server which
-  exposes the Python interpreter.
+This module implements a very very simple COM server which
+exposes the Python interpreter.
 
-  This is designed more as a demonstration than a full blown COM server.
-  General functionality and Error handling are both limited.
+This is designed more as a demonstration than a full blown COM server.
+General functionality and Error handling are both limited.
 
-  To use this object, ensure it is registered by running this module
-  from Python.exe.  Then, from Visual Basic, use "CreateObject('Python.Interpreter')",
-  and call its methods!
+To use this object, ensure it is registered by running this module
+from Python.exe.  Then, from Visual Basic, use "CreateObject('Python.Interpreter')",
+and call its methods!
 """
 
 import winerror

py2docfx/venv/venv1/Lib/site-packages/win32com/servers/test_pycomtest.py

@@ -6,7 +6,6 @@ import pythoncom
 import winerror
 
 # Ensure the vtables in the tlb are known.
-from win32com import universal
 from win32com.client import constants, gencache
 from win32com.server.exception import COMException
 from win32com.server.util import wrap

py2docfx/venv/venv1/Lib/site-packages/win32com/test/GenTestScripts.py

@@ -3,6 +3,7 @@
 #
 import os
 import sys
+import traceback
 
 import pythoncom
 import win32com
@@ -60,10 +61,7 @@ def GenerateAll():
 
 def CleanAll():
     print("Cleaning generated test scripts...")
-    try:  # Clear exceptions!
-        1 / 0
-    except:
-        pass
+    traceback.clear_frames(sys.exc_info()[2])  # Clear exceptions!
     genPath = GetGenPath()
     for args in genList:
         try:

py2docfx/venv/venv1/Lib/site-packages/win32com/test/errorSemantics.py

@@ -158,7 +158,7 @@ def test():
             "The source in the exception tuple did not yield the correct string",
             str(com_exc),
         )
-        assert exc[2] == "\U0001F600", (
+        assert exc[2] == "\U0001f600", (
             "The description in the exception tuple did not yield the correct string",
             str(com_exc),
         )
@@ -213,7 +213,7 @@ if logging is not None:
         except pythoncom.error as exc:
             # `excepinfo` is a tuple with elt 2 being the traceback we captured.
             message = exc.excepinfo[2]
-            assert message.endswith("Exception: \U0001F600\n")
+            assert message.endswith("Exception: \U0001f600\n")
         assert handler.num_emits == 1, handler.num_emits
         assert handler.last_record.startswith(
             "pythoncom error: Unexpected exception in gateway method 'Commit'"
@@ -228,7 +228,7 @@ if logging is not None:
         except pythoncom.error as exc:
             # `excepinfo` is a tuple with elt 2 being the traceback we captured.
             message = exc.excepinfo[2]
-            assert message.endswith("Exception: \U0001F600\n")
+            assert message.endswith("Exception: \U0001f600\n")
         assert handler.num_emits == 1, handler.num_emits
         handler.reset()
 

py2docfx/venv/venv1/Lib/site-packages/win32com/test/pippo_server.py

@@ -41,10 +41,7 @@ class CPippo:
 
 
 def BuildTypelib():
-    if sys.version_info >= (3, 8):
-        from setuptools.modified import newer
-    else:
-        from distutils.dep_util import newer
+    from setuptools.modified import newer
 
     this_dir = os.path.dirname(__file__)
     idl = os.path.abspath(os.path.join(this_dir, "pippo.idl"))

py2docfx/venv/venv1/Lib/site-packages/win32com/test/testADOEvents.py

@@ -2,7 +2,7 @@ import os
 import time
 
 import pythoncom
-from win32com.client import Dispatch, DispatchWithEvents, constants
+from win32com.client import DispatchWithEvents, constants
 
 finished = 0  # Flag for the wait loop from (3) to test
 

py2docfx/venv/venv1/Lib/site-packages/win32com/test/testAXScript.py

@@ -15,10 +15,9 @@ class AXScript(win32com.test.util.TestCase):
         file = win32api.GetFullPathName(
             os.path.join(next(iter(win32com.axscript.client.__path__)), "pyscript.py")
         )
-        from win32com.test.util import RegisterPythonServer
 
         self.verbose = verbose
-        RegisterPythonServer(file, "python", verbose=self.verbose)
+        win32com.test.util.RegisterPythonServer(file, "python", verbose=self.verbose)
 
     def testHost(self):
         file = win32api.GetFullPathName(

py2docfx/venv/venv1/Lib/site-packages/win32com/test/testDictionary.py

@@ -17,7 +17,7 @@ def MakeTestDictionary():
 
 
 def TestDictAgainst(dict, check):
-    for key, value in list(check.items()):
+    for key, value in check.items():
         assert (
             dict(key) == value
         ), f"Indexing for '{key!r}' gave the incorrect value - {dict[key]!r}/{check[key]!r}"
@@ -26,9 +26,10 @@ def TestDictAgainst(dict, check):
 # Ensure we have the correct version registered.
 def Register(quiet):
     import win32com.servers.dictionary
-    from win32com.test.util import RegisterPythonServer
 
-    RegisterPythonServer(win32com.servers.dictionary.__file__, "Python.Dictionary")
+    win32com.test.util.RegisterPythonServer(
+        win32com.servers.dictionary.__file__, "Python.Dictionary"
+    )
 
 
 def TestDict(quiet=None):

py2docfx/venv/venv1/Lib/site-packages/win32com/test/testDynamic.py

@@ -37,8 +37,8 @@ class VeryPermissive:
             )  # Probably call as PROPGET.
 
         for arg in args[:-1]:
-            print(str(arg), end=" ")
-        print(str(args[-1]))
+            print(arg, end=" ")
+        print(args[-1])
 
 
 def Test():
@@ -65,9 +65,7 @@ def Test():
         client.TestSequence = v
         assert v == list(
             client.TestSequence
-        ), "Dynamic sequences not working! {!r}/{!r}".format(
-            repr(v), repr(client.testSequence)
-        )
+        ), f"Dynamic sequences not working! {v!r}/{client.testSequence!r}"
 
         client.write("This", "output", "has", "come", "via", "testDynamic.py")
         # Check our new "_FlagAsMethod" works (kinda!)

py2docfx/venv/venv1/Lib/site-packages/win32com/test/testExchange.py

@@ -6,7 +6,7 @@
 import os
 
 import pythoncom
-from win32com.client import constants, gencache
+from win32com.client import gencache
 
 ammodule = None  # was the generated module!
 
@@ -86,16 +86,11 @@ def TestUser(session):
     print("User has %d fields" % len(fields))
     for f in range(len(fields)):
         field = fields[f + 1]
-        try:
-            id = PropTagsById[field.ID]
-        except KeyError:
-            id = field.ID
+        id = PropTagsById.get(field.ID, field.ID)
         print(f"{field.Name}/{id}={field.Value}")
 
 
 def test():
-    import win32com.client
-
     oldcwd = os.getcwd()
     try:
         session = gencache.EnsureDispatch("MAPI.Session")

py2docfx/venv/venv1/Lib/site-packages/win32com/test/testGatewayAddresses.py

@@ -60,7 +60,7 @@ def FailObjectIdentity(ob1, ob2, when):
     if not CheckObjectIdentity(ob1, ob2):
         global numErrors
         numErrors += 1
-        print(when, f"are not identical ({repr(ob1)}, {repr(ob2)})")
+        print(f"{when} are not identical ({ob1!r}, {ob2!r})")
 
 
 class Dummy:

py2docfx/venv/venv1/Lib/site-packages/win32com/test/testIterators.py

@@ -126,7 +126,7 @@ class WrappedPythonCOMServerTestCase(_BaseTestCase):
 def suite():
     # We don't want our base class run
     suite = unittest.TestSuite()
-    for item in list(globals().values()):
+    for item in globals().values():
         if (
             isinstance(item, type)
             and issubclass(item, unittest.TestCase)