trsplit 0.21.15

There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global trsplit --version 0.21.15                
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.15                
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=trsplit&version=0.21.15                
nuke :add-package trsplit --version 0.21.15                

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.15 Add trglob for platform-independent "find" for testing. Add Antlr4ng target, a new Antlr4 tool and TypeScript runtime.

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.8 115 11/1/2024
0.23.7 2,523 10/9/2024
0.23.6 740 9/21/2024
0.23.5 93 9/15/2024
0.23.4 102 9/7/2024
0.23.3 116 8/15/2024
0.23.2 126 6/28/2024
0.23.1 105 6/22/2024
0.23.0 189 4/25/2024
0.22.0 214 2/26/2024
0.21.16 278 11/16/2023
0.21.15 158 11/16/2023
0.21.14 145 11/15/2023
0.21.13 158 11/14/2023
0.21.12 242 10/27/2023
0.21.11 208 10/24/2023
0.21.9 259 9/27/2023
0.21.8 190 9/26/2023
0.21.7 227 9/26/2023
0.21.6 204 9/20/2023
0.21.5 204 9/18/2023
0.21.4 219 9/17/2023
0.21.3 214 9/14/2023
0.21.2 197 9/4/2023
0.21.1 268 8/15/2023
0.21.0 231 6/25/2023
0.20.27 187 6/15/2023
0.20.26 177 6/5/2023
0.20.25 183 6/3/2023
0.20.24 185 6/1/2023
0.20.23 174 5/31/2023
0.20.22 191 5/21/2023
0.20.21 203 5/15/2023
0.20.20 181 5/11/2023
0.20.19 188 5/8/2023
0.20.18 189 5/8/2023
0.20.17 209 5/4/2023
0.20.16 235 5/1/2023
0.20.15 212 4/27/2023
0.20.14 214 4/21/2023
0.20.13 239 4/13/2023
0.20.12 299 3/17/2023
0.20.11 276 3/15/2023
0.20.10 278 3/15/2023
0.20.9 281 3/14/2023
0.20.8 284 3/14/2023
0.20.7 284 3/13/2023
0.20.6 288 3/11/2023
0.20.5 275 3/11/2023
0.20.4 275 3/9/2023
0.20.3 275 3/8/2023
0.20.2 265 3/7/2023
0.20.1 276 3/7/2023
0.20.0 348 2/22/2023
0.19.3 312 2/19/2023
0.19.2 356 2/2/2023
0.19.1 352 1/28/2023
0.19.0 367 1/15/2023
0.19.0-alpha7 265 1/15/2023
0.19.0-alpha6 281 1/14/2023
0.19.0-alpha5 290 1/12/2023
0.19.0-alpha4 274 1/11/2023
0.18.1 508 11/11/2022
0.18.0 473 11/7/2022
0.17.0 539 9/11/2022
0.16.5 598 7/29/2022
0.16.4 581 6/13/2022
0.16.3 583 5/7/2022
0.16.2 587 5/6/2022
0.16.1 558 5/5/2022
0.16.0 643 4/13/2022
0.15.1 596 4/4/2022
0.15.0 569 3/20/2022
0.14.3 575 2/27/2022
0.14.2 559 2/18/2022
0.14.1 597 1/26/2022
0.14.0 573 1/26/2022
0.13.8 575 1/14/2022
0.13.7 579 1/13/2022
0.13.6 576 1/13/2022
0.13.5 607 1/12/2022
0.13.4 567 1/11/2022
0.13.3 567 1/10/2022
0.13.2 388 12/24/2021
0.13.1 409 12/24/2021
0.13.0 392 12/23/2021
0.12.0 409 12/6/2021
0.11.5 493 10/17/2021
0.11.4 485 10/17/2021
0.11.3 419 9/28/2021
0.11.2 457 9/26/2021
0.11.1 469 9/25/2021
0.11.0 504 9/24/2021
0.10.0 491 9/9/2021
0.8.9 451 8/13/2021
0.8.8 421 8/5/2021
0.8.7 430 7/20/2021
0.8.6 443 7/13/2021
0.8.5 416 7/6/2021
0.8.4 428 6/24/2021
0.8.3 512 6/13/2021
0.8.2 421 6/8/2021
0.8.1 404 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.15 Add trglob for platform-independent "find" for testing. Add Antlr4ng target, a new Antlr4 tool and TypeScript runtime.