suvi 2.7.0__tar.gz

suvi-2.7.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+/build
+/serve.spec
+.vscode/.ropeproject/objectdb
+log/
+env/
+suvi.egg-info/
+dist/
+.vscode/*.log
+exe/

suvi-2.7.0/.gitlab-ci.yml

@@ -0,0 +1,70 @@
+stages:
+  - build
+  - deploy
+
+build:
+  stage: build
+  image: python:3.11
+  variables:
+    GIT_DEPTH: 0
+  script:
+    - python -m venv .venv
+    - source .venv/bin/activate
+    - pip install --upgrade pip
+    - pip install -e ".[dev]"
+    - python -m build --no-isolation --sdist --wheel
+  artifacts:
+    paths:
+      - dist/*
+
+deploy_gitlab:
+  stage: deploy
+  image: python:3.11
+  variables:
+    TWINE_USERNAME: gitlab-ci-token
+    TWINE_PASSWORD: $CI_JOB_TOKEN
+  script:
+    - python -m venv .venv
+    - source .venv/bin/activate
+    - pip install --upgrade pip
+    - pip install -e ".[dev]"
+    - python -m twine upload --verbose --skip-existing --repository-url ${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/pypi dist/*
+  needs:
+    - build
+
+deploy_pypi_test:
+  stage: deploy
+  image: python:3.11
+  variables:
+    TWINE_USERNAME: __token__
+    TWINE_PASSWORD: $PYPI_TEST_TOKEN
+  script:
+    - python -m venv .venv
+    - source .venv/bin/activate
+    - pip install -e ".[dev]"   
+    - python3 -m twine upload --verbose --skip-existing --repository testpypi dist/*
+  needs:
+    - build
+  only:
+    - tags
+  except:
+    - branches
+
+deploy_pypi:
+  stage: deploy
+  image: python:3.11
+  variables:
+    TWINE_USERNAME: __token__
+    TWINE_PASSWORD: $PYPI_TOKEN
+  script:
+    - python -m venv .venv
+    - source .venv/bin/activate
+    - pip install -e ".[dev]"   
+    - python3 -m twine upload --verbose --skip-existing --repository pypi dist/*
+  needs:
+    - build
+    - deploy_pypi_test
+  only:
+    - tags
+  except:
+    - branches

suvi-2.7.0/.vscode/.ropeproject/config.py

@@ -0,0 +1,123 @@
+# The default ``config.py``
+# flake8: noqa
+
+
+def set_prefs(prefs):
+    """This function is called before opening the project"""
+
+    # Specify which files and folders to ignore in the project.
+    # Changes to ignored resources are not added to the history and
+    # VCSs.  Also they are not returned in `Project.get_files()`.
+    # Note that ``?`` and ``*`` match all characters but slashes.
+    # '*.pyc': matches 'test.pyc' and 'pkg/test.pyc'
+    # 'mod*.pyc': matches 'test/mod1.pyc' but not 'mod/1.pyc'
+    # '.svn': matches 'pkg/.svn' and all of its children
+    # 'build/*.o': matches 'build/lib.o' but not 'build/sub/lib.o'
+    # 'build//*.o': matches 'build/lib.o' and 'build/sub/lib.o'
+    prefs["ignored_resources"] = [
+        "*.pyc",
+        "*~",
+        ".ropeproject",
+        ".hg",
+        ".svn",
+        "_svn",
+        ".git",
+        ".tox",
+    ]
+
+    # Specifies which files should be considered python files.  It is
+    # useful when you have scripts inside your project.  Only files
+    # ending with ``.py`` are considered to be python files by
+    # default.
+    # prefs['python_files'] = ['*.py']
+
+    # Custom source folders:  By default rope searches the project
+    # for finding source folders (folders that should be searched
+    # for finding modules).  You can add paths to that list.  Note
+    # that rope guesses project source folders correctly most of the
+    # time; use this if you have any problems.
+    # The folders should be relative to project root and use '/' for
+    # separating folders regardless of the platform rope is running on.
+    # 'src/my_source_folder' for instance.
+    # prefs.add('source_folders', 'src')
+
+    # You can extend python path for looking up modules
+    # prefs.add('python_path', '~/python/')
+
+    # Should rope save object information or not.
+    prefs["save_objectdb"] = True
+    prefs["compress_objectdb"] = False
+
+    # If `True`, rope analyzes each module when it is being saved.
+    prefs["automatic_soa"] = True
+    # The depth of calls to follow in static object analysis
+    prefs["soa_followed_calls"] = 0
+
+    # If `False` when running modules or unit tests "dynamic object
+    # analysis" is turned off.  This makes them much faster.
+    prefs["perform_doa"] = True
+
+    # Rope can check the validity of its object DB when running.
+    prefs["validate_objectdb"] = True
+
+    # How many undos to hold?
+    prefs["max_history_items"] = 32
+
+    # Shows whether to save history across sessions.
+    prefs["save_history"] = True
+    prefs["compress_history"] = False
+
+    # Set the number spaces used for indenting.  According to
+    # :PEP:`8`, it is best to use 4 spaces.  Since most of rope's
+    # unit-tests use 4 spaces it is more reliable, too.
+    prefs["indent_size"] = 4
+
+    # Builtin and c-extension modules that are allowed to be imported
+    # and inspected by rope.
+    prefs["extension_modules"] = []
+
+    # Add all standard c-extensions to extension_modules list.
+    prefs["import_dynload_stdmods"] = True
+
+    # If `True` modules with syntax errors are considered to be empty.
+    # The default value is `False`; When `False` syntax errors raise
+    # `rope.base.exceptions.ModuleSyntaxError` exception.
+    prefs["ignore_syntax_errors"] = False
+
+    # If `True`, rope ignores unresolvable imports.  Otherwise, they
+    # appear in the importing namespace.
+    prefs["ignore_bad_imports"] = False
+
+    # If `True`, rope will insert new module imports as
+    # `from <package> import <module>` by default.
+    prefs["prefer_module_from_imports"] = False
+
+    # If `True`, rope will transform a comma list of imports into
+    # multiple separate import statements when organizing
+    # imports.
+    prefs["split_imports"] = False
+
+    # If `True`, rope will remove all top-level import statements and
+    # reinsert them at the top of the module when making changes.
+    prefs["pull_imports_to_top"] = True
+
+    # If `True`, rope will sort imports alphabetically by module name instead
+    # of alphabetically by import statement, with from imports after normal
+    # imports.
+    prefs["sort_imports_alphabetically"] = False
+
+    # Location of implementation of
+    # rope.base.oi.type_hinting.interfaces.ITypeHintingFactory In general
+    # case, you don't have to change this value, unless you're an rope expert.
+    # Change this value to inject you own implementations of interfaces
+    # listed in module rope.base.oi.type_hinting.providers.interfaces
+    # For example, you can add you own providers for Django Models, or disable
+    # the search type-hinting in a class hierarchy, etc.
+    prefs[
+        "type_hinting_factory"
+    ] = "rope.base.oi.type_hinting.factory.default_type_hinting_factory"
+
+
+def project_opened(project):
+    """This function is called after opening the project"""
+    # Do whatever you like here!

suvi-2.7.0/.vscode/launch.json

@@ -0,0 +1,47 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "with config options",
+            "type": "python",
+            "request": "launch",
+            "program": "${workspaceFolder}/suvi/app.py",
+            "args": [
+                "--bind",
+                "127.0.0.1", 
+                "--enforce",
+                "--admin-login",
+                "admin",
+                "--admin-password",
+                "ecmind",
+                "--user-login",
+                "user",
+                "--user-password",
+                "test",
+            ],
+            "console": "integratedTerminal",
+            "cwd": "${workspaceFolder}"
+        },
+        {
+            "name": "suvi without config options",
+            "type": "python",
+            "request": "launch",
+            "program": "${workspaceFolder}/suvi/app.py",
+            "args": [],
+            "console": "integratedTerminal",
+            "cwd": "${workspaceFolder}"
+        },
+        {
+            "name": "suvi --help",
+            "type": "python",
+            "request": "launch",
+            "program": "${workspaceFolder}/suvi/app.py",
+            "args": ["--help"],
+            "console": "integratedTerminal",
+            "cwd": "${workspaceFolder}"
+        }        
+    ]
+}

suvi-2.7.0/.vscode/settings.json

@@ -0,0 +1,19 @@
+{
+    "cSpell.words": [
+        "ABOUT",
+        "Mind",
+        "Switzerland",
+        "configparser",
+        "deque",
+        "flask",
+        "flaskext",
+        "hashlib",
+        "jsonify",
+        "pathlib",
+        "psutil",
+        "threading",
+        "uptime",
+        "waitress"
+    ],
+    "python.formatting.provider": "black"
+}

suvi-2.7.0/MANIFEST.in

@@ -0,0 +1,3 @@
+recursive-include suvi/templates *
+recursive-include suvi/static *
+global-exclude *.pyc

suvi-2.7.0/Makefile

@@ -0,0 +1,12 @@
+build:
+	pip install build
+	python -m build
+
+
+pull_dependencies:
+	- mkdir -p suvi/static/dependencies
+	curl -o suvi/static/dependencies/bootstrap.min.css https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css
+	curl -o suvi/static/dependencies/bootstrap.bundle.min.js https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js
+	curl -o suvi/static/dependencies/htmx.min.js https://unpkg.com/htmx.org@1.9.12/dist/htmx.min.js
+	curl -o suvi/static/dependencies/jquery.min.js https://code.jquery.com/jquery-3.7.1.min.js
+	

suvi-2.7.0/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.1
+Name: suvi
+Version: 2.7.0
+Summary: ECMind Supervisor
+Author-email: ECMind GmbH <info@ecmind.ch>
+Project-URL: Homepage, https://gitlab.ecmind.ch/open/suvi
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+
+## Documentation source
+
+This README.md is just boilerplate for the [wiki](https://gitlab.ecmind.ch/open/suvi/-/wikis/home).
+
+## Parameters
+
+  `--bind`: The ip/interface where suvi listens at. [default: 0.0.0.0]
+  `--port`: The listening port. [default: 8080]
+  `--enforce` / `--no-enforce`: Require a basic auth login [default: no-enforce]
+  `--admin-login`: Username for the admin user [default: admin]
+  `--admin-password`: Password for the admin user
+  `--user-login`: Username for the standard user [default: user]
+  `--user-password`: Password for the standard user
+  `--tasks`: Where to look for task config files (`.json` files) [default: ./tasks]
+  `--cycle`: Update interval in seconds to look for new/deleted task config files [default: 10]
+  `--logs`: Directory where to store suvi and task log files. [default: ./log]
+  `--log-rotate-when`: When to rotate log files (`H` for hours, `D` for days or `midnight`) [default: midnight]
+  `--log-rotate-interval`: How many instances fo `when` have to pass before rotating the log file [default: 1]
+  `--log-backup-count`: How many file rollovers should be stored [default: 5]
+  `--help`: Show help message and exit.
+
+### Using environment vars to configure suvi
+
+Parameters can be set via environment vars, example:
+
+```bash
+#/bin/bash
+
+PW1=$(pwmake 80)
+PW2=$(pwmake 80)
+
+echo Setting admin password to "$PW1" and user password to "$PW2".
+
+SUVI_ENFORCE=True \
+SUVI_ADMIN_LOGIN=admin \
+SUVI_ADMIN_PASSWORD="$PW1" \
+SUVI_USER_LOGIN=user \
+SUVI_USER_PASSWORD="$PW2" \
+suvi
+```
+
+### Using `suvi.toml` to configure suvi
+
+Parameters can also be set by a `suvi.toml` file:
+
+```toml
+bind = "0.0.0.0"
+port = 8080
+enforce = true
+admin_login = "admin"
+admin_password = "RamesesII"
+user_login = "user"
+user_password = "TrustNo1"
+tasks = "./tasks"
+cycle = 5
+logs = "./log"
+log_rotate_when = "midnight"
+log_rotate_interval = 1
+log_backup_count = 5
+```
+
+The values of the configuration file are overwritten by console values. For windows service deployments, `suvi.toml` is expected at `%WINDIR%\system32`.
+
+## Task config files (`.json`)
+
+- `type`: Defines the startup strategy
+  - `"type": "ondemand"`: Run the task on user interaction/get call.
+  - `"type": "keepalive"`: Automatically start the task with suvi and restart if necessary.
+  - `"type": "schedule"`: Automatically start the task with suvi and restart if necessary.
+- `exec`: Defines how to start the task
+  - `"exec": "system"`: Starts an external executable via `popen`
+  - `"exec": "shell"`: Starts an external executable via `popen` in the current system shell.
+    - The "`args`" list should be joined and instead just separated by spaces for the shell to interpret the command.
+  - `"exec": "stop"`: Stops (= kill & reload) tasks by config file name i. e. on a schedule
+    - Example: `{ "type": "schedule", "schedule": "* 0 * * *", "exec": "stop", "args": [ "has-to-restart-sometimes" ], "cwd": "/tmp" }`
+    - `"args"` may contain one or more config files names without the json extension
+  - `"exec": "talend"`: Deflates & starts a talend job build to a zip package
+    - When using `"talend"` for `"exec"`, this additional config parameters exist:
+      - `"package"`: Path to the talend build zip file.
+      - `"java"`: Optional path to the java binary. When this path to the `java` binary is omitted, the system default will be used.
+    - The `cwd` parameter is used as base path for deflated jobs. When `cmd` is omitted, the system default temp path is used instead. 
+    - Example: `{ "type": "keepalive", "exec": "talend", "package": "/jobs/talend-demo-job-with-subtask.zip", "args": ["--context=Test", "-Xms256M", "-Xmx1024M"], "cwd": "/tmp", "info": "deflate and keepalive talend demo job" }`
+- `args`: Array of startup params or an array of arrays it multiple programs should be started if the previous job succeeded
+  - `"args": ["notepad.exe", "test.txt"]`
+  - `"args": [ ["notepad.exe", "test.txt"], ["calc.exe"] ]`
+- `cwd`: Optional startup path for the task
+  - `"cwd": "C:/temp"`
+- `env`: Optional dictionary that extends/overwrites suvis environment variables
+  - `"env": {"TAIL_FILE": "/tmp/test"}, "args": ["bash", "-c", "tail -f $TAIL_FILE"]`
+- `schedule`: Read when `"type": "schedule"` is set to launch an instance of the task if not already running.
+  - minutes, hours, days, month, weekdays
+  - `"schedule": "0 0,4,8,12,16,20 * * 1-5"`: Start Monday to Friday on every four hours.
+  - The crontab syntax element `/` is not supported at the moment.
+  - Minutes range from `0` to `59`
+  - Hours range from `0` to `23`
+  - Days range from `1` to `31`
+  - Month range from `1` (Jan) to `12` (Dec)
+  - Weekdays range from `1` (Mon) to `7` (Sun) including `0` (also Sun)
+- `tokens`: Optional list of secret tokens to start a tasks without a password via HTTP GET or POST at `/run/hook/<token>`
+  - Example: `"tokens": ["30d827f9-e22f-4b6a-85f1-bcb9977c6155", "69f541f8-614a-45f4-950b-67998c819ee0"]`
+  - When POSTing to a webhook of `"exec": "system"`, the raw body gets redirected to STDIN of the (first) `"args"` command.
+- `info`: Optional markdown text to provide task info.
+  - Line breaks have to be encoded as `\n` in JSON.
+
+## Environment variables of tasks
+
+The environment variables for the runtime of a task consist of:
+
+- `SUVI_TASK_NAME` set to the task name.
+- `SUVI_EXEC_UUID` set to a unique uuid for each task execution. This uuid is unchanged between executions of subtasks (when `args` is a list is lists).
+- Variables set by the OS
+- Variables set by `env` task configuration.
+
+## Change log
+
+- Version 1.20
+  - Allow task args to be an array of arrays to run subsequent programs (and break if one fails).
+  - `requirements.txt` added.
+- Version 1.21
+  - Removed push monitoring in favor of `/telemetry.json` endpoint.
+- Version 1.22
+  - Require user auth for telemetry endpoint.
+- Version 2.0.0
+  - Remove `ini` file in favour of command line arguments.
+  - Make installable.
+  - Version scheme change to be compatible with pip.
+- Version 2.0.1/2.0.2
+  - Fixed base dir for installed app.
+  - Fixed package data for templates/static files.
+- Version 2.1.0
+  - Remove `psutils` dependency;
+  - therefore remove `/top` and memory overview in `/manage/`.
+- Version 2.2.0
+  - Redesign & Licencing infos.
+  - `config.toml`, command line options.
+- Version 2.2.1
+  - Also log outputs with invalid UTF-8 chars
+- Version 2.2.2
+  - Recursively kill child processes when stopping a task.
+- Version 2.3.0
+  - Send POST message body of webhooks to STDIN.
+- Version 2.3.1/2.3.2
+  - Set cycle default to `5` seconds.
+  - Design updates (i.e. allow to start/stop task from task log).
+- Version 2.3.3
+  - Add `shell` setting.
+- Version 2.3.4
+  - Add suvi specific ENV variables `SUVI_TASK_NAME` and `SUVI_EXEC_UUID`.
+  - Fix exec type to ondemand for unknown types.
+- Version 2.4.0
+  - Refactoring of task internals.
+- Version 2.4.1
+  - Python 3.6 compatibility.
+- Version 2.4.2
+  - View global and tasks logs in plain text.
+  - Set log queues to 1000 lines (from 500).
+  - Add action buttons in task log list.
+- Version 2.4.3
+  - Set task queues to 1000 lines (from 500).
+- Version 2.4.4
+  - Fix token handling regression.
+- Version 2.4.5
+  - Fix task listing for ondemand talend tasks.
+- Version 2.4.6
+  - Fix talend infos in task list for non-running ondemand tasks.
+- Version 2.4.7/2.4.8
+  - Fix suvi no more loading tasks after first parsing error.
+  - Refactor `"shell": "true"` field to `"exec": "shell"`.
+  - Print missing file/directory on File Not Found errors in suvi log.
+- Version 2.5.8
+  - Update to Bootstrap 5.3, htmx 1.92. and JQuery 3.7.0
+- Version 2.5.9
+  - Update minium Python version to 3.9.
+  - Fix stop tasks bug.
+- Version 2.6.0
+  - Switch Markdown parser to `python-markdown`.
+- Version 2.6.1
+  - Windows service stops will try to stop tasks before shutdown.
+  - Terminate frontend process on shutdown.
+  - Admin interface shutdown will shutdown suvi (service) itself.
+  - Change Windows service temp path to be consistent between starts.
+- Version 2.6.2/2.6.3
+  - Update HTMX to 2.0.4.
+  - Allow filtering configured tasks, running tasks and task logs list.
+- Version 2.6.4
+  - Upgrade to Pyton >= 3.12
+- Version 2.7.0
+  - Open Source release
+  - Cleanups
+  - Remove build targets for old closed source edition

suvi-2.7.0/README.md

@@ -0,0 +1,190 @@
+## Documentation source
+
+This README.md is just boilerplate for the [wiki](https://gitlab.ecmind.ch/open/suvi/-/wikis/home).
+
+## Parameters
+
+  `--bind`: The ip/interface where suvi listens at. [default: 0.0.0.0]
+  `--port`: The listening port. [default: 8080]
+  `--enforce` / `--no-enforce`: Require a basic auth login [default: no-enforce]
+  `--admin-login`: Username for the admin user [default: admin]
+  `--admin-password`: Password for the admin user
+  `--user-login`: Username for the standard user [default: user]
+  `--user-password`: Password for the standard user
+  `--tasks`: Where to look for task config files (`.json` files) [default: ./tasks]
+  `--cycle`: Update interval in seconds to look for new/deleted task config files [default: 10]
+  `--logs`: Directory where to store suvi and task log files. [default: ./log]
+  `--log-rotate-when`: When to rotate log files (`H` for hours, `D` for days or `midnight`) [default: midnight]
+  `--log-rotate-interval`: How many instances fo `when` have to pass before rotating the log file [default: 1]
+  `--log-backup-count`: How many file rollovers should be stored [default: 5]
+  `--help`: Show help message and exit.
+
+### Using environment vars to configure suvi
+
+Parameters can be set via environment vars, example:
+
+```bash
+#/bin/bash
+
+PW1=$(pwmake 80)
+PW2=$(pwmake 80)
+
+echo Setting admin password to "$PW1" and user password to "$PW2".
+
+SUVI_ENFORCE=True \
+SUVI_ADMIN_LOGIN=admin \
+SUVI_ADMIN_PASSWORD="$PW1" \
+SUVI_USER_LOGIN=user \
+SUVI_USER_PASSWORD="$PW2" \
+suvi
+```
+
+### Using `suvi.toml` to configure suvi
+
+Parameters can also be set by a `suvi.toml` file:
+
+```toml
+bind = "0.0.0.0"
+port = 8080
+enforce = true
+admin_login = "admin"
+admin_password = "RamesesII"
+user_login = "user"
+user_password = "TrustNo1"
+tasks = "./tasks"
+cycle = 5
+logs = "./log"
+log_rotate_when = "midnight"
+log_rotate_interval = 1
+log_backup_count = 5
+```
+
+The values of the configuration file are overwritten by console values. For windows service deployments, `suvi.toml` is expected at `%WINDIR%\system32`.
+
+## Task config files (`.json`)
+
+- `type`: Defines the startup strategy
+  - `"type": "ondemand"`: Run the task on user interaction/get call.
+  - `"type": "keepalive"`: Automatically start the task with suvi and restart if necessary.
+  - `"type": "schedule"`: Automatically start the task with suvi and restart if necessary.
+- `exec`: Defines how to start the task
+  - `"exec": "system"`: Starts an external executable via `popen`
+  - `"exec": "shell"`: Starts an external executable via `popen` in the current system shell.
+    - The "`args`" list should be joined and instead just separated by spaces for the shell to interpret the command.
+  - `"exec": "stop"`: Stops (= kill & reload) tasks by config file name i. e. on a schedule
+    - Example: `{ "type": "schedule", "schedule": "* 0 * * *", "exec": "stop", "args": [ "has-to-restart-sometimes" ], "cwd": "/tmp" }`
+    - `"args"` may contain one or more config files names without the json extension
+  - `"exec": "talend"`: Deflates & starts a talend job build to a zip package
+    - When using `"talend"` for `"exec"`, this additional config parameters exist:
+      - `"package"`: Path to the talend build zip file.
+      - `"java"`: Optional path to the java binary. When this path to the `java` binary is omitted, the system default will be used.
+    - The `cwd` parameter is used as base path for deflated jobs. When `cmd` is omitted, the system default temp path is used instead. 
+    - Example: `{ "type": "keepalive", "exec": "talend", "package": "/jobs/talend-demo-job-with-subtask.zip", "args": ["--context=Test", "-Xms256M", "-Xmx1024M"], "cwd": "/tmp", "info": "deflate and keepalive talend demo job" }`
+- `args`: Array of startup params or an array of arrays it multiple programs should be started if the previous job succeeded
+  - `"args": ["notepad.exe", "test.txt"]`
+  - `"args": [ ["notepad.exe", "test.txt"], ["calc.exe"] ]`
+- `cwd`: Optional startup path for the task
+  - `"cwd": "C:/temp"`
+- `env`: Optional dictionary that extends/overwrites suvis environment variables
+  - `"env": {"TAIL_FILE": "/tmp/test"}, "args": ["bash", "-c", "tail -f $TAIL_FILE"]`
+- `schedule`: Read when `"type": "schedule"` is set to launch an instance of the task if not already running.
+  - minutes, hours, days, month, weekdays
+  - `"schedule": "0 0,4,8,12,16,20 * * 1-5"`: Start Monday to Friday on every four hours.
+  - The crontab syntax element `/` is not supported at the moment.
+  - Minutes range from `0` to `59`
+  - Hours range from `0` to `23`
+  - Days range from `1` to `31`
+  - Month range from `1` (Jan) to `12` (Dec)
+  - Weekdays range from `1` (Mon) to `7` (Sun) including `0` (also Sun)
+- `tokens`: Optional list of secret tokens to start a tasks without a password via HTTP GET or POST at `/run/hook/<token>`
+  - Example: `"tokens": ["30d827f9-e22f-4b6a-85f1-bcb9977c6155", "69f541f8-614a-45f4-950b-67998c819ee0"]`
+  - When POSTing to a webhook of `"exec": "system"`, the raw body gets redirected to STDIN of the (first) `"args"` command.
+- `info`: Optional markdown text to provide task info.
+  - Line breaks have to be encoded as `\n` in JSON.
+
+## Environment variables of tasks
+
+The environment variables for the runtime of a task consist of:
+
+- `SUVI_TASK_NAME` set to the task name.
+- `SUVI_EXEC_UUID` set to a unique uuid for each task execution. This uuid is unchanged between executions of subtasks (when `args` is a list is lists).
+- Variables set by the OS
+- Variables set by `env` task configuration.
+
+## Change log
+
+- Version 1.20
+  - Allow task args to be an array of arrays to run subsequent programs (and break if one fails).
+  - `requirements.txt` added.
+- Version 1.21
+  - Removed push monitoring in favor of `/telemetry.json` endpoint.
+- Version 1.22
+  - Require user auth for telemetry endpoint.
+- Version 2.0.0
+  - Remove `ini` file in favour of command line arguments.
+  - Make installable.
+  - Version scheme change to be compatible with pip.
+- Version 2.0.1/2.0.2
+  - Fixed base dir for installed app.
+  - Fixed package data for templates/static files.
+- Version 2.1.0
+  - Remove `psutils` dependency;
+  - therefore remove `/top` and memory overview in `/manage/`.
+- Version 2.2.0
+  - Redesign & Licencing infos.
+  - `config.toml`, command line options.
+- Version 2.2.1
+  - Also log outputs with invalid UTF-8 chars
+- Version 2.2.2
+  - Recursively kill child processes when stopping a task.
+- Version 2.3.0
+  - Send POST message body of webhooks to STDIN.
+- Version 2.3.1/2.3.2
+  - Set cycle default to `5` seconds.
+  - Design updates (i.e. allow to start/stop task from task log).
+- Version 2.3.3
+  - Add `shell` setting.
+- Version 2.3.4
+  - Add suvi specific ENV variables `SUVI_TASK_NAME` and `SUVI_EXEC_UUID`.
+  - Fix exec type to ondemand for unknown types.
+- Version 2.4.0
+  - Refactoring of task internals.
+- Version 2.4.1
+  - Python 3.6 compatibility.
+- Version 2.4.2
+  - View global and tasks logs in plain text.
+  - Set log queues to 1000 lines (from 500).
+  - Add action buttons in task log list.
+- Version 2.4.3
+  - Set task queues to 1000 lines (from 500).
+- Version 2.4.4
+  - Fix token handling regression.
+- Version 2.4.5
+  - Fix task listing for ondemand talend tasks.
+- Version 2.4.6
+  - Fix talend infos in task list for non-running ondemand tasks.
+- Version 2.4.7/2.4.8
+  - Fix suvi no more loading tasks after first parsing error.
+  - Refactor `"shell": "true"` field to `"exec": "shell"`.
+  - Print missing file/directory on File Not Found errors in suvi log.
+- Version 2.5.8
+  - Update to Bootstrap 5.3, htmx 1.92. and JQuery 3.7.0
+- Version 2.5.9
+  - Update minium Python version to 3.9.
+  - Fix stop tasks bug.
+- Version 2.6.0
+  - Switch Markdown parser to `python-markdown`.
+- Version 2.6.1
+  - Windows service stops will try to stop tasks before shutdown.
+  - Terminate frontend process on shutdown.
+  - Admin interface shutdown will shutdown suvi (service) itself.
+  - Change Windows service temp path to be consistent between starts.
+- Version 2.6.2/2.6.3
+  - Update HTMX to 2.0.4.
+  - Allow filtering configured tasks, running tasks and task logs list.
+- Version 2.6.4
+  - Upgrade to Pyton >= 3.12
+- Version 2.7.0
+  - Open Source release
+  - Cleanups
+  - Remove build targets for old closed source edition