.gitattributes

@@ -0,0 +1 @@
+*\[generated\].go linguist-language=txt

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: antonmedv

.github/images/demo.tape

@@ -0,0 +1,83 @@
+Set Shell zsh
+Sleep 500ms
+Type "repl"
+Enter
+Sleep 500ms
+Type "1..9 | filter("
+Sleep 500ms
+Type "# "
+Sleep 500ms
+Type "% 2 == 0) | map("
+Sleep 500ms
+Type "# ^ 2"
+Sleep 500ms
+Type ")"
+Enter
+Sleep 1s
+Type "de"
+Sleep 500ms
+Type "bug"
+Enter
+Sleep 1.5s
+Enter 50
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Enter
+Sleep 1.5s
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Escape
+Type "OB"
+Enter
+Sleep 2s
+Escape
+Type "OB"
+Escape
+Type "OB"
+Ctrl+C
+Sleep 1s
+Ctrl+D
+Ctrl+D
+

.github/scripts/coverage.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env zx
+
+const expected = 90
+const exclude = [
+  'expr/test', // We do not need to test the test package.
+  'checker/mock', // Mocks only used for testing.
+  'vm/func_types', // Generated files.
+  'vm/runtime/helpers', // Generated files.
+  'internal/difflib', // Test dependency. This is vendored dependency, and ideally we also have good tests for it.
+  'internal/spew', // Test dependency.
+  'internal/testify', // Test dependency.
+  'patcher/value', // Contains a lot of repeating code. Ideally we should have a test for it.
+  'pro', // Expr Pro is not a part of the main codebase.
+]
+
+cd(path.resolve(__dirname, '..', '..'))
+
+await spinner('Running tests', async () => {
+  await $`go test -coverprofile=coverage.out -coverpkg=github.com/expr-lang/expr/... ./...`
+  const coverage = fs.readFileSync('coverage.out').toString()
+    .split('\n')
+    .filter(line => {
+      for (const ex of exclude)
+        if (line.includes(ex)) return false
+      return true
+    })
+    .join('\n')
+  fs.writeFileSync('coverage.out', coverage)
+  await $`go tool cover -html=coverage.out -o coverage.html`
+})
+
+const cover = await $({verbose: true})`go tool cover -func=coverage.out`
+const total = +cover.stdout.match(/total:\s+\(statements\)\s+(\d+\.\d+)%/)[1]
+if (total < expected) {
+  echo(chalk.red(`Coverage is too low: ${total}% < ${expected}% (expected)`))
+  process.exit(1)
+} else {
+  echo(`Coverage is good: ${chalk.green(total + '%')} >= ${expected}% (expected)`)
+}

.github/workflows/build.yml

@@ -0,0 +1,23 @@
+name: build
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        go-versions: [ '1.18', '1.22', '1.24' ]
+        go-arch: [ '386' ]
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup Go ${{ matrix.go-version }}
+        uses: actions/setup-go@v4
+        with:
+          go-version: ${{ matrix.go-version }}
+      - name: Build
+        run: GOARCH=${{ matrix.go-arch }} go build

.github/workflows/check.yml

@@ -0,0 +1,19 @@
+name: check
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup Go 1.18
+        uses: actions/setup-go@v4
+        with:
+          go-version: 1.18
+      - name: Test
+        run: npx zx .github/scripts/coverage.mjs

.github/workflows/diff.yml

@@ -0,0 +1,32 @@
+name: diff
+
+on:
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  bench:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Setup Go 1.18
+        uses: actions/setup-go@v4
+        with:
+          go-version: 1.18
+      - name: Install benchstat
+        # NOTE: benchstat@latest requires go 1.23 since 2025-02-14 - this is the last go 1.18 ref
+        # https://cs.opensource.google/go/x/perf/+/c95ad7d5b636f67d322a7e4832e83103d0fdd292
+        run: go install golang.org/x/perf/cmd/benchstat@884df5810d2850d775c2cb4885a7ea339128a17d
+
+      - uses: actions/checkout@v3
+      - name: Benchmark new code
+        run: go test -bench=. -benchmem -run=^$ -count=10 -timeout=30m | tee /tmp/new.txt
+
+      - name: Checkout master
+        uses: actions/checkout@v3
+        with:
+          ref: master
+      - name: Benchmark master
+        run: go test -bench=. -benchmem -run=^$ -count=10 -timeout=30m | tee /tmp/old.txt
+
+      - name: Diff
+        run: benchstat /tmp/old.txt /tmp/new.txt

.github/workflows/fuzz.yml

@@ -0,0 +1,35 @@
+name: fuzz
+on: [pull_request]
+permissions: {}
+jobs:
+  fuzzing:
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+    steps:
+      - name: Build Fuzzers
+        id: build
+        uses: google/oss-fuzz/infra/cifuzz/actions/build_fuzzers@master
+        with:
+          oss-fuzz-project-name: 'expr'
+          language: 'go'
+      - name: Run Fuzzers
+        uses: google/oss-fuzz/infra/cifuzz/actions/run_fuzzers@master
+        with:
+          oss-fuzz-project-name: 'expr'
+          language: 'go'
+          fuzz-seconds: 600
+          output-sarif: true
+      - name: Upload Crash
+        uses: actions/upload-artifact@v4
+        if: failure() && steps.build.outcome == 'success'
+        with:
+          name: artifacts
+          path: ./out/artifacts
+      - name: Upload Sarif
+        if: always() && steps.build.outcome == 'success'
+        uses: github/codeql-action/upload-sarif@v3
+        with:
+          # Path to SARIF file relative to the root of the repository
+          sarif_file: cifuzz-sarif/results.sarif
+          checkout_path: cifuzz-sarif

.github/workflows/test.yml

@@ -0,0 +1,44 @@
+name: test
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        go-versions: [ '1.18', '1.19', '1.20', '1.21', '1.22', '1.23', '1.24' ]
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup Go ${{ matrix.go-version }}
+        uses: actions/setup-go@v4
+        with:
+          go-version: ${{ matrix.go-version }}
+      - name: Test
+        run: go test ./...
+
+  debug:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup Go 1.18
+        uses: actions/setup-go@v4
+        with:
+          go-version: 1.18
+      - name: Test
+        run: go test -tags=expr_debug -run=TestDebugger -v ./vm
+
+  race:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup Go 1.21
+        uses: actions/setup-go@v4
+        with:
+          go-version: 1.21
+      - name: Test
+        run: go test -race .

.gitignore

@@ -0,0 +1,11 @@
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+*.test
+*.out
+*.html
+custom_tests.json
+pro/
+test/avs/