Prefer javadoc.io over sonatype.org for artifacts other than sbt-plugins

.gitignore

@@ -1,4 +1,3 @@
-.*
 target/
 
 # Files created for deployment

src/main/scala/com/thoughtworks/sbtApiMappings/JavadocIoApiMappingRule.scala

@@ -0,0 +1,31 @@
+package com.thoughtworks.sbtApiMappings
+
+import sbt._
+import com.thoughtworks.Extractor._
+
+object JavadocIoApiMappingRule extends AutoPlugin {
+
+  import ApiMappings.autoImport._
+
+  override def requires = ApiMappings
+
+  override def trigger = allRequirements
+
+  private def nonSbtModuleID: Attributed[File] => Option[(String, String, String)] = { jar =>
+    for {
+      moduleID <- jar.get(Keys.moduleID.key)
+      if !moduleID.extraAttributes.contains("sbtVersion")
+    } yield (moduleID.organization, moduleID.name, moduleID.revision)
+  }
+
+  private def javadocIoRule: PartialFunction[Attributed[File], URL] = {
+    case nonSbtModuleID.extract(organization, libraryName, revision) =>
+      val organizationPath = organization.replace('.', '/')
+      url(s"https://javadoc.io/page/$organization/$libraryName/$revision/index.html")
+  }
+
+  override def projectSettings = {
+    apiMappingRules := apiMappingRules.value.orElse(javadocIoRule)
+  }
+
+}

src/main/scala/com/thoughtworks/sbtApiMappings/SonatypeApiMappingRule.scala

@@ -3,13 +3,14 @@ package com.thoughtworks.sbtApiMappings
 import sbt._
 import com.thoughtworks.Extractor._
 
+/** Mapping to sonatype.org URL for all artifacts */
 object SonatypeApiMappingRule extends AutoPlugin {
 
   import ApiMappings.autoImport._
 
   override def requires = ApiMappings
 
-  override def trigger = allRequirements
+  override def trigger = noTrigger
 
   private val JarBaseNameRegex = """(.*)\.jar""".r
 

src/main/scala/com/thoughtworks/sbtApiMappings/SonatypeApiMappingRuleForSbtPlugins.scala

@@ -0,0 +1,39 @@
+package com.thoughtworks.sbtApiMappings
+
+import sbt._
+import com.thoughtworks.Extractor._
+
+/** Mapping to sonatype.org URL only for artifacts that are not supported by javadoc.io */
+object SonatypeApiMappingRuleForSbtPlugins extends AutoPlugin {
+
+  import ApiMappings.autoImport._
+
+  override def requires = ApiMappings
+
+  override def trigger = allRequirements
+
+  private val JarBaseNameRegex = """(.*)\.jar""".r
+
+  private def nonSbtModuleID: Attributed[File] => Option[(String, String, String, String)] = { jar =>
+    jar.data.getName match {
+      case JarBaseNameRegex(baseName) =>
+        for {
+          moduleID <- jar.get(Keys.moduleID.key)
+          if moduleID.extraAttributes.contains("sbtVersion")
+        } yield (baseName, moduleID.organization, moduleID.name, moduleID.revision)
+      case _ =>
+        None
+    }
+  }
+
+  private def sonatypeRule: PartialFunction[Attributed[File], URL] = {
+    case nonSbtModuleID.extract(baseName, organization, libraryName, revision) =>
+      val organizationPath = organization.replace('.', '/')
+      url(s"https://oss.sonatype.org/service/local/repositories/public/archive/$organizationPath/$libraryName/$revision/$baseName-javadoc.jar/!/index.html")
+  }
+
+  override def projectSettings = {
+    apiMappingRules := apiMappingRules.value.orElse(sonatypeRule)
+  }
+
+}

src/sbt-test/sbt-api-mappings/all-libraries-2.12/build.sbt

@@ -1,17 +1,14 @@
-def isDownloadableApiDocumentation(url: URL) = {
+def assertDownloadableApiDocumentation(url: URL) = {
   import java.net.HttpURLConnection
   val connection = url.openConnection().asInstanceOf[HttpURLConnection]
   try {
-    connection.getResponseCode == 200
+    assert((200 to 399).contains(connection.getResponseCode),
+           s"Unexpected HTTP response code ${connection.getResponseCode} when fetching $url")
   } finally {
     connection.disconnect()
   }
 }
 
-def assertDownloadableApiDocumentation(url: URL) = {
-  assert(isDownloadableApiDocumentation(url), s"Cannot open $url!")
-}
-
 val check = TaskKey[Unit]("check")
 
 val scalacheckModuleId = "org.scalacheck" %% "scalacheck" % "1.13.4"
@@ -23,7 +20,10 @@ check := {
                                                 scalacheckModuleId,
                                                 Artifact("scalacheck"))
   val Some((_, url)) = (apiMappings in Test in doc).value.find(_._1.getName == scalacheckJarName)
-  assertDownloadableApiDocumentation(url)
+
+  // The expected URL is browsable but not accessible from java.net.HttpURLConnection
+  val expectedUrl = "https://javadoc.io/page/org.scalacheck/scalacheck_2.12/1.13.4/index.html"
+  assert(url.toString == expectedUrl)
   assert(!(apiMappings in Compile in doc).value.exists(_._1.getName == scalacheckJarName))
 }