v0.8.0

[klauer]

What's Changed

• Fixed support for function call chaining in general expressions beyond just statements (Syntax Parsing Failure - Accessing an Attribute on a Dereferenced Pointer Returned from a Method Doesn't Work #93 / FIX: function call chaining in expressions #94)
• Fixed support for indirect specifications with initialization parameters (e.g., POINTER TO FB_Something(1, 2)) (Failure to Parse POINTER TO Object using FB_Init #85, FIX: init arguments for pointer type specifications #95)
• Some initial API documentation is now available on GitHub Pages
  • All transformer (lark grammar -> AST-like) dataclasses now have docstrings and examples (ENH/DOC: docstrings + start of API docs #89)
  • Dataclass documentation shows the associated Lark grammar rule(s)
• Fixed incorrect escape character for double quotes in double-byte strings ($" Unused grammar rule clean-up and grammar coverage tests #86)
• The prototype Sphinx domain is returns to being functional post-solution-loading refactor (FIX: make sphinx domain work again #87)
• Comment pre-parsing will now include positional metadata (ENH/DOC: docstrings + start of API docs #89)
• Preliminary supporting for annotating source code with HTML/XML tags (stylesheets not included) (ENH: first pass at html output #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 Unused grammar rule clean-up and grammar coverage tests #86
• FIX: make sphinx domain work again by @klauer in FIX: make sphinx domain work again #87
• ENH/DOC: docstrings + start of API docs by @klauer in ENH/DOC: docstrings + start of API docs #89
• ENH: first pass at html output by @klauer in ENH: first pass at html output #88
• CI: documentation deployment GitHub Action by @klauer in CI: documentation deployment GitHub Action #92
• FIX: function call chaining in expressions by @klauer in FIX: function call chaining in expressions #94
• FIX: init arguments for pointer type specifications by @klauer in FIX: init arguments for pointer type specifications #95

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

---

This discussion was created from the release v0.8.0.

[klauer]

Note: minor bugfix release v0.8.1 to address a packaging issue.

Planning to pull v0.8.0 from PyPI - just install v0.8.1 if the above is of interest to you.