зеркало из https://github.com/github/ruby.git
106 строки
3.4 KiB
Ruby
106 строки
3.4 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
# The Prism Ruby parser.
|
|
#
|
|
# "Parsing Ruby is suddenly manageable!"
|
|
# - You, hopefully
|
|
#
|
|
module Prism
|
|
# There are many files in prism that are templated to handle every node type,
|
|
# which means the files can end up being quite large. We autoload them to make
|
|
# our require speed faster since consuming libraries are unlikely to use all
|
|
# of these features.
|
|
|
|
autoload :BasicVisitor, "prism/visitor"
|
|
autoload :Compiler, "prism/compiler"
|
|
autoload :Debug, "prism/debug"
|
|
autoload :DesugarCompiler, "prism/desugar_compiler"
|
|
autoload :Dispatcher, "prism/dispatcher"
|
|
autoload :DotVisitor, "prism/dot_visitor"
|
|
autoload :DSL, "prism/dsl"
|
|
autoload :LexCompat, "prism/lex_compat"
|
|
autoload :LexRipper, "prism/lex_compat"
|
|
autoload :MutationCompiler, "prism/mutation_compiler"
|
|
autoload :NodeInspector, "prism/node_inspector"
|
|
autoload :Pack, "prism/pack"
|
|
autoload :Pattern, "prism/pattern"
|
|
autoload :Serialize, "prism/serialize"
|
|
autoload :Translation, "prism/translation"
|
|
autoload :Visitor, "prism/visitor"
|
|
|
|
# Some of these constants are not meant to be exposed, so marking them as
|
|
# private here.
|
|
|
|
private_constant :Debug
|
|
private_constant :LexCompat
|
|
private_constant :LexRipper
|
|
|
|
# :call-seq:
|
|
# Prism::lex_compat(source, **options) -> ParseResult
|
|
#
|
|
# Returns a parse result whose value is an array of tokens that closely
|
|
# resembles the return value of Ripper::lex. The main difference is that the
|
|
# `:on_sp` token is not emitted.
|
|
#
|
|
# For supported options, see Prism::parse.
|
|
def self.lex_compat(source, **options)
|
|
LexCompat.new(source, **options).result # steep:ignore
|
|
end
|
|
|
|
# :call-seq:
|
|
# Prism::lex_ripper(source) -> Array
|
|
#
|
|
# This lexes with the Ripper lex. It drops any space events but otherwise
|
|
# returns the same tokens. Raises SyntaxError if the syntax in source is
|
|
# invalid.
|
|
def self.lex_ripper(source)
|
|
LexRipper.new(source).result # steep:ignore
|
|
end
|
|
|
|
# :call-seq:
|
|
# Prism::load(source, serialized) -> ParseResult
|
|
#
|
|
# Load the serialized AST using the source as a reference into a tree.
|
|
def self.load(source, serialized)
|
|
Serialize.load(source, serialized)
|
|
end
|
|
|
|
# :call-seq:
|
|
# Prism::parse_failure?(source, **options) -> bool
|
|
#
|
|
# Returns true if the source parses with errors.
|
|
def self.parse_failure?(source, **options)
|
|
!parse_success?(source, **options)
|
|
end
|
|
|
|
# :call-seq:
|
|
# Prism::parse_file_failure?(filepath, **options) -> bool
|
|
#
|
|
# Returns true if the file at filepath parses with errors.
|
|
def self.parse_file_failure?(filepath, **options)
|
|
!parse_file_success?(filepath, **options)
|
|
end
|
|
end
|
|
|
|
require_relative "prism/node"
|
|
require_relative "prism/node_ext"
|
|
require_relative "prism/parse_result"
|
|
require_relative "prism/parse_result/comments"
|
|
require_relative "prism/parse_result/newlines"
|
|
|
|
# This is a Ruby implementation of the prism parser. If we're running on CRuby
|
|
# and we haven't explicitly set the PRISM_FFI_BACKEND environment variable, then
|
|
# it's going to require the built library. Otherwise, it's going to require a
|
|
# module that uses FFI to call into the library.
|
|
if RUBY_ENGINE == "ruby" and !ENV["PRISM_FFI_BACKEND"]
|
|
require "prism/prism"
|
|
|
|
# The C extension is the default backend on CRuby.
|
|
Prism::BACKEND = :CEXT
|
|
else
|
|
require_relative "prism/ffi"
|
|
|
|
# The FFI backend is used on other Ruby implementations.
|
|
Prism::BACKEND = :FFI
|
|
end
|