# QtPy: Abstraction layer for PyQt5/PySide2/PyQt6/PySide6
[](./LICENSE)
[](https://pypi.org/project/QtPy/)
[](https://www.anaconda.com/download/)
[](https://www.anaconda.com/download/)
[](#backers)
[](https://gitter.im/spyder-ide/public)<br>
[](https://github.com/spyder-ide/qtpy)
[](https://github.com/spyder-ide/qtpy/actions)
[](https://coveralls.io/github/spyder-ide/qtpy?branch=master)
*Copyright © 2009– The Spyder Development Team*
## Description
**QtPy** is a small abstraction layer that lets you
write applications using a single API call to either PyQt or PySide.
It provides support for PyQt5, PySide2, PyQt6 and PySide6 using the Qt5 layout
(where the QtGui module has been split into QtGui and QtWidgets).
Basically, you can write your code as if you were using PyQt or PySide directly,
but import Qt modules from `qtpy` instead of `PyQt5`, `PySide2`, `PyQt6` or `PySide6`.
Accordingly, when porting code between different Qt bindings (PyQt vs PySide) or Qt versions (Qt5 vs Qt6), QtPy makes this much more painless, and allows you to easily and incrementally transition between them. QtPy handles incompatibilities and differences between bindings or Qt versions for you while keeping your project running, so you can focus more on your own code and less on keeping track of supporting every Qt version and binding. Furthermore, when you do want to upgrade or support new bindings, it allows you to update your project module by module rather than all at once. You can check out examples of this approach in projects using QtPy, like [git-cola](https://github.com/git-cola/git-cola/issues/232).
### Attribution and acknowledgments
This project is based on the [pyqode.qt](https://github.com/pyQode/pyqode.qt)
project and the [spyderlib.qt](https://github.com/spyder-ide/spyder/tree/2.3/spyderlib/qt)
module from the [Spyder](https://github.com/spyder-ide/spyder) project, and
also includes contributions adapted from
[qt-helpers](https://github.com/glue-viz/qt-helpers), developed as part of the
[glue](http://glueviz.org) project.
Unlike `pyqode.qt` this is not a namespace package, so it is not tied
to a particular project or namespace.
### License
This project is released under the [MIT license](LICENSE.txt).
### Requirements
You need PyQt5, PySide2, PyQt6 or PySide6 installed in your system to make use
of QtPy. If several of these packages are found, PyQt5 is used by
default unless you set the `QT_API` environment variable.
`QT_API` can take the following values:
* `pyqt5` (to use PyQt5).
* `pyside2` (to use PySide2).
* `pyqt6` (to use PyQt6).
* `pyside6` (to use PySide6).
### Module aliases and constants
* `QtCore.pyqtSignal`, `QtCore.pyqtSlot` and `QtCore.pyqtProperty` (available on PyQt5/6) are instead exposed as `QtCore.Signal`, `QtCore.Slot` and `QtCore.Property`, respectively, following the Qt5 module layout.
* The Qt version being used can be checked with `QtCore.__version__` (instead of `QtCore.QT_VERSION_STR`) as well as from `qtpy.QT_VERSION`.
* For PyQt6 enums, unscoped enum access was added by promoting the enums of the `QtCore`, `QtGui`, `QtTest` and `QtWidgets` modules.
* Compatibility is added between the `QtGui` and `QtOpenGL` modules for the `QOpenGL*` classes.
* To check the current binding version, you can use `qtpy.PYSIDE_VERSION` for PySide2/6 and `qtpy.PYQT_VERSION` for PyQt5/6. If the respective binding is not being used, the value of its attribute will be `None`.
* To check the current selected binding, you can use `qtpy.API_NAME`
* There are boolean values to check if Qt5/6, PyQt5/6 or PySide2/6 are being used: `qtpy.QT5`, `qtpy.QT6`, `qtpy.PYQT5`, `qtpy.PYQT6`, `qtpy.PYSIDE2` and `qtpy.PYSIDE6`. `True` if currently being used, `False` otherwise.
#### Compat module
In the `qtpy.compat` module, you can find wrappers for `QFileDialog` static methods and SIP/Shiboken functions, such as:
* `QFileDialog.getExistingDirectory` wrapped with `qtpy.compat.getexistingdirectory`
* `QFileDialog.getOpenFileName` wrapped with `qtpy.compat.getopenfilename`
* `QFileDialog.getOpenFileNames` wrapped with `qtpy.compat.getopenfilenames`
* `QFileDialog.getSaveFileName` wrapped with `qtpy.compat.getsavefilename`
* `sip.isdeleted` and `shiboken.isValid` wrapped with `qtpy.compat.isalive`
### Installation
```bash
pip install qtpy
```
or
```bash
conda install qtpy
```
### Type checker integration
Type checkers have no knowledge of installed packages, so these tools require
additional configuration.
A Command Line Interface (CLI) is offered to help with usage of QtPy (to get MyPy
and Pyright/Pylance args/configurations).
#### Mypy
The `mypy-args` command helps you to generate command line arguments for Mypy
that will enable it to process the QtPy source files with the same API
as QtPy itself would have selected.
If you run
```bash
qtpy mypy-args
```
QtPy will output a string of Mypy CLI args that will reflect the currently
selected Qt API.
For example, in an environment where PyQt5 is installed and selected
(or the default fallback, if no binding can be found in the environment),
this would output the following:
```text
--always-true=PYQT5 --always-false=PYSIDE2 --always-false=PYQT6 --always-false=PYSIDE6
```
Using Bash or a similar shell, this can be injected into
the Mypy command line invocation as follows:
```bash
mypy --package mypackage $(qtpy mypy-args)
```
#### Pyright/Pylance
In the case of Pyright, instead of runtime arguments, it is required to create a
config file for the project, called `pyrightconfig.json` or a `pyright` section
in `pyproject.toml`. See [here](https://github.com/microsoft/pyright/blob/main/docs/configuration.md)
for reference. In order to set this configuration, QtPy offers the `pyright-config`
command for guidance.
If you run
```bash
qtpy pyright-config
```
you will get the necessary configs to be included in your project files. If you don't
have them, it is recommended to create the latter. For example, in an environment where PyQt5
is installed and selected (or the default fallback, if no binding can be found in the
environment), this would output the following:
```text
pyrightconfig.json:
{"defineConstant": {"PYQT5": true, "PYSIDE2": false, "PYQT6": false, "PYSIDE6": false}}
pyproject.toml:
[tool.pyright.defineConstant]
PYQT5 = true
PYSIDE2 = false
PYQT6 = false
PYSIDE6 = false
```
**Note**: These configurations are necessary for the correct usage of the default VSCode's type
checking feature while using QtPy in your source code.
## Testing matrix
Currently, QtPy runs tests for different bindings on Linux, Windows and macOS, using
Python 3.7 and 3.11, and installing those bindings with `conda` and `pip`. For the
PyQt bindings, we also check the installation of extra packages via `pip`.
Following this, the current test matrix looks something like this:
| | Python | 3.7 | | 3.11 | |
|---------|-----------------|--------------------------------------------|------|--------------------|----------------------------|
| OS | Binding / manager | conda | pip | conda | pip |
| Linux | PyQt5 | 5.12 | 5.15 | 5.15 | 5.15 (with extras) |
| | PyQt6 | skip (unavailable) | 6.3 | skip (unavailable) | 6.5 (with extras) |
| | PySide2 | 5.13 | 5.12 | 5.15 | skip (no wheels available) |
| | PySide6 | 6.4 | 6.3 | 6.5 | 6.5 |
| Windows | PyQt5 | 5.9 | 5.15 | 5.15 | 5.15 (with extras) |
| | PyQt6 | skip (unavailable) | 6.2 | skip (unavailable) | 6.5 (with extras) |
| | PySide2 | 5.13 | 5.12 | 5.15 | skip (no wheels available) |
| | PySide6 | skip (test hang with 6.4. 6.5 unavailable) | 6.2 | 6.5 | 6.5 |
| MacOS | PyQt5 | 5.12 | 5.15 | 5.15 | 5.15 (with extras) |
| | PyQt6 | skip (unavailable) | 6.3 | skip (unavailable) | 6.5 (with extras) |
| | PySide2 | 5.13 | 5.12 | 5.15 | skip (no wheels available) |
| | PySide6 | 6.4 | 6.3 | 6.5 | 6.5 |
**Note**: The mentioned extra packages for the PyQt bindings are the following:
* `PyQt3D` and `PyQt6-3D`
* `PyQtChart` and `PyQt6-Charts`
* `PyQtDataVisualization` and `PyQt6-DataVisualization`
* `PyQtNetworkAuth` and `PyQt6-NetworkAuth`
* `PyQtPurchasing`
* `PyQtWebEngine` and `PyQt6-WebEngine`
* `QScintilla` and `PyQt6-QScintilla`
## Contributing
Everyone is welcome to contribute! See our [Contributing guide](CONTRIBUTING.md) for more details.
## Sponsors
QtPy is funded thanks to the generous support of
[](https://www.quansight.com/)[](https://numfocus.org/)
and the donations we have received from our users around the world through [Open Collective](https://opencollective.com/spyder/):
[](https://opencollective.com/spyder#support)
Raw data
{
"_id": null,
"home_page": "https://github.com/spyder-ide/qtpy",
"name": "QtPy",
"maintainer": "Spyder Development Team and QtPy Contributors",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "spyder.python@gmail.com",
"keywords": "qt PyQt5 PyQt6 PySide2 PySide6",
"author": "Colin Duquesnoy and the Spyder Development Team",
"author_email": "spyder.python@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/eb/9a/7ce646daefb2f85bf5b9c8ac461508b58fa5dcad6d40db476187fafd0148/QtPy-2.4.1.tar.gz",
"platform": null,
"description": "# QtPy: Abstraction layer for PyQt5/PySide2/PyQt6/PySide6\r\n\r\n[](./LICENSE)\r\n[](https://pypi.org/project/QtPy/)\r\n[](https://www.anaconda.com/download/)\r\n[](https://www.anaconda.com/download/)\r\n[](#backers)\r\n[](https://gitter.im/spyder-ide/public)<br>\r\n[](https://github.com/spyder-ide/qtpy)\r\n[](https://github.com/spyder-ide/qtpy/actions)\r\n[](https://coveralls.io/github/spyder-ide/qtpy?branch=master)\r\n\r\n*Copyright \u00a9 2009\u2013 The Spyder Development Team*\r\n\r\n\r\n## Description\r\n\r\n**QtPy** is a small abstraction layer that lets you\r\nwrite applications using a single API call to either PyQt or PySide.\r\n\r\nIt provides support for PyQt5, PySide2, PyQt6 and PySide6 using the Qt5 layout\r\n(where the QtGui module has been split into QtGui and QtWidgets).\r\n\r\nBasically, you can write your code as if you were using PyQt or PySide directly,\r\nbut import Qt modules from `qtpy` instead of `PyQt5`, `PySide2`, `PyQt6` or `PySide6`.\r\n\r\nAccordingly, when porting code between different Qt bindings (PyQt vs PySide) or Qt versions (Qt5 vs Qt6), QtPy makes this much more painless, and allows you to easily and incrementally transition between them. QtPy handles incompatibilities and differences between bindings or Qt versions for you while keeping your project running, so you can focus more on your own code and less on keeping track of supporting every Qt version and binding. Furthermore, when you do want to upgrade or support new bindings, it allows you to update your project module by module rather than all at once. You can check out examples of this approach in projects using QtPy, like [git-cola](https://github.com/git-cola/git-cola/issues/232).\r\n\r\n### Attribution and acknowledgments\r\n\r\nThis project is based on the [pyqode.qt](https://github.com/pyQode/pyqode.qt)\r\nproject and the [spyderlib.qt](https://github.com/spyder-ide/spyder/tree/2.3/spyderlib/qt)\r\nmodule from the [Spyder](https://github.com/spyder-ide/spyder) project, and\r\nalso includes contributions adapted from\r\n[qt-helpers](https://github.com/glue-viz/qt-helpers), developed as part of the\r\n[glue](http://glueviz.org) project.\r\n\r\nUnlike `pyqode.qt` this is not a namespace package, so it is not tied\r\nto a particular project or namespace.\r\n\r\n\r\n### License\r\n\r\nThis project is released under the [MIT license](LICENSE.txt).\r\n\r\n\r\n### Requirements\r\n\r\nYou need PyQt5, PySide2, PyQt6 or PySide6 installed in your system to make use\r\nof QtPy. If several of these packages are found, PyQt5 is used by\r\ndefault unless you set the `QT_API` environment variable.\r\n\r\n`QT_API` can take the following values:\r\n\r\n* `pyqt5` (to use PyQt5).\r\n* `pyside2` (to use PySide2).\r\n* `pyqt6` (to use PyQt6).\r\n* `pyside6` (to use PySide6).\r\n\r\n\r\n### Module aliases and constants\r\n\r\n* `QtCore.pyqtSignal`, `QtCore.pyqtSlot` and `QtCore.pyqtProperty` (available on PyQt5/6) are instead exposed as `QtCore.Signal`, `QtCore.Slot` and `QtCore.Property`, respectively, following the Qt5 module layout.\r\n\r\n* The Qt version being used can be checked with `QtCore.__version__` (instead of `QtCore.QT_VERSION_STR`) as well as from `qtpy.QT_VERSION`.\r\n\r\n* For PyQt6 enums, unscoped enum access was added by promoting the enums of the `QtCore`, `QtGui`, `QtTest` and `QtWidgets` modules.\r\n\r\n* Compatibility is added between the `QtGui` and `QtOpenGL` modules for the `QOpenGL*` classes.\r\n\r\n* To check the current binding version, you can use `qtpy.PYSIDE_VERSION` for PySide2/6 and `qtpy.PYQT_VERSION` for PyQt5/6. If the respective binding is not being used, the value of its attribute will be `None`.\r\n\r\n* To check the current selected binding, you can use `qtpy.API_NAME`\r\n\r\n* There are boolean values to check if Qt5/6, PyQt5/6 or PySide2/6 are being used: `qtpy.QT5`, `qtpy.QT6`, `qtpy.PYQT5`, `qtpy.PYQT6`, `qtpy.PYSIDE2` and `qtpy.PYSIDE6`. `True` if currently being used, `False` otherwise.\r\n\r\n#### Compat module\r\n\r\nIn the `qtpy.compat` module, you can find wrappers for `QFileDialog` static methods and SIP/Shiboken functions, such as:\r\n\r\n* `QFileDialog.getExistingDirectory` wrapped with `qtpy.compat.getexistingdirectory`\r\n\r\n* `QFileDialog.getOpenFileName` wrapped with `qtpy.compat.getopenfilename`\r\n\r\n* `QFileDialog.getOpenFileNames` wrapped with `qtpy.compat.getopenfilenames`\r\n\r\n* `QFileDialog.getSaveFileName` wrapped with `qtpy.compat.getsavefilename`\r\n\r\n* `sip.isdeleted` and `shiboken.isValid` wrapped with `qtpy.compat.isalive`\r\n\r\n\r\n### Installation\r\n\r\n```bash\r\npip install qtpy\r\n```\r\n\r\nor\r\n\r\n```bash\r\nconda install qtpy\r\n```\r\n\r\n\r\n### Type checker integration\r\n\r\nType checkers have no knowledge of installed packages, so these tools require\r\nadditional configuration.\r\n\r\nA Command Line Interface (CLI) is offered to help with usage of QtPy (to get MyPy\r\nand Pyright/Pylance args/configurations).\r\n\r\n#### Mypy\r\n\r\nThe `mypy-args` command helps you to generate command line arguments for Mypy\r\nthat will enable it to process the QtPy source files with the same API\r\nas QtPy itself would have selected.\r\n\r\nIf you run\r\n\r\n```bash\r\nqtpy mypy-args\r\n```\r\n\r\nQtPy will output a string of Mypy CLI args that will reflect the currently\r\nselected Qt API.\r\nFor example, in an environment where PyQt5 is installed and selected\r\n(or the default fallback, if no binding can be found in the environment),\r\nthis would output the following:\r\n\r\n```text\r\n--always-true=PYQT5 --always-false=PYSIDE2 --always-false=PYQT6 --always-false=PYSIDE6\r\n```\r\n\r\nUsing Bash or a similar shell, this can be injected into\r\nthe Mypy command line invocation as follows:\r\n\r\n```bash\r\nmypy --package mypackage $(qtpy mypy-args)\r\n```\r\n\r\n#### Pyright/Pylance\r\n\r\nIn the case of Pyright, instead of runtime arguments, it is required to create a\r\nconfig file for the project, called `pyrightconfig.json` or a `pyright` section\r\nin `pyproject.toml`. See [here](https://github.com/microsoft/pyright/blob/main/docs/configuration.md)\r\nfor reference. In order to set this configuration, QtPy offers the `pyright-config`\r\ncommand for guidance.\r\n\r\nIf you run\r\n\r\n```bash\r\nqtpy pyright-config\r\n```\r\n\r\nyou will get the necessary configs to be included in your project files. If you don't\r\nhave them, it is recommended to create the latter. For example, in an environment where PyQt5\r\nis installed and selected (or the default fallback, if no binding can be found in the\r\nenvironment), this would output the following:\r\n\r\n```text\r\npyrightconfig.json:\r\n{\"defineConstant\": {\"PYQT5\": true, \"PYSIDE2\": false, \"PYQT6\": false, \"PYSIDE6\": false}}\r\n\r\npyproject.toml:\r\n[tool.pyright.defineConstant]\r\nPYQT5 = true\r\nPYSIDE2 = false\r\nPYQT6 = false\r\nPYSIDE6 = false\r\n```\r\n\r\n**Note**: These configurations are necessary for the correct usage of the default VSCode's type\r\nchecking feature while using QtPy in your source code.\r\n\r\n\r\n## Testing matrix\r\n\r\nCurrently, QtPy runs tests for different bindings on Linux, Windows and macOS, using\r\nPython 3.7 and 3.11, and installing those bindings with `conda` and `pip`. For the\r\nPyQt bindings, we also check the installation of extra packages via `pip`.\r\n\r\nFollowing this, the current test matrix looks something like this:\r\n\r\n| | Python | 3.7 | | 3.11 | |\r\n|---------|-----------------|--------------------------------------------|------|--------------------|----------------------------|\r\n| OS | Binding / manager | conda | pip | conda | pip |\r\n| Linux | PyQt5 | 5.12 | 5.15 | 5.15 | 5.15 (with extras) |\r\n| | PyQt6 | skip (unavailable) | 6.3 | skip (unavailable) | 6.5 (with extras) |\r\n| | PySide2 | 5.13 | 5.12 | 5.15 | skip (no wheels available) |\r\n| | PySide6 | 6.4 | 6.3 | 6.5 | 6.5 |\r\n| Windows | PyQt5 | 5.9 | 5.15 | 5.15 | 5.15 (with extras) |\r\n| | PyQt6 | skip (unavailable) | 6.2 | skip (unavailable) | 6.5 (with extras) |\r\n| | PySide2 | 5.13 | 5.12 | 5.15 | skip (no wheels available) |\r\n| | PySide6 | skip (test hang with 6.4. 6.5 unavailable) | 6.2 | 6.5 | 6.5 |\r\n| MacOS | PyQt5 | 5.12 | 5.15 | 5.15 | 5.15 (with extras) |\r\n| | PyQt6 | skip (unavailable) | 6.3 | skip (unavailable) | 6.5 (with extras) |\r\n| | PySide2 | 5.13 | 5.12 | 5.15 | skip (no wheels available) |\r\n| | PySide6 | 6.4 | 6.3 | 6.5 | 6.5 |\r\n\r\n**Note**: The mentioned extra packages for the PyQt bindings are the following:\r\n\r\n* `PyQt3D` and `PyQt6-3D`\r\n* `PyQtChart` and `PyQt6-Charts`\r\n* `PyQtDataVisualization` and `PyQt6-DataVisualization`\r\n* `PyQtNetworkAuth` and `PyQt6-NetworkAuth`\r\n* `PyQtPurchasing`\r\n* `PyQtWebEngine` and `PyQt6-WebEngine` \r\n* `QScintilla` and `PyQt6-QScintilla`\r\n\r\n## Contributing\r\n\r\nEveryone is welcome to contribute! See our [Contributing guide](CONTRIBUTING.md) for more details.\r\n\r\n\r\n## Sponsors\r\n\r\nQtPy is funded thanks to the generous support of\r\n\r\n\r\n[](https://www.quansight.com/)[](https://numfocus.org/)\r\n\r\nand the donations we have received from our users around the world through [Open Collective](https://opencollective.com/spyder/):\r\n\r\n[](https://opencollective.com/spyder#support)\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Provides an abstraction layer on top of the various Qt bindings (PyQt5/6 and PySide2/6).",
"version": "2.4.1",
"project_urls": {
"Bug Tracker": "https://github.com/spyder-ide/qtpy/issues",
"Github": "https://github.com/spyder-ide/qtpy",
"Homepage": "https://github.com/spyder-ide/qtpy",
"Parent Project": "https://www.spyder-ide.org/"
},
"split_keywords": [
"qt",
"pyqt5",
"pyqt6",
"pyside2",
"pyside6"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7ea92146d5117ad8a81185331e0809a6b48933c10171f5bac253c6df9fce991c",
"md5": "14150c2fbc09ccb10e3db92e0273eab7",
"sha256": "1c1d8c4fa2c884ae742b069151b0abe15b3f70491f3972698c683b8e38de839b"
},
"downloads": -1,
"filename": "QtPy-2.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "14150c2fbc09ccb10e3db92e0273eab7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 93500,
"upload_time": "2023-10-23T23:53:25",
"upload_time_iso_8601": "2023-10-23T23:53:25.174481Z",
"url": "https://files.pythonhosted.org/packages/7e/a9/2146d5117ad8a81185331e0809a6b48933c10171f5bac253c6df9fce991c/QtPy-2.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "eb9a7ce646daefb2f85bf5b9c8ac461508b58fa5dcad6d40db476187fafd0148",
"md5": "9a4ed88d2b16b3e660265881430c4779",
"sha256": "a5a15ffd519550a1361bdc56ffc07fda56a6af7292f17c7b395d4083af632987"
},
"downloads": -1,
"filename": "QtPy-2.4.1.tar.gz",
"has_sig": false,
"md5_digest": "9a4ed88d2b16b3e660265881430c4779",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 65492,
"upload_time": "2023-10-23T23:53:26",
"upload_time_iso_8601": "2023-10-23T23:53:26.685614Z",
"url": "https://files.pythonhosted.org/packages/eb/9a/7ce646daefb2f85bf5b9c8ac461508b58fa5dcad6d40db476187fafd0148/QtPy-2.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-23 23:53:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "spyder-ide",
"github_project": "qtpy",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "qtpy"
}
JSON
