py2docfx 0.1.13rc2012291__py3-none-any.whl → 0.1.13rc2022156__py3-none-any.whl

py2docfx/venv/venv1/Lib/site-packages/win32/lib/win32gui_struct.py

@@ -91,7 +91,7 @@ def UnpackNMITEMACTIVATE(lparam):
 
 
 # MENUITEMINFO struct
-# http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/WinUI/WindowsUserInterface/Resources/Menus/MenuReference/MenuStructures/MENUITEMINFO.asp
+# https://learn.microsoft.com/en-us/windows/win32/api/winuser/ns-winuser-menuiteminfow
 # We use the struct module to pack and unpack strings as MENUITEMINFO
 # structures.  We also have special handling for the 'fMask' item in that
 # structure to avoid the caller needing to explicitly check validity
@@ -463,7 +463,7 @@ def EmptyTVITEM(hitem, mask=None, text_buf_size=512):
     else:
         text_addr = text_buf_size = 0
     buf = struct.pack(
-        _tvitem_fmt, mask, hitem, 0, 0, text_addr, text_buf_size, 0, 0, 0, 0  # text
+        _tvitem_fmt, mask, hitem, 0, 0, text_addr, text_buf_size, 0, 0, 0, 0
     )
     return array.array("b", buf), extra
 
@@ -758,7 +758,7 @@ def PackLVCOLUMN(fmt=None, cx=None, text=None, subItem=None, image=None, order=N
         text_addr, _ = text_buffer.buffer_info()
         text_len = len(text)
     buf = struct.pack(
-        _lvcolumn_fmt, mask, fmt, cx, text_addr, text_len, subItem, image, order  # text
+        _lvcolumn_fmt, mask, fmt, cx, text_addr, text_len, subItem, image, order
     )
     return array.array("b", buf), extra
 
@@ -808,9 +808,7 @@ def EmptyLVCOLUMN(mask=None, text_buf_size=512):
         text_addr, _ = text_buffer.buffer_info()
     else:
         text_addr = text_buf_size = 0
-    buf = struct.pack(
-        _lvcolumn_fmt, mask, 0, 0, text_addr, text_buf_size, 0, 0, 0  # text
-    )
+    buf = struct.pack(_lvcolumn_fmt, mask, 0, 0, text_addr, text_buf_size, 0, 0, 0)
     return array.array("b", buf), extra
 
 
@@ -952,6 +950,8 @@ def UnpackDEV_BROADCAST(lparam):
         _, _, _, x["unitmask"], x["flags"] = struct.unpack(
             fmt, buf[: struct.calcsize(fmt)]
         )
+    elif devtype == win32con.DBT_DEVTYP_PORT:
+        x["name"] = win32gui.PyGetString(lparam + struct.calcsize(hdr_format))
     else:
         raise NotImplementedError("unknown device type %d" % (devtype,))
     return DEV_BROADCAST_INFO(devtype, **extra)

py2docfx/venv/venv1/Lib/site-packages/win32/lib/win32pdhquery.py

@@ -88,10 +88,10 @@ number of common one-off tasks.
 If you can access the MS Developers Network Library, you can find
 information about the PDH API as MS describes it.  For a background article,
 try:
-http://msdn.microsoft.com/library/en-us/dnperfmo/html/msdn_pdhlib.asp
+https://web.archive.org/web/20040926110045/http://msdn.microsoft.com:80/library/en-us/dnperfmo/html/msdn_pdhlib.asp
 
 The reference guide for the PDH API was last spotted at:
-http://msdn.microsoft.com/library/en-us/perfmon/base/using_the_pdh_interface.asp
+https://learn.microsoft.com/en-us/windows/win32/perfctrs/using-the-pdh-functions-to-consume-counter-data
 
 
 In general the Python version of the API is just a wrapper around the
@@ -108,7 +108,7 @@ in this plan.  There should be an article describing the creation of
 a simple logger there, but the example above is 90% of the work of
 that project, so don't sweat it if you don't find anything there.
 (currently the account hasn't been set up).
-http://starship.skyport.net/crew/mcfletch/
+https://web.archive.org/web/19980422204546/http://starship.skyport.net/crew/mcfletch/
 
 If you need to contact me immediately, (why I can't imagine), you can
 email me at mcfletch@golden.net, or just post your question to the
@@ -331,9 +331,8 @@ class BaseQuery:
                 if not ok:
                     temp.append(-1)  # a better way to signal failure???
             return temp
-        except (
-            win32api.error
-        ):  # will happen if, for instance, no counters are part of the query and we attempt to collect data for it.
+        # will happen if, for instance, no counters are part of the query and we attempt to collect data for it.
+        except win32api.error:
             return [-1] * len(self.counters)
 
     # pickle functions
@@ -505,10 +504,10 @@ class Query(BaseQuery):
     def collectdatawhile(self, period=1):
         """
         Threaded collection of performance data:
-        This method sets up a simple semaphor system for signalling
+        This method sets up a simple semaphore system for signalling
         when you would like to start and stop a threaded data collection
         method.  The collection runs every period seconds until the
-        semaphor attribute is set to a non-true value (which normally
+        semaphore attribute is set to a non-true value (which normally
         should be done by calling query.collectdatawhile_stop() .)
         e.g.:
                 query.collectdatawhile(2)
@@ -561,11 +560,11 @@ class Query(BaseQuery):
         self.volatilecounters = volatilecounters
 
 
-class QueryError:
-    def __init__(self, query):
+class QueryError(Exception):
+    def __init__(self, query: BaseQuery):
         self.query = query
 
     def __repr__(self):
-        return "<Query Error in %s>" % repr(self.query)
+        return f"<Query Error in {self.query!r}>"
 
     __str__ = __repr__

py2docfx/venv/venv1/Lib/site-packages/win32/lib/win32pdhutil.py

@@ -27,7 +27,7 @@ import win32pdh
 error = win32pdh.error  # Re-exported alias
 
 # Handle some localization issues.
-# see http://support.microsoft.com/default.aspx?scid=http://support.microsoft.com:80/support/kb/articles/Q287/1/59.asp&NoWebContent=1
+# see https://www.betaarchive.com/wiki/index.php?title=Microsoft_KB_Archive/287159
 # Build a map of english_counter_name: counter_id
 counter_english_map: dict[str, int] = {}
 
@@ -60,8 +60,8 @@ def GetPerformanceAttributes(
     # thread's CPU usage is either 0 or 100).  To read counters like this,
     # you should copy this function, but keep the counter open, and call
     # CollectQueryData() each time you need to know.
-    # See http://support.microsoft.com/default.aspx?scid=kb;EN-US;q262938
-    # and http://msdn.microsoft.com/library/en-us/dnperfmo/html/perfmonpt2.asp
+    # See https://www.betaarchive.com/wiki/index.php?title=Microsoft_KB_Archive/262938
+    # and https://web.archive.org/web/20040926105842/http://msdn.microsoft.com:80/library/en-us/dnperfmo/html/perfmonpt2.asp
     # My older explanation for this was that the "AddCounter" process forced
     # the CPU to 100%, but the above makes more sense :)
     path = win32pdh.MakeCounterPath((machine, object, instance, None, inum, counter))
@@ -145,8 +145,8 @@ def ShowAllProcesses():
                 )
                 hcs.append(win32pdh.AddCounter(hq, path))
             win32pdh.CollectQueryData(hq)
-            # as per http://support.microsoft.com/default.aspx?scid=kb;EN-US;q262938, some "%" based
-            # counters need two collections
+            # as per https://www.betaarchive.com/wiki/index.php?title=Microsoft_KB_Archive/262938
+            # some "%" based  counters need two collections
             time.sleep(0.01)
             win32pdh.CollectQueryData(hq)
             print("%-15s\t" % (instance[:15]), end=" ")

py2docfx/venv/venv1/Lib/site-packages/win32/lib/win32rcparser.py

@@ -7,6 +7,7 @@
 This is a parser for Windows .rc files, which are text files which define
 dialogs and other Windows UI resources.
 """
+
 from __future__ import annotations
 
 import os

py2docfx/venv/venv1/Lib/site-packages/win32/lib/win32serviceutil.py

@@ -63,8 +63,7 @@ def LocatePythonServiceExe(exe=None):
 
     # If pywintypes.dll isn't next to us, or at least next to pythonXX.dll,
     # there's a good chance the service will not run. That's usually copied by
-    # `pywin32_postinstall`, but putting it next to the python DLL seems
-    # reasonable.
+    # `pywin32_postinstall`, but putting it next to the python DLL seems reasonable.
     # (Unlike the .exe above, we don't unconditionally copy this, and possibly
     # copy it to a different place. Doesn't seem a good reason for that!?)
     python_dll = win32api.GetModuleFileName(sys.dllhandle)
@@ -751,10 +750,9 @@ def HandleCommandLine(
                 "delayed": win32service.SERVICE_AUTO_START,  ## ChangeServiceConfig2 called later
                 "disabled": win32service.SERVICE_DISABLED,
             }
-            try:
-                startup = map[val.lower()]
-            except KeyError:
-                print("'%s' is not a valid startup option" % val)
+            startup = map.get(val.lower())
+            if not startup:
+                print(f"{val!r} is not a valid startup option")
             if val.lower() == "delayed":
                 delayedstart = True
             elif val.lower() == "auto":