v0.8.0

What's Changed

• Fixed support for function call chaining in general expressions beyond just statements (#93 / #94)
• Fixed support for indirect specifications with initialization parameters (e.g., POINTER TO FB_Something(1, 2)) (#85, #95)
• Some initial API documentation is now available on GitHub Pages
  • All transformer (lark grammar -> AST-like) dataclasses now have docstrings and examples (#89)
  • Dataclass documentation shows the associated Lark grammar rule(s)
• Fixed incorrect escape character for double quotes in double-byte strings ($" #86)
• The prototype Sphinx domain is returns to being functional post-solution-loading refactor (#87)
• Comment pre-parsing will now include positional metadata (#89)
• Preliminary supporting for annotating source code with HTML/XML tags (stylesheets not included) (#88)
  • Example: blark format --output-format html FB_ProjectA.TcPOU
• More test coverage of the grammar and related tools

Grammar

• Added chained_function_call grammar rule (ChainedFunctionCall dataclass)
• Some unused rules and terminals - vestiges of old blark functionality - were removed
  • structured_var_declaration, function_var_decl, step_*
• Added chained_function_call
  • chained_function_call_statement now uses chained_function_call

Pull Requests

• Unused grammar rule clean-up and grammar coverage tests by @klauer in #86
• FIX: make sphinx domain work again by @klauer in #87
• ENH/DOC: docstrings + start of API docs by @klauer in #89
• ENH: first pass at html output by @klauer in #88
• CI: documentation deployment GitHub Action by @klauer in #92
• FIX: function call chaining in expressions by @klauer in #94
• FIX: init arguments for pointer type specifications by @klauer in #95

Full Changelog: v0.7.1...v0.8.0