Class: Rubyzen::Parsers::ASTParser

Inherits:

Object

• Object
• Rubyzen::Parsers::ASTParser

Defined in:

lib/rubyzen/parsers/a_s_t_parser.rb

Overview

Singleton parser that converts Ruby source files into Rubyzen declarations using RuboCop’s AST processing. Results are cached via Cache::ParseCache.

Class Method Summary

• .instance ⇒ ASTParser

  Returns the singleton instance of the parser.

Instance Method Summary

• #initialize ⇒ ASTParser constructor

  A new instance of ASTParser.

• #parse_file(file_path) ⇒ Declarations::FileDeclaration^?

  Parses a Ruby source file and returns its declaration, using the cache.

Constructor Details

#initialize ⇒ ASTParser

Returns a new instance of ASTParser.

# File 'lib/rubyzen/parsers/a_s_t_parser.rb', line 16

def initialize
  @cache = Rubyzen::Cache::ParseCache.new
end

Class Method Details

.instance ⇒ ASTParser

Returns the singleton instance of the parser.

Returns:

• (ASTParser)

# File 'lib/rubyzen/parsers/a_s_t_parser.rb', line 12

def self.instance
  @instance ||= new
end

Instance Method Details

#parse_file(file_path) ⇒ Declarations::FileDeclaration^?

Parses a Ruby source file and returns its declaration, using the cache.

Parameters:

• file_path (String) —

  absolute path to the Ruby file

Returns:

• (Declarations::FileDeclaration, nil) —

  the parsed file declaration, or nil if unparseable

# File 'lib/rubyzen/parsers/a_s_t_parser.rb', line 24

def parse_file(file_path)
  @cache.fetch_or_parse(file_path) do
    source = File.read(file_path)
    processed_source = RuboCop::AST::ProcessedSource.new(source, RUBY_VERSION.to_f, file_path)
    next nil unless processed_source.ast
    Rubyzen::Declarations::FileDeclaration.new(file_path, processed_source.ast)
  end
end