module JsDuck
# Writes HTML JavaScript/CSS source into HTML file.
class SourceWriter
# Initializes SourceFormatter to the directory where
# HTML-formatted source files will be placed.
#
# Wrapper can be either :page or nil; with the first one the whole
# HTML page is created, otherwise source is left as is.
def initialize(output_dir, wrapper = :page)
@output_dir = output_dir
@wrapper = wrapper
end
# Writes HTML into file in output directory. It returns the name
# of the file that it wrote.
def write(source, filename)
fname = uniq_html_filename(filename)
File.open(fname, 'w') do |f|
f.write(@wrapper ? wrap_page(source) : source)
end
fname
end
def uniq_html_filename(filename)
fname = html_filename(filename)
nr = 1
while file_exists?(fname)
nr += 1
fname = html_filename(filename, nr)
end
fname
end
def html_filename(filename, nr=0)
@output_dir + "/" + File.basename(filename, ".js") + (nr > 0 ? nr.to_s : "") + ".html"
end
# Case-insensitive check for file existance to avoid conflicts
# when source files dir is moved to Windows machine.
def file_exists?(filename)
Dir.glob(filename, File::FNM_CASEFOLD).length > 0
end
# Returns source wrapped inside HTML page
def wrap_page(source)
return <<-EOHTML
The source code