From afc6488d3386771f69ab4a3e305099e16c34f4d7 Mon Sep 17 00:00:00 2001 From: Jun Komoda <45822440+junkmd@users.noreply.github.com> Date: Mon, 5 Feb 2024 08:44:16 +0900 Subject: [PATCH] Bump version and update change log for 1.3.0 (#510) * update `docs/source/conf.py` * update `comtypes/__init__.py` * update `README.md` * update `.github/workflows/autofmt.yml` * update change log for 1.3.0 Dropping Python 2.7 support --- .github/workflows/autofmt.yml | 2 +- CHANGES.txt | 26 ++++++++++++++++++++++++++ README.md | 18 ++++++------------ comtypes/__init__.py | 2 +- docs/source/conf.py | 4 ++-- 5 files changed, 36 insertions(+), 16 deletions(-) diff --git a/.github/workflows/autofmt.yml b/.github/workflows/autofmt.yml index 52eac760..494109b5 100644 --- a/.github/workflows/autofmt.yml +++ b/.github/workflows/autofmt.yml @@ -1,6 +1,6 @@ on: pull_request: - branches: [drop_py2] # TODO: add `master` + branches: [main] jobs: formatter: diff --git a/CHANGES.txt b/CHANGES.txt index 32b5a330..8bb764bd 100644 --- a/CHANGES.txt +++ b/CHANGES.txt @@ -1,6 +1,32 @@ Comtypes CHANGELOG ================== +Release 1.3.0 +-------------- + * Improve error message on non Windows environments. By @CristiFati. + * Adjust styles of codebase. By @junkmd. + * Apply ``black==22.12.0`` formatter. By @junkmd. + * Modernize ``client.dynamic``. By @junkmd. + * Add tests for ``client.dynamic``. By @junkmd. + * Fix ``test_client``. By @junkmd. + * Fix ``test_getactiveobj``. By @junkmd. + * Make explicit the symbols that imports from the wrapper module into the friendly module. By @junkmd. + * Modernize type annotations in statically defined modules. By @junkmd. + * Fix several type annotations in statically defined modules. By @jonschz and @junkmd. + * Remove ``sys.version_info`` bridges from production codebase. By @junkmd. + * Remove ``for_stub=True`` conditional branch from the ``tools.codegenerator.ImportedNamespaces.getvalue``. By @junkmd. + * Fix ``codegenerator`` as generating ``__next__()`` instead of ``next()`` in ``IEnum...``. By @jonschz. + * Add unit test for generated ``IEnum...`` interfaces. By @jonschz. + * Remove ``'Programming Language :: Python :: 2.7'`` from ``setup.py``. By @junkmd. + * Change the base class of ``_ComMemberSpec`` and ``_DispMemberSpec`` to ``typing.NamedTuple``. By @junkmd. + * Delint and remove wildcard-import from ``typeinfo``. By @junkmd. + * Split ``DISPPARAMS`` instantiation in ``IDispatch.Invoke`` method. By @junkmd. + * Move ``clear_comtypes_cache`` to be a callable ``comtypes.clear_cache`` module. By @bennyrowland. + * Wrapper modules are now imported into friendly modules using an abstracted name, ``__wrapper_module__``. By @junkmd. + * Fix old index bug in ``call_with_inout`` within ``_fix_inout_args``. By @jonschz. + * Fix ``CONTRIBUTING.md``. By @junkmd. + * Update ``README.md``. By @junkmd. + Release 1.2.1 -------------- * Replace ``distutils`` with ``setuptools``. By @junkmd. diff --git a/README.md b/README.md index 46c179e0..a074ebf9 100644 --- a/README.md +++ b/README.md @@ -13,8 +13,12 @@ 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. -Available on `Python` 2.7 and 3.3-3.12. -- [Supporting `Python` 2.7 will be dropped](#ongoing-plans). +Available on `Python` 3.7-3.12. +- [`comtypes==1.2.1`](https://pypi.org/project/comtypes/1.2.1/) is the last version supporting `Python` 2.7 and 3.3-3.6. +- In `Python` 3.7.6 and 3.8.1, `comtypes` would not work as reported in [GH-202](https://github.com/enthought/comtypes/issues/202). +This bug has been fixed in `Python` >= 3.7.7 and >= 3.8.2. +- In `Python` 3.8 and 3.9, some of `comtypes` functionalities may not work correctly as reported in [GH-212](https://github.com/enthought/comtypes/issues/212). +This bug has been fixed in `Python` >= 3.10.10 and >= 3.11.2. ## Where to get it @@ -45,16 +49,6 @@ https://github.com/enthought/comtypes ### Ongoing plans -#### Drop supporting `Python` 2.x from this package -For the time being, the development target branch of this package is the [`drop_py2` branch](https://github.com/enthought/comtypes/tree/drop_py2) and the [`main` branch](https://github.com/enthought/comtypes/tree/main) is in maintenance-only-mode. - -As the name suggests, `drop_py2` is a mid-term-planning branch to drop supporting `Python` 2.x from this package, and start supporting `Python` 3.x only. - -The codebase changes in the `drop_py2` branch will be merged into the `main` branch in the future, and the `main` branch will back to the development target branch. -Until then, no changes will be made to the `main` branch except in the case of corresponding to regressions. - -Please refer to [the GitHub issue](https://github.com/enthought/comtypes/issues/392) for details. - #### `GetModule` will also generate static typing for methods and properties `comtypes.client.GetModule` generates `Python` wrapper modules from a COM type library, containing interface classes, coclasses, constants, and structures. The `.py` files are generated in the `comtypes.gen` package. diff --git a/comtypes/__init__.py b/comtypes/__init__.py index 0bc90a51..886800b7 100644 --- a/comtypes/__init__.py +++ b/comtypes/__init__.py @@ -1,5 +1,5 @@ # comtypes version numbers follow semver (http://semver.org/) and PEP 440 -__version__ = "1.2.1" +__version__ = "1.3.0" import atexit from ctypes import * diff --git a/docs/source/conf.py b/docs/source/conf.py index da952fc6..02d12858 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -48,9 +48,9 @@ # built documents. # # The short X.Y version. -version = '1.2' +version = '1.3' # The full version, including alpha/beta/rc tags. -release = '1.2.1' +release = '1.3.0' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages.