Make pywin32_postinstall and pywin32_testall into Console Scripts

.github/workflows/main.yml

@@ -52,7 +52,7 @@ jobs:
       - name: Run tests
         # Run the tests directly from the source dir so support files (eg, .wav files etc)
         # can be found - they aren't installed into the Python tree.
-        run: python pywin32_testall.py -v -skip-adodbapi
+        run: python -m win32.scripts.pywin32_testall -v -skip-adodbapi
 
       - name: Build wheels
         run: pip wheel . -v --wheel-dir=dist

README.md

@@ -57,7 +57,7 @@ Outside of a virtual environment you might want to install COM objects, services
 this by executing:
 
 ```shell
-python Scripts/pywin32_postinstall.py -install
+pywin32_postinstall -install
 ```
 
 From the root of your Python installation.
@@ -91,7 +91,7 @@ It usually means one of 2 things:
 So you should run it again:
 
     ```shell
-    python Scripts/pywin32_postinstall.py -install
+    pywin32_postinstall -install
     ```
 
     This will make some small attempts to cleanup older conflicting installs.

setup.py

@@ -2108,7 +2108,18 @@ def convert_optional_data_files(files):
     license="PSF",
     classifiers=classifiers,
     cmdclass=cmdclass,
-    scripts=["pywin32_postinstall.py", "pywin32_testall.py"],
+    # This adds the scripts under Python3XX/Scripts, but doesn't actually do much
+    scripts=[
+        "win32/scripts/pywin32_postinstall.py",
+        "win32/scripts/pywin32_testall.py",
+    ],
+    # This shortcuts `python -m win32.scripts.some_script` to just `some_script`
+    entry_points={
+        "console_scripts": [
+            "pywin32_postinstall = win32.scripts.pywin32_postinstall:main",
+            "pywin32_testall = win32.scripts.pywin32_testall:main",
+        ]
+    },
     ext_modules=ext_modules,
     package_dir={
         "win32com": "com/win32com",

pywin32_postinstall.py → win32/scripts/pywin32_postinstall.py

@@ -657,6 +657,10 @@ def main():
 
     > python pywin32_postinstall.py -install
 
+    * or if pywin32 is already installed:
+
+    > pywin32_postinstall -install
+
     This should be run automatically after installation,
     but if it fails you can run it again.