Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

gh-117058: Update GUI and packaging recommendations for macOS. #117059

Merged
merged 2 commits into from
Mar 20, 2024
Merged

gh-117058: Update GUI and packaging recommendations for macOS. #117059

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
decb8cf
Update GUI and packaging recommendations for macOS.
freakboy3742 Mar 20, 2024
df060a4
Removed news file.
freakboy3742 Mar 20, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 25 additions & 11 deletions Doc/using/mac.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -152,26 +152,41 @@ Tk toolkit (https://www.tcl.tk). An Aqua-native version of Tk is bundled with
macOS by Apple, and the latest version can be downloaded and installed from
https://www.activestate.com; it can also be built from source.

*wxPython* is another popular cross-platform GUI toolkit that runs natively on
macOS. Packages and documentation are available from https://www.wxpython.org.
A number of alternative macOS GUI toolkits are available:

*PyQt* is another popular cross-platform GUI toolkit that runs natively on
macOS. More information can be found at
https://riverbankcomputing.com/software/pyqt/intro.
* `PySide <https://www.qt.io/qt-for-python>`__: Official Python bindings to the
`Qt GUI toolkit <https://qt.io>`__.

*PySide* is another cross-platform Qt-based toolkit. More information at
https://www.qt.io/qt-for-python.
* `PyQt <https://riverbankcomputing.com/software/pyqt/intro>`__: Alternative
Python bindings to Qt.

* `Kivy <https://kivy.org>`__: A cross-platform GUI toolkit that supports
desktop and mobile platforms.

* `Toga <https://toga.readthedocs.io>`__: Part of the `BeeWare Project
<https://beeware.org>`__; supports desktop, mobile, web and console apps.

* `wxPython <https://www.wxpython.org>`__: A cross-platform toolkit that
supports desktop operating systems.

.. _distributing-python-applications-on-the-mac:

Distributing Python Applications
================================

The standard tool for deploying standalone Python applications on the Mac is
:program:`py2app`. More information on installing and using :program:`py2app`
can be found at https://pypi.org/project/py2app/.
A range of tools exist for converting your Python code into a standalone
distributable application:

* `py2app <https://pypi.org/project/py2app/>`__: Supports creating macOS ``.app``
bundles from a Python project.

* `Briefcase <https://briefcase.readthedocs.io>`__: Part of the `BeeWare Project
<https://beeware.org>`__; a cross-platform packaging tool that supports
creation of ``.app`` bundles on macOS, as well as managing signing and
notarization.

* `PyInstaller <https://pyinstaller.org/>`__: A cross-platform packaging tool that creates
a single file or folder as a distributable artifact.

Other Resources
===============
Expand All @@ -184,4 +199,3 @@ https://www.python.org/community/sigs/current/pythonmac-sig/
Another useful resource is the MacPython wiki:

https://wiki.python.org/moin/MacPython

Loading