Sha256: 58dcba9f7dc91bd55f696a6ee45be82f23d14405d848eb96e67731468f5b6b96
Contents?: true
Size: 1.91 KB
Versions: 8
Compression:
Stored size: 1.91 KB
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
module Source
# 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 FileParser
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
end
Version data entries
8 entries across 8 versions & 1 rubygems