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, 120 insertions, 0 deletions

diff --git a/examples/network/fortuneserver/fortuneserver.py b/examples/network/fortuneserver/fortuneserver.py
new file mode 100644
index 000000000..7b8f05a32
--- /dev/null
+++ b/examples/network/fortuneserver/fortuneserver.py
@@ -0,0 +1,117 @@
+
+#############################################################################
+##
+## 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$
+##
+#############################################################################
+
+"""PySide6 port of the network/fortuneserver example from Qt v5.x"""
+
+import random
+
+from PySide6 import QtCore, QtWidgets, QtNetwork
+
+
+class Server(QtWidgets.QDialog):
+    def __init__(self, parent=None):
+        super(Server, self).__init__(parent)
+
+        statusLabel = QtWidgets.QLabel()
+        quitButton = QtWidgets.QPushButton("Quit")
+        quitButton.setAutoDefault(False)
+
+        self.tcpServer = QtNetwork.QTcpServer(self)
+        if not self.tcpServer.listen():
+            QtWidgets.QMessageBox.critical(self, "Fortune Server",
+                    "Unable to start the server: %s." % self.tcpServer.errorString())
+            self.close()
+            return
+
+        statusLabel.setText("The server is running on port %d.\nRun the "
+                "Fortune Client example now." % self.tcpServer.serverPort())
+
+        self.fortunes = (
+                "You've been leading a dog's life. Stay off the furniture.",
+                "You've got to think about tomorrow.",
+                "You will be surprised by a loud noise.",
+                "You will feel hungry again in another hour.",
+                "You might have mail.",
+                "You cannot kill time without injuring eternity.",
+                "Computers are not intelligent. They only think they are.")
+
+        quitButton.clicked.connect(self.close)
+        self.tcpServer.newConnection.connect(self.sendFortune)
+
+        buttonLayout = QtWidgets.QHBoxLayout()
+        buttonLayout.addStretch(1)
+        buttonLayout.addWidget(quitButton)
+        buttonLayout.addStretch(1)
+
+        mainLayout = QtWidgets.QVBoxLayout()
+        mainLayout.addWidget(statusLabel)
+        mainLayout.addLayout(buttonLayout)
+        self.setLayout(mainLayout)
+
+        self.setWindowTitle("Fortune Server")
+
+    def sendFortune(self):
+        block = QtCore.QByteArray()
+        out = QtCore.QDataStream(block, QtCore.QIODevice.WriteOnly)
+        out.setVersion(QtCore.QDataStream.Qt_4_0)
+        out.writeUInt16(0)
+        fortune = self.fortunes[random.randint(0, len(self.fortunes) - 1)]
+
+        out.writeString(fortune)
+        out.device().seek(0)
+        out.writeUInt16(block.size() - 2)
+
+        clientConnection = self.tcpServer.nextPendingConnection()
+        clientConnection.disconnected.connect(clientConnection.deleteLater)
+
+        clientConnection.write(block)
+        clientConnection.disconnectFromHost()
+
+
+if __name__ == '__main__':
+
+    import sys
+
+    app = QtWidgets.QApplication(sys.argv)
+    server = Server()
+    random.seed(None)
+    sys.exit(server.exec_())
diff --git a/examples/network/fortuneserver/fortuneserver.pyproject b/examples/network/fortuneserver/fortuneserver.pyproject
new file mode 100644
index 000000000..b97b4156f
--- /dev/null
+++ b/examples/network/fortuneserver/fortuneserver.pyproject
@@ -0,0 +1,3 @@
+{
+    "files": ["fortuneserver.py"]
+}