examples: directory structure

When generating the gallery automatically, the structure
of the examples was not the same for all the modules.

This reorganization was made under the following assumption:

An example requires:
- its own directory,
- a '.pyproject' file,
- one or more '.py' files,
- extra files (likes images, .rc, .ui, etc)

Even for cases when  subdirectories are made to depict categories, like
'widgets/state-machine/...', one directory is required per example.

There should not be '.pyproject' files for categories,
except for the general 'examples.pyproject' to open all of them.

Task-number: PYSIDE-1490
Pick-to: 6.0
Change-Id: Ie690773c816a248016dbebaad90fbb1d1c2aeea5
Reviewed-by: Cristian Maureira-Fredes <cristian.maureira-fredes@qt.io>

2 files changed, 150 insertions, 0 deletions

diff --git a/examples/widgets/itemviews/fetchmore/fetchmore.py b/examples/widgets/itemviews/fetchmore/fetchmore.py
new file mode 100644
index 000000000..c91874004
--- /dev/null
+++ b/examples/widgets/itemviews/fetchmore/fetchmore.py
@@ -0,0 +1,147 @@
+
+#############################################################################
+##
+## Copyright (C) 2009 Darryl Wallace, 2009 <wallacdj@gmail.com>
+## Copyright (C) 2013 Riverbank Computing Limited.
+## Copyright (C) 2016 The Qt Company Ltd.
+## Contact: http://www.qt.io/licensing/
+##
+## This file is part of the Qt for Python examples of the Qt Toolkit.
+##
+## $QT_BEGIN_LICENSE:BSD$
+## You may use this file under the terms of the BSD license as follows:
+##
+## "Redistribution and use in source and binary forms, with or without
+## modification, are permitted provided that the following conditions are
+## met:
+##   * Redistributions of source code must retain the above copyright
+##     notice, this list of conditions and the following disclaimer.
+##   * Redistributions in binary form must reproduce the above copyright
+##     notice, this list of conditions and the following disclaimer in
+##     the documentation and/or other materials provided with the
+##     distribution.
+##   * Neither the name of The Qt Company Ltd nor the names of its
+##     contributors may be used to endorse or promote products derived
+##     from this software without specific prior written permission.
+##
+##
+## THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+## "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+## LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+## A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+## OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+## LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+## DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+## THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+## (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+## OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+##
+## $QT_END_LICENSE$
+##
+#############################################################################
+
+from PySide6 import QtCore, QtWidgets
+
+
+class FileListModel(QtCore.QAbstractListModel):
+    numberPopulated = QtCore.Signal(int)
+
+    def __init__(self, parent=None):
+        super(FileListModel, self).__init__(parent)
+
+        self.fileCount = 0
+        self.fileList = []
+
+    def rowCount(self, parent=QtCore.QModelIndex()):
+        return self.fileCount
+
+    def data(self, index, role=QtCore.Qt.DisplayRole):
+        if not index.isValid():
+            return None
+
+        if index.row() >= len(self.fileList) or index.row() < 0:
+            return None
+
+        if role == QtCore.Qt.DisplayRole:
+            return self.fileList[index.row()]
+
+        if role == QtCore.Qt.BackgroundRole:
+            batch = (index.row() // 100) % 2
+#  FIXME: QGuiApplication::palette() required
+            if batch == 0:
+                return qApp.palette().base()
+
+            return qApp.palette().alternateBase()
+
+        return None
+
+    def canFetchMore(self, index):
+        return self.fileCount < len(self.fileList)
+
+    def fetchMore(self, index):
+        remainder = len(self.fileList) - self.fileCount
+        itemsToFetch = min(100, remainder)
+
+        self.beginInsertRows(QtCore.QModelIndex(), self.fileCount,
+                self.fileCount + itemsToFetch)
+
+        self.fileCount += itemsToFetch
+
+        self.endInsertRows()
+
+        self.numberPopulated.emit(itemsToFetch)
+
+    def setDirPath(self, path):
+        dir = QtCore.QDir(path)
+
+        self.beginResetModel()
+        self.fileList = list(dir.entryList())
+        self.fileCount = 0
+        self.endResetModel()
+
+
+class Window(QtWidgets.QWidget):
+    def __init__(self, parent=None):
+        super(Window, self).__init__(parent)
+
+        model = FileListModel(self)
+        model.setDirPath(QtCore.QLibraryInfo.location(QtCore.QLibraryInfo.PrefixPath))
+
+        label = QtWidgets.QLabel("Directory")
+        lineEdit = QtWidgets.QLineEdit()
+        label.setBuddy(lineEdit)
+
+        view = QtWidgets.QListView()
+        view.setModel(model)
+
+        self.logViewer = QtWidgets.QTextBrowser()
+        self.logViewer.setSizePolicy(QtWidgets.QSizePolicy(QtWidgets.QSizePolicy.Preferred, QtWidgets.QSizePolicy.Preferred))
+
+        lineEdit.textChanged.connect(model.setDirPath)
+        lineEdit.textChanged.connect(self.logViewer.clear)
+        model.numberPopulated.connect(self.updateLog)
+
+        layout = QtWidgets.QGridLayout()
+        layout.addWidget(label, 0, 0)
+        layout.addWidget(lineEdit, 0, 1)
+        layout.addWidget(view, 1, 0, 1, 2)
+        layout.addWidget(self.logViewer, 2, 0, 1, 2)
+
+        self.setLayout(layout)
+        self.setWindowTitle("Fetch More Example")
+
+    def updateLog(self, number):
+        self.logViewer.append("%d items added." % number)
+
+
+if __name__ == '__main__':
+
+    import sys
+
+    app = QtWidgets.QApplication(sys.argv)
+
+    window = Window()
+    window.show()
+
+    sys.exit(app.exec_())
diff --git a/examples/widgets/itemviews/fetchmore/fetchmore.pyproject b/examples/widgets/itemviews/fetchmore/fetchmore.pyproject
new file mode 100644
index 000000000..e5c369374
--- /dev/null
+++ b/examples/widgets/itemviews/fetchmore/fetchmore.pyproject
@@ -0,0 +1,3 @@
+{
+    "files": ["fetchmore.py"]
+}