diff -r 3fc8dfeb6ebe -r b99e7fd55fd3 src/eric7/EricWidgets/EricFileDialog.py
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/eric7/EricWidgets/EricFileDialog.py Thu Jul 07 11:23:56 2022 +0200
@@ -0,0 +1,250 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2010 - 2022 Detlev Offenbach <detlev@die-offenbachs.de>
+#
+
+"""
+Module implementing alternative functions for the QFileDialog static methods.
+"""
+
+from PyQt6.QtWidgets import QFileDialog
+
+import Globals
+
+Option = QFileDialog.Option
+
+ShowDirsOnly = QFileDialog.Option.ShowDirsOnly
+DontResolveSymlinks = QFileDialog.Option.DontResolveSymlinks
+DontConfirmOverwrite = QFileDialog.Option.DontConfirmOverwrite
+DontUseNativeDialog = QFileDialog.Option.DontUseNativeDialog
+ReadOnly = QFileDialog.Option.ReadOnly
+HideNameFilterDetails = QFileDialog.Option.HideNameFilterDetails
+DontUseCustomDirectoryIcons = QFileDialog.Option.DontUseCustomDirectoryIcons
+
+
+def __reorderFilter(filterStr, initialFilter=""):
+ """
+ Private function to reorder the file filter to cope with a KDE issue
+ introduced by distributor's usage of KDE file dialogs.
+
+ @param filterStr Qt file filter
+ @type str
+ @param initialFilter initial filter
+ @type str
+ @return the rearranged Qt file filter
+ @rtype str
+ """
+ if initialFilter and not Globals.isMacPlatform():
+ fileFilters = filterStr.split(';;')
+ if len(fileFilters) < 10 and initialFilter in fileFilters:
+ fileFilters.remove(initialFilter)
+ fileFilters.insert(0, initialFilter)
+ return ";;".join(fileFilters)
+ else:
+ return filterStr
+
+
+def getOpenFileName(parent=None, caption="", directory="",
+ filterStr="", options=None):
+ """
+ Module function to get the name of a file for opening it.
+
+ @param parent parent widget of the dialog
+ @type QWidget
+ @param caption window title of the dialog
+ @type str
+ @param directory working directory of the dialog
+ @type str
+ @param filterStr filter string for the dialog
+ @type str
+ @param options various options for the dialog
+ @type QFileDialog.Options
+ @return name of file to be opened
+ @rtype str
+ """
+ if options is None:
+ options = QFileDialog.Option(0)
+ return QFileDialog.getOpenFileName(
+ parent, caption, directory, filterStr, "", options)[0]
+
+
+def getOpenFileNameAndFilter(parent=None, caption="", directory="",
+ filterStr="", initialFilter="",
+ options=None):
+ """
+ Module function to get the name of a file for opening it and the selected
+ file name filter.
+
+ @param parent parent widget of the dialog
+ @type QWidget
+ @param caption window title of the dialog
+ @type str
+ @param directory working directory of the dialog
+ @type str
+ @param filterStr filter string for the dialog
+ @type str
+ @param initialFilter initial filter for the dialog
+ @type str
+ @param options various options for the dialog
+ @type QFileDialog.Options
+ @return name of file to be opened and selected filter
+ @rtype tuple of (str, str)
+ """
+ if options is None:
+ options = QFileDialog.Option(0)
+ newfilter = __reorderFilter(filterStr, initialFilter)
+ return QFileDialog.getOpenFileName(
+ parent, caption, directory, newfilter, initialFilter, options)
+
+
+def getOpenFileNames(parent=None, caption="", directory="",
+ filterStr="", options=None):
+ """
+ Module function to get a list of names of files for opening.
+
+ @param parent parent widget of the dialog
+ @type QWidget
+ @param caption window title of the dialog
+ @type str
+ @param directory working directory of the dialog
+ @type str
+ @param filterStr filter string for the dialog
+ @type str
+ @param options various options for the dialog
+ @type QFileDialog.Options
+ @return list of file names to be opened
+ @rtype list of str
+ """
+ if options is None:
+ options = QFileDialog.Option(0)
+ return QFileDialog.getOpenFileNames(
+ parent, caption, directory, filterStr, "", options)[0]
+
+
+def getOpenFileNamesAndFilter(parent=None, caption="", directory="",
+ filterStr="", initialFilter="",
+ options=None):
+ """
+ Module function to get a list of names of files for opening and the
+ selected file name filter.
+
+ @param parent parent widget of the dialog
+ @type QWidget
+ @param caption window title of the dialog
+ @type str
+ @param directory working directory of the dialog
+ @type str
+ @param filterStr filter string for the dialog
+ @type str
+ @param initialFilter initial filter for the dialog
+ @type str
+ @param options various options for the dialog
+ @type QFileDialog.Options
+ @return list of file names to be opened and selected filter
+ @rtype tuple of (list of str, str)
+ """
+ if options is None:
+ options = QFileDialog.Option(0)
+ newfilter = __reorderFilter(filterStr, initialFilter)
+ return QFileDialog.getOpenFileNames(
+ parent, caption, directory, newfilter, initialFilter, options)
+
+
+def getOpenFileAndDirNames(parent=None, caption="", directory="",
+ filterStr="", options=None):
+ """
+ Module function to get the names of files and directories for opening.
+
+ @param parent parent widget of the dialog
+ @type QWidget
+ @param caption window title of the dialog
+ @type str
+ @param directory working directory of the dialog
+ @type str
+ @param filterStr filter string for the dialog
+ @type str
+ @param options various options for the dialog
+ @type QFileDialog.Options
+ @return names of the selected files and folders
+ @rtype list of str
+ """
+ from .EricDirFileDialog import EricDirFileDialog
+ return EricDirFileDialog.getOpenFileAndDirNames(
+ parent, caption, directory, filterStr, options
+ )
+
+
+def getSaveFileName(parent=None, caption="", directory="",
+ filterStr="", options=None):
+ """
+ Module function to get the name of a file for saving it.
+
+ @param parent parent widget of the dialog
+ @type QWidget
+ @param caption window title of the dialog
+ @type str
+ @param directory working directory of the dialog
+ @type str
+ @param filterStr filter string for the dialog
+ @type str
+ @param options various options for the dialog
+ @type QFileDialog.Options
+ @return name of file to be saved
+ @rtype str
+ """
+ if options is None:
+ options = QFileDialog.Option(0)
+ return QFileDialog.getSaveFileName(
+ parent, caption, directory, filterStr, "", options)[0]
+
+
+def getSaveFileNameAndFilter(parent=None, caption="", directory="",
+ filterStr="", initialFilter="",
+ options=None):
+ """
+ Module function to get the name of a file for saving it and the selected
+ file name filter.
+
+ @param parent parent widget of the dialog
+ @type QWidget
+ @param caption window title of the dialog
+ @type str
+ @param directory working directory of the dialog
+ @type str
+ @param filterStr filter string for the dialog
+ @type str
+ @param initialFilter initial filter for the dialog
+ @type str
+ @param options various options for the dialog
+ @type QFileDialog.Options
+ @return name of file to be saved and selected filte
+ @rtype tuple of (str, str)
+ """
+ if options is None:
+ options = QFileDialog.Option(0)
+ newfilter = __reorderFilter(filterStr, initialFilter)
+ return QFileDialog.getSaveFileName(
+ parent, caption, directory, newfilter, initialFilter, options)
+
+
+def getExistingDirectory(parent=None, caption="",
+ directory="",
+ options=QFileDialog.Option.ShowDirsOnly):
+ """
+ Module function to get the name of a directory.
+
+ @param parent parent widget of the dialog
+ @type QWidget
+ @param caption window title of the dialog
+ @type str
+ @param directory working directory of the dialog
+ @type str
+ @param options various options for the dialog
+ @type QFileDialog.Options
+ @return name of selected directory
+ @rtype str
+ """
+ if options is None:
+ options = QFileDialog.Option(0)
+ return QFileDialog.getExistingDirectory(parent, caption, directory,
+ options)
