Include parser translation

Author: kddnewton

.github/workflows/main.yml

@@ -23,6 +23,8 @@ jobs:
       # TESTOPTS: --verbose
     steps:
     - uses: actions/checkout@master
+      with:
+        submodules: true
     - uses: ruby/setup-ruby@v1
       with:
         bundler-cache: true

.gitmodules

@@ -7,3 +7,6 @@
 [submodule "test/ruby-syntax-fixtures"]
 	path = test/ruby-syntax-fixtures
 	url = https://github.com/ruby-syntax-tree/ruby-syntax-fixtures
+[submodule "test/suites/parser"]
+	path = test/suites/parser
+	url = https://github.com/whitequark/parser

.rubocop.yml

@@ -9,6 +9,7 @@ AllCops:
   Exclude:
   - '{.git,.github,bin,coverage,pkg,spec,test/fixtures,vendor,tmp}/**/*'
   - test/ruby-syntax-fixtures/**/*
+  - test/suites/parser/**/*
   - test.rb
 
 Gemspec/DevelopmentDependencies:

Rakefile

@@ -6,8 +6,16 @@ require "syntax_tree/rake_tasks"
 
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
+  t.libs << "test/suites"
   t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
+
+  # These are our own tests.
+  test_files = FileList["test/**/*_test.rb"]
+
+  # This is a big test file from the parser gem that tests its functionality.
+  test_files << "test/suites/parser/test/test_parser.rb"
+
+  t.test_files = test_files
 end
 
 task default: :test

lib/syntax_tree.rb

@@ -40,6 +40,8 @@
 require_relative "syntax_tree/yarv/assembler"
 require_relative "syntax_tree/yarv/vm"
 
+require_relative "syntax_tree/translation"
+
 # Syntax Tree is a suite of tools built on top of the internal CRuby parser. It
 # provides the ability to generate a syntax tree from source, as well as the
 # tools necessary to inspect and manipulate that syntax tree. It can be used to

lib/syntax_tree/translation.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module SyntaxTree
+  # This module is responsible for translating the Syntax Tree syntax tree into
+  # other representations.
+  module Translation
+    # This method translates the given node into the representation defined by
+    # the whitequark/parser gem. We don't explicitly list it as a dependency
+    # because it's not required for the core functionality of Syntax Tree.
+    def self.to_parser(node, source)
+      require "parser"
+      require_relative "translation/parser"
+
+      buffer = ::Parser::Source::Buffer.new("(string)")
+      buffer.source = source
+
+      node.accept(Parser.new(buffer))
+    end
+  end
+end