Contents

require 'jsduck/js_parser'
require 'jsduck/css_parser'
require 'jsduck/doc_parser'
require 'jsduck/merger'
require 'jsduck/ast'
require 'jsduck/doc_type'
require 'jsduck/doc_ast'
require 'jsduck/class_doc_expander'

module JsDuck

  # Performs the actual parsing of CSS or JS source.
  #
  # This is the class that brings together all the different steps of
  # parsing the source.
  class SourceFileParser

    def initialize
      @doc_type = DocType.new
      @doc_parser = DocParser.new
      @class_doc_expander = ClassDocExpander.new
      @doc_ast = DocAst.new
      @merger = Merger.new
    end

    # Parses file into final docset that can be fed into Aggregator
    def parse(contents, filename="", options={})
      @doc_ast.filename = filename

      parse_js_or_css(contents, filename, options).map do |docset|
        expand(docset)
      end.flatten.map do |docset|
        merge(docset)
      end
    end

    private

    # Parses the file depending on filename as JS or CSS
    def parse_js_or_css(contents, filename, options)
      if filename =~ /\.s?css$/
        docs = CssParser.new(contents, options).parse
      else
        docs = JsParser.new(contents, options).parse
        docs = Ast.new(docs, options).detect_all!
      end
    end

    # Parses the docs, detects tagname and expands class docset
    def expand(docset)
      docset[:comment] = @doc_parser.parse(docset[:comment])
      docset[:tagname] = @doc_type.detect(docset[:comment], docset[:code])

      if docset[:tagname] == :class
        @class_doc_expander.expand(docset)
      else
        docset
      end
    end

    # Merges comment and code parts of docset
    def merge(docset)
      @doc_ast.linenr = docset[:linenr]
      docset[:comment] = @doc_ast.detect(docset[:tagname], docset[:comment])

      @merger.merge(docset)
    end
  end

end

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
jsduck-4.0.1	lib/jsduck/source_file_parser.rb
jsduck-4.0.0	lib/jsduck/source_file_parser.rb
jsduck-4.0.beta2	lib/jsduck/source_file_parser.rb