14 example module reference implementation for moduletester adoption

.vscode/launch.json

@@ -6,23 +6,20 @@
     "configurations": [
         {
             "name": "Run ModuleTester",
-            "type": "python",
+            "type": "debugpy",
             "request": "launch",
             "module": "moduletester.gui.main",
             "console": "integratedTerminal",
             "envFile": "${workspaceFolder}/.env",
             "justMyCode": false,
-            "args": [
-                "--unattended",
-            ],
             "env": {
                 "LANG": "en",
                 "QT_COLOR_MODE": "light",
             }
         },
         {
             "name": "Run current file",
-            "type": "python",
+            "type": "debugpy",
             "request": "launch",
             "program": "${file}",
             "console": "integratedTerminal",

.vscode/tasks.json

@@ -368,6 +368,55 @@
                 "🧹 Clean Up",
             ],
         },
+        {
+            "label": "📋 Update requirements.txt",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": [
+                "scripts/update_requirements.py",
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}",
+            },
+            "group": {
+                "kind": "build",
+                "isDefault": false,
+            },
+            "presentation": {
+                "clear": true,
+                "echo": true,
+                "focus": false,
+                "panel": "dedicated",
+                "reveal": "always",
+                "showReuseMessage": true,
+            },
+            "problemMatcher": [],
+        },
+        {
+            "label": "🧪 Run Example Calculator (ModuleTester)",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": [
+                "scripts/run_with_env.py",
+                "${command:python.interpreterPath}",
+                "scripts/run_example.py",
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}",
+            },
+            "group": {
+                "kind": "build",
+                "isDefault": true,
+            },
+            "presentation": {
+                "clear": true,
+                "echo": true,
+                "focus": false,
+                "panel": "dedicated",
+                "reveal": "always",
+                "showReuseMessage": true,
+            },
+        },
         {
             "label": "❔ Untracked files",
             "type": "shell",

CHANGELOG.md

@@ -1,5 +1,27 @@
 # ModuleTester Releases #
 
+## Version 1.1.0 ##
+
+### New features
+
+- Add Example Calculator reference implementation (`example/`) demonstrating
+  full ModuleTester integration with manual GUI tests, unit tests (pytest +
+  coverage), and qualification scripts
+- Add step-by-step integration guide in documentation (`doc/example.rst`)
+
+## Version 1.0.1 ##
+
+### Bug fixes
+
+- Set fixed font for result label in `ResultError` and `ResultOutput` widgets
+- Change launch configuration type from `python` to `debugpy`
+
+### Improvements
+
+- Add `pypandoc_binary` to requirements
+- Add missing `PyQtWebEngine` to requirements
+- Add deps requirements sync script `scripts\update_requirements.py`
+
 ## Version 1.0.0 ##
 
 First stable release of ModuleTester.

README.md

@@ -75,9 +75,14 @@ and is used to test [PlotPyStack](https://github.com/PlotPyStack) libraries.
 
 ## Example
 
-Using ModuleTester on the `guidata` Python package — the tree view shows test
-hierarchy and execution status, while dockable panels display test properties,
-output, and errors:
+ModuleTester ships with a complete **Example Calculator** project in the
+[`example/`](example/) directory that demonstrates all three test categories:
+manual GUI tests, unit tests with coverage, and qualification scripts.
+
+See the [integration guide](https://moduletester.readthedocs.io/en/latest/example.html)
+for a step-by-step tutorial on adding ModuleTester to your own project.
+
+![ModuleTester — example tests](https://raw.githubusercontent.com/Codra-Ingenierie-Informatique/ModuleTester/main/doc/images/shots/example.moduletester.png)
 
 ![ModuleTester — guidata tests](https://raw.githubusercontent.com/Codra-Ingenierie-Informatique/ModuleTester/main/doc/images/shots/guidata.moduletester.png)
 

doc/changelog.rst

@@ -4,6 +4,14 @@ Changelog
 See the full changelog on `GitHub <https://github.com/Codra-Ingenierie-Informatique/ModuleTester/blob/main/CHANGELOG.md>`_.
 
 
+Version 1.0.1
+-------------
+
+Bug fixes and improvements — see the
+`CHANGELOG.md <https://github.com/Codra-Ingenierie-Informatique/ModuleTester/blob/main/CHANGELOG.md>`_
+for the complete list.
+
+
 Version 1.0.0
 -------------
 

doc/cli.rst

@@ -28,7 +28,7 @@ Launch the graphical interface.
      - Python package to load on startup. The package must be importable.
    * - ``-f``, ``--file``
      - str
-     - Path to a ``.mt`` project file to open on startup.
+     - Path to a ``.moduletester`` project file to open on startup.
 
 **Examples**
 
@@ -41,7 +41,7 @@ Launch the graphical interface.
    $ moduletester -p guidata
 
    # Open a saved project file
-   $ moduletester -f /path/to/project.mt
+   $ moduletester -f /path/to/project.moduletester
 
 .. note::