gh-74268: Popen: add kwarg to hide process window on Windows

[ammgws]

https://bugs.python.org/issue30082

Before: On Windows, pythonw opens a console window

After: On Windows, pythonw no longer opens a console window if force_hide is set

Test script:

import subprocess

subprocess.run(
    [
        "C:\\WINDOWS\\system32\\WindowsPowerShell\\v1.0\\powershell.exe",
        "-command",
        "Start-Sleep -Seconds 3; notepad.exe",
    ],
    check=True,
    # added in this PR:
    force_hide=True,
)

• Issue: hide command prompt when using subprocess.Popen with shell=False on Windows #74268

[ammgws]

Removed unrelated commit

[ammgws]

Resolved conflicts due to 23c0fb8

Also, what to do about the news entry?

[zooba]

Add a NEWS entry to the Windows section that reads:

Adds new ``force_hide`` argument to :mod:`subprocess` functions.
This passes ``SW_HIDE`` to the new process, which most applications
will use to not display any window even if they normally would.

[ammgws]

Done, cheers!

[ammgws]

I had a go at updating the docs as well, but I suspect it could be better worded so any layman could understand the differences between the two options.

[ammgws]

cpython/Lib/test/test_os.py

Line 254 in 62bf263

def write_windows_console(self, *args):

This could be replaced with force_hide

[python-cla-bot]

All commit authors signed the Contributor License Agreement.

[ammgws]

Not sure if something is meant to be done about the date in the filename since it has been years since it was first generated...

[ammgws]

Hi @eryksun, I have rebased this to resolve merge conflicts. It is from a few years ago but I believe there were no lingering review comments to block this one from proceeding.

[github-actions]

This PR is stale because it has been open for 90 days with no activity.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #34085712 | 📁 Comparing e9524eb against main (db0ee44)

  🔍 Preview build  

301 files changed · + 9 added · ± 291 modified · - 1 deleted

+ Added

• c-api/sentinel.html
• c-api/slots.html
• deprecations/pending-removal-in-3.21.html
• howto/abi3t-migration.html
• library/asyncio-threading.html
• library/asyncio-tools.html
• library/tkinter.fontchooser.html
• library/tkinter.systray.html
• whatsnew/3.16.html

± Modified

• bugs.html
• glossary.html
• index.html
• license.html
• py-modindex.html
• c-api/arg.html
• c-api/bytes.html
• c-api/capsule.html
• c-api/complex.html
• c-api/concrete.html
• and 281 more...

- Deleted

• library/asyncio-policy.html