tree-sitter-t32

Lauterbach TRACE32® script language grammar for tree-sitter. Support for HLL expressions was adapted from tree-sitter-c.

A demo is available here.

Features

Full coverage of the PRACTICE script language including TRACE32® commands & functions
Extended support for HLL expressions

Quick Start

Dependencies

Tree-sitter CLI for generating the parser from the grammar.
A C compiler
Make [optional]
Yarn [optional]

Commands

Generate parser

Create and build the tree-sitter parser for the TRACE32® grammar.

tree-sitter generate

Parse TRACE32® Script

Use tree-sitter to parse a TRACE32® script.

Example:

; --------------------------------------------------------------------------------
; @Title: Beautify an existing PRACTICE script
; @Description:
;   Beautifies the script, fixing the CamelCasing and indentation.
; @Keywords: PRACTICE, EDIT.FORMAT, CamelCasing, indent, beautify
; @Author: MOB
; @Copyright: (C) 1989-2020 Lauterbach GmbH, licensed for use with TRACE32(R) only
; --------------------------------------------------------------------------------
; $Id: beautify.cmm 19661 2022-07-29 15:43:03Z rweiss $

PARAMETERS &script

IF "&script"==""
(
  DIALOG.File.open *.cmm
  ENTRY %LINE &script
)

IF FILE.EXIST("&script")
(
  ECHO %COLOR.GRAY "beautifying: &script"
  SETUP.EDITOR.TYPE PowerView ; required for EDIT.FORMAT
  PEDIT "&script"
  EDIT.FORMAT /Beautify
  EDIT.SAVE "&script"
  EDIT.CLOSE "&script"
  ECHO %COLOR.GREEN "beautified: &script"
)
ELSE
(
  ECHO %ERROR "Error: no such file: &script"
)

ENDDO

tree-sitter parse <path>

Prints the syntax tree

(script [0, 0] - [34, 0]
  (comment [0, 0] - [1, 0])
  (comment [1, 0] - [2, 0])
  (comment [2, 0] - [3, 0])
  (comment [3, 0] - [4, 0])
  (comment [4, 0] - [5, 0])
  (comment [5, 0] - [6, 0])
  (comment [6, 0] - [7, 0])
  (comment [7, 0] - [8, 0])
  (comment [8, 0] - [9, 0])
  (parameter_declaration [10, 0] - [11, 0]
    command: (identifier [10, 0] - [10, 10])
    macro: (macro [10, 11] - [10, 18]))
  (if_block [12, 0] - [18, 0]
    command: (identifier [12, 0] - [12, 2])
    condition: (binary_expression [12, 3] - [12, 16]
      left: (string [12, 3] - [12, 12]
        (macro [12, 4] - [12, 11]))
      right: (string [12, 14] - [12, 16]))
    (block [13, 0] - [17, 0]
      (command_expression [14, 2] - [15, 0]
        command: (identifier [14, 2] - [14, 18])
        arguments: (argument_list [14, 18] - [14, 24]
          (path [14, 19] - [14, 24])))
      (parameter_declaration [15, 2] - [16, 0]
        command: (identifier [15, 2] - [15, 7])
        (identifier [15, 8] - [15, 13])
        macro: (macro [15, 14] - [15, 21]))))
  (if_block [18, 0] - [32, 0]
    command: (identifier [18, 0] - [18, 2])
    condition: (call_expression [18, 3] - [18, 24]
      function: (identifier [18, 3] - [18, 13])
      arguments: (argument_list [18, 13] - [18, 24]
        (string [18, 14] - [18, 23]
          (macro [18, 15] - [18, 22]))))
    (block [19, 0] - [28, 0]
      (command_expression [20, 2] - [21, 0]
        command: (identifier [20, 2] - [20, 6])
        arguments: (argument_list [20, 6] - [20, 41]
          (format_expression [20, 7] - [20, 18]
            value: (identifier [20, 8] - [20, 13])
            value: (identifier [20, 14] - [20, 18]))
          (string [20, 19] - [20, 41]
            (macro [20, 33] - [20, 40]))))
      (command_expression [21, 2] - [22, 0]
        command: (identifier [21, 2] - [21, 19])
        arguments: (argument_list [21, 19] - [21, 29]
          (identifier [21, 20] - [21, 29]))
        (comment [21, 29] - [22, 0]))
      (command_expression [22, 2] - [23, 0]
        command: (identifier [22, 2] - [22, 7])
        arguments: (argument_list [22, 7] - [22, 17]
          (string [22, 8] - [22, 17]
            (macro [22, 9] - [22, 16]))))
      (command_expression [23, 2] - [24, 0]
        command: (identifier [23, 2] - [23, 13])
        arguments: (argument_list [23, 13] - [23, 23]
          (option_expression [23, 14] - [23, 23]
            option: (identifier [23, 15] - [23, 23]))))
      (command_expression [24, 2] - [25, 0]
        command: (identifier [24, 2] - [24, 11])
        arguments: (argument_list [24, 11] - [24, 21]
          (string [24, 12] - [24, 21]
            (macro [24, 13] - [24, 20]))))
      (command_expression [25, 2] - [26, 0]
        command: (identifier [25, 2] - [25, 12])
        arguments: (argument_list [25, 12] - [25, 22]
          (string [25, 13] - [25, 22]
            (macro [25, 14] - [25, 21]))))
      (command_expression [26, 2] - [27, 0]
        command: (identifier [26, 2] - [26, 6])
        arguments: (argument_list [26, 6] - [26, 41]
          (format_expression [26, 7] - [26, 19]
            value: (identifier [26, 8] - [26, 13])
            value: (identifier [26, 14] - [26, 19]))
          (string [26, 20] - [26, 41]
            (macro [26, 33] - [26, 40])))))
    (else_block [28, 0] - [32, 0]
      command: (identifier [28, 0] - [28, 4])
      (block [29, 0] - [32, 0]
        (command_expression [30, 2] - [31, 0]
          command: (identifier [30, 2] - [30, 6])
          arguments: (argument_list [30, 6] - [30, 44]
            (format_expression [30, 7] - [30, 13]
              value: (identifier [30, 8] - [30, 13]))
            (string [30, 14] - [30, 44]
              (macro [30, 36] - [30, 43])))))))
  (command_expression [33, 0] - [34, 0]
    command: (identifier [33, 0] - [33, 5])))

Highlight TRACE32® Script

Use tree-sitter to highlight a TRACE32® script.

tree-sitter highlight <path>

Prints the highlighted file

Create Code Navigation Tags

Use tree-sitter to create a tags file from a TRACE32® script.

; --------------------------------------------------------------------------------
; @Title: Example test case for Unittests
; @Description:
;   This is an example for a test case which can be executed with lbunit.cmm.
; @Keywords: lbtest test case
; @Author: MOB
; @Copyright: (C) 1989-2015 Lauterbach GmbH, licensed for use with TRACE32(R) only
; --------------------------------------------------------------------------------
; $Id: test_example.cmm 8648 2015-09-03 17:04:05Z mobermeir $

; the following block must be present in the beginning of every test case
PRIVATE &func &args &result
ENTRY &func %LINE &args
GOSUB &func &args // call subroutine and return result
ENTRY %LINE &result
ENDDO &result
; end of mandatory block

; SetupTestCase will be called once at the beginning of the test case
; It can be removed if it is not needed.
SetupTestCase:
(
  PRIVATE &date
  &date=DATE.DATE()+" "+DATE.TIME()
  PUTS "test case started at: &date"
  RETURN
)

; SetupTest will be called just before every test
; It can be removed if it is not needed.
SetupTest:
(
  ; here can be some setup
  Data.Set VM:0x0--0xFF 0xA
  RETURN
)

; All tests must start with "Test_"
Test_MyFirstTest:
(
  ; Assertions can be used:
  A_FALSE FALSE()
  A_TRUE (1.+1.==2.)
  RETURN
)

Test_MySecondTest:
(
  A_NUM_EQ 0xA Data.Byte(VM:0x0)
  A_X_PASS Data.Set VM:0x0 0xB
  A_NUM_EQ 0xB Data.Byte(VM:0x0)
  RETURN
)

Test_MyThirdTest:
(
  ; Tests can return "PASS", "FAIL" or "NOT_EXEC"
  ; (alternatively or in addition to assertions)
  IF (0xA!=Data.Byte(VM:0x0))
  (
    RETURN "FAIL"
  )
  ELSE IF (0xB==Data.Byte(VM:0x0))
  (
    RETURN "NOT_EXEC"
  )
  ELSE
  (
    RETURN "PASS"
  )
  RETURN // same as "PASS"
)

MyHelper:
(
  A_NUM_EQ 0xA Data.Byte(VM:0x10)
  RETURN
)

Test_MyFourthTest:
(
  ; tests can call helper functions
  RePeaT 2.
  (
    GOSUB MyHelper
  )
  RETURN
)

DisabledTest_MyFifthTest:
(
  ; this routine will not be executed since it doesn't start with "Test_"
  RETURN
)

; TearDownTest will be called just after every test
; It can be removed if it is not needed.
TearDownTest:
(
  ; here could be some cleanup
  Break.RESet
  RETURN
)

; TearDownTestCase will be called once at the end of the test case
; It can be removed if it is not needed.
TearDownTestCase:
(
  PRIVATE &date
  &date=DATE.DATE()+" "+DATE.TIME()
  PUTS "test case ended at: &date"
  RETURN
)

tree-sitter tags <path>

Prints a list of tags

func      	 | call    	ref (13, 7) - (13, 11) `GOSUB &func &args // call subroutine and return result`
SetupTestCase	 | function	def (20, 0) - (20, 13) `SetupTestCase:`
SetupTest 	 | function	def (30, 0) - (30, 9) `SetupTest:`
Test_MyFirstTest	 | function	def (38, 0) - (38, 16) `Test_MyFirstTest:`
Test_MySecondTest	 | function	def (46, 0) - (46, 17) `Test_MySecondTest:`
Test_MyThirdTest	 | function	def (54, 0) - (54, 16) `Test_MyThirdTest:`
MyHelper  	 | function	def (73, 0) - (73, 8) `MyHelper:`
Test_MyFourthTest	 | function	def (79, 0) - (79, 17) `Test_MyFourthTest:`
MyHelper  	 | call    	ref (84, 10) - (84, 18) `GOSUB MyHelper`
DisabledTest_MyFifthTest	 | function	def (89, 0) - (89, 24) `DisabledTest_MyFifthTest:`
TearDownTest	 | function	def (97, 0) - (97, 12) `TearDownTest:`
TearDownTestCase	 | function	def (106, 0) - (106, 16) `TearDownTestCase:`

Development

There is a makefile to simplify the most common activities. The makefile expects you to have Yarn installed and set up.

To build the parser from the grammar:

make build

To run all tests:

make test-all

Editor Support

Editor	Plugin	Syntax Highlighting	Local Variables	Folds	Indents
Neovim	nvim-treesitter	✓	✓	✓	✓
Helix		✓

nvim-treesitter

Run

:TSInstall t32

to automatically install the supported grammar.

Limitations

(symbol) nodes that represent an unquoted module, like \module, cannot be differentiated from user-defined TRACE32 internal HLL variables, e.g. \x.
(symbol) nodes that depend on the hex radix mode cannot always be kept apart from (address) nodes, e.g. P:A::B:0x800. To avoid conflicts always add the radix mode to the number.
Commands from the Var command group that contain multiple chained (format_expression) (_hll_expression) blocks
Unquoted (path) nodes are not clearly distinguishable from other literal types in command argument lists.
For HLL expressions used at the top level of commands, the use of spaces is more restricted than for nested expressions inside parentheses. The grammar only models the strict behavior.
(recursive_macro_expansion) nodes are restricted to the left-hand side of assignment expressions. In other contexts, recursive PRACTICE macro expansions cannot be distinguished from && operators.

Packages

Language	Package	Download
Node.js	npm
Python	PyPI	📦
Rust	crates.io

Mirrors

This repository is mirrored to https://gitlab.com/xasc/tree-sitter-t32 and https://github.com/xasc/tree-sitter-t32. The main repository is https://codeberg.org/xasc/tree-sitter-t32.

Contributing

For the time being, we are not accepting pull requests. However, please feel free to open issues for changes you would like to see.

License

Distributed under the MIT license. REUSE is used for managing licensing information throughout the project. For more accurate licensing information, please check the individual files.

References

Release files for tree-sitter-t32 9.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tree-sitter-t32 9.0.2
File	Size	Uploaded
tree_sitter_t32-9.0.2.tar.gz	263.2 kB	Sep 6, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for tree-sitter-t32 9.0.2
File	Interpreter	ABI	Platform	Reset
tree_sitter_t32-9.0.2-cp310-abi3-win_arm64.whl 124.3 kB Sep 6, 2026	CPython 3.10	abi3	Windows ARM64	Details
tree_sitter_t32-9.0.2-cp310-abi3-win_amd64.whl 125.1 kB Sep 6, 2026	CPython 3.10	abi3	Windows x86-64	Details
tree_sitter_t32-9.0.2-cp310-abi3-musllinux_1_2_x86_64.whl 147.7 kB Sep 6, 2026	CPython 3.10	abi3	Linux musl 1.2+ x86-64	Details
tree_sitter_t32-9.0.2-cp310-abi3-musllinux_1_2_aarch64.whl 148.4 kB Sep 6, 2026	CPython 3.10	abi3	Linux musl 1.2+ ARM64	Details
tree_sitter_t32-9.0.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl 148.3 kB Sep 6, 2026	CPython 3.10	abi3	Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64	Details
tree_sitter_t32-9.0.2-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl 149.7 kB Sep 6, 2026	CPython 3.10	abi3	Linux glibc 2.17+ ARM64, Linux glibc 2.28+ ARM64	Details
tree_sitter_t32-9.0.2-cp310-abi3-macosx_11_0_arm64.whl 129.6 kB Sep 6, 2026	CPython 3.10	abi3	macOS 11.0+ ARM64	Details
tree_sitter_t32-9.0.2-cp310-abi3-macosx_10_9_x86_64.whl 122.9 kB Sep 6, 2026	CPython 3.10	abi3	macOS 10.9+ x86-64	Details

Total release size: 1.4 MB

Release files / tree_sitter_t32-9.0.2.tar.gz

Download URL	tree_sitter_t32-9.0.2.tar.gz
Size	263.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`4ff6b41e63081af799e1ea551cc6c128cdf3db0a6cf7ccd26fbd89f9e7d9835d`
BLAKE2b-256 checksum How to use checksums	`543eb1b282f889cad8ce5dbbfea16fc539a23d1fbc77d5d73623b5b72bdbbdb3`
Upload date	Sep 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / tree_sitter_t32-9.0.2-cp310-abi3-win_arm64.whl

Download URL	tree_sitter_t32-9.0.2-cp310-abi3-win_arm64.whl
Size	124.3 kB
Tags	CPython 3.10 Windows ARM64 abi3
SHA-256 checksum How to use checksums	`bfc5752732adb88ef965e18cf71d352a1e5f5839cb11174852fb499f083d33df`
BLAKE2b-256 checksum How to use checksums	`8ff0727c9cd936ea06bdebb7465d630bf47b55ac70eb510e72f615d34aedcd23`
Upload date	Sep 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / tree_sitter_t32-9.0.2-cp310-abi3-win_amd64.whl

Download URL	tree_sitter_t32-9.0.2-cp310-abi3-win_amd64.whl
Size	125.1 kB
Tags	CPython 3.10 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`936dd697840d05d425b4f652ef8bdec3ab3b624e88e2d72d7b53f38893116a9c`
BLAKE2b-256 checksum How to use checksums	`cebf43062abd1c75ed130fbbdac1d60546c3b2a3be90f99d6643bc0cf651b96e`
Upload date	Sep 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / tree_sitter_t32-9.0.2-cp310-abi3-musllinux_1_2_x86_64.whl

Download URL	tree_sitter_t32-9.0.2-cp310-abi3-musllinux_1_2_x86_64.whl
Size	147.7 kB
Tags	CPython 3.10 Linux musl 1.2+ x86-64 abi3
SHA-256 checksum How to use checksums	`57110f3abd5b10721a2da510476d61cd6e4d916ce33e5307ccf135533f195ca7`
BLAKE2b-256 checksum How to use checksums	`0c533482622640146bc49d90d8b469d4075f186ed8ae67683dd0394cbd01ac14`
Upload date	Sep 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / tree_sitter_t32-9.0.2-cp310-abi3-musllinux_1_2_aarch64.whl

Download URL	tree_sitter_t32-9.0.2-cp310-abi3-musllinux_1_2_aarch64.whl
Size	148.4 kB
Tags	CPython 3.10 Linux musl 1.2+ ARM64 abi3
SHA-256 checksum How to use checksums	`184268081eb4b2381371adcead6964392694081461725aad377d80aed5093b07`
BLAKE2b-256 checksum How to use checksums	`39791af38a6337aec5ecad8ca35569b3339c2046afaebbd00874457025de1fa8`
Upload date	Sep 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / tree_sitter_t32-9.0.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL	tree_sitter_t32-9.0.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size	148.3 kB
Tags	CPython 3.10 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum How to use checksums	`df785ee788f77e941b592f53ba95f79a461174c7816865eb0328c6450af6a0db`
BLAKE2b-256 checksum How to use checksums	`16a4f21e30c8e03212b1e47ffefe7ede22169a36d5d77c87ba68b38ba5b6fce7`
Upload date	Sep 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / tree_sitter_t32-9.0.2-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl

Download URL	tree_sitter_t32-9.0.2-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
Size	149.7 kB
Tags	CPython 3.10 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum How to use checksums	`f4cffa1305a51dd250e4913623a62f9b83798c0ec6e6828676af7b6c994cbf60`
BLAKE2b-256 checksum How to use checksums	`83c137b80ea7ed4336a453e706adab82f547891d00b4aeb34ec4358c47956359`
Upload date	Sep 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / tree_sitter_t32-9.0.2-cp310-abi3-macosx_11_0_arm64.whl

Download URL	tree_sitter_t32-9.0.2-cp310-abi3-macosx_11_0_arm64.whl
Size	129.6 kB
Tags	CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`2c3beab6a0cf67d6d86fa7c6ff1647ddcb6da340de1213be1337e03369e07c8e`
BLAKE2b-256 checksum How to use checksums	`1458e7288041b8aaa61dd4341d428c08bc8a9467227f1c11165c2d1edad8966e`
Upload date	Sep 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / tree_sitter_t32-9.0.2-cp310-abi3-macosx_10_9_x86_64.whl

Download URL	tree_sitter_t32-9.0.2-cp310-abi3-macosx_10_9_x86_64.whl
Size	122.9 kB
Tags	CPython 3.10 abi3 macOS 10.9+ x86-64
SHA-256 checksum How to use checksums	`418fd2011283f28c0fd65b900ae2206fac3ba624a0c527adeb9be62e3114ea6b`
BLAKE2b-256 checksum How to use checksums	`09c8af8a8aecce2f26e7bdc0803bd4244925daac8679f8f04008f3b34885d21d`
Upload date	Sep 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`