# pywin32
[](https://github.com/mhammond/pywin32/actions?query=workflow%3ACI)
[](https://pypi.org/project/pywin32)
[](https://pypi.org/project/pywin32)
[](https://pypi.org/project/pywin32)
[](https://spdx.org/licenses/PSF-2.0.html)
-----
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](https://github.com/mhammond/pywin32/blob/master/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](https://mhammond.github.io/pywin32/)
of the helpfile that ships with the installers (thanks [@ofek](https://github.com/mhammond/pywin32/pull/1774)!).
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](https://github.com/mhammond/pywin32/issues) for
all bugs (or suspected bugs) in pywin32. [pull-requests](https://github.com/mhammond/pywin32/pulls)
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](http://mail.python.org/mailman/listinfo/python-win32) -
note that you must be subscribed to the list before posting.
## Binaries
[Binary releases are deprecated.](https://mhammond.github.io/pywin32_installers.html)
While they are still provided, [find them here](https://github.com/mhammond/pywin32/releases)
## Installing via PIP
You should install pywin32 via pip - eg,
> python -m pip install --upgrade 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.
For unreleased changes, you can download builds made by [github actions](https://github.com/mhammond/pywin32/actions/) -
choose any "workflow" from the `main` branch and download its "artifacts")
### `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` and `pythoncomXX.dll`
(where `XX` 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` and `pythonXX.dll`.
* Manually copy `pythonservice.exe` from the `site-packages/win32` directory to
the same place as these DLLs.
## Building from source
Install Visual Studio 2019 (later probably works, but options might be different),
select "Desktop Development with C++", then the following options:
* Windows 10 SDK (latest offered I guess? At time of writing, 10.0.18362)
* "C++ for MFC for ..."
* ARM build tools if necessary.
(the free compilers probably work too, but haven't been tested - let me know your experiences!)
`setup.py` is a standard distutils build script, so you probably want:
> python setup.py install
or
> python setup.py --help
Some modules need obscure SDKs to build - `setup.py` should succeed, gracefully
telling you why it failed to build them - if the build actually fails with your
configuration, please [open an issue](https://github.com/mhammond/pywin32/issues).
## 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 via `py -3.? -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
Raw data
{
"_id": null,
"home_page": "https://github.com/mhammond/pywin32",
"name": "pywin32",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Mark Hammond (et al)",
"author_email": "mhammond@skippinet.com.au",
"download_url": "",
"platform": null,
"description": "# pywin32\r\n\r\n[](https://github.com/mhammond/pywin32/actions?query=workflow%3ACI)\r\n[](https://pypi.org/project/pywin32)\r\n[](https://pypi.org/project/pywin32)\r\n[](https://pypi.org/project/pywin32)\r\n[](https://spdx.org/licenses/PSF-2.0.html)\r\n\r\n-----\r\n\r\nThis is the readme for the Python for Win32 (pywin32) extensions, which provides access to many of the Windows APIs from Python.\r\n\r\nSee [CHANGES.txt](https://github.com/mhammond/pywin32/blob/master/CHANGES.txt) for recent notable changes.\r\n\r\nOnly Python 3 is supported. If you want Python 2 support, you want build `228`.\r\n\r\n## Docs\r\n\r\nThe docs are a long and sad story, but [there's now an online version](https://mhammond.github.io/pywin32/)\r\nof the helpfile that ships with the installers (thanks [@ofek](https://github.com/mhammond/pywin32/pull/1774)!).\r\nLots of that is very old, but some is auto-generated and current. Would love help untangling the docs!\r\n\r\n## Support\r\n\r\nFeel free to [open issues](https://github.com/mhammond/pywin32/issues) for\r\nall bugs (or suspected bugs) in pywin32. [pull-requests](https://github.com/mhammond/pywin32/pulls)\r\nfor all bugs or features are also welcome.\r\n\r\nHowever, please **do not open github issues for general support requests**, or\r\nfor problems or questions using the modules in this package - they will be\r\nclosed. For such issues, please email the\r\n[python-win32 mailing list](http://mail.python.org/mailman/listinfo/python-win32) -\r\nnote that you must be subscribed to the list before posting.\r\n\r\n## Binaries\r\n[Binary releases are deprecated.](https://mhammond.github.io/pywin32_installers.html)\r\nWhile they are still provided, [find them here](https://github.com/mhammond/pywin32/releases)\r\n\r\n## Installing via PIP\r\n\r\nYou should install pywin32 via pip - eg,\r\n> python -m pip install --upgrade pywin32\r\n\r\nIf you encounter any problems when upgrading (eg, \"module not found\" errors or similar), you\r\nshould execute:\r\n\r\n> python Scripts/pywin32_postinstall.py -install\r\n\r\nThis will make some small attempts to cleanup older conflicting installs.\r\n\r\nNote that if you want to use pywin32 for \"system wide\" features, such as\r\nregistering COM objects or implementing Windows Services, then you must run\r\nthat command from an elevated (ie, \"Run as Administrator) command prompt.\r\n\r\nFor unreleased changes, you can download builds made by [github actions](https://github.com/mhammond/pywin32/actions/) -\r\nchoose any \"workflow\" from the `main` branch and download its \"artifacts\")\r\n\r\n### `The specified procedure could not be found` / `Entry-point not found` Errors?\r\nA very common report is that people install pywin32, but many imports fail with errors\r\nsimilar to the above.\r\n\r\nIn almost all cases, this tends to mean there are other pywin32 DLLs installed in your system,\r\nbut in a different location than the new ones. This sometimes happens in environments that\r\ncome with pywin32 pre-shipped (eg, anaconda?).\r\n\r\nThe possible solutions are:\r\n\r\n* Run the \"post_install\" script documented above.\r\n\r\n* Otherwise, find and remove all other copies of `pywintypesXX.dll` and `pythoncomXX.dll`\r\n (where `XX` is the Python version - eg, \"39\")\r\n\r\n### Running as a Windows Service\r\n\r\nModern Python installers do not, by default, install Python in a way that is suitable for\r\nrunning as a service, particularly for other users.\r\n\r\n* Ensure Python is installed in a location where the user running the service has\r\n access to the installation and is able to load `pywintypesXX.dll` and `pythonXX.dll`.\r\n\r\n* Manually copy `pythonservice.exe` from the `site-packages/win32` directory to\r\n the same place as these DLLs.\r\n\r\n## Building from source\r\n\r\nInstall Visual Studio 2019 (later probably works, but options might be different),\r\nselect \"Desktop Development with C++\", then the following options:\r\n* Windows 10 SDK (latest offered I guess? At time of writing, 10.0.18362)\r\n* \"C++ for MFC for ...\"\r\n* ARM build tools if necessary.\r\n\r\n(the free compilers probably work too, but haven't been tested - let me know your experiences!)\r\n\r\n`setup.py` is a standard distutils build script, so you probably want:\r\n\r\n> python setup.py install\r\n\r\nor\r\n\r\n> python setup.py --help\r\n\r\nSome modules need obscure SDKs to build - `setup.py` should succeed, gracefully\r\ntelling you why it failed to build them - if the build actually fails with your\r\nconfiguration, please [open an issue](https://github.com/mhammond/pywin32/issues).\r\n\r\n## Release process\r\n\r\nThe following steps are performed when making a new release - this is mainly\r\nto form a checklist so mhammond doesn't forget what to do :)\r\n\r\n* Ensure CHANGES.txt has everything worth noting, commit it.\r\n\r\n* Update setup.py with the new build number.\r\n\r\n* Execute build.bat, wait forever, test the artifacts.\r\n\r\n* Upload .whl artifacts to pypi - we do this before pushing the tag because they might be\r\n rejected for an invalid `README.md`. Done via `py -3.? -m twine upload dist/*XXX*.whl`.\r\n\r\n* Commit setup.py (so the new build number is in the repo), create a new git tag\r\n\r\n* Upload the .exe installers to github.\r\n\r\n* Update setup.py with the new build number + \".1\" (eg, 123.1), to ensure\r\n future test builds aren't mistaken for the real release.\r\n\r\n* Make sure everything is pushed to github, including the tag (ie,\r\n `git push --tags`)\r\n\r\n* Send mail to python-win32\r\n",
"bugtrack_url": null,
"license": "PSF",
"summary": "Python for Window Extensions",
"version": "306",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8b1efc18ad83ca553e01b97aa8393ff10e33c1fb57801db05488b83282ee9913",
"md5": "48e87c97de29b35d4f3e824652b90ded",
"sha256": "e65028133d15b64d2ed8f06dd9fbc268352478d4f9289e69c190ecd6818b6407"
},
"downloads": -1,
"filename": "pywin32-306-cp311-cp311-win32.whl",
"has_sig": false,
"md5_digest": "48e87c97de29b35d4f3e824652b90ded",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": null,
"size": 8507689,
"upload_time": "2023-03-25T23:50:08",
"upload_time_iso_8601": "2023-03-25T23:50:08.499857Z",
"url": "https://files.pythonhosted.org/packages/8b/1e/fc18ad83ca553e01b97aa8393ff10e33c1fb57801db05488b83282ee9913/pywin32-306-cp311-cp311-win32.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7e9ead6b1ae2a5ad1066dc509350e0fbf74d8d50251a51e420a2a8feaa0cecbd",
"md5": "6570b90026cc26083324b01d6bfc8c8e",
"sha256": "a7639f51c184c0272e93f244eb24dafca9b1855707d94c192d4a0b4c01e1100e"
},
"downloads": -1,
"filename": "pywin32-306-cp311-cp311-win_amd64.whl",
"has_sig": false,
"md5_digest": "6570b90026cc26083324b01d6bfc8c8e",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": null,
"size": 9227547,
"upload_time": "2023-03-25T23:50:20",
"upload_time_iso_8601": "2023-03-25T23:50:20.331744Z",
"url": "https://files.pythonhosted.org/packages/7e/9e/ad6b1ae2a5ad1066dc509350e0fbf74d8d50251a51e420a2a8feaa0cecbd/pywin32-306-cp311-cp311-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9120f744bff1da8f43388498503634378dbbefbe493e65675f2cc52f7185c2c2",
"md5": "f7773764c088dc38ce799992a45e7e8c",
"sha256": "70dba0c913d19f942a2db25217d9a1b726c278f483a919f1abfed79c9cf64d3a"
},
"downloads": -1,
"filename": "pywin32-306-cp311-cp311-win_arm64.whl",
"has_sig": false,
"md5_digest": "f7773764c088dc38ce799992a45e7e8c",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": null,
"size": 10388324,
"upload_time": "2023-03-25T23:50:30",
"upload_time_iso_8601": "2023-03-25T23:50:30.904686Z",
"url": "https://files.pythonhosted.org/packages/91/20/f744bff1da8f43388498503634378dbbefbe493e65675f2cc52f7185c2c2/pywin32-306-cp311-cp311-win_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "149117e016d5923e178346aabda3dfec6629d1a26efe587d19667542105cf0a6",
"md5": "5a5e68c4e5e96ccc2ec706a1773f927a",
"sha256": "383229d515657f4e3ed1343da8be101000562bf514591ff383ae940cad65458b"
},
"downloads": -1,
"filename": "pywin32-306-cp312-cp312-win32.whl",
"has_sig": false,
"md5_digest": "5a5e68c4e5e96ccc2ec706a1773f927a",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": null,
"size": 8507705,
"upload_time": "2023-03-25T23:50:40",
"upload_time_iso_8601": "2023-03-25T23:50:40.279452Z",
"url": "https://files.pythonhosted.org/packages/14/91/17e016d5923e178346aabda3dfec6629d1a26efe587d19667542105cf0a6/pywin32-306-cp312-cp312-win32.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "831c25b79fc3ec99b19b0a0730cc47356f7e2959863bf9f3cd314332bddb4f68",
"md5": "acba781d743df2d7ae84b9b6aefa4ce3",
"sha256": "37257794c1ad39ee9be652da0462dc2e394c8159dfd913a8a4e8eb6fd346da0e"
},
"downloads": -1,
"filename": "pywin32-306-cp312-cp312-win_amd64.whl",
"has_sig": false,
"md5_digest": "acba781d743df2d7ae84b9b6aefa4ce3",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": null,
"size": 9227429,
"upload_time": "2023-03-25T23:50:50",
"upload_time_iso_8601": "2023-03-25T23:50:50.222344Z",
"url": "https://files.pythonhosted.org/packages/83/1c/25b79fc3ec99b19b0a0730cc47356f7e2959863bf9f3cd314332bddb4f68/pywin32-306-cp312-cp312-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1c43e3444dc9a12f8365d9603c2145d16bf0a2f8180f343cf87be47f5579e547",
"md5": "0f30d279dcf1dc137c99088add54ee84",
"sha256": "5821ec52f6d321aa59e2db7e0a35b997de60c201943557d108af9d4ae1ec7040"
},
"downloads": -1,
"filename": "pywin32-306-cp312-cp312-win_arm64.whl",
"has_sig": false,
"md5_digest": "0f30d279dcf1dc137c99088add54ee84",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": null,
"size": 10388145,
"upload_time": "2023-03-25T23:51:01",
"upload_time_iso_8601": "2023-03-25T23:51:01.401720Z",
"url": "https://files.pythonhosted.org/packages/1c/43/e3444dc9a12f8365d9603c2145d16bf0a2f8180f343cf87be47f5579e547/pywin32-306-cp312-cp312-win_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "28196b8f416ff02132c404042f251eb90a41d15abe677481fcff22077e943c6f",
"md5": "a9a59c9939e80e975295c86047ac3c42",
"sha256": "1c73ea9a0d2283d889001998059f5eaaba3b6238f767c9cf2833b13e6a685f65"
},
"downloads": -1,
"filename": "pywin32-306-cp37-cp37m-win32.whl",
"has_sig": false,
"md5_digest": "a9a59c9939e80e975295c86047ac3c42",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 8612400,
"upload_time": "2023-03-25T23:51:10",
"upload_time_iso_8601": "2023-03-25T23:51:10.852473Z",
"url": "https://files.pythonhosted.org/packages/28/19/6b8f416ff02132c404042f251eb90a41d15abe677481fcff22077e943c6f/pywin32-306-cp37-cp37m-win32.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "80e608192cb5728a6ffdb70ea990d9a1351b320d31a751bb463e652d9e05e7aa",
"md5": "396b92a09b00d2975d074f719c719d56",
"sha256": "72c5f621542d7bdd4fdb716227be0dd3f8565c11b280be6315b06ace35487d36"
},
"downloads": -1,
"filename": "pywin32-306-cp37-cp37m-win_amd64.whl",
"has_sig": false,
"md5_digest": "396b92a09b00d2975d074f719c719d56",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 9334533,
"upload_time": "2023-03-25T23:51:20",
"upload_time_iso_8601": "2023-03-25T23:51:20.078856Z",
"url": "https://files.pythonhosted.org/packages/80/e6/08192cb5728a6ffdb70ea990d9a1351b320d31a751bb463e652d9e05e7aa/pywin32-306-cp37-cp37m-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0e57c3ec32b498f24a2392404d1f0fd29f47a3f7339d7d579df7a0560cff337c",
"md5": "38bb41e9d1eefc814018a16cae5f9395",
"sha256": "e4c092e2589b5cf0d365849e73e02c391c1349958c5ac3e9d5ccb9a28e017b3a"
},
"downloads": -1,
"filename": "pywin32-306-cp38-cp38-win32.whl",
"has_sig": false,
"md5_digest": "38bb41e9d1eefc814018a16cae5f9395",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": null,
"size": 8632118,
"upload_time": "2023-03-25T23:51:29",
"upload_time_iso_8601": "2023-03-25T23:51:29.387018Z",
"url": "https://files.pythonhosted.org/packages/0e/57/c3ec32b498f24a2392404d1f0fd29f47a3f7339d7d579df7a0560cff337c/pywin32-306-cp38-cp38-win32.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fa80a6b22e031590cc5f4fcbd5bf4bcf63a9dabce9d59065f53add99a8caaec5",
"md5": "0dec759005df307e59c7fc16cc56e7ec",
"sha256": "e8ac1ae3601bee6ca9f7cb4b5363bf1c0badb935ef243c4733ff9a393b1690c0"
},
"downloads": -1,
"filename": "pywin32-306-cp38-cp38-win_amd64.whl",
"has_sig": false,
"md5_digest": "0dec759005df307e59c7fc16cc56e7ec",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": null,
"size": 9373699,
"upload_time": "2023-03-25T23:51:39",
"upload_time_iso_8601": "2023-03-25T23:51:39.175541Z",
"url": "https://files.pythonhosted.org/packages/fa/80/a6b22e031590cc5f4fcbd5bf4bcf63a9dabce9d59065f53add99a8caaec5/pywin32-306-cp38-cp38-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7e7f419c4fcadcaa374a0ae41cbdf6c3a81452892dd6c523aea629d17e49146e",
"md5": "2d2d98e91723255eafb2af0b369e061a",
"sha256": "e25fd5b485b55ac9c057f67d94bc203f3f6595078d1fb3b458c9c28b7153a802"
},
"downloads": -1,
"filename": "pywin32-306-cp39-cp39-win32.whl",
"has_sig": false,
"md5_digest": "2d2d98e91723255eafb2af0b369e061a",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": null,
"size": 8573451,
"upload_time": "2023-03-25T23:51:47",
"upload_time_iso_8601": "2023-03-25T23:51:47.590096Z",
"url": "https://files.pythonhosted.org/packages/7e/7f/419c4fcadcaa374a0ae41cbdf6c3a81452892dd6c523aea629d17e49146e/pywin32-306-cp39-cp39-win32.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1cf724d8ed4fd9c43b90354df7764f81f0dd5e623f9a50f1538f90fe085d6dff",
"md5": "8825c29dd5dc6e8d906d82c666a7081f",
"sha256": "39b61c15272833b5c329a2989999dcae836b1eed650252ab1b7bfbe1d59f30f4"
},
"downloads": -1,
"filename": "pywin32-306-cp39-cp39-win_amd64.whl",
"has_sig": false,
"md5_digest": "8825c29dd5dc6e8d906d82c666a7081f",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": null,
"size": 9312883,
"upload_time": "2023-03-25T23:51:56",
"upload_time_iso_8601": "2023-03-25T23:51:56.688794Z",
"url": "https://files.pythonhosted.org/packages/1c/f7/24d8ed4fd9c43b90354df7764f81f0dd5e623f9a50f1538f90fe085d6dff/pywin32-306-cp39-cp39-win_amd64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-25 23:50:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "mhammond",
"github_project": "pywin32",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pywin32"
}
JSON
