Difference between revisions of "Qt for Python"

From Qt Wiki
Jump to: navigation, search
(Redirected page to PySide2)
 
Line 1: Line 1:
#REDIRECT [[PySide2]]
+
{{LangSwitch}}
 +
[[Category:QtForPython]]
 +
== Qt for Python ==
 +
The '''Qt for Python''' project aims to provide a complete port of the [[PySide]] module to Qt 5. The development started on [https://github.com/PySide GitHub] in May 2015. The project managed to port Pyside to Qt 5.3, 5.4 & 5.5. During April 2016 The Qt Company decided to properly support the port (see [https://groups.google.com/forum/#!topic/pyside-dev/pqwzngAGLWE details] ).
 +
 
 +
This wiki page tracks the progress of the '''Qt for Python''' project development and provides further information concerning the effort.
 +
 
 +
'''Qt for Python''' will be available under GPL, LGPL and commercial license.
 +
 
 +
== Getting Started ==
 +
* [[PySide2_GettingStarted|Getting started guide for macOS, Windows and Linux]]
 +
* [[Qt_for_Python_Tutorial|Tutorial (under construction)]]
 +
* [https://bugreports.qt.io/browse/PYSIDE Bug tracker] to report any issue.
 +
* [https://codereview.qt-project.org CodeReview] and [https://codereview.qt-project.org/#/q/project:%255Epyside.%252B,n,z PySide2 open patches]
 +
* Git repository (5.9 branch is the branch currently worked on for PySide2)
 +
** ssh://codereview.qt-project.org/pyside/pyside-setup
 +
* [[PySide2_Development_Getting_Started|Development: Getting started]]
 +
* [https://doc-snapshots.qt.io/qtforpython/ Official documentation (''in progress'')]
 +
 
 +
== How does '''Qt for Python''' look like? ==
 +
 
 +
<syntaxhighlight lang="python" line='line'>
 +
import sys
 +
from PySide2.QtWidgets import QApplication, QLabel
 +
                                                   
 +
if __name__ == "__main__":
 +
    app = QApplication([])
 +
    label = QLabel("Hello World")
 +
    label.show()
 +
    sys.exit(app.exec_())
 +
</syntaxhighlight>
 +
 
 +
More examples can be found in the [http://code.qt.io/cgit/pyside/pyside-setup.git/tree/examples project's repository] inside the '''examples''' directory.
 +
== Community ==
 +
 
 +
* Official IRC channel on FreeNode '''#qt-pyside'''
 +
* [http://lists.qt-project.org/mailman/listinfo/pyside Official Mailing list]
 +
* Keybase: [https://keybase.io/team/pyside keybase.io/team/pyside]
 +
* Gitter: [http://gitter.im/PySide/pyside2 gitter.im/PySide/pyside2]
 +
 
 +
== Development Status ==
 +
 
 +
=== Weekly development progress ===
 +
The summary of the development progress can be found in [https://wiki.qt.io/PySide2_Development_Notes Development Notes by date]
 +
 
 +
=== Pyside Development Progress Notes ===
 +
 
 +
The most current view of the progress can be found in Jira:
 +
 
 +
# [https://bugreports.qt.io/secure/IssueNavigator.jspa?mode=hide&requestId=17825 Unresolved issues]
 +
# [https://bugreports.qt.io/secure/IssueNavigator.jspa?mode=hide&requestId=18025 All issues (including resolved)]
 +
 
 +
The second link is useful to monitor the progress of the backlog. The best way to achieve this is to sort the list by the "Updated" column.
 +
Larger backlog/feature items are filed as "User Stories" in Jira.
 +
 
 +
=== Missing PySide2 bindings ===
 +
 
 +
The list of the current missing bindings can be found in [[PySide2_Missing_Bindings|Missing PySide2 bindings]]
 +
 
 +
=== Outstanding tasks for release ===
 +
 
 +
# Determine PySide2 package number
 +
# Ensure multi target packages can be created (long standing - reduced Python API usage )
 +
# General Doc changes required for release
 +
## Getting started
 +
## Some examples documented
 +
## pyinstaller usage
 +
## Class documentation polish
 +
## snapshot generation on http://doc-snapshot.qt-project.org/
 +
 
 +
== Frequently Asked Questions ==
 +
 
 +
* Q: PySide? Qt for Python? what is the name?
 +
** A: The name of the project is '''Qt for Python''' and the name of the module is '''PySide2'''.
 +
* Q: Why PySide2 and not just PySide?
 +
** A: Since PySide was developed for Qt4, when the port was made to support Qt5, the name was change to PySide2 to infer that is was a newer version.
 +
* Q: Where I can find information about the old PySide project?
 +
** A: The old wiki page of the project is available on [[PySide]], '''but''' the project is deprecated, and there is no official support for it. We highly recommend to not use it.
 +
* Q: My project is using PySide, how hard would it be to adapt it to PySide2?
 +
** A: The changes are the same between [https://doc.qt.io/qt-5/qt5-intro.html Qt4 and Qt5], and for PySide users means mostly on adapting the ''import'' statement, since many classes were moved from QtGui to QtWidgets.
 +
::''Qt 5 is highly compatible with Qt 4. It is possible for developers of Qt 4 applications to seamlessly move on to Qt 5 with their current functionality and gradually develop new things leveraging all the great items Qt 5 makes possible.
 +
''
 +
== Contributing to the Qt for Python Wiki ==
 +
 
 +
This Wiki is a community area where you can easily contribute, and which may contain rapidly changing information.
 +
Please put any wiki pages related to Qt for Python into the "QtForPython" category by adding the following text to the top of the page:
 +
<code>
 +
[[Category:QtForPython]]
 +
</code>
 +
 
 +
When creating a new wiki page, please start the name with the prefix "Qt_for_Python", so all the wiki page names will have the same structure.

Revision as of 11:08, 18 April 2018

En Ar Bg De El Es Fa Fi Fr Hi Hu It Ja Kn Ko Ms Nl Pl Pt Ru Sq Th Tr Uk Zh

Qt for Python

The Qt for Python project aims to provide a complete port of the PySide module to Qt 5. The development started on GitHub in May 2015. The project managed to port Pyside to Qt 5.3, 5.4 & 5.5. During April 2016 The Qt Company decided to properly support the port (see details ).

This wiki page tracks the progress of the Qt for Python project development and provides further information concerning the effort.

Qt for Python will be available under GPL, LGPL and commercial license.

Getting Started

How does Qt for Python look like?

1 import sys
2 from PySide2.QtWidgets import QApplication, QLabel
3                                                      
4 if __name__ == "__main__":
5     app = QApplication([])
6     label = QLabel("Hello World")
7     label.show()
8     sys.exit(app.exec_())

More examples can be found in the project's repository inside the examples directory.

Community

Development Status

Weekly development progress

The summary of the development progress can be found in Development Notes by date

Pyside Development Progress Notes

The most current view of the progress can be found in Jira:

  1. Unresolved issues
  2. All issues (including resolved)

The second link is useful to monitor the progress of the backlog. The best way to achieve this is to sort the list by the "Updated" column. Larger backlog/feature items are filed as "User Stories" in Jira.

Missing PySide2 bindings

The list of the current missing bindings can be found in Missing PySide2 bindings

Outstanding tasks for release

  1. Determine PySide2 package number
  2. Ensure multi target packages can be created (long standing - reduced Python API usage )
  3. General Doc changes required for release
    1. Getting started
    2. Some examples documented
    3. pyinstaller usage
    4. Class documentation polish
    5. snapshot generation on http://doc-snapshot.qt-project.org/

Frequently Asked Questions

  • Q: PySide? Qt for Python? what is the name?
    • A: The name of the project is Qt for Python and the name of the module is PySide2.
  • Q: Why PySide2 and not just PySide?
    • A: Since PySide was developed for Qt4, when the port was made to support Qt5, the name was change to PySide2 to infer that is was a newer version.
  • Q: Where I can find information about the old PySide project?
    • A: The old wiki page of the project is available on PySide, but the project is deprecated, and there is no official support for it. We highly recommend to not use it.
  • Q: My project is using PySide, how hard would it be to adapt it to PySide2?
    • A: The changes are the same between Qt4 and Qt5, and for PySide users means mostly on adapting the import statement, since many classes were moved from QtGui to QtWidgets.
Qt 5 is highly compatible with Qt 4. It is possible for developers of Qt 4 applications to seamlessly move on to Qt 5 with their current functionality and gradually develop new things leveraging all the great items Qt 5 makes possible.

Contributing to the Qt for Python Wiki

This Wiki is a community area where you can easily contribute, and which may contain rapidly changing information. Please put any wiki pages related to Qt for Python into the "QtForPython" category by adding the following text to the top of the page:

[[Category:QtForPython]]

When creating a new wiki page, please start the name with the prefix "Qt_for_Python", so all the wiki page names will have the same structure.