METADATA 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120
  1. Metadata-Version: 2.0
  2. Name: pywin32
  3. Version: 301
  4. Summary: Python for Window Extensions
  5. Home-page: https://github.com/mhammond/pywin32
  6. Author: Mark Hammond (et al)
  7. Author-email: mhammond@skippinet.com.au
  8. License: PSF
  9. Description-Content-Type: text/markdown
  10. Platform: UNKNOWN
  11. Classifier: Environment :: Win32 (MS Windows)
  12. Classifier: Intended Audience :: Developers
  13. Classifier: License :: OSI Approved :: Python Software Foundation License
  14. Classifier: Operating System :: Microsoft :: Windows
  15. Classifier: Programming Language :: Python :: 3.5
  16. Classifier: Programming Language :: Python :: 3.6
  17. Classifier: Programming Language :: Python :: 3.7
  18. Classifier: Programming Language :: Python :: 3.8
  19. Classifier: Programming Language :: Python :: 3.9
  20. Classifier: Programming Language :: Python :: Implementation :: CPython
  21. # pywin32
  22. [![CI](https://github.com/mhammond/pywin32/workflows/CI/badge.svg)](https://github.com/mhammond/pywin32/actions?query=workflow%3ACI)
  23. [![PyPI - Version](https://img.shields.io/pypi/v/pywin32.svg)](https://pypi.org/project/pywin32)
  24. [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pywin32.svg)](https://pypi.org/project/pywin32)
  25. [![PyPI - Downloads](https://img.shields.io/pypi/dm/pywin32.svg)](https://pypi.org/project/pywin32)
  26. [![License - PSF-2.0](https://img.shields.io/badge/license-PSF--2.0-9400d3.svg)](https://spdx.org/licenses/PSF-2.0.html)
  27. -----
  28. This is the readme for the Python for Win32 (pywin32) extensions, which provides access to many of the Windows APIs from Python.
  29. See [CHANGES.txt](https://github.com/mhammond/pywin32/blob/master/CHANGES.txt) for recent notable changes.
  30. Build 228 is the last build supporting Python 2, and as part of this transition,
  31. all code in the repository is now using Python 3 syntax.
  32. To highlight and celebrate this change, build 228 is the last numbered 2XX - the
  33. following build numbers start at 300.
  34. In other words, there is no build 229 - the build numbers jump from 228 to 300.
  35. As of build 222, pywin32 has a new home at [github](https://github.com/mhammond/pywin32).
  36. You can find build 221 and later on github and older versions can be found on
  37. the old project home at [sourceforge](https://sourceforge.net/projects/pywin32/)
  38. A special shout-out to @xoviat who provided enormous help with the github move!
  39. ## Support
  40. Feel free to [open issues](https://github.com/mhammond/pywin32/issues) for
  41. all bugs (or suspected bugs) in pywin32. [pull-requests](https://github.com/mhammond/pywin32/pulls)
  42. for all bugs or features are also welcome.
  43. However, please **do not open github issues for general support requests**, or
  44. for problems or questions using the modules in this package - they will be
  45. closed. For such issues, please email the
  46. [python-win32 mailing list](http://mail.python.org/mailman/listinfo/python-win32) -
  47. note that you must be subscribed to the list before posting.
  48. ## Binaries
  49. By far the easiest way to use pywin32 is to grab binaries from the [most recent release](https://github.com/mhammond/pywin32/releases)
  50. ## Installing via PIP
  51. You can install pywin32 via pip:
  52. > pip install pywin32
  53. Note that if you want to use pywin32 for "system wide" features, such as
  54. registering COM objects or implementing Windows Services, then you must run
  55. the following command from an elevated command prompt:
  56. > python Scripts/pywin32_postinstall.py -install
  57. ## Building from source
  58. Building from source has been simplified recently - you just need Visual Studio
  59. and the Windows 10 SDK installed (the free compilers probably work too, but
  60. haven't been tested - let me know your experiences!)
  61. `setup.py` is a standard distutils build script. You probably want:
  62. > python setup.py install
  63. or
  64. > python setup.py --help
  65. You can run `setup.py` without any arguments to see
  66. specific information about dependencies. A vanilla MSVC installation should
  67. be able to build most extensions and list any extensions that could not be
  68. built due to missing libraries - if the build actually fails with your
  69. configuration, please [open an issue](https://github.com/mhammond/pywin32/issues).
  70. ## Release process
  71. The following steps are performed when making a new release - this is mainly
  72. to form a checklist so mhammond doesn't forget what to do :)
  73. * Ensure CHANGES.txt has everything worth noting, commit it.
  74. * Update setup.py with the new build number.
  75. * Execute build.bat, wait forever, test the artifacts.
  76. * Commit setup.py (so the new build number is in the repo), create a new git tag
  77. * Update setup.py with the new build number + ".1" (eg, 123.1), to ensure
  78. future test builds aren't mistaken for the real release.
  79. * Make sure everything is pushed to github, including the tag (ie,
  80. `git push --tags`)
  81. * Upload the .exe installers to github (using the web UI), the .whl files to
  82. pypi (using `py -3.5 -m twine upload dist/*XXX*.whl` where `XXX` is the build
  83. number).
  84. * Send mail to python-win32