antlr-rust-runtime 0.4.0

High performance Rust runtime and target support for ANTLR v4 generated parsers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

name: Parse Benchmark

on:
  pull_request:
  workflow_dispatch:

permissions:
  contents: read

jobs:
  parse-bench:
    runs-on: ubuntu-latest
    timeout-minutes: 45

    steps:
      - name: Checkout head
        # actions/checkout v6
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
        with:
          path: head
          persist-credentials: false

      - name: Checkout base
        if: github.event_name == 'pull_request'
        # actions/checkout v6
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
        with:
          ref: ${{ github.event.pull_request.base.sha }}
          path: base
          persist-credentials: false

      - name: Set up Java
        # actions/setup-java v5
        uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654
        with:
          distribution: temurin
          java-version: '21'

      - name: Set up Go
        # actions/setup-go v5
        uses: actions/setup-go@40f1582b2485089dde7abd97c1529aa768e1baff
        with:
          go-version: '1.23.x'

      - name: Set up Python
        # actions/setup-python v6
        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405
        with:
          python-version: '3.11'

      - name: Set up Rust
        run: |
          rustup toolchain install 1.95.0 --profile minimal
          rustup default 1.95.0

      - name: Install Python benchmark dependencies
        run: python -m pip install -r head/tools/parse-bench/requirements.txt

      - name: Fetch ANTLR benchmark inputs
        run: |
          mkdir -p /tmp/antlr-cleanroom/tools
          curl -fLo /tmp/antlr-cleanroom/tools/antlr-4.13.2-complete.jar \
            https://www.antlr.org/download/antlr-4.13.2-complete.jar
          mkdir -p /tmp/antlr-cleanroom/grammars-v4
          git -C /tmp/antlr-cleanroom/grammars-v4 init -q
          git -C /tmp/antlr-cleanroom/grammars-v4 remote add origin https://github.com/antlr/grammars-v4.git
          git -C /tmp/antlr-cleanroom/grammars-v4 sparse-checkout init --cone
          git -C /tmp/antlr-cleanroom/grammars-v4 sparse-checkout set kotlin/kotlin csharp/v7 java/java sql/trino
          git -C /tmp/antlr-cleanroom/grammars-v4 fetch --depth 1 origin 284602b3f23ca54dc30778204ab7ae9e969145e9
          git -C /tmp/antlr-cleanroom/grammars-v4 checkout FETCH_HEAD

      - name: Run base benchmark
        if: github.event_name == 'pull_request'
        run: |
          if [ -f base/tools/parse-bench/run.py ]; then
            python base/tools/parse-bench/run.py \
              --quick \
              --work-dir base/target/parse-bench \
              --json "$PWD/base-parse-bench.json"
          else
            echo "base branch does not have parse benchmark script; skipping base comparison"
          fi

      - name: Run head benchmark
        run: |
          python head/tools/parse-bench/run.py \
            --quick \
            --work-dir head/target/parse-bench \
            --json "$PWD/head-parse-bench.json"

      - name: Compare against base
        if: github.event_name == 'pull_request'
        run: |
          if [ -f base-parse-bench.json ]; then
            compare_args=(
              --baseline base-parse-bench.json \
              --current head-parse-bench.json \
              --max-regression 1.15 \
              --require-speedup kotlin:rust-antlr:go-antlr:3.0
            )
            if ! cmp -s \
              base/tools/parse-bench/fixtures/manifest.json \
              head/tools/parse-bench/fixtures/manifest.json; then
              compare_args+=(--allow-empty)
            fi
            python head/tools/parse-bench/compare.py "${compare_args[@]}"
          else
            echo "no base benchmark report; comparison will start once this workflow is on the base branch"
          fi

      - name: Upload benchmark reports
        if: always()
        # actions/upload-artifact v4
        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
        with:
          name: parse-bench-results
          path: '*-parse-bench.json'