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

py2docfx/venv/venv1/Lib/site-packages/win32/scripts/pywin32_testall.py

@@ -0,0 +1,120 @@
+"""A test runner for pywin32"""
+
+import os
+import site
+import subprocess
+import sys
+
+# locate the dirs based on where this script is - it may be either in the
+# source tree, or in an installed Python 'Scripts' tree.
+project_root = os.path.dirname(os.path.dirname(os.path.dirname(__file__)))
+site_packages = [site.getusersitepackages()] + site.getsitepackages()
+
+failures = []
+
+
+# Run a test using subprocess and wait for the result.
+# If we get an returncode != 0, we know that there was an error, but we don't
+# abort immediately - we run as many tests as we can.
+def run_test(script, cmdline_extras):
+    dirname, scriptname = os.path.split(script)
+    # some tests prefer to be run from their directory.
+    cmd = [sys.executable, "-u", scriptname] + cmdline_extras
+    print("--- Running '%s' ---" % script)
+    sys.stdout.flush()
+    result = subprocess.run(cmd, check=False, cwd=dirname)
+    print(f"*** Test script '{script}' exited with {result.returncode}")
+    sys.stdout.flush()
+    if result.returncode:
+        failures.append(script)
+
+
+def find_and_run(possible_locations, extras):
+    for maybe in possible_locations:
+        if os.path.isfile(maybe):
+            run_test(maybe, extras)
+            break
+    else:
+        raise RuntimeError(
+            "Failed to locate a test script in one of %s" % possible_locations
+        )
+
+
+def main():
+    import argparse
+
+    code_directories = [project_root] + site_packages
+
+    parser = argparse.ArgumentParser(
+        description="A script to trigger tests in all subprojects of PyWin32."
+    )
+    parser.add_argument(
+        "-no-user-interaction",
+        default=False,
+        action="store_true",
+        help="(This is now the default - use `-user-interaction` to include them)",
+    )
+
+    parser.add_argument(
+        "-user-interaction",
+        action="store_true",
+        help="Include tests which require user interaction",
+    )
+
+    parser.add_argument(
+        "-skip-adodbapi",
+        default=False,
+        action="store_true",
+        help="Skip the adodbapi tests; useful for CI where there's no provider",
+    )
+
+    args, remains = parser.parse_known_args()
+
+    # win32, win32ui / Pythonwin
+
+    extras = []
+    if args.user_interaction:
+        extras.append("-user-interaction")
+    extras.extend(remains)
+    scripts = [
+        "win32/test/testall.py",
+        "Pythonwin/pywin/test/all.py",
+    ]
+    for script in scripts:
+        maybes = [os.path.join(directory, script) for directory in code_directories]
+        find_and_run(maybes, extras)
+
+    # win32com
+    maybes = [
+        os.path.join(directory, "win32com", "test", "testall.py")
+        for directory in [os.path.join(project_root, "com")] + site_packages
+    ]
+    extras = remains + ["1"]  # only run "level 1" tests in CI
+    find_and_run(maybes, extras)
+
+    # adodbapi
+    if not args.skip_adodbapi:
+        maybes = [
+            os.path.join(directory, "adodbapi", "test", "adodbapitest.py")
+            for directory in code_directories
+        ]
+        find_and_run(maybes, remains)
+        # This script has a hard-coded sql server name in it, (and markh typically
+        # doesn't have a different server to test on) but there is now supposed to be a server out there on the Internet
+        # just to run these tests, so try it...
+        maybes = [
+            os.path.join(directory, "adodbapi", "test", "test_adodbapi_dbapi20.py")
+            for directory in code_directories
+        ]
+        find_and_run(maybes, remains)
+
+    if failures:
+        print("The following scripts failed")
+        for failure in failures:
+            print(">", failure)
+        sys.exit(1)
+    print("All tests passed \\o/")
+
+
+if __name__ == "__main__":
+    main()

py2docfx/venv/venv1/Lib/site-packages/win32/scripts/regsetup.py

@@ -447,8 +447,7 @@ def RegisterShellInfo(searchPaths):
 
 #       FindRegisterApp("win32", ["win32con.pyc", "win32api%s.pyd" % suffix], searchPaths)
 
-usage = (
-    """\
+usage = """\
 regsetup.py - Setup/maintain the registry for Python apps.
 
 Run without options, (but possibly search paths) to repair a totally broken
@@ -475,9 +474,7 @@ Usage:   %s [options ...] paths ...
 
 --description   -- Print a description of the usage.
 --examples      -- Print examples of usage.
-"""
-    % sys.argv[0]
-)
+""" % sys.argv[0]
 
 description = """\
 If no options are processed, the program attempts to validate and set
@@ -500,9 +497,9 @@ of the registry.
 # Using raw string so that all paths meant to be copied read correctly inline and when printed
 examples = r"""
 Examples:
-"regsetup c:\wierd\spot\1 c:\wierd\spot\2"
+"regsetup c:\weird\spot\1 c:\weird\spot\2"
 Attempts to setup the core Python.  Looks in some standard places,
-as well as the 2 wierd spots to locate the core Python files (eg, Python.exe,
+as well as the 2 weird spots to locate the core Python files (eg, Python.exe,
 pythonXX.dll, the standard library and Win32 Extensions).
 
 "regsetup -a myappname . .\subdir"

py2docfx/venv/venv1/Lib/site-packages/win32/scripts/setup_d.py

@@ -61,7 +61,7 @@ def _docopy(src, dest):
         return 1
     except:
         print(f"Error copying '{src}' -> '{dest}'")
-        print(str(sys.exc_info()[1]))
+        print(sys.exc_info()[1])
         usage_and_die(3)
 
 

py2docfx/venv/venv1/Lib/site-packages/win32/test/handles.py

@@ -5,6 +5,14 @@ import pywintypes
 import win32api
 
 
+class TestError1(Exception):
+    pass
+
+
+class TestError2(Exception):
+    pass
+
+
 # A class that will never die vie refcounting, but will die via GC.
 class Cycle:
     def __init__(self, handle):
@@ -21,7 +29,7 @@ class PyHandleTestCase(unittest.TestCase):
             h = win32event.CreateEvent(None, 0, 0, None)
             if invalidate:
                 win32api.CloseHandle(int(h))
-            1 / 0
+            raise TestError1
             # If we invalidated, then the object destruction code will attempt
             # to close an invalid handle.  We don't wan't an exception in
             # this case
@@ -30,13 +38,13 @@ class PyHandleTestCase(unittest.TestCase):
             """This function should throw an OSError."""
             try:
                 f1(invalidate)
-            except ZeroDivisionError as exc:
-                raise OSError("raise 2")
+            except TestError1:
+                raise TestError2
 
-        self.assertRaises(OSError, f2, False)
+        self.assertRaises(TestError2, f2, False)
         # Now do it again, but so the auto object destruction
         # actually fails.
-        self.assertRaises(OSError, f2, True)
+        self.assertRaises(TestError2, f2, True)
 
     def testCleanup2(self):
         # Cause an exception during object destruction.

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_clipboard.py

@@ -7,7 +7,18 @@ import unittest
 import pywintypes
 import win32con
 import win32gui
-from win32clipboard import *
+from win32clipboard import (
+    CloseClipboard,
+    EmptyClipboard,
+    GetClipboardData,
+    GetClipboardDataHandle,
+    GetClipboardFormatName,
+    GetGlobalMemory,
+    OpenClipboard,
+    RegisterClipboardFormat,
+    SetClipboardData,
+    SetClipboardText,
+)
 
 custom_format_name = "PythonClipboardTestFormat"
 

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_sspi.py

@@ -84,7 +84,7 @@ class TestSSPI(unittest.TestCase):
 
     def _doTestEncryptStream(self, pkg_name):
         # Test out the SSPI/GSSAPI interop wrapping examples at
-        # https://docs.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi
+        # https://learn.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi
 
         sspiclient, sspiserver = self._doAuth(pkg_name)
 

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_win32api.py

@@ -14,6 +14,10 @@ import winerror
 from pywin32_testutil import TestSkipped
 
 
+class TestError(Exception):
+    pass
+
+
 class CurrentUserTestCase(unittest.TestCase):
     def testGetCurrentUser(self):
         domain = win32api.GetDomainName()
@@ -63,7 +67,7 @@ class Registry(unittest.TestCase):
         # This used to leave a stale exception behind.
         def reg_operation():
             hkey = win32api.RegCreateKey(win32con.HKEY_CURRENT_USER, self.key_name)
-            x = 3 / 0  # or a statement like: raise Exception
+            raise TestError
 
         # do the test
         try:
@@ -71,10 +75,10 @@ class Registry(unittest.TestCase):
                 try:
                     reg_operation()
                 except:
-                    1 / 0  # Force exception
+                    raise TestError  # Force a TestError
             finally:
                 win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, self.key_name)
-        except ZeroDivisionError:
+        except TestError:
             pass
 
     def testValues(self):
@@ -262,7 +266,7 @@ class Misc(unittest.TestCase):
             "BatteryLifeTime",
             "BatteryFullLifeTime",
         )
-        self.assertEqual(set(test_keys), set(sps.keys()))
+        self.assertEqual(set(test_keys), set(sps))
 
 
 if __name__ == "__main__":

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_win32clipboard.py

@@ -5,7 +5,6 @@ import win32clipboard
 
 
 class TestGetSetClipboardData(unittest.TestCase):
-
     def copyData(self, data, format_):
         win32clipboard.OpenClipboard()
         ret = None
@@ -30,13 +29,13 @@ class TestGetSetClipboardData(unittest.TestCase):
         test_data = {
             "Dummy str": win32clipboard.CF_UNICODETEXT,
             b"Dummy bytes text": win32clipboard.CF_TEXT,
-            b"Dummy\x00\xFF bytes": win32clipboard.CF_DIB,
+            b"Dummy\x00\xff bytes": win32clipboard.CF_DIB,
         }
         for data, fmt in test_data.items():
             self.assertEqual(data, self.copyData(data, fmt))
         test_data = {
             "Dummy str": (win32clipboard.CF_TEXT, win32clipboard.CF_DIB),
-            b"Dummy\x00\xFF bytes": (win32clipboard.CF_UNICODETEXT,),
+            b"Dummy\x00\xff bytes": (win32clipboard.CF_UNICODETEXT,),
         }
         for data, formats in test_data.items():
             for fmt in formats:

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_win32cred.py

@@ -5,7 +5,6 @@ import win32cred
 
 
 class TestCredFunctions(unittest.TestCase):
-
     def setUp(self):
         self.flags = 0
         self.dummy_cred = {

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_win32crypt.py

@@ -2,11 +2,24 @@
 
 import contextlib
 import unittest
-from typing import Any, Iterator
+from collections.abc import Iterator
+from typing import Any
 
 import win32crypt
-from pywin32_testutil import TestSkipped, find_test_fixture, testmain
-from win32cryptcon import *
+from pywin32_testutil import find_test_fixture, testmain
+from win32cryptcon import (
+    CERT_QUERY_CONTENT_CERT,
+    CERT_QUERY_CONTENT_FLAG_CERT,
+    CERT_QUERY_FORMAT_BASE64_ENCODED,
+    CERT_QUERY_FORMAT_BINARY,
+    CERT_QUERY_FORMAT_FLAG_ALL,
+    CERT_QUERY_OBJECT_BLOB,
+    CERT_QUERY_OBJECT_FILE,
+    CERT_STORE_ADD_REPLACE_EXISTING,
+    CERT_STORE_PROV_SYSTEM,
+    CERT_SYSTEM_STORE_CURRENT_USER,
+    CERT_SYSTEM_STORE_LOCAL_MACHINE,
+)
 
 
 class Crypt(unittest.TestCase):

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_win32file.py

@@ -227,16 +227,25 @@ class TestSimpleOps(unittest.TestCase):
         )
         try:
             ct, at, wt = win32file.GetFileTime(f)
-            self.assertTrue(
-                ct >= now,
+            # NOTE (Avasam): I've seen the time be off from -0.003 to +1.11 seconds,
+            # so the above comment about microseconds might be wrong.
+            # Let's standardize ms and avoid random CI failures
+            # https://github.com/mhammond/pywin32/issues/2203
+            ct = ct.replace(microsecond=0)
+            at = at.replace(microsecond=0)
+            wt = wt.replace(microsecond=0)
+            self.assertGreaterEqual(
+                ct,
+                now,
                 f"File was created in the past - now={now}, created={ct}",
             )
-            self.assertTrue(now <= ct <= nowish, (now, ct))
-            self.assertTrue(
-                wt >= now,
+            self.assertTrue(now <= ct <= nowish, (now, ct, nowish))
+            self.assertGreaterEqual(
+                wt,
+                now,
                 f"File was written-to in the past now={now}, written={wt}",
             )
-            self.assertTrue(now <= wt <= nowish, (now, wt))
+            self.assertTrue(now <= wt <= nowish, (now, wt, nowish))
 
             # Now set the times.
             win32file.SetFileTime(f, later, later, later, UTCTimes=True)
@@ -632,7 +641,10 @@ class TestDirectoryChanges(unittest.TestCase):
             try:
                 print("waiting", dh)
                 changes = win32file.ReadDirectoryChangesW(
-                    dh, 8192, False, flags  # sub-tree
+                    dh,
+                    8192,
+                    False,  # sub-tree
+                    flags,
                 )
                 print("got", changes)
             except:
@@ -646,7 +658,11 @@ class TestDirectoryChanges(unittest.TestCase):
         overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
         while 1:
             win32file.ReadDirectoryChangesW(
-                dh, buf, False, flags, overlapped  # sub-tree
+                dh,
+                buf,
+                False,  # sub-tree
+                flags,
+                overlapped,
             )
             # Wait for our event, or for 5 seconds.
             rc = win32event.WaitForSingleObject(overlapped.hEvent, 5000)

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_win32gui.py

@@ -4,7 +4,6 @@ import operator
 import sys
 import unittest
 
-import pywin32_testutil
 import pywintypes
 import win32api
 import win32gui

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_win32guistruct.py

@@ -3,7 +3,6 @@ import unittest
 
 import pythoncom
 import win32con
-import win32gui
 import win32gui_struct
 
 
@@ -13,10 +12,8 @@ class TestBase(unittest.TestCase):
         for n, v in kw.items():
             self.assertEqual(v, d[n], f"'{n}' doesn't match: {v!r} != {d[n]!r}")
             checked[n] = True
-        checked_keys = list(checked.keys())
-        passed_keys = list(kw.keys())
-        checked_keys.sort()
-        passed_keys.sort()
+        checked_keys = sorted(checked)
+        passed_keys = sorted(kw)
         self.assertEqual(checked_keys, passed_keys)
 
 

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_win32inet.py

@@ -2,22 +2,39 @@ import unittest
 
 import winerror
 from pywin32_testutil import TestSkipped, testmain
-from win32inet import *
-from win32inetcon import *
+from win32inet import (
+    FtpCommand,
+    InternetCanonicalizeUrl,
+    InternetConnect,
+    InternetGetCookie,
+    InternetGetLastResponseInfo,
+    InternetOpen,
+    InternetOpenUrl,
+    InternetReadFile,
+    InternetSetCookie,
+    error,
+)
+from win32inetcon import (
+    FTP_TRANSFER_TYPE_ASCII,
+    INTERNET_FLAG_EXISTING_CONNECT,
+    INTERNET_INVALID_PORT_NUMBER,
+    INTERNET_OPEN_TYPE_DIRECT,
+    INTERNET_SERVICE_FTP,
+)
 
 
 class CookieTests(unittest.TestCase):
     def testCookies(self):
         data = "TestData=Test"
-        InternetSetCookie("http://www.python.org", None, data)
-        got = InternetGetCookie("http://www.python.org", None)
+        InternetSetCookie("https://www.python.org", None, data)
+        got = InternetGetCookie("https://www.python.org", None)
         # handle that there might already be cookies for the domain.
         bits = (x.strip() for x in got.split(";"))
         self.assertTrue(data in bits)
 
     def testCookiesEmpty(self):
         try:
-            InternetGetCookie("http://site-with-no-cookie.python.org", None)
+            InternetGetCookie("https://site-with-no-cookie.python.org", None)
             self.fail("expected win32 exception")
         except error as exc:
             self.assertEqual(exc.winerror, winerror.ERROR_NO_MORE_ITEMS)
@@ -44,7 +61,7 @@ class TestNetwork(unittest.TestCase):
 
     def testPythonDotOrg(self):
         hdl = InternetOpenUrl(
-            self.hi, "http://www.python.org", None, INTERNET_FLAG_EXISTING_CONNECT
+            self.hi, "https://www.python.org", None, INTERNET_FLAG_EXISTING_CONNECT
         )
         chunks = []
         while 1:

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_win32net.py

@@ -1,7 +1,6 @@
 import unittest
 
 import win32net
-import win32netcon
 
 
 class TestCase(unittest.TestCase):

py2docfx/venv/venv1/Lib/site-packages/win32/test/test_win32ts.py

@@ -0,0 +1,19 @@
+# Tests for win32ts module
+
+import unittest
+
+import win32ts
+
+
+class Win32TsTestCase(unittest.TestCase):
+    def test_is_remote_session(self):
+        ret = win32ts.WTSQuerySessionInformation(
+            win32ts.WTS_CURRENT_SERVER_HANDLE,
+            win32ts.WTS_CURRENT_SESSION,
+            win32ts.WTSIsRemoteSession,
+        )
+        self.assertIsInstance(ret, bool)
+
+
+if __name__ == "__main__":
+    unittest.main()

py2docfx/venv/venv1/Lib/site-packages/win32/winxpgui.py

@@ -3,19 +3,11 @@ The `winxpgui` module is obsolete and has been completely replaced \
 by `win32gui` and `win32console.GetConsoleWindow`. Use those instead. \
 """
 
-from __future__ import annotations
-
 import warnings
 
-from win32console import (
+from win32console import (  # nopycln: import
     GetConsoleWindow as GetConsoleWindow,  # noqa: PLC0414 # Explicit re-export
 )
-from win32gui import *
+from win32gui import *  # nopycln: import
 
-warnings.warn(
-    """\
-The `winxpgui` module is obsolete and has been completely replaced \
-by `win32gui` and `win32console.GetConsoleWindow`. Use those instead. \
-""",
-    category=DeprecationWarning,
-)
+warnings.warn(str(__doc__), category=DeprecationWarning)

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

@@ -17,7 +17,9 @@ This obviously applies to all cooperating objects, not just DAO and
 Access.
 """
 
-mapCLSIDToClass = {}
+from __future__ import annotations
+
+mapCLSIDToClass: dict[str, type] = {}
 
 
 def RegisterCLSID(clsid, pythonClass):