Класс: Parser::Source::Map

Map связывает узлы AST с исходным кодом, из которого они были разобраны. Точнее, Map или его подкласс содержит набор диапазонов:

• expression: наименьший диапазон, включающий весь исходный код, соответствующий узлу, и все диапазоны expression его дочерних элементов.
• другие диапазоны (begin, end, operator, ...): диапазоны, специфичные для узла и указывающие на различные интересующие токены, соответствующие узлу.

Обратите внимание, что карта Heredoc — единственная, у которой expression не включает другие диапазоны. Она охватывает только маркер heredoc (<<HERE), но не сам документ here.

Все диапазоны, кроме expression, определяются подклассами Map.

Диапазоны (кроме expression) могут быть nil, если соответствующий токен отсутствует в исходном коде. Например, у хеша могут отсутствовать открывающие и закрывающие фигурные скобки, и в его карте исходного кода они тоже будут отсутствовать.

p Parser::CurrentRuby.parse('[1 => 2]').children[0].loc
# => <Parser::Source::Map::Collection:0x007f5492b547d8
#  @end=nil, @begin=nil,
#  @expression=#<Source::Range (string) 1...7>>

В документе AST_FORMAT описано, как диапазоны связаны с токенами исходного кода. Например, запись

(array (int 1) (int 2))

"[1, 2]"
 ^ begin
      ^ end
 ~~~~~~ expression

означает, что если node является (array (int 1) (int 2)) AST::Node, то node.loc поддерживает begin, end и expression, а node.loc.begin возвращает диапазон, указывающий на открывающую скобку, и так далее.

Если вы хотите написать код, полиморфный относительно карты исходного кода (то есть принимающий несколько подклассов Map), используйте respond_to? вместо is_a?, чтобы проверить, содержит ли карта нужный вам диапазон. Конкретные подклассы Map могут меняться между версиями, но их интерфейсы останутся совместимыми.

Визуализировать карты исходного кода можно с помощью инструмента командной строки ruby-parse -E.

source://parser//lib/parser/source/map.rb#70