# comtypes
![Works on Windows only](https://img.shields.io/badge/-Windows-0078D6.svg?logo=windows&style=flat)
[![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/dm/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)
[![Tidelift Subscription](https://tidelift.com/badges/package/pypi/comtypes)](https://tidelift.com/subscription/pkg/pypi-comtypes?utm_source=pypi-comtypes&utm_medium=readme)
## About
`comtypes` is a lightweight `Python` [COM](https://learn.microsoft.com/en-us/windows/win32/com/component-object-model--com--portal) package, based on the [`ctypes`](https://docs.python.org/library/ctypes.html) FFI library.
`comtypes` allows to define, call, and implement custom and dispatch-based COM interfaces in pure `Python`.
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` 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
The source code is currently hosted on GitHub at:
https://github.com/enthought/comtypes
An installer for the latest released version is available at the [Python Package Index (PyPI)](https://pypi.org/project/comtypes).
```sh
# PyPI
pip install comtypes
```
## Dependencies
`comtypes` requires no third-party packages to run - this is truly **pure** `Python` package.
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
## For Enterprise
Available as part of the Tidelift Subscription.
This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.
[Learn more](https://tidelift.com/subscription/pkg/pypi-comtypes?utm_source=pypi-comtypes&utm_medium=referral&utm_campaign=github).
## Documentation:
The documentation is currently hosted on pythonhosted at:
https://pythonhosted.org/comtypes
Raw data
{
"_id": null,
"home_page": "https://github.com/enthought/comtypes",
"name": "comtypes",
"maintainer": null,
"docs_url": "https://pythonhosted.org/comtypes/",
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Thomas Heller",
"author_email": "theller@python.net",
"download_url": "https://files.pythonhosted.org/packages/98/25/7ee077ebd229e79bc59fe22633f0f4e0c872149735f04b23c87f6ccd05dc/comtypes-1.4.2.zip",
"platform": null,
"description": "# comtypes\r\n\r\n![Works on Windows only](https://img.shields.io/badge/-Windows-0078D6.svg?logo=windows&style=flat) \r\n[![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/dm/comtypes)](https://pypi.org/project/comtypes/) \r\n[![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) \r\n[![Tidelift Subscription](https://tidelift.com/badges/package/pypi/comtypes)](https://tidelift.com/subscription/pkg/pypi-comtypes?utm_source=pypi-comtypes&utm_medium=readme)\r\n\r\n## About\r\n\r\n`comtypes` is a lightweight `Python` [COM](https://learn.microsoft.com/en-us/windows/win32/com/component-object-model--com--portal) package, based on the [`ctypes`](https://docs.python.org/library/ctypes.html) FFI library.\r\n\r\n`comtypes` allows to define, call, and implement custom and dispatch-based COM interfaces in pure `Python`.\r\n\r\nThis package works on Windows only.\r\n- [`comtypes==1.1.7`](https://pypi.org/project/comtypes/1.1.7/) is the last version supporting Windows CE.\r\n\r\nAvailable on `Python` 3.7-3.12.\r\n- [`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.\r\n- 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). \r\nThis bug has been fixed in `Python` >= 3.7.7 and >= 3.8.2.\r\n- 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). \r\nThis bug has been fixed in `Python` >= 3.10.10 and >= 3.11.2.\r\n\r\n## Where to get it\r\n\r\nThe source code is currently hosted on GitHub at:\r\nhttps://github.com/enthought/comtypes\r\n\r\nAn installer for the latest released version is available at the [Python Package Index (PyPI)](https://pypi.org/project/comtypes).\r\n\r\n```sh\r\n# PyPI\r\npip install comtypes\r\n```\r\n\r\n## Dependencies\r\n\r\n`comtypes` requires no third-party packages to run - this is truly **pure** `Python` package.\r\n\r\nOptional features include the follows...\r\n- to process arrays as `numpy`'s `ndarray`\r\n- type hints be interpreted by `mypy` or several static type checkers\r\n\r\nBut these third-parties are not required as a prerequisite for runtime.\r\n\r\n## Community of the developers\r\n\r\nTracking issues, reporting bugs and contributing to the codebase and documentation are on GitHub at:\r\nhttps://github.com/enthought/comtypes\r\n\r\n## For Enterprise\r\n\r\nAvailable as part of the Tidelift Subscription.\r\n\r\nThis project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.\r\n\r\n[Learn more](https://tidelift.com/subscription/pkg/pypi-comtypes?utm_source=pypi-comtypes&utm_medium=referral&utm_campaign=github).\r\n\r\n## Documentation:\r\n\r\nThe documentation is currently hosted on pythonhosted at:\r\nhttps://pythonhosted.org/comtypes\r\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Pure Python COM package",
"version": "1.4.2",
"project_urls": {
"Download": "https://github.com/enthought/comtypes/releases",
"Homepage": "https://github.com/enthought/comtypes"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3ce06164ef8362e06562d132028611b3e1d3026497042e5d72de64e3ce03a42f",
"md5": "2bc6d0f33e5db67ce328a26e58ec7754",
"sha256": "ce5f9ae2ca9e02b38d790cfd04271c234e12ed44056d0f979e7b7f587c963fe0"
},
"downloads": -1,
"filename": "comtypes-1.4.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2bc6d0f33e5db67ce328a26e58ec7754",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 201216,
"upload_time": "2024-05-06T23:46:03",
"upload_time_iso_8601": "2024-05-06T23:46:03.012378Z",
"url": "https://files.pythonhosted.org/packages/3c/e0/6164ef8362e06562d132028611b3e1d3026497042e5d72de64e3ce03a42f/comtypes-1.4.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "98257ee077ebd229e79bc59fe22633f0f4e0c872149735f04b23c87f6ccd05dc",
"md5": "3d08f964d8f22b47f09a13b484501d65",
"sha256": "eb72473b0dea9495e84c79e340c239012e8572f51dedf726a9dfd7aeaf2a1ffb"
},
"downloads": -1,
"filename": "comtypes-1.4.2.zip",
"has_sig": false,
"md5_digest": "3d08f964d8f22b47f09a13b484501d65",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 222142,
"upload_time": "2024-05-06T23:46:04",
"upload_time_iso_8601": "2024-05-06T23:46:04.619320Z",
"url": "https://files.pythonhosted.org/packages/98/25/7ee077ebd229e79bc59fe22633f0f4e0c872149735f04b23c87f6ccd05dc/comtypes-1.4.2.zip",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-06 23:46:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "enthought",
"github_project": "comtypes",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"appveyor": true,
"lcname": "comtypes"
}