Python for Window Extensions
Project description
pywin32
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.
Only Python 3 is supported. If you want Python 2 support, you want build 228
.
Docs
The docs are a long and sad story, but there's now an online version of the helpfile that ships with the installers (thanks @ofek!). Lots of that is very old, but some is auto-generated and current. Would love help untangling the docs!
Support
Feel free to open issues for all bugs (or suspected bugs) in pywin32. pull-requests for all bugs or features are also welcome.
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.
Binaries
By far the easiest way to use pywin32 is to grab binaries from the most recent release
Note that there are no 32-bit binary installers for 3.10 and later - see this github issue
Installing via PIP
You can install pywin32 via pip:
pip install pywin32
If you encounter any problems when upgrading (eg, "module not found" errors or similar), you should execute:
python Scripts/pywin32_postinstall.py -install
This will make some small attempts to cleanup older conflicting installs.
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 that command from an elevated (ie, "Run as Administrator) command prompt.
The specified procedure could not be found
/ Entry-point not found
Errors?
A very common report is that people install pywin32, but many imports fail with errors similar to the above.
In almost all cases, this tends to mean there are other pywin32 DLLs installed in your system, but in a different location than the new ones. This sometimes happens in environments that come with pywin32 pre-shipped (eg, anaconda?).
The possible solutions are:
-
Run the "post_install" script documented above.
-
Otherwise, find and remove all other copies of
pywintypesXX.dll
andpythoncomXX.dll
(whereXX
is the Python version - eg, "39")
Running as a Windows Service
Modern Python installers do not, by default, install Python in a way that is suitable for running as a service, particularly for other users.
-
Ensure Python is installed in a location where the user running the service has access to the installation and is able to load
pywintypesXX.dll
andpythonXX.dll
. -
Manually copy
pythonservice.exe
from thesite-packages/win32
directory to the same place as these DLLs.
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
or
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.
Release process
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.
-
Upload .whl artifacts to pypi - we do this before pushing the tag because they might be rejected for an invalid
README.md
. Done viapy -3.5 -m twine upload dist/*XXX*.whl
. -
Commit setup.py (so the new build number is in the repo), create a new git tag
-
Upload the .exe installers to github.
-
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
) -
Send mail to python-win32
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Hashes for pywin32-304-cp311-cp311-win_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cbbe34dad39bdbaa2889a424d28752f1b4971939b14b1bb48cbf0182a3bcfc43 |
|
MD5 | 2e238812b419739fa46031d2a9cad37e |
|
BLAKE2b-256 | 39c0cd6cb7bd1619f647b1614cf622190e4ff089c21032c219da9a7ae3c1de6d |
Hashes for pywin32-304-cp311-cp311-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7ffa0c0fa4ae4077e8b8aa73800540ef8c24530057768c3ac57c609f99a14fd4 |
|
MD5 | e4647e4396baa2ec95ec2369866a68bd |
|
BLAKE2b-256 | 6b9e44c8b74afb6657e1ca48b4855fcdebad29ae4ead654d88238bea319ec993 |
Hashes for pywin32-304-cp311-cp311-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 30c53d6ce44c12a316a06c153ea74152d3b1342610f1b99d40ba2795e5af0269 |
|
MD5 | 27690839bff24ab442c49bb2bd8da19e |
|
BLAKE2b-256 | dd1a3fabb07100936c52ec063e4de01ecfbdef7120704f15277b3565cc2f461f |
Hashes for pywin32-304-cp310-cp310-win_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d3ee45adff48e0551d1aa60d2ec066fec006083b791f5c3527c40cd8aefac71f |
|
MD5 | f7acd14410f3748bc44c0ec91a2b1b3b |
|
BLAKE2b-256 | 7591fa2a9d3861184df4c2dc57c9a29e6e856f6bbe3702acccf169329f9b6eae |
Hashes for pywin32-304-cp310-cp310-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4f32145913a2447736dad62495199a8e280a77a0ca662daa2332acf849f0be48 |
|
MD5 | 46d57fe54a4e2cdff8bc631302570562 |
|
BLAKE2b-256 | 14079a2bd2cdcdeecd013ed83173209f1c984662ef05922ef6fe5f0fb9cc120e |
Hashes for pywin32-304-cp310-cp310-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3c7bacf5e24298c86314f03fa20e16558a4e4138fc34615d7de4070c23e65af3 |
|
MD5 | 4a1739e91585d6585d1080979db278e5 |
|
BLAKE2b-256 | 056b9f8421a9a2ab5f33cbb9fd2f282ac971e584f6a83d44f6672bd17f1d68b2 |
Hashes for pywin32-304-cp39-cp39-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d24a3382f013b21aa24a5cfbfad5a2cd9926610c0affde3e8ab5b3d7dbcf4ac9 |
|
MD5 | c9d17968d2f68b34160000b66c4192f2 |
|
BLAKE2b-256 | bcca9311427c719f6902c30ac4a6b252a38632fa3fd0e7b360a526a0a3b1dae7 |
Hashes for pywin32-304-cp38-cp38-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ead865a2e179b30fb717831f73cf4373401fc62fbc3455a0889a7ddac848f83e |
|
MD5 | 2e8a028e757a194727cc1093563eccbd |
|
BLAKE2b-256 | 4d33251aacef6d983476e4176e3c9b542f60c34735c034392e73762e699e9a5c |
Hashes for pywin32-304-cp37-cp37m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bb2ea2aa81e96eee6a6b79d87e1d1648d3f8b87f9a64499e0b92b30d141e76df |
|
MD5 | 8768986f3d63c708fd8a585a0c6fc3ad |
|
BLAKE2b-256 | a4d9e80172360b380ea41f423f3ddf2d0d986dd88c7b69c102494f52fd84012f |
Hashes for pywin32-304-cp37-cp37m-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f64c0377cf01b61bd5e76c25e1480ca8ab3b73f0c4add50538d332afdf8f69c5 |
|
MD5 | b2508970e6637d4cad2e76fb6d5cc233 |
|
BLAKE2b-256 | ee8835150e6f5abce37693525c05176f55efed4996c997e88e4a31746e53d638 |
Hashes for pywin32-304-cp36-cp36m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | de9827c23321dcf43d2f288f09f3b6d772fee11e809015bdae9e69fe13213988 |
|
MD5 | 6f7e08b8cfd97ca8829988e16c1681a6 |
|
BLAKE2b-256 | 709444ec60e63d77fb3bb9ff91e6906baf3e750445dc8b6b8374d1c6d79c9412 |
Hashes for pywin32-304-cp36-cp36m-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | be253e7b14bc601718f014d2832e4c18a5b023cbe72db826da63df76b77507a1 |
|
MD5 | f0efb963a275ad41b99b702814ee05f1 |
|
BLAKE2b-256 | c18bdde940428f9b891e1d9d7b0c2199c7a332d57429ae49e10e1619d67044db |