Clarify textual dependencies in documentation / packaging

Signed-off-by: Richard Oliver <[email protected]>

Author: roliver-rpi

README.adoc

@@ -59,11 +59,13 @@ $ sudo reboot now
 Next, you will have to configure `rpi-sb-provisioner` by using the TUI. In a terminal, run: 
 
 ----
-$ configure.sh
+$ config.sh
 ----
 
 WARNING: This will not work if you have not reboot after installing the package! 
 
+WARNING: `rpi-sb-provisioner' must be installed with `--install-suggests' for `config.sh' to work. This will require installation of `python3-textual' and `python3-rich' from Debian's Trixie release.
+
 Running this command will open up a full screen text UI. The TUI supports mouse input or keyboard navigation! 
 Each of the boxes contains a name, text entry and help button. The steps for editing each parameter are as follows:
 
@@ -215,6 +217,8 @@ WARNING: `rpi-sb-provisioner` will not, by default, block JTAG access. If you wi
 
 === Monitoring via the monitoring application
 
+WARNING: `rpi-sb-provisioner' must be installed with `--install-suggests' for `monitor.sh' to work. This will require installation of `python3-textual' and `python3-rich' from Debian's Trixie release.
+
 `rpi-sb-provisioner` also contains a monitoring application. This can be used to observe the progress of a device as it is being provisioned. It also allows for easy introspection of the log files and lists all completed and failed devices.
 The monitoring application supports both mouse or keyboard input. Navigation between boxes can be acheived by using the `tab` key or by clicking on the desired area.
 

nfpm.yaml

@@ -143,7 +143,6 @@ depends:
   - dctrl-tools
   - diffutils
   - findutils
-  - python3-textual
   - libengine-pkcs11-openssl
   - libp11-kit-dev
   - gnutls-bin
@@ -158,8 +157,21 @@ depends:
 # Suggested packages. (overridable)
 # This will expand any env var you set in the field, e.g. ${SUGGESTS_BLA}
 # the env var approach can be used to account for differences in platforms
-# suggests:
-#   - bzr
+#
+# textual is a hard requirement for config.sh / monitor.sh but the version
+# packaged for Bookworm (0.1.13) does not implement features we depend upon.
+# At a minimum, we require 'The CSS Release' (0.2.0). As a more recent textual
+# package is available for Trixie (0.52.1), the dependencies have been listed
+# as 'suggests'.
+#
+# Debian's python3-textual (0.52.1-1) declares a dependency on python3-rich (>= 10.7.0),
+# but this is incorrect as (>= 13.3.3) is required due to use of Style.clear_meta_and_links.
+# clear_meta_and_links has been an upstream python3-textual requirement as of
+# (0.17.0). As such declare the dependencies below such that they can be
+# fulfilled by Debian's python3-textual, python3-rich Trixie packages.
+suggests:
+  - python3-textual (>= 0.17.0)
+  - python3-rich (>= 13.3.3)
 
 # Packages it conflicts with. (overridable)
 # This will expand any env var you set in the field, e.g. ${CONFLICTS_BLA}