Release 0.36.0

[lsolbach]

Main Features

• generalized and enhanced templates and reduced the number of templates
  • many diagrams (except C4 and UML diagrams) are created via templates
• added a default generation configuration in the templates directory
• made the model api more flexible by using selection criteria instead of set of element types for graph navigation
• enhanced error reporting on model load
• fixed the generation of the list of views per namespace

Examples

For examples of Overarch models and scripts take a look at

• My Bank Model
• Overarch Models

Changelog

• breaking changed referring-nodes, referring-relations, referred-nodes and referred-relations
  • the functions now take selection criteria instead of a set of element types
  • this allows for more flexible model graph navigation
  • the signatures have been updated in the model api
  • the templates have been updated to reflect those changes
• report model file name on exception in import
• report missing or duplicate element ids and parent overrides
• added :collapsed key to mark nodes that should not be expanded in a C4/UML view
  • :collapsed true should be added on a :ref to the node in the content of the view
• added flexibility in view attributes
• added predicates for resolvable elements and relations
• moved traversal step functions from element to model
• moved model building to repository
• prepared merging of models
• added cycle prevention to traverse to make it a general depth first graph traversal function
• added generic transitive search capabilities based on traverse
• fixed model argument in selected-elements
• fixed child check for elements without ids in model building
• fixed a bug in union-by-id that could result in ref attributes not merged for content in views
• added filtering for rendered model elements in view selections before applying include directives
• added a process view definition
• added multiline description formatting for graphviz rendering
• reduced number of templates
  • enhanced model view graphviz template to be usable for concept and process views
  • added a markdown model node template to replace more specific markdown templates
  • added a markdown view template to replace more specific markdown templates
• added glossary view markdown template
• added a default generation config in templates dir
• fixed generation of views per namespace markdown page
• updated docstrings
• updated docs
• updated dependencies
• refactored test models and views
• first steps towards a tools.deps build

---

This discussion was created from the release Release 0.36.0.