This is the readme for the Python for Win32 (pywin32) extensions, which provides access to many of the Windows APIs from Python.
See CHANGES.txt for recent notable changes.
Build 228 is the last build supporting Python 2, and as part of this transition, all code in the repository is now using Python 3 syntax. To highlight and celebrate this change, build 228 is the last numbered 2XX - the following build numbers start at 300.
In other words, there is no build 229 - the build numbers jump from 228 to 300.
A special shout-out to @xoviat who provided enormous help with the github move!
However, please do not open github issues for general support requests, or for problems or questions using the modules in this package - they will be closed. For such issues, please email the python-win32 mailing list - note that you must be subscribed to the list before posting.
By far the easiest way to use pywin32 is to grab binaries from the most recent release
Installing via PIP
You can install pywin32 via pip:
pip install pywin32
Note that if you want to use pywin32 for "system wide" features, such as registering COM objects or implementing Windows Services, then you must run the following command from an elevated command prompt:
python Scripts/pywin32_postinstall.py -install
Building from source
Building from source has been simplified recently - you just need Visual Studio and the Windows 10 SDK installed (the free compilers probably work too, but haven't been tested - let me know your experiences!)
setup.py is a standard distutils build script. You probably want:
python setup.py install
python setup.py --help
You can run
setup.py without any arguments to see
specific information about dependencies. A vanilla MSVC installation should
be able to build most extensions and list any extensions that could not be
built due to missing libraries - if the build actually fails with your
configuration, please open an issue.
The following steps are performed when making a new release - this is mainly to form a checklist so mhammond doesn't forget what to do :)
Ensure CHANGES.txt has everything worth noting, commit it.
Update setup.py with the new build number.
Execute build.bat, wait forever, test the artifacts.
Commit setup.py (so the new build number is in the repo), create a new git tag
Update setup.py with the new build number + ".1" (eg, 123.1), to ensure future test builds aren't mistaken for the real release.
Make sure everything is pushed to github, including the tag (ie,
git push --tags)
Upload the .exe installers to github (using the web UI), the .whl files to pypi (using
py -3.5 -m twine upload dist/*XXX*.whlwhere
XXXis the build number).
Send mail to python-win32