macros 2.0

[vlada-shubina]

Problem

Macros are pain point for a while when it comes to refactoring and code understanding.
I struggled a lot to write documentation for them as interfaces were very vague.

Docs effort:
fixes #5028
fixes #4616

Solution

This is 7.0.2xx(?)/8.0.1xx effort.

• created better interfaces for macro component based on generics
• created base types for macro and macro config implementation that do common actions
• cleaned up the logic of macro processing
  • if macro relies on other variable, and this variable doesn't exist - the processing stops
  • changed logic in GeneratePort macro - previously macro was not releasing socket until the macro is run. Now tracking the list of assigned ports instead.
• added logging
• fixed coalesce macro: should fallback value be used when source value is empty string #5028

TODO:

• add doc on how to add a new macro
• localization
• better unit tests
• agree on coalesce behavior
• investigate the bug when TemplateCreator can return null
• investigate how often float and hex types are used
• add better warnings on low\high validation in port macro

Checks:

• Added unit tests
• Added #nullable enable to all the modified files ?

[vlada-shubina]

@JanKrivanek I would like to kick of the review of this PR, though I'm still working on improving the test coverage.

The areas of review:

• new macro component interfaces - it would be good to have it pre-ready in case we start to support custom components.
• updated macro logic and improved parsing of the configuration with error handling.
• documentation

[JanKrivanek]

Overall looks good. I like the extraction of the common settings/validation code!

I havent look into actual macros in depth (as I didn't expect much changes, other than extracting config and getting rid of repetitive validation ocde) - I will need to do a second pass on those.

[JanKrivanek]

I like the changes!

I have only 1 minor naming suggestion, other than that it looks ready to go

[JanKrivanek]

Coalesce functionality looks good. I have just some notes to doc

[vlada-shubina]

Open tasks:

• agree on coalesce behavior
• investigate bug when TemplateCreator can return null
• investigate how often float and hex types are used

[JanKrivanek]

I agree with reverting the changes in the coallesce macro.
Overall looks good!