Transition from object map to object tree and UI improvements

[skuntz]

Object Tree is an extension of the object map for use with the debug console. It provides an easily traversable structure to allow for storage and inspection of arbitrary types and improved usability, particularly for containers.

The object tree is organized as a tree, implemented as a vector of vectors with an enforced hierarchy and strong typing. It is dynamically built -- as the user traverses the simulation structure, new objects are added (same principle as ObjectMapDeferred). It uses a combination of CRTP, Visitor, Variant, and Polymorphism. It adds support for generic fundamentals and the numeric handler enables direct comparison against constants and other tree nodes.

Console command improvements with object tree include:

• cd: Components and objects named the same are explicitly disambiguated

• ls: Support for ls -l and -ll to control the level of detail

• set: Indices are now supported e.g. set container[i][j][k]

• watchpoints: Leverage the type information in the object tree to perform native comparison between generic types and constants; Watchpoints on a container size now possible with a small extension

• print: Indices, explicit verbosity, and formatting now supported and names are slightly demangled. print -v N -f [hex | dec | oct] container[i][j][k]

General UI improvements:

• Ensures variable names are uniquely qualified by the object hierarchy
• Supports cd into any type, including containers, and clearer printing of types
• Provides confirmation prompt when overwriting user-defined commands
• Adds show command to display user-defined commands
• ctrl-d shuts down simulation fixing a runaway prompt on some systems
• Updates trigger output to avoid splitting text in parallel execution
• Adds paging to print, info all, watchlist, and printtrace commands (previously only enabled for ls)
• Resolves an issue where print -r N does not print top level components
• Provides warnings for read-only variables

[github-actions]

CLANG-FORMAT TEST - PASSED

[github-actions]

CLANG-FORMAT TEST - PASSED

[sst-autotester]

Status Flag 'Pre-Test Inspection' - - This Pull Request Requires Inspection... The code must be inspected by a member of the Team before Testing/Merging
NO INSPECTION HAS BEEN PERFORMED ON THIS PULL REQUEST! - This PR must be inspected by setting label 'AT: PRE-TEST INSPECTED'.

[donofrio]

This code can be removed, print formatting for debugConsole is now handled locally to that class. I neglected to remove this code.

[donofrio]

(this goes for all changes in this file)

[github-actions]

CLANG-FORMAT TEST - PASSED

[kpgriesser]

Testing update:

• All sst-test-core and sst-ext-tests are passing on all TCL platforms.
• Completed valgrind and address sanitizer testing with no issues

To run sst-ext-tests with these changes use:

git checkout `obj_tree_merge`
cd build
cmake .. -DENABLE_ALL_TESTS=ON -DENABLE_NEW_TESTS=ON 
ctest

Once this PR is merged into devel, we will update sst-ext-tests/devel to match.

At this point, there is no additional work planned for this branch other than writing new tests as time allows.

[kpgriesser]

In addition to the 'planned improvements' listed in the sst-docs web page,

https://sst-simulator.org/sst-docs/docs/guides/features/debug#planned-improvements

TCL has issues and enhancements tracked in GitHub here:

https://github.com/tactcomplabs/sst-core/issues

[github-actions]

CLANG-FORMAT TEST - PASSED

[sst-autotester]

Status Flag 'Pre-Test Inspection' - - This Pull Request Requires Inspection... The code must be inspected by a member of the Team before Testing/Merging
NO INSPECTION HAS BEEN PERFORMED ON THIS PULL REQUEST! - This PR must be inspected by setting label 'AT: PRE-TEST INSPECTED'.