v0.7.0

[klauer]

What's Changed

This release includes a major rework of TwinCAT solution file loading, the blark CLI tool, and a number of grammar-related fixes.

• INTERFACE definitions are now supported. (ENH: interface support #73) The solution loader can load these .TcIO files directly.
• Add support for the JMP statement (ENH: first pass at JMP and labeled statements #79)
• Grammar fixes for the following:
  • Arrays of arrays in type declarations and initialization (e.g., fValue : ARRAY [1..10] OF ARRAY [1..10] OF INT;) (Support arrays of arrays #66)
  • Code with identifiers starting with Return or Continue will no longer be mistaken for statements of the same name (Resolve RETURN and CONTINUE Overly-Greedy Matching #68)
  • String lengths may now be expressions (e.g., STRING(g_Constant + 1) := 'abc') (FIX: string length expression #72)
  • Expressions in initial array elements are no longer limited to constants (e.g., currentChannel : ARRAY[1..g_c_someConstant] OF POINTER TO struct_groupData := [ ADR(_object[1].someValue) ];) (FIX: Bugfix for expressions in initial array elements #74)
  • Removed support for power expression (**) which is invalid in TwinCAT-flavor ST (FIX/CLN: remove unsupported power_expression #76)
• A new TwinCAT solution loader (.sln, .tsproj, .TcPOU, etc.) was added to blark with a goal of making file loading more easily customizable, with the option to load/save arbitrary file formats. (REF/ENH: standalone solution parser and rewrite of input/output format support #64)
  • The implementation is preliminary and subject to change (as is everything in blark).
  • blark continues to support the current input formats (plain text .st files, and TwinCAT source code files)
  • Removed the dependency on pytmc (for code loading, the dependency store, and everything else).
  • New requirement, lxml, for project parsing.
  • Allow for mapping of blark input line numbers back to source code files. Input files may now correspond to one or more different grammar rules (e.g., a TcPOU FUNCTION_BLOCK that contains declaration, an implementation, and any number of METHOD / ACTION / PROPERTY sub-items).
  • Allow for in-place code rewriting of source code files (blark format --write my_pou.TcPOU)
• Rework of user-facing parsing API to use a consistent dataclass. (REF/ENH: standalone solution parser and rewrite of input/output format support #64)
  • This groups together the source code, a map of line numbers, the raw lark.Tree, and an option to easily transform it into blark.transform dataclasses to allow for code rewriting, reformatting, summarization, and so on.
• Rework of the blark parse CLI. See blark parse --help for more details.
• Rework of the blark format CLI to support the new input/output file handling. See blark format --help for more details.

Pull Requests

• Support arrays of arrays by @engineerjoe440 in Support arrays of arrays #66
• Resolve RETURN and CONTINUE Overly-Greedy Matching by @engineerjoe440 in Resolve RETURN and CONTINUE Overly-Greedy Matching #68
• FIX: string length expression by @klauer in FIX: string length expression #72
• REF/ENH: standalone solution parser and rewrite of input/output format support by @klauer in REF/ENH: standalone solution parser and rewrite of input/output format support #64
• FIX/CLN: remove unsupported power_expression by @klauer in FIX/CLN: remove unsupported power_expression #76
• FIX: Bugfix for expressions in initial array elements by @klauer in FIX: Bugfix for expressions in initial array elements #74
• ENH: interface support by @klauer in ENH: interface support #73
• ENH: first pass at JMP and labeled statements by @klauer in ENH: first pass at JMP and labeled statements #79
• FIX: ignore global text list project files by @klauer in FIX: ignore global text list project files #81

Full Changelog: v0.6.0...v0.7.0

---

This discussion was created from the release v0.7.0.