From 28cb96e66ef16826d4cdb48fb8092afcb349d7f2 Mon Sep 17 00:00:00 2001 From: junkmd Date: Tue, 13 Dec 2022 08:02:21 +0900 Subject: [PATCH 1/4] update `README.md` --- README.md | 52 +++++++++++++++++++++++++++++++++------------------- 1 file changed, 33 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 207ba3367..da059689a 100644 --- a/README.md +++ b/README.md @@ -1,31 +1,45 @@ -comtypes -======== +# comtypes -**comtypes** is a lightweight Python COM package, based on the ctypes_ -FFI library, in less than 10000 lines of code (not counting the -tests). +[![PyPI version](https://badge.fury.io/py/comtypes.svg)](https://pypi.org/project/comtypes/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/comtypes)](https://pypi.org/project/comtypes/) [![PyPI - License](https://img.shields.io/pypi/l/comtypes)](https://pypi.org/project/comtypes/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/comtypes)](https://pypi.org/project/comtypes/) +[![GitHub Repo stars](https://img.shields.io/github/stars/enthought/comtypes?style=social)](https://github.com/enthought/comtypes/stargazers) [![GitHub forks](https://img.shields.io/github/forks/enthought/comtypes?style=social)](https://github.com/enthought/comtypes/network/members) -**comtypes** allows to define, call, and implement custom and -dispatch-based COM interfaces in pure Python. It works on Windows and -64-bit Windows. Windows CE support was dropped since comtypes==1.1.8. +## About -Documentation: +`comtypes` is a lightweight `Python` COM package, based on the [`ctypes`](https://docs.python.org/library/ctypes.html) FFI library. - https://pythonhosted.org/comtypes +`comtypes` allows to define, call, and implement custom and dispatch-based COM interfaces in pure `Python`. - Contribute using the `source repository and issue tracker - `_ on GitHub. +This package works on only Windows. +- [`comtypes==1.1.7`](https://pypi.org/project/comtypes/1.1.7/) is the last version of supporting Windows CE. -Mailing list: +## Where to get it - http://gmane.org/info.php?group=gmane.comp.python.comtypes.user +The source code is currently hosted on GitHub at: +https://github.com/enthought/comtypes - https://lists.sourceforge.net/lists/listinfo/comtypes-users/ +Binary installers for the latest released version are available at the [Python Package Index (PyPI)](https://pypi.org/project/comtypes). -Download: +```sh +# PyPI +pip install comtypes +``` - Releases can be downloaded in the PyPI page: +## Dependencies - https://pypi.python.org/pypi/comtypes +`comtypes` requires no third-party packages to run - this is truly **pure** `Python` package. -.. _ctypes: http://docs.python.org/lib/module-ctypes.html +Optional features include the follows... +- to process arrays as `numpy`'s `ndarray` +- type hints be interpreted by `mypy` or several static type checkers + +But these third-parties are not required as a prerequisite for runtime. + +## Community of the developers + +Tracking issues, reporting bugs and contributing to the codebase and documentation are on GitHub at: +https://github.com/enthought/comtypes + +## Documentation: + +The documentation is currently hosted on pythonhosted at: +https://pythonhosted.org/comtypes From 29e81f10749ed5770752f1ce02f887b43bfc9e6f Mon Sep 17 00:00:00 2001 From: junkmd Date: Tue, 13 Dec 2022 08:16:31 +0900 Subject: [PATCH 2/4] update `setup.classifiers` for rendering ver badge --- setup.py | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/setup.py b/setup.py index 13045e88d..69efad96c 100644 --- a/setup.py +++ b/setup.py @@ -73,7 +73,15 @@ def run(self): 'Operating System :: Microsoft :: Windows', 'Programming Language :: Python', 'Programming Language :: Python :: 2.7', - 'Programming Language :: Python :: 3', + 'Programming Language :: Python :: 3.3', + 'Programming Language :: Python :: 3.4', + 'Programming Language :: Python :: 3.5', + 'Programming Language :: Python :: 3.6', + 'Programming Language :: Python :: 3.7', + 'Programming Language :: Python :: 3.8', + 'Programming Language :: Python :: 3.9', + 'Programming Language :: Python :: 3.10', + 'Programming Language :: Python :: 3.11', 'Topic :: Software Development :: Libraries :: Python Modules', ] From ab814835a9a9da61638db0e57295c2cc793ac335 Mon Sep 17 00:00:00 2001 From: junkmd <45822440+junkmd@users.noreply.github.com> Date: Thu, 15 Dec 2022 17:44:53 +0900 Subject: [PATCH 3/4] revert setup.py --- setup.py | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) diff --git a/setup.py b/setup.py index 69efad96c..13045e88d 100644 --- a/setup.py +++ b/setup.py @@ -73,15 +73,7 @@ def run(self): 'Operating System :: Microsoft :: Windows', 'Programming Language :: Python', 'Programming Language :: Python :: 2.7', - 'Programming Language :: Python :: 3.3', - 'Programming Language :: Python :: 3.4', - 'Programming Language :: Python :: 3.5', - 'Programming Language :: Python :: 3.6', - 'Programming Language :: Python :: 3.7', - 'Programming Language :: Python :: 3.8', - 'Programming Language :: Python :: 3.9', - 'Programming Language :: Python :: 3.10', - 'Programming Language :: Python :: 3.11', + 'Programming Language :: Python :: 3', 'Topic :: Software Development :: Libraries :: Python Modules', ] From 6db170a49e970b15a0ef3027be95ccae4fac1941 Mon Sep 17 00:00:00 2001 From: junkmd Date: Wed, 28 Dec 2022 04:26:47 +0900 Subject: [PATCH 4/4] fix grammar and wording --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index da059689a..bacdf97a4 100644 --- a/README.md +++ b/README.md @@ -9,15 +9,15 @@ `comtypes` allows to define, call, and implement custom and dispatch-based COM interfaces in pure `Python`. -This package works on only Windows. -- [`comtypes==1.1.7`](https://pypi.org/project/comtypes/1.1.7/) is the last version of supporting Windows CE. +This package works on Windows only. +- [`comtypes==1.1.7`](https://pypi.org/project/comtypes/1.1.7/) is the last version supporting Windows CE. ## Where to get it The source code is currently hosted on GitHub at: https://github.com/enthought/comtypes -Binary installers for the latest released version are available at the [Python Package Index (PyPI)](https://pypi.org/project/comtypes). +An installer for the latest released version is available at the [Python Package Index (PyPI)](https://pypi.org/project/comtypes). ```sh # PyPI