[enhancement] Improve programming error messages

[vkarak]

This PR improves substantially the programming error messages in ReFrame in an attempt to help users when writing tests. More specifically, the reframe syntax errors are treated, which are those directly related to the special test syntax and were the most difficult to decipher.

The key challenge of such messages is that they are thrown raised class construction and not at the exact point where they are sourced. Although we could get precise line information for every variable, parameter and fixture definition and even every assignment in a test class, this would make loading of the tests prohibitively slow, as it requires stack inspection. Thus, for variables, parameters and fixtures we only store the name of the owner class, so that we can provide precise guidance to the user when error occurs. We also provide source code information for every reframe syntax error, but this is limited to the line where the class is defined.

Also all the syntax error messages where rephrased carefully taking the test developer's perspective. Some of them also contain suggestions on how to properly fix the code.

Closes #2308.

Todos

• Remove precise code annotation for Python < 3.11
• Check if we need to update the docs (listings etc.)

[teojgo]

I have commented mostly about string formatting

[victorusu]

lgtm