feature: now uses Diagnosticism for version information (#52)

Author: synesissoftware

CHANGES.md

@@ -9,6 +9,8 @@
 * examples:
   * restored **example.cpp.linking.N_with_stock** (**examples/cpp/linking/N_with_stock/**) linking **be.N** + **bec.stock**, multiplexing console / file / fprintf / null / syslog (Windows Syslog + debugger on Win32); re-enabled the **examples/cpp/linking** CMake subdirectory; listed in **README.md**;
   * **example.cpp.linking.N_with_stock**: define `PANTHEIOS_FE_PROCESS_IDENTITY` with `PANTHEIOS_EXTERN` (C++ `const` external linkage) and `PAN_BE_N_BACKEND_LIST` in an `extern "C"` block without `PANTHEIOS_EXTERN` (stock Pantheios C++ form; avoids GCC/MinGW `-Werror` on `extern` + initializer);
+* testing:
+  * (example/test only) now uses **Diagnosticism** for version strings;
 * version:
   * current composite is `PANTHEIOS_VER_1_0_1_RC4` (`0x010001E4`) in **include/pantheios/pantheios.h**;
   * **test.unit.getversion** asserts `PANTHEIOS_VER_1_0_1_RC4`;

CMakeLists.txt

@@ -147,6 +147,7 @@ endif(PANTHEIOS_USE_WIDE_STRINGS)
 # optional:
 # - ACE - stock ACE backends (be/bec/bel/ber.ACE);
 # - b64;
+# - Diagnosticism - required for testing only;
 # - shwild - required for testing only;
 #
 # - Threads;
@@ -322,6 +323,27 @@ if(NOT b64_FOUND)
 endif()
 
 
+# ############################
+# Diagnosticism
+
+if(NOT NO_DIAGNOSTICISM)
+
+	find_package(Diagnosticism QUIET)
+
+	if(Diagnosticism_FOUND)
+
+		message("-- CMake package Diagnosticism found (version ${Diagnosticism_VERSION})")
+
+		add_compile_definitions(HAS_Diagnosticism)
+	endif(Diagnosticism_FOUND)
+endif()
+
+if(NOT b64_FOUND)
+
+	add_compile_definitions(PANTHEIOS_NO_B64)
+endif()
+
+
 # ############################
 # shwild
 

NEWS.md

@@ -3,7 +3,7 @@
 
 | Date                | News Item                                                     | Details    |
 | ------------------- | ------------------------------------------------------------- | ---------- |
-| 14th October 2026   | [Pantheios 1.0.1-rc4 released](https://github.com/synesissoftware/Pantheios/releases/tag/1.0.1-rc4) | **bec.stock** / **WithCallback** (no **bec.test**); **example.cpp.linking.N_with_stock**; `PANTHEIOS_VER_1_0_1_RC4` |
+| 14th October 2026   | [Pantheios 1.0.1-rc4 released](https://github.com/synesissoftware/Pantheios/releases/tag/1.0.1-rc4) | **bec.stock** / **WithCallback** (no **bec.test**); **example.cpp.linking.N_with_stock**; **Diagnosticism** version strings; `PANTHEIOS_VER_1_0_1_RC4` |
 | 12th October 2026   | [Pantheios 1.0.1-rc3 released](https://github.com/synesissoftware/Pantheios/releases/tag/1.0.1-rc3) | **bec.AnsiConsole** VT / default sink; optional **ACE**; **CMake** leaf helpers; entry/main + path canonicalisation; headless scratch **`--skip-interactive`**; `_RELSTATUS`; CI refactor; Phase **4c** **test.scratch.versions**; **STLSoft** **1.11.1-rc8** floor |
 | 6th September 2026  | [Pantheios 1.0.1-rc2 released](https://github.com/synesissoftware/Pantheios/releases/tag/1.0.1-rc2) | transitive link dependencies in **pantheios-config.cmake**; added **.vscode/settings.json** |
 | 5th August 2026     | [Pantheios 1.0.1-rc1 released](https://github.com/synesissoftware/Pantheios/releases/tag/1.0.1-rc1) | modular GitHub Actions CI; documentation modernisation; **bec.AnsiConsole** back-end; **CMake** package config |

test/scratch/versions/CMakeLists.txt

@@ -18,6 +18,14 @@ if(b64_FOUND)
 	)
 endif(b64_FOUND)
 
+if(Diagnosticism_FOUND)
+
+	target_link_libraries(test.scratch.versions
+		PRIVATE
+			Diagnosticism::core
+	)
+endif(Diagnosticism_FOUND)
+
 if(shwild_FOUND)
 
 	target_link_shwild(test.scratch.versions)

test/scratch/versions/main.cpp

@@ -22,6 +22,11 @@
 # include <b64/b64.h>
 #endif
 
+#ifdef HAS_Diagnosticism
+# include <diagnosticism/diagnosticism.h>
+# include <diagnosticism/version_string.h>
+#endif
+
 #ifdef HAS_shwild
 # include <shwild/shwild.h>
 #endif
@@ -30,6 +35,10 @@
 # include <woad/woad.h>
 #endif
 
+#ifdef HAS_xTests
+# include <xtests/xtests.h>
+#endif
+
 #include <iomanip>
 #include <iostream>
 
@@ -53,26 +62,63 @@ version(
 ,   T_integer   libver
 )
 {
-    stm
-        << prefix
-        << libname
-        << ": v"
-        << ((libver >> 24) & 0xff)
-        << '.'
-        << ((libver >> 16) & 0xff)
-        << '.'
-        << ((libver >> 8) & 0xff)
-        << '.'
-        << ((libver >> 0) & 0xff)
-        << " ("
-        << macroname
-        << " = 0x"
-        << std::hex << std::setfill('0') << std::setw(8)
-        << static_cast<unsigned>(libver)
-        << std::dec
-        << ")"
-        << std::endl
-        ;
+#ifdef HAS_Diagnosticism
+
+    char    sz[100];
+    size_t  sz_len;
+
+    if (0 == diagnosticism_calc_version_string(
+        sz, sizeof(sz)
+    ,   ((libver >> 24) & 0xff)
+    ,   ((libver >> 16) & 0xff)
+    ,   ((libver >> 8) & 0xff)
+    ,   ((libver >> 0) & 0xff)
+    ,   &sz_len
+    ))
+    {
+        sz[sz_len] = '\0';
+
+        stm
+            << prefix
+            << libname
+            << ": v"
+            << sz
+            << " ("
+            << macroname
+            << " = 0x"
+            << std::hex << std::setfill('0') << std::setw(8)
+            << static_cast<unsigned>(libver)
+            << std::dec
+            << ")"
+            << std::endl
+            ;
+
+        return;
+    }
+    else
+#endif /* HAS_Diagnosticism */
+    {
+        stm
+            << prefix
+            << libname
+            << ": v"
+            << ((libver >> 24) & 0xff)
+            << '.'
+            << ((libver >> 16) & 0xff)
+            << '.'
+            << ((libver >> 8) & 0xff)
+            << '.'
+            << ((libver >> 0) & 0xff)
+            << " ("
+            << macroname
+            << " = 0x"
+            << std::hex << std::setfill('0') << std::setw(8)
+            << static_cast<unsigned>(libver)
+            << std::dec
+            << ")"
+            << std::endl
+            ;
+    }
 }
 
 
@@ -105,6 +151,15 @@ int main(int /* argc */, char* /* argv */[])
     }
 #endif
 
+#ifdef HAS_Diagnosticism
+
+    {
+        unsigned const libver = DIAGNOSTICISM_VER;
+
+        version(std::cout, "\t", "Diagnosticism", "DIAGNOSTICISM_VER", libver);
+    }
+#endif
+
 #ifdef HAS_shwild
 
     {
@@ -123,9 +178,17 @@ int main(int /* argc */, char* /* argv */[])
     }
 #endif
 
+#ifdef HAS_xTests
+
+    {
+        unsigned const libver = _XTESTS_VER;
+
+        version(std::cout, "\t", "xTests", "_XTESTS_VER", libver);
+    }
+#endif
+
     return EXIT_SUCCESS;
 }
 
 
 /* ///////////////////////////// end of file //////////////////////////// */
-