package akka import sbt._ import sbtunidoc.Plugin.UnidocKeys._ import sbtunidoc.Plugin.{ ScalaUnidoc, JavaUnidoc, scalaJavaUnidocSettings, genjavadocSettings, scalaUnidocSettings } import sbt.Keys._ import sbt.File import scala.annotation.tailrec object Unidoc { def settings(ignoreAggregates: Seq[Project], ignoreProjects: Seq[Project]) = { val withoutAggregates = ignoreAggregates.foldLeft(inAnyProject) { _ -- inAggregates(_, transitive = true, includeRoot = true) } val docProjectFilter = ignoreProjects.foldLeft(withoutAggregates) { _ -- inProjects(_) } inTask(unidoc)(Seq( unidocProjectFilter in ScalaUnidoc := docProjectFilter, unidocProjectFilter in JavaUnidoc := docProjectFilter, apiMappings in ScalaUnidoc := (apiMappings in (Compile, doc)).value )) } val genjavadocEnabled = sys.props.get("akka.genjavadoc.enabled").getOrElse("false").toBoolean val (unidocSettings, javadocSettings) = if (genjavadocEnabled) (scalaJavaUnidocSettings, genjavadocSettings) else (scalaUnidocSettings, Nil) lazy val scaladocDiagramsEnabled = sys.props.get("akka.scaladoc.diagrams").getOrElse("true").toBoolean lazy val scaladocAutoAPI = sys.props.get("akka.scaladoc.autoapi").getOrElse("true").toBoolean def scaladocSettings: Seq[sbt.Setting[_]] = { scaladocSettingsNoVerificationOfDiagrams ++ (if (scaladocDiagramsEnabled) Seq(doc in Compile ~= scaladocVerifier) else Seq.empty) } // for projects with few (one) classes there might not be any diagrams def scaladocSettingsNoVerificationOfDiagrams: Seq[sbt.Setting[_]] = { inTask(doc)(Seq( scalacOptions in Compile <++= (version, baseDirectory in ThisBuild) map scaladocOptions, autoAPIMappings := scaladocAutoAPI )) } def scaladocOptions(ver: String, base: File): List[String] = { val urlString = GitHub.url(ver) + "/€{FILE_PATH}.scala" val opts = List("-implicits", "-doc-source-url", urlString, "-sourcepath", base.getAbsolutePath) if (scaladocDiagramsEnabled) "-diagrams"::opts else opts } def scaladocVerifier(file: File): File= { @tailrec def findHTMLFileWithDiagram(dirs: Seq[File]): Boolean = { if (dirs.isEmpty) false else { val curr = dirs.head val (newDirs, files) = curr.listFiles.partition(_.isDirectory) val rest = dirs.tail ++ newDirs val hasDiagram = files exists { f => val name = f.getName if (name.endsWith(".html") && !name.startsWith("index-") && !name.equals("index.html") && !name.equals("package.html")) { val source = scala.io.Source.fromFile(f)(scala.io.Codec.UTF8) val hd = try source.getLines().exists(_.contains("