Ruby Parser类用法及代码示例

解析器是一个简单的类，它是 RDoc::Parser 的子类，并实现扫描以用解析的数据填充 RDoc::TopLevel 。

初始化方法接受一个 RDoc::TopLevel 来填充解析的内容、要解析的文件的名称、文件的内容、一个 RDoc::Options 对象和一个 RDoc::Stats 对象来通知用户已解析的项目。然后调用扫描方法来解析文件，并且必须返回 RDoc::TopLevel 对象。通过调用 super 这些项目将为您设置。

为了被 RDoc 使用，解析器需要注册它可以解析的文件扩展名。使用 ::parse_files_matching 注册扩展。

require 'rdoc'

class RDoc::Parser::Xyz < RDoc::Parser
  parse_files_matching /\.xyz$/

  def initialize top_level, file_name, content, options, stats
    super

    # extra initialization if needed
  end

  def scan
    # parse file and fill in @top_level
  end
end