Add task to update requirements.txt and include toml-to-requirements in dependencies

Author: cdebonnel

.vscode/tasks.json

@@ -172,6 +172,32 @@
             },
             "type": "shell"
         },
+        {
+            "label": "Update requirements.txt",
+            "command": "toml-to-req",
+            "args": [
+                "--toml-file",
+                "pyproject.toml",
+                "--optional-lists",
+                "dev,doc,test",
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "group": {
+                "kind": "build",
+                "isDefault": false
+            },
+            "presentation": {
+                "clear": true,
+                "echo": true,
+                "focus": false,
+                "panel": "dedicated",
+                "reveal": "always",
+                "showReuseMessage": true,
+            },
+            "type": "shell"
+        },
         {
             "label": "Clean Up",
             "type": "shell",

doc/dev/platforms.rst

@@ -37,12 +37,12 @@ which is the reference file for the project dependencies.
     Please note that the generation is not systematic and the ``requirements.txt``
     file may not be up-to-date.
 
-To update the ``requirements.txt`` file, you need to install the
-``toml-to-requirements`` and execute the following command:
+To update the ``requirements.txt`` file, use the Visual Studio task
+``Update requirements.txt`` or execute the following command:
 
 .. code-block:: bash
 
-    toml-to-req --toml-file .\pyproject.toml --include-optional
+    toml-to-req --toml-file pyproject.toml --include-optional-lists dev,doc,test
 
 
 Microsoft Windows 10

doc/requirements.rst

@@ -51,8 +51,11 @@ Optional modules for development:
       - 
       - Code coverage measurement for Python
     * - Cython
-      - 
+      - >=3.0
       - The Cython compiler for writing C extensions in the Python language.
+    * - toml-to-requirements
+      - ==0.3.0
+      - Convert a pyproject.toml file to a requirements.txt file
 
 Optional modules for building the documentation:
 

pyproject.toml

@@ -56,7 +56,7 @@ plotpy-tests = "plotpy.tests:run"
 plotpy-benchmarks = "plotpy.tests.benchmarks:run"
 
 [project.optional-dependencies]
-dev = ["ruff", "pylint", "Coverage", "Cython>=3.0"]
+dev = ["ruff", "pylint", "Coverage", "Cython>=3.0", "toml-to-requirements==0.3.0"]
 doc = [
     "PyQt5",
     "sphinx",