1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
package dotty.tools
package dottydoc
import dotty.tools.dottydoc.util.syntax._
import core.ContextDottydoc
import dotc.core.Contexts._
import dotc.{ Compiler, Driver }
import model.Package
import model.json._
import dotc.config._
import dotc.core.Comments.ContextDoc
import staticsite.Site
/** `DocDriver` implements the main entry point to the Dotty documentation
* tool. It's methods are used by the external scala and java APIs.
*/
class DocDriver extends Driver {
import _root_.java.util.{ Map => JMap }
import model.java._
override def setup(args: Array[String], rootCtx: Context): (List[String], Context) = {
val ctx = rootCtx.fresh
val summary = CompilerCommand.distill(args)(ctx)
ctx.setSettings(summary.sstate)
ctx.setSetting(ctx.settings.YkeepComments, true)
ctx.setSetting(ctx.settings.YnoInline, true)
ctx.setProperty(ContextDoc, new ContextDottydoc)
val fileNames = CompilerCommand.checkUsage(summary, sourcesRequired)(ctx)
(fileNames, ctx)
}
override def newCompiler(implicit ctx: Context): Compiler = new DocCompiler
def compiledDocs(args: Array[String]): collection.Map[String, Package] = {
val (fileNames, ctx) = setup(args, initCtx.fresh)
doCompile(newCompiler(ctx), fileNames)(ctx)
ctx.docbase.packages
}
def compiledDocsJava(args: Array[String]): JMap[String, Package] = {
scala.collection.JavaConverters.mapAsJavaMapConverter(compiledDocs(args)).asJava
}
def indexToJson(index: collection.Map[String, Package]): String =
index.json
def indexToJsonJava(index: JMap[String, Package]): String = {
import scala.collection.JavaConverters._
indexToJson(index.asScala)
}
override def main(args: Array[String]): Unit = {
implicit val (filesToDocument, ctx) = setup(args, initCtx.fresh)
val reporter = doCompile(newCompiler(ctx), filesToDocument)(ctx)
val docs = ctx.docbase.packages
val siteRoot = new java.io.File(ctx.settings.siteRoot.value)
if (!siteRoot.exists || !siteRoot.isDirectory)
ctx.error(s"Site root does not exist: $siteRoot")
else {
Site(siteRoot, ctx.settings.projectName.value, docs)
.generateApiDocs()
.copyStaticFiles()
.generateHtmlFiles()
.generateBlog()
System.exit(if (reporter.hasErrors) 1 else 0)
}
}
}
|
