Update build process with doc publishing (googleapis#13)

michaelbausor · web-flow · commit 64ff0258e720 · 2017-04-14T08:53:25.000-07:00
* Update build process with doc publishing
* Add template and update .gitignore
diff --git a/.gitignore b/.gitignore
@@ -2,6 +2,7 @@
 bin
 build
 .gradle
+tmp_gh-pages
 
 # Eclipse
 .apt_generated
diff --git a/build.gradle b/build.gradle
@@ -24,7 +24,8 @@ apply plugin: 'com.github.sherter.google-java-format'
 
 group = "com.google.api"
 archivesBaseName = "api-common"
-version = "0.1.0"
+
+project.version = new File("version.txt").text.trim()
 
 sourceCompatibility = 1.7
 targetCompatibility = 1.7
@@ -69,6 +70,10 @@ dependencies {
     libraries.commons
 }
 
+clean.doFirst {
+  delete 'tmp_gh-pages/'
+}
+
 jacocoTestReport {
   reports {
     xml.enabled true
@@ -264,3 +269,47 @@ tasks.verifyGoogleJavaFormat {
   exclude 'build/**'
 }
 test.dependsOn verifyGoogleJavaFormat
+
+// Release
+// =======
+
+task checkOutGhPages {
+  if (!new File('tmp_gh-pages').exists()) {
+    exec {
+      commandLine 'git', 'clone', '--branch', 'gh-pages',
+          '--single-branch', 'https://github.com/googleapis/api-common-java/', 'tmp_gh-pages'
+    }
+  }
+}
+
+task copyFilesToGhPages {
+  dependsOn 'checkOutGhPages'
+  dependsOn 'javadoc'
+  doLast {
+    def newSiteDirPath = 'tmp_gh-pages/' + project.version + '/apidocs/'
+    new File(newSiteDirPath).mkdirs()
+    copy {
+      from 'build/docs/javadoc'
+      into newSiteDirPath
+    }
+    copy {
+      from 'README.md'
+      into 'tmp_gh-pages'
+      rename { filename -> filename.replace 'README', 'index' }
+    }
+  }
+}
+
+task createApiDocsRedirect {
+  dependsOn 'copyFilesToGhPages'
+  doLast {
+    def template = new File('templates/apidocs_index.html.template').text
+    def outputContent = template.replace('{{siteVersion}}', project.version)
+    new File('tmp_gh-pages/apidocs/index.html').write(outputContent)
+  }
+}
+
+// Regenerates the gh-pages branch under tmp_gh-pages, which must be committed separately
+task updateDocsWithCurrentVersion {
+  dependsOn 'createApiDocsRedirect'
+}
diff --git a/templates/apidocs_index.html.template b/templates/apidocs_index.html.template
@@ -0,0 +1 @@
+<html><head><meta http-equiv="refresh" content="0; URL='http://googleapis.github.io/api-common-java/{{siteVersion}}/apidocs/'" /></head><body></body></html>
diff --git a/version.txt b/version.txt
@@ -0,0 +1 @@
+0.1.1-SNAPSHOT

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+<html><head><meta http-equiv="refresh" content="0; URL='http://googleapis.github.io/api-common-java/{{siteVersion}}/apidocs/'" /></head><body></body></html>`