Evaluator improvements

[mikee47]

• Fix handling expressions such as "!value". Substitution converts this to " not value" and space at beginning needs stripping
• Support lists and sets
• Pull evaluator README into main documentation tree and reference directly

[what-the-diff]

PR Summary

• Enhanced List and Set Type Handling
  We've improved the functionality of our program by now allowing it to process both list and set literals. The change influences the _eval method, ultimately increasing the efficiency of handling these particular data types.

• Refined Expression Parsing
  We've simplified the way we parse instructions or 'expressions' within our run method. This update includes removing any unnecessary whitespace found at the beginning or end of our process instructions.

• Expanded Test Coverage
  In order to ensure the quality of our system, we have widened our range of test cases. Our updates cover the following areas:

  • Test cases for reversing the logical value of a numerical variable, testing both single (!NUMERIC_VAR) and double (!!NUMERIC_VAR) reversals.
  • Additional checks for elements belonging to a list under different conditions.
  • Tests for set literals - this helps us to ensure that collections of unique items are evaluated correctly.

• Improved Checks for Equivalence in Tests
  To cover scenarios where data types might differ yet represent the same value, we've updated our equality checks in tests to compare string representations of values. The change with success = (str(actual) == str(expected)) checks for matched content instead of matched types, making our tests more reliable in diverse situations.

[mikee47]

@pljakobs Anything else you'd find useful in the evaluator?

[pljakobs]

not at this time, it does anything I need in ConfigDB.
If it will be enabled in .hw files, hex/dec conversion would probably be useful but beyond that, I currently lack the imagination what else could be useful.

[mikee47]

If it will be enabled in .hw files, hex/dec conversion would probably be useful...

I'll take a look at that separately