trino_sql_parser 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0fab1f747a3ffd1712e2047e1ae823f4a83426f0d69b297d98d5266db69fa3c0
+  data.tar.gz: 398bb435ddc860cb2164e001e424aa64cd16da0ac6fec394c9b43be66741947e
+SHA512:
+  metadata.gz: 4816c2d9ed1d218a77f8fd8886b074aaebfc4cd839cb577458bcf39014bef8470c4aa8a6b8fd1093760b1b687f93f86020265993c9b7130450966fa8ac969902
+  data.tar.gz: e73763ede15e0be526bd1e6498fcbc46a0917d66ad33e88159381724fb4923ddc7007f0e8e13bea54373b3f2e731ff19e01565caaf17d8e21481f75c6f7ed6d6

data/.gitignore

@@ -0,0 +1,5 @@
+Gemfile.lock
+pkg/*
+/.gradle
+/build/*
+/lib/trino_sql_parser/trino-sql-parser.jar

data/ChangeLog

@@ -0,0 +1,31 @@
+
+2021-01-05 version 1.1.0:
+
+* Update Presto 341 to Trino 351.
+
+2020-10-09 version 1.0.0:
+
+* Update Presto version from 317 to 341
+* Presto 341 supports (CREATE | REFRESH) MATERIALIZED VIEW statements
+
+2020-05-27 version 0.4.1:
+
+* Update Presto version from 316 to 317
+* Updated dependency gem versions
+
+2019-08-02 version 0.4.0:
+
+* Support process running more than idle_wait was killed unexpectedly
+
+2019-08-02 version 0.3.0:
+
+* Added support for PRESTO_SQL_PARSER_JAVA env var
+
+2019-08-02 version 0.2.0:
+
+* Fixed PrestoSqlParser.java_args to work
+
+2019-08-01 version 0.1.0:
+
+* The first release
+

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2019 Sadayuki Furuhashi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+

data/README.md

@@ -0,0 +1,140 @@
+# trino_sql_parser
+
+Trino SQL Parser for Ruby parses a SQL using Trino's native SQL parser precisely and reports syntax errors.
+
+Optionally, it also returns a ANTLR tokens sequence which is useful to analyze and reformat SQL statements.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'trino_sql_parser'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install trino_sql_parser
+
+## Runtime dependency
+
+`java` command must be available because this TrinoSqlParser needs to use Trino's jar file.
+
+If `java` is not available, such as in a pre-built Docker container, you would install java using following script:
+
+```bash
+if [[ ! -d ~/java/jre_11.0.4_11 ]]; then
+    mkdir -p ~/java
+    curl -L "https://github.com/AdoptOpenJDK/openjdk11-binaries/releases/download/jdk-11.0.4%2B11/OpenJDK11U-jre_x64_linux_hotspot_11.0.4_11.tar.gz" | tar zx -C ~/java
+    mv ~/java/jdk-11.0.4+11-jre ~/java/jre_11.0.4_11
+fi
+echo 'export PATH=$HOME/java/jre_11.0.4_11/bin:$PATH' >> ~/.bashrc
+```
+
+On Circle CI 2.0, you can add following configuration to `steps` section:
+
+```yaml
+  - type: cache-restore
+    key: jre_11.0.4_11
+  - run:
+      name: Install java
+      command: |
+        set -xe
+        if [[ ! -d ~/java/jre_11.0.4_11 ]]; then
+          mkdir -p ~/java
+          curl -L "https://github.com/AdoptOpenJDK/openjdk11-binaries/releases/download/jdk-11.0.4%2B11/OpenJDK11U-jre_x64_linux_hotspot_11.0.4_11.tar.gz" | tar zx -C ~/java
+          mv ~/java/jdk-11.0.4+11-jre ~/java/jre_11.0.4_11
+        fi
+        echo 'export PATH=$HOME/java/jre_11.0.4_11/bin:$PATH' >> $BASH_ENV
+  - type: cache-save
+    key: jre_11.04_11
+    paths:
+      - ~/java
+```
+
+## Usage
+
+Most typical use case is checking syntax error as following:
+
+```ruby
+require 'trino_sql_parser'
+
+parser = TrinoSqlParser.new
+begin
+  parser.parse("syntax error!")
+rescue TrinoSqlParser::ParseError => e
+  puts e.message
+
+  # Detailed error information is available in ParseError#errors
+  e.errors.each do |error|
+    line = error['line']
+    column = error['column']
+    message = error['message']
+    puts "Error at #{line}:#{column}: #{message}"
+  end
+end
+```
+
+Optionally, you can get ANTLR token list. It also supports multiple statements.
+
+```ruby
+require 'trino_sql_parser'
+
+sql = <<SQL
+select 1;
+
+-- this is another statement:
+select profiles.id, count(*) as count from events
+left join profiles on events.profile_id = profiles.id
+group by 1
+SQL
+
+parser = TrinoSqlParser.new(with_tokens: true)
+statements = parser.parse(sql)
+
+# First statement's tokens
+p statements[0]['tokens']
+#=> [
+#     ["select", "'SELECT'", 1, 0],
+#     [" ", "WS", 1, 6],
+#     ["1", "INTEGER_VALUE", 1, 7], [";", "DELIMITER", 1, 8]
+#   ]
+
+# Second statement's tokens
+p statements[1]['tokens']
+```
+
+## Options
+
+```ruby
+TrinoSqlParser.java_cmd = "java"  # java command (default: TRINO_SQL_PARSER_JAVA env var or "java")
+TrinoSqlParser.java_args = []     # command-line arguments of java_cmd
+TrinoSqlParser.java_env = {}      # environment variables given to java_cmd
+```
+
+## Development
+
+### Build
+
+```
+bundle
+bundle exec rake jar    # builds jar to lib/trino_sql_parser/trino-sql-parser.jar
+bundle exec rake spec   # runs tests
+bundle exec rake build  # builds a gem file
+```
+
+### Release
+
+```
+gem push pkg/trino_sql_parser-<version>.gem
+```
+
+### Update version and dependencies
+
+* Gem version: `VERSION` at `lib/trino_sql_parser/version.rb`
+* Trino version: dependency version at `build.gradle`
+

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :jar do
+  sh "./gradlew shadowJar"
+  cp "build/libs/trino-sql-parser-1.0.0-all.jar", "lib/trino_sql_parser/trino-sql-parser.jar"
+end
+
+task :default => [:jar, :spec, :build]

data/build.gradle

@@ -0,0 +1,43 @@
+plugins {
+    id 'com.github.johnrengelman.shadow' version '5.1.0'
+}
+apply plugin: 'com.github.johnrengelman.shadow'
+apply plugin: 'java'
+apply plugin: 'idea'
+
+group = 'trino-sql-parser-support-process'
+version = '1.0.0'
+
+dependencies {
+    compile 'io.trino:trino-parser:351'
+    compile "com.fasterxml.jackson.core:jackson-databind:2.9.9"
+    compile "com.fasterxml.jackson.datatype:jackson-datatype-guava:2.9.9"
+    compile "com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.9.9"
+}
+
+repositories {
+    mavenCentral()
+}
+
+sourceCompatibility = 1.8
+targetCompatibility = 1.8
+
+compileJava.options.encoding = 'UTF-8'
+compileTestJava.options.encoding = 'UTF-8'
+
+tasks.withType(JavaCompile) {
+    options.compilerArgs << "-Xlint:unchecked" << "-Xlint:deprecation"
+}
+
+shadowJar {
+    manifest {
+        attributes 'Implementation-Title': project.name,
+                   'Implementation-Version': project.version,
+                   'Implementation-Vendor-Id': project.group,
+                   'Specification-Title': project.name,
+                   'Specification-Version': project.version,
+                   'Main-Class': 'TrinoSqlParserSupportProcess'
+    }
+    mergeServiceFiles {
+    }
+}

data/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-5.5.1-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

data/gradlew

@@ -0,0 +1,172 @@
+#!/usr/bin/env sh
+
+##############################################################################
+##
+##  Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+    ls=`ls -ld "$PRG"`
+    link=`expr "$ls" : '.*-> \(.*\)$'`
+    if expr "$link" : '/.*' > /dev/null; then
+        PRG="$link"
+    else
+        PRG=`dirname "$PRG"`"/$link"
+    fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >/dev/null
+APP_HOME="`pwd -P`"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS=""
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn () {
+    echo "$*"
+}
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "`uname`" in
+  CYGWIN* )
+    cygwin=true
+    ;;
+  Darwin* )
+    darwin=true
+    ;;
+  MINGW* )
+    msys=true
+    ;;
+  NONSTOP* )
+    nonstop=true
+    ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+        JAVACMD="$JAVA_HOME/bin/java"
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD="java"
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
+    MAX_FD_LIMIT=`ulimit -H -n`
+    if [ $? -eq 0 ] ; then
+        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+            MAX_FD="$MAX_FD_LIMIT"
+        fi
+        ulimit -n $MAX_FD
+        if [ $? -ne 0 ] ; then
+            warn "Could not set maximum file descriptor limit: $MAX_FD"
+        fi
+    else
+        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+    fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin, switch paths to Windows format before running java
+if $cygwin ; then
+    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+    JAVACMD=`cygpath --unix "$JAVACMD"`
+
+    # We build the pattern for arguments to be converted via cygpath
+    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+    SEP=""
+    for dir in $ROOTDIRSRAW ; do
+        ROOTDIRS="$ROOTDIRS$SEP$dir"
+        SEP="|"
+    done
+    OURCYGPATTERN="(^($ROOTDIRS))"
+    # Add a user-defined pattern to the cygpath arguments
+    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+    fi
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    i=0
+    for arg in "$@" ; do
+        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
+
+        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
+            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+        else
+            eval `echo args$i`="\"$arg\""
+        fi
+        i=$((i+1))
+    done
+    case $i in
+        (0) set -- ;;
+        (1) set -- "$args0" ;;
+        (2) set -- "$args0" "$args1" ;;
+        (3) set -- "$args0" "$args1" "$args2" ;;
+        (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+        (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+        (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+        (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+        (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+        (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+    esac
+fi
+
+# Escape application args
+save () {
+    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
+    echo " "
+}
+APP_ARGS=$(save "$@")
+
+# Collect all arguments for the java command, following the shell quoting and substitution rules
+eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+
+# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
+if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then
+  cd "$(dirname "$0")"
+fi
+
+exec "$JAVACMD" "$@"

data/gradlew.bat

@@ -0,0 +1,84 @@
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS=
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto init
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto init
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:init
+@rem Get command-line arguments, handling Windows variants
+
+if not "%OS%" == "Windows_NT" goto win9xME_args
+
+:win9xME_args
+@rem Slurp the command line arguments.
+set CMD_LINE_ARGS=
+set _SKIP=2
+
+:win9xME_args_slurp
+if "x%~1" == "x" goto execute
+
+set CMD_LINE_ARGS=%*
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

data/lib/trino_sql_parser.rb

@@ -0,0 +1,73 @@
+require 'json'
+
+class TrinoSqlParser
+  module ClassMethods
+    attr_accessor :java_cmd
+    attr_accessor :java_args
+    attr_accessor :java_env
+    attr_accessor :jar_path
+  end
+
+  extend ClassMethods
+
+  self.java_cmd = ENV['TRINO_SQL_PARSER_JAVA']
+  if self.java_cmd == nil || self.java_cmd.strip.empty?
+    self.java_cmd = "java"
+  end
+
+  self.java_args = []
+
+  self.java_env = {}
+
+  self.jar_path = File.join(File.dirname(__FILE__), "trino_sql_parser/trino-sql-parser.jar")
+
+  class ParseError < StandardError
+    def initialize(errors)
+      @errors = errors
+      message = errors.map do |error|
+        "[#{error['line']}:#{error['column']}] #{error['message']}"
+      end.join(", ")
+      super(message)
+    end
+
+    attr_reader :errors
+  end
+
+  require 'trino_sql_parser/support_process'
+
+  def initialize(with_tokens: false)
+    @support_process = SupportProcess.new(with_tokens: with_tokens)
+  end
+
+  def parse(sql)
+    unless sql.is_a?(String)
+      raise ArgumentError, "SQL must be a String but got #{sql.class}"
+    end
+    request_line = JSON.dump({"sql" => sql})
+
+    success = false
+    begin
+      @support_process.send_line(request_line)
+      response_line = @support_process.receive_line
+      raise "Process crashed" unless response_line
+      response = JSON.parse(response_line)
+      statements = response['statements']
+      errors = response['errors']
+      success = true
+    rescue => e
+      raise "Support process failed with an error: #{e}"
+    ensure
+      @support_process.kill! unless success
+    end
+
+    if errors
+      raise ParseError.new(errors)
+    end
+
+    statements.map do |h|
+      h.reject! {|k, v| v == nil }
+    end
+
+    statements
+  end
+end

data/lib/trino_sql_parser/support_process.rb

@@ -0,0 +1,72 @@
+require 'shellwords'
+
+class TrinoSqlParser
+  class SupportProcess
+    def initialize(idle_wait: 2, with_tokens:)
+      @idle_wait = idle_wait
+      @with_tokens = with_tokens
+      @mutex = Mutex.new
+      @last_used_pid = nil
+      @pipe = nil
+      @pid = nil
+    end
+
+    def start!
+      return if @pipe
+
+      cmd = (
+        [TrinoSqlParser.java_cmd] +
+        TrinoSqlParser.java_args.map {|arg| Shellwords.escape(arg) } +
+        ["-jar", Shellwords.escape(TrinoSqlParser.jar_path)]
+      ).join(' ')
+
+      if @with_tokens
+        cmd << " --with-tokens"
+      end
+
+      @pipe = IO.popen(TrinoSqlParser.java_env, cmd, "r+", external_encoding: 'UTF-8')
+      @pid = @pipe.pid
+      Thread.new(@pid, &method(:monitor_thread))
+    end
+
+    def kill!
+      @mutex.synchronize do
+        if @pid
+          Process.kill("KILL", @pid)
+          @pipe.close rescue nil
+          @pipe = nil
+          @pid = nil
+        end
+      end
+    end
+
+    def send_line(line)
+      @mutex.synchronize do  # block kill! during execution
+        start! unless @pipe
+        @pipe.puts line
+        @last_used_pid = @pipe.pid
+      end
+      nil
+    end
+
+    def receive_line
+      @pipe.gets
+    end
+
+    private
+
+    def monitor_thread(pid)
+      while true
+        done = Process.waitpid2(pid, Process::WNOHANG) rescue true
+        break if done
+
+        sleep @idle_wait
+        if @last_used_pid != pid
+          kill! rescue nil
+        end
+
+        @last_used_pid = nil  # Next check kills the process
+      end
+    end
+  end
+end

data/lib/trino_sql_parser/version.rb

@@ -0,0 +1,3 @@
+class TrinoSqlParser
+  VERSION = "1.1.0"
+end

data/settings.gradle

@@ -0,0 +1 @@
+rootProject.name = 'trino-sql-parser'

data/spec/trino_sql_parser_spec.rb

@@ -0,0 +1,40 @@
+require 'trino_sql_parser'
+
+RSpec.describe TrinoSqlParser do
+  let(:parser) do
+    TrinoSqlParser.new
+  end
+
+  it "raises ParseError::ParseError" do
+    expect(lambda { parser.parse("...") }).to raise_error(TrinoSqlParser::ParseError)
+  end
+
+  describe TrinoSqlParser::ParseError do
+    it "includes detailed error messages" do
+      e = nil
+      begin
+        parser.parse("xxx; yyy")
+      rescue TrinoSqlParser::ParseError
+        e = $!
+      end
+      expect(e.errors[0]['message']).to include("mismatched input 'xxx'")
+      expect(e.errors[0]['line']).to eq(1)
+      expect(e.errors[1]['message']).to include("mismatched input 'yyy'")
+      expect(e.errors[1]['line']).to eq(1)
+    end
+  end
+
+  context "with_tokens" do
+    let(:parser) do
+      TrinoSqlParser.new(with_tokens: true)
+    end
+
+    it "returns token list" do
+      statements = parser.parse("select 1; select * from t")
+      text, type, line, column = *statements[0]['tokens'].first
+      expect(text).to eq("select")
+      expect(line).to eq(1)
+      expect(column).to eq(0)
+    end
+  end
+end

data/src/main/java/JsonErrorReport.java

@@ -0,0 +1,24 @@
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public class JsonErrorReport
+{
+    private final String message;
+    private final int line;
+    private final int column;
+
+    public JsonErrorReport(String message, int line, int column)
+    {
+        this.message = message;
+        this.line= line;
+        this.column= column;
+    }
+
+    @JsonProperty
+    public String getMessage() { return message; }
+
+    @JsonProperty
+    public int getLine() { return line; }
+
+    @JsonProperty
+    public int getColumn() { return column; }
+}

data/src/main/java/JsonRequest.java

@@ -0,0 +1,14 @@
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public class JsonRequest
+{
+    private final String sql;
+
+    public JsonRequest(@JsonProperty("sql") String sql)
+    {
+        this.sql = sql;
+    }
+
+    @JsonProperty
+    public String getSql() { return sql; }
+}

data/src/main/java/JsonResult.java

@@ -0,0 +1,27 @@
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+import java.util.List;
+
+public class JsonResult
+{
+    private final List<JsonStatement> statements;
+    private final List<JsonErrorReport> errors;
+
+    public JsonResult(List<JsonStatement> statements, List<JsonErrorReport> errors)
+    {
+        if (errors.isEmpty()) {
+            this.statements = statements;
+            this.errors = null;
+        }
+        else {
+            this.statements = null;
+            this.errors = errors;
+        }
+    }
+
+    @JsonProperty
+    public List<JsonStatement> getStatements() { return statements; }
+
+    @JsonProperty
+    public List<JsonErrorReport> getErrors() { return errors; }
+}

data/src/main/java/JsonStatement.java

@@ -0,0 +1,64 @@
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyOrder;
+import io.trino.sql.parser.StatementSplitterWithOffsetRetained.Fragment;
+import io.trino.sql.parser.StatementSplitterWithOffsetRetained;
+import io.trino.sql.tree.Statement;
+import java.util.List;
+import org.antlr.v4.runtime.Token;
+import static com.google.common.collect.ImmutableList.toImmutableList;
+
+public class JsonStatement
+{
+    @JsonFormat(shape=JsonFormat.Shape.ARRAY)
+    @JsonPropertyOrder({"text", "type", "line", "column"})
+    public static class JsonToken
+    {
+        private final String text;
+        private final String type;
+        private final int line;
+        private final int column;
+
+        public JsonToken(Token token)
+        {
+            this.text = token.getText();
+            this.type = StatementSplitterWithOffsetRetained.getTokenName(token);
+            this.line= token.getLine();
+            this.column= token.getCharPositionInLine();
+        }
+
+        public String getText() { return text; }
+
+        public String getType() { return type; }
+
+        public int getLine() { return line; }
+
+        public int getColumn() { return column; }
+    }
+
+    private final int line;
+    private final int column;
+    private final List<JsonToken> tokens;
+
+    public JsonStatement(Fragment fragment, Statement statement, boolean withTokens)
+    {
+        this.line= fragment.getLineOffset() + 1;
+        this.column= fragment.getFirstLineColumnOffset();
+        if (withTokens) {
+            this.tokens = fragment.getTokens().stream().map(JsonToken::new).collect(toImmutableList());
+        }
+        else {
+            this.tokens = null;
+        }
+    }
+
+    @JsonProperty
+    public int getLine() { return line; }
+
+    @JsonProperty
+    public int getColumn() { return column; }
+
+    @JsonProperty
+    public List<JsonToken> getTokens() { return tokens; }
+}

data/src/main/java/TrinoSqlParserSupportProcess.java

@@ -0,0 +1,82 @@
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.datatype.guava.GuavaModule;
+import com.fasterxml.jackson.datatype.jdk8.Jdk8Module;
+import com.google.common.collect.ImmutableList;
+import com.google.common.io.ByteStreams;
+import io.trino.sql.parser.ParsingException;
+import io.trino.sql.parser.ParsingOptions.DecimalLiteralTreatment;
+import io.trino.sql.parser.ParsingOptions;
+import io.trino.sql.parser.SqlParser;
+import io.trino.sql.parser.StatementSplitterWithOffsetRetained.Fragment;
+import io.trino.sql.parser.StatementSplitterWithOffsetRetained;
+import io.trino.sql.tree.Statement;
+import java.io.BufferedReader;
+import java.io.InputStreamReader;
+import java.util.List;
+import static com.google.common.collect.ImmutableList.toImmutableList;
+import static java.nio.charset.StandardCharsets.UTF_8;
+
+public class TrinoSqlParserSupportProcess
+{
+    public static void main(String[] args) throws Exception
+    {
+        boolean withTokens = false;
+
+        for (String arg : args) {
+            switch (arg) {
+            case "--with-tokens":
+                withTokens = true;
+                break;
+            default:
+                System.err.println("Unknown argument: " + arg);
+                System.exit(1);
+            }
+        }
+
+        ObjectMapper mapper = new ObjectMapper();
+        mapper.registerModule(new GuavaModule());
+        mapper.registerModule(new Jdk8Module());
+
+        BufferedReader in = new BufferedReader(new InputStreamReader(System.in, UTF_8));
+        while (true) {
+            String line = in.readLine();
+            if (line == null) {
+                return;
+            }
+
+            JsonRequest request = mapper.readValue(line, JsonRequest.class);
+            JsonResult result = parse(request.getSql(), withTokens);
+            System.out.println(mapper.writeValueAsString(result));
+        }
+    }
+
+    public static JsonResult parse(String sql,
+            boolean withTokens)
+    {
+        ImmutableList.Builder<JsonStatement> statements = ImmutableList.builder();
+        ImmutableList.Builder<JsonErrorReport> errors = ImmutableList.builder();
+
+        List<Fragment> fragments = StatementSplitterWithOffsetRetained.split(sql);
+
+        SqlParser parser = new SqlParser();
+
+        for (Fragment fragment : fragments) {
+            try {
+                Statement statement = parser.createStatement(
+                        fragment.getStatement(),
+                        new ParsingOptions(DecimalLiteralTreatment.AS_DOUBLE));
+                statements.add(new JsonStatement(fragment, statement, withTokens));
+            }
+            catch (ParsingException ex) {
+                errors.add(
+                        new JsonErrorReport(
+                            ex.getErrorMessage(),
+                            ex.getLineNumber() + fragment.getLineOffset(),
+                            ex.getColumnNumber() + (ex.getLineNumber() == 1 ? fragment.getFirstLineColumnOffset() : 0)));
+            }
+        }
+
+        return new JsonResult(statements.build(), errors.build());
+    }
+}

data/src/main/java/io/trino/sql/parser/StatementSplitterWithOffsetRetained.java

@@ -0,0 +1,150 @@
+// This code is in this package following classes are package-private:
+//   io.trino.sql.parser.DelimiterLexer
+package io.trino.sql.parser;
+
+import com.google.common.collect.ImmutableList;
+import com.google.common.collect.ImmutableSet;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Set;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+import org.antlr.v4.runtime.ANTLRInputStream;
+import org.antlr.v4.runtime.CharStream;
+import org.antlr.v4.runtime.Token;
+import org.antlr.v4.runtime.TokenSource;
+import org.antlr.v4.runtime.Vocabulary;
+
+public class StatementSplitterWithOffsetRetained
+{
+    private static final Vocabulary vocabulary = new SqlBaseParser(null).getVocabulary();
+
+    public static String getTokenName(Token token)
+    {
+        return vocabulary.getDisplayName(token.getType());
+    }
+
+    public static List<Fragment> split(String sql)
+    {
+        return new StatementSplitterWithOffsetRetained().run(sql);
+    }
+
+    private int currentLine;
+    private int currentCharPositionInLine;
+    private List<Token> currentFragmentTokens = new ArrayList<>();
+
+    private StatementSplitterWithOffsetRetained()
+    { }
+
+    private void resetState(int nextLine, int nextCharPositionInLine)
+    {
+        this.currentLine = nextLine;
+        this.currentCharPositionInLine = nextCharPositionInLine;
+        this.currentFragmentTokens.clear();
+    }
+
+    private List<Fragment> run(String sql)
+    {
+        ImmutableList.Builder<Fragment> results = ImmutableList.builder();
+        resetState(1, 0);
+
+        TokenSource tokens = getLexer(sql, ImmutableSet.of(";"));
+        while (true) {
+            Token token = tokens.nextToken();
+            if (token.getType() == Token.EOF) {
+                completeFragmentTo(results, null);
+                return results.build();
+            }
+            else if (token.getType() == SqlBaseParser.DELIMITER) {
+                completeFragmentTo(results, token);
+                resetState(token.getLine(), token.getCharPositionInLine() + token.getText().length());
+            }
+            else {
+                currentFragmentTokens.add(token);
+            }
+        }
+    }
+
+    private void completeFragmentTo(ImmutableList.Builder<Fragment> results, Token deliminatorToken)
+    {
+        String statement = currentFragmentTokens.stream().map(Token::getText).collect(Collectors.joining(""));
+        Token firstToken = findFirstNonWhitespaceToken(statement);
+        if (firstToken != null) {  // skip empty statements
+            if (deliminatorToken != null) {
+                currentFragmentTokens.add(deliminatorToken);
+            }
+            int lineOffset = (currentLine - 1) + (firstToken.getLine() - 1);
+            int firstLineColumnOffset = firstToken.getCharPositionInLine() + (firstToken.getLine() == 1 ? currentCharPositionInLine : 0);
+            statement = removeLines(statement, firstToken.getLine() - 1);
+            statement = statement.substring(firstToken.getCharPositionInLine());
+            results.add(new Fragment(statement, lineOffset, firstLineColumnOffset, ImmutableList.copyOf(currentFragmentTokens)));
+        }
+    }
+
+    private static String removeLines(String string, int count)
+    {
+        if (count > 0) {
+            String[] lines = string.split("\\n");
+            return Stream.of(lines).skip(count).collect(Collectors.joining("\n"));
+        }
+        else {
+            return string;
+        }
+    }
+
+    private static Token findFirstNonWhitespaceToken(String statement)
+    {
+        TokenSource tokens = getLexer(statement, ImmutableSet.of());
+        while (true) {
+            Token token = tokens.nextToken();
+            if (token.getType() == Token.EOF) {
+                return null;
+            }
+            if (token.getChannel() != Token.HIDDEN_CHANNEL) {
+                return token;
+            }
+        }
+    }
+
+    private static TokenSource getLexer(String sql, Set<String> terminators)
+    {
+        CharStream stream = new CaseInsensitiveStream(new ANTLRInputStream(sql));
+        return new DelimiterLexer(stream, terminators);
+    }
+
+    public static class Fragment
+    {
+        private final String statement;
+        private final int lineOffset;
+        private final int firstLineColumnOffset;
+        private final List<Token> tokens;
+
+        public Fragment(String statement, int lineOffset, int firstLineColumnOffset, List<Token> tokens)
+        {
+            this.statement = statement;
+            this.lineOffset = lineOffset;
+            this.firstLineColumnOffset = firstLineColumnOffset;
+            this.tokens = tokens;
+        }
+
+        public String getStatement()
+        {
+            return statement;
+        }
+
+        public int getLineOffset()
+        {
+            return lineOffset;
+        }
+
+        public int getFirstLineColumnOffset()
+        {
+            return firstLineColumnOffset;
+        }
+
+        public List<Token> getTokens()
+        {
+            return tokens;
+        }
+    }
+}

data/trino_sql_parser.gemspec

@@ -0,0 +1,22 @@
+# encoding: utf-8
+$:.push File.expand_path('../lib', __FILE__)
+require "trino_sql_parser/version"
+
+Gem::Specification.new do |gem|
+  gem.name          = "trino_sql_parser"
+  gem.summary       = "Trino SQL Parser for Ruby"
+  gem.description   = "Trino SQL Parser for Ruby parses a SQL using Trino's native SQL parser precisely and reports error if given SQL has syntax errors. Optionally, it returns a ANTLR tokens sequence."
+  gem.version       = TrinoSqlParser::VERSION
+  gem.authors       = ["Sadayuki Furuhashi"]
+  gem.email         = ["frsyuki@gmail.com"]
+  gem.homepage      = "https://github.com/frsyuki/trino_sql_parser"
+  gem.license       = "MIT"
+  gem.files         = `git ls-files`.split("\n") + ["lib/trino_sql_parser/trino-sql-parser.jar"]
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency "bundler"
+  gem.add_development_dependency "rake", "~> 13"
+  gem.add_development_dependency "rspec", "~> 3"
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: trino_sql_parser
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+platform: ruby
+authors:
+- Sadayuki Furuhashi
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-01-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+description: Trino SQL Parser for Ruby parses a SQL using Trino's native SQL parser
+  precisely and reports error if given SQL has syntax errors. Optionally, it returns
+  a ANTLR tokens sequence.
+email:
+- frsyuki@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ChangeLog
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- build.gradle
+- gradle/wrapper/gradle-wrapper.jar
+- gradle/wrapper/gradle-wrapper.properties
+- gradlew
+- gradlew.bat
+- lib/trino_sql_parser.rb
+- lib/trino_sql_parser/support_process.rb
+- lib/trino_sql_parser/trino-sql-parser.jar
+- lib/trino_sql_parser/version.rb
+- settings.gradle
+- spec/trino_sql_parser_spec.rb
+- src/main/java/JsonErrorReport.java
+- src/main/java/JsonRequest.java
+- src/main/java/JsonResult.java
+- src/main/java/JsonStatement.java
+- src/main/java/TrinoSqlParserSupportProcess.java
+- src/main/java/io/trino/sql/parser/StatementSplitterWithOffsetRetained.java
+- trino_sql_parser.gemspec
+homepage: https://github.com/frsyuki/trino_sql_parser
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key:
+specification_version: 4
+summary: Trino SQL Parser for Ruby
+test_files:
+- spec/trino_sql_parser_spec.rb