added qt wizard

Author: tikuma-lsuhsc

.github/workflows/test_n_pub.yml

@@ -13,23 +13,19 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        python-version: [3.7, 3.8, 3.9, "3.10"]
+        python-version: ["3.12"]
         os: [ubuntu-latest, macos-latest, windows-latest]
         # python-version: [3.7, 3.8, 3.9]
         # os: [windows-latest]
-        exclude:
-          - os: macos-latest
-            python-version: 3.7
+        include:
           - os: ubuntu-latest
-            python-version: 3.7
-          - os: macos-latest
             python-version: 3.8
           - os: ubuntu-latest
-            python-version: 3.8
-          - os: macos-latest
             python-version: 3.9
+          - os: macos-latest
+            python-version: "3.10"
           - os: ubuntu-latest
-            python-version: 3.9
+            python-version: "3.11"
 
     steps:
       - run: echo ${{github.ref}}

pyproject.toml

@@ -37,5 +37,8 @@ Pull_Requests = "https://github.com/python-ffmpegio/python-ffmpegio-downloader/p
 [project.scripts]
 ffdl = "ffmpeg_downloader.__main__:main"
 
+[project.gui-scripts]
+ffdl-gui = "ffmpeg_downloader.qt.__main__:main"
+
 [tool.setuptools.dynamic]
 version = { attr = "ffmpeg_downloader.__version__" }

src/ffmpeg_downloader/qt/__init__.py

@@ -0,0 +1,3 @@
+from .wizard import InstallFFmpegWizard
+
+__all__ = ["InstallFFmpegWizard"]

src/ffmpeg_downloader/qt/__main__.py

@@ -0,0 +1,14 @@
+import sys
+from PyQt6.QtWidgets import QApplication
+from ffmpeg_downloader.qt.wizard import InstallFFmpegWizard
+
+
+def main():
+    app = QApplication(sys.argv)
+    wizard = InstallFFmpegWizard()
+    wizard.show()
+    sys.exit(app.exec())
+
+
+if __name__ == "__main__":
+    main()

src/ffmpeg_downloader/qt/assets/FFmpeg_icon.svg

@@ -0,0 +1,125 @@
+"""
+Qt binding and backend selector.
+
+The selection logic is as follows:
+- if any of PyQt6, PySide6, PyQt5, or PySide2 have already been
+  imported (checked in that order), use it;
+- otherwise, if the QT_API environment variable (used by Enthought) is set, use
+  it to determine which binding to use;
+
+[taken from matplotlib]
+"""
+
+import operator
+import os
+import platform
+import sys
+
+from packaging.version import parse as parse_version
+
+QT_API_PYQT6 = "PyQt6"
+QT_API_PYSIDE6 = "PySide6"
+QT_API_PYQT5 = "PyQt5"
+QT_API_PYSIDE2 = "PySide2"
+QT_API_ENV = os.environ.get("QT_API")
+if QT_API_ENV is not None:
+    QT_API_ENV = QT_API_ENV.lower()
+_ETS = {  # Mapping of QT_API_ENV to requested binding.
+    "pyqt6": QT_API_PYQT6,
+    "pyside6": QT_API_PYSIDE6,
+    "pyqt5": QT_API_PYQT5,
+    "pyside2": QT_API_PYSIDE2,
+}
+# First, check if anything is already imported.
+if sys.modules.get("PyQt6.QtCore"):
+    QT_API = QT_API_PYQT6
+elif sys.modules.get("PySide6.QtCore"):
+    QT_API = QT_API_PYSIDE6
+elif sys.modules.get("PyQt5.QtCore"):
+    QT_API = QT_API_PYQT5
+elif sys.modules.get("PySide2.QtCore"):
+    QT_API = QT_API_PYSIDE2
+# A non-Qt backend was selected but we still got there (possible, e.g., when
+# fully manually embedding Matplotlib in a Qt app without using pyplot).
+elif QT_API_ENV is None:
+    QT_API = None
+elif QT_API_ENV in _ETS:
+    QT_API = _ETS[QT_API_ENV]
+else:
+    raise RuntimeError(
+        "The environment variable QT_API has the unrecognized value {!r}; "
+        "valid values are {}".format(QT_API_ENV, ", ".join(_ETS))
+    )
+
+
+def _setup_pyqt5plus():
+    global QtCore, QtWidgets, QtGui, __version__
+    global _to_int
+
+    if QT_API == QT_API_PYQT6:
+        from PyQt6 import QtCore, QtWidgets, QtGui
+
+        __version__ = QtCore.PYQT_VERSION_STR
+        _to_int = operator.attrgetter("value")
+    elif QT_API == QT_API_PYSIDE6:
+        from PySide6 import QtCore, QtWidgets, QtGui, __version__
+
+        if parse_version(__version__) >= parse_version("6.4"):
+            _to_int = operator.attrgetter("value")
+        else:
+            _to_int = int
+    elif QT_API == QT_API_PYQT5:
+        from PyQt5 import QtCore, QtWidgets, QtGui
+
+        __version__ = QtCore.PYQT_VERSION_STR
+        _to_int = int
+    elif QT_API == QT_API_PYSIDE2:
+        from PySide2 import QtCore, QtWidgets, QtGui, __version__
+
+        _to_int = int
+    else:
+        raise AssertionError(f"Unexpected QT_API: {QT_API}")
+
+
+if QT_API in [QT_API_PYQT6, QT_API_PYQT5, QT_API_PYSIDE6, QT_API_PYSIDE2]:
+    _setup_pyqt5plus()
+elif QT_API is None:  # See above re: dict.__getitem__.
+    _candidates = [
+        (_setup_pyqt5plus, QT_API_PYQT6),
+        (_setup_pyqt5plus, QT_API_PYSIDE6),
+        (_setup_pyqt5plus, QT_API_PYQT5),
+        (_setup_pyqt5plus, QT_API_PYSIDE2),
+    ]
+    for _setup, QT_API in _candidates:
+        try:
+            _setup()
+        except ImportError:
+            continue
+        break
+    else:
+        raise ImportError(
+            "Failed to import any of the following Qt binding modules: {}".format(
+                ", ".join([QT_API for _, QT_API in _candidates])
+            )
+        )
+else:  # We should not get there.
+    raise AssertionError(f"Unexpected QT_API: {QT_API}")
+_version_info = tuple(QtCore.QLibraryInfo.version().segments())
+
+
+if _version_info < (5, 12):
+    raise ImportError(
+        f"The Qt version imported is "
+        f"{QtCore.QLibraryInfo.version().toString()} but Matplotlib requires "
+        f"Qt>=5.12"
+    )
+
+
+# Fixes issues with Big Sur
+# https://bugreports.qt.io/browse/QTBUG-87014, fixed in qt 5.15.2
+if (
+    sys.platform == "darwin"
+    and parse_version(platform.mac_ver()[0]) >= parse_version("10.16")
+    and _version_info < (5, 15, 2)
+):
+    os.environ.setdefault("QT_MAC_WANTS_LAYER", "1")