модуль RubyVM::AbstractSyntaxTree

AbstractSyntaxTree предоставляет методы для разбора кода Ruby в абстрактные синтаксические деревья. Узлы в дереве являются экземплярами RubyVM::AbstractSyntaxTree::Node.

Этот класс специфичен для MRI, так как он раскрывает детали реализации абстрактного синтаксического дерева MRI.

Этот класс экспериментальный, и его API нестабилен, поэтому он может измениться без предварительного уведомления. Например, порядок дочерних узлов не гарантируется, количество дочерних узлов может измениться, нет способа получить доступ к дочерним узлам по имени и т.д.

Если вам нужен стабильный API или API, работающий под несколькими реализациями Ruby, рассмотрите использование драгоценного камня parser или Ripper. Если вы хотите сделать RubyVM::AbstractSyntaxTree стабильным, пожалуйста, присоединяйтесь к обсуждению на bugs.ruby-lang.org/issues/14844.

Публичные методы класса

RubyVM::AbstractSyntaxTree.of(proc) → RubyVM::AbstractSyntaxTree::Node Показать исходный код

RubyVM::AbstractSyntaxTree.of(method) → RubyVM::AbstractSyntaxTree::Node

# File ast.rb, line 68
def self.of body
  __builtin_ast_s_of body
end

Возвращает узлы AST заданного proc или method.

RubyVM::AbstractSyntaxTree.of(proc {1 + 2})
# => #<RubyVM::AbstractSyntaxTree::Node:SCOPE@1:35-1:42>

def hello
  puts "hello, world"
end

RubyVM::AbstractSyntaxTree.of(method(:hello))
# => #<RubyVM::AbstractSyntaxTree::Node:SCOPE@1:0-3:3>

RubyVM::AbstractSyntaxTree.parse(string) → RubyVM::AbstractSyntaxTree::Node Показать исходный код

# File ast.rb, line 34
def self.parse string
  __builtin_ast_s_parse string
end

Парсит заданную строку в абстрактное синтаксическое дерево, возвращая корневой узел этого дерева.

SyntaxError генерируется, если заданная строка имеет неверный синтаксис.

RubyVM::AbstractSyntaxTree.parse("x = 1 + 2")
# => #<RubyVM::AbstractSyntaxTree::Node:SCOPE@1:0-1:9>

RubyVM::AbstractSyntaxTree.parse_file(pathname) → RubyVM::AbstractSyntaxTree::Node Показать исходный код

# File ast.rb, line 49
def self.parse_file pathname
  __builtin_ast_s_parse_file pathname
end

Читает файл из pathname, затем парсит его, как ::parse, возвращая корневой узел абстрактного синтаксического дерева.

SyntaxError генерируется, если содержимое pathname не является допустимым синтаксисом Ruby.

RubyVM::AbstractSyntaxTree.parse_file("my-app/app.rb")
# => #<RubyVM::AbstractSyntaxTree::Node:SCOPE@1:0-31:3>

Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.