trsplit 0.21.6

There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global trsplit --version 0.21.6                
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local trsplit --version 0.21.6                
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=trsplit&version=0.21.6                
nuke :add-package trsplit --version 0.21.6                

trsplit

Summary

Split a combined Antlr4 grammar

Description

The split command splits one grammar into two. The input grammar must be a combined lexer/parser grammar implemented in one file. The transformation creates a lexer grammar and a parser grammar, outputed as parse tree data with the two grammars. trsponge is used to instantiate the two files in the file system.

Usage

trsplit

Details

The trsplit application splits a combined grammar into two files. It does this as follows:

  • Partition the rules in the grammar into parser and lexer rules. This is done by examining the LHS symbol: parser rules start with a lowercase LHS symbol name; lexer rules start with an uppercase LHS symbol name.
  • In the parser grammar, insert an optionsSpec declaration that contains a tokenVocab specification for the name of the vocabulary generated for the lexer grammar.
  • Add grammarDecl statements to the top of the new files to declare the parser and lexer grammars.

After splitting, use trsponge to output the files. The resulting files may require hand-tweaking due to various constraints that split grammars must follow, including:

  • String literals that do not have a corresponding lexer rule must be modified.
  • Parser options do not apply to lexer grammars. Remove or replace.

Example

trparse Arithmetic.g4 | trsplit | trsponge

Current version

0.21.6 Fix trquery.

Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
0.23.11 649 12/18/2024
0.23.10 86 12/12/2024
0.23.9 87 11/29/2024
0.23.8 135 11/1/2024
0.23.7 4,172 10/9/2024
0.23.6 746 9/21/2024
0.23.5 101 9/15/2024
0.23.4 110 9/7/2024
0.23.3 122 8/15/2024
0.23.2 132 6/28/2024
0.23.1 111 6/22/2024
0.23.0 194 4/25/2024
0.22.0 219 2/26/2024
0.21.16 282 11/16/2023
0.21.15 162 11/16/2023
0.21.14 151 11/15/2023
0.21.13 162 11/14/2023
0.21.12 246 10/27/2023
0.21.11 212 10/24/2023
0.21.9 263 9/27/2023
0.21.8 194 9/26/2023
0.21.7 231 9/26/2023
0.21.6 208 9/20/2023
0.21.5 208 9/18/2023
0.21.4 223 9/17/2023
0.21.3 220 9/14/2023
0.21.2 201 9/4/2023
0.21.1 272 8/15/2023
0.21.0 235 6/25/2023
0.20.27 191 6/15/2023
0.20.26 181 6/5/2023
0.20.25 187 6/3/2023
0.20.24 189 6/1/2023
0.20.23 178 5/31/2023
0.20.22 195 5/21/2023
0.20.21 207 5/15/2023
0.20.20 185 5/11/2023
0.20.19 192 5/8/2023
0.20.18 193 5/8/2023
0.20.17 217 5/4/2023
0.20.16 239 5/1/2023
0.20.15 216 4/27/2023
0.20.14 218 4/21/2023
0.20.13 243 4/13/2023
0.20.12 303 3/17/2023
0.20.11 280 3/15/2023
0.20.10 282 3/15/2023
0.20.9 285 3/14/2023
0.20.8 290 3/14/2023
0.20.7 288 3/13/2023
0.20.6 292 3/11/2023
0.20.5 279 3/11/2023
0.20.4 279 3/9/2023
0.20.3 279 3/8/2023
0.20.2 269 3/7/2023
0.20.1 280 3/7/2023
0.20.0 352 2/22/2023
0.19.3 316 2/19/2023
0.19.2 360 2/2/2023
0.19.1 356 1/28/2023
0.19.0 371 1/15/2023
0.19.0-alpha7 267 1/15/2023
0.19.0-alpha6 283 1/14/2023
0.19.0-alpha5 292 1/12/2023
0.19.0-alpha4 276 1/11/2023
0.18.1 513 11/11/2022
0.18.0 478 11/7/2022
0.17.0 544 9/11/2022
0.16.5 603 7/29/2022
0.16.4 586 6/13/2022
0.16.3 591 5/7/2022
0.16.2 595 5/6/2022
0.16.1 563 5/5/2022
0.16.0 648 4/13/2022
0.15.1 601 4/4/2022
0.15.0 574 3/20/2022
0.14.3 580 2/27/2022
0.14.2 564 2/18/2022
0.14.1 602 1/26/2022
0.14.0 578 1/26/2022
0.13.8 580 1/14/2022
0.13.7 584 1/13/2022
0.13.6 581 1/13/2022
0.13.5 612 1/12/2022
0.13.4 572 1/11/2022
0.13.3 572 1/10/2022
0.13.2 393 12/24/2021
0.13.1 414 12/24/2021
0.13.0 397 12/23/2021
0.12.0 417 12/6/2021
0.11.5 501 10/17/2021
0.11.4 493 10/17/2021
0.11.3 427 9/28/2021
0.11.2 465 9/26/2021
0.11.1 480 9/25/2021
0.11.0 512 9/24/2021
0.10.0 499 9/9/2021
0.8.9 459 8/13/2021
0.8.8 427 8/5/2021
0.8.7 436 7/20/2021
0.8.6 449 7/13/2021
0.8.5 422 7/6/2021
0.8.4 434 6/24/2021
0.8.3 518 6/13/2021
0.8.2 427 6/8/2021
0.8.1 410 6/2/2021

# trsplit
## Summary
Split a combined Antlr4 grammar
## Description
The split command splits one grammar into two. The input grammar
must be a combined lexer/parser grammar implemented in one file.
The transformation creates a lexer grammar and a parser grammar,
outputed as parse tree data with the two grammars.
[trsponge](https://github.com/kaby76/Domemtech.Trash/tree/main/trsponge)
is used to instantiate the two files in the file system.
## Usage
trsplit
## Details
The `trsplit` application splits a combined grammar into two files.
It does this as follows:
* Partition the rules in the grammar into parser and lexer rules. This
is done by examining the LHS symbol: parser rules start with a lowercase
LHS symbol name; lexer rules start with an uppercase LHS symbol name.
* In the parser grammar, insert an `optionsSpec` declaration that
contains a `tokenVocab` specification for the name of the vocabulary
generated for the lexer grammar.
* Add `grammarDecl` statements to the top of the new files to declare
the parser and lexer grammars.
After splitting, use `trsponge` to output the files. The resulting files
may require hand-tweaking due to various constraints that split grammars
must follow, including:
* String literals that do not have a corresponding lexer rule must be
modified.
* Parser options do not apply to lexer grammars. Remove or replace.
## Example
trparse Arithmetic.g4 | trsplit | trsponge
## Current version
0.21.6 Fix trquery.