From 6dc4c0af16a17817019de59406305336030bc6ba Mon Sep 17 00:00:00 2001
From: Lukas Bednar <lbednar@redhat.com>
Date: Tue, 7 Nov 2017 15:27:05 +0100
Subject: [PATCH] Generate KubeVirt API Reference documentation

---
 .gitignore                               |  3 ++
 hack/gen-swagger-doc/build.gradle        | 31 ++++++++++++++
 hack/gen-swagger-doc/gen-swagger-docs.sh | 53 ++++++++++++++++++++++++
 3 files changed, 87 insertions(+)
 create mode 100644 hack/gen-swagger-doc/build.gradle
 create mode 100755 hack/gen-swagger-doc/gen-swagger-docs.sh

diff --git a/.gitignore b/.gitignore
index d2b9da3fb279..13d120d95267 100644
--- a/.gitignore
+++ b/.gitignore
@@ -22,3 +22,6 @@ hack/config-local.sh
 tags
 .Gopkg.*
 .GeneratedDockerfile
+.gradle
+*.adoc
+html5
diff --git a/hack/gen-swagger-doc/build.gradle b/hack/gen-swagger-doc/build.gradle
new file mode 100644
index 000000000000..2a488ddcde91
--- /dev/null
+++ b/hack/gen-swagger-doc/build.gradle
@@ -0,0 +1,31 @@
+buildscript {
+    repositories {
+        mavenLocal()
+        jcenter()
+    }
+
+    dependencies {
+        classpath "io.github.swagger2markup:swagger2markup:1.3.1"
+        classpath "org.asciidoctor:asciidoctor-gradle-plugin:1.5.6"
+    }
+}
+
+apply plugin: 'org.asciidoctor.convert'
+
+task gendocs << {
+  io.github.swagger2markup.Swagger2MarkupConverter
+    .from(java.nio.file.Paths.get("./api/openapi-spec/swagger.json"))
+    .build()
+    .toFolder(java.nio.file.Paths.get("./hack/gen-swagger-doc"));
+}
+
+asciidoctor {
+  sourceDir = file('./')
+  sources {
+    // paths.adoc is being renamed to operations.adoc by gen-swagger-docs.sh.
+    // Keeping it here in case somebody run: gradle gendocs asciidoctor
+    include 'definitions.adoc', 'overview.adoc', 'paths.adoc',  'security.adoc', 'operations.adoc'
+  }
+  outputDir = file('./')
+  attributes 'toc' : 'right'
+}
diff --git a/hack/gen-swagger-doc/gen-swagger-docs.sh b/hack/gen-swagger-doc/gen-swagger-docs.sh
new file mode 100755
index 000000000000..020d83f12097
--- /dev/null
+++ b/hack/gen-swagger-doc/gen-swagger-docs.sh
@@ -0,0 +1,53 @@
+#!/bin/bash
+
+set -o errexit
+set -o nounset
+set -o pipefail
+
+VERSION="${1:-v1}"
+WORKDIR="hack/gen-swagger-doc"
+GRADLE_BUILD_FILE="$WORKDIR/build.gradle"
+
+# Generate *.adoc files from swagger.json
+gradle -b $GRADLE_BUILD_FILE gendocs --info
+
+#insert a TOC for top level API objects
+buf="== Top Level API Objects\n\n"
+top_level_models=$(grep '&[A-Za-z]*{},' pkg/api/${VERSION}/types.go | sed 's/.*&//;s/{},//')
+
+# check if the top level models exist in the definitions.adoc. If they exist,
+# their name will be <version>.<model_name>
+for m in $top_level_models
+do
+  if grep -xq "=== ${VERSION}.$m" "$WORKDIR/definitions.adoc"
+  then
+    buf+="* <<${VERSION}.$m>>\n"
+  fi
+done
+sed -i "1i $buf" "$WORKDIR/definitions.adoc"
+
+# fix the links in .adoc, replace <<x,y>> with link:definitions.html#_x[y], and lowercase the _x part
+sed -i -e 's|<<\(.*\),\(.*\)>>|link:#\L\1\E[\2]|g' "$WORKDIR/definitions.adoc"
+sed -i -e 's|<<\(.*\),\(.*\)>>|link:./definitions.html#\L\1\E[\2]|g' "$WORKDIR/paths.adoc"
+
+# change the title of paths.adoc from "paths" to "operations"
+sed -i 's|== Paths|== Operations|g' "$WORKDIR/paths.adoc"
+mv -f "$WORKDIR/paths.adoc" "$WORKDIR/operations.adoc"
+
+# $$ has special meaning in asciidoc, we need to escape it
+sed -i 's|\$\$|+++$$+++|g' "$WORKDIR/definitions.adoc"
+
+# Add links to definitons & operations under overview
+cat >> "$WORKDIR/overview.adoc" << __END__
+== KubeVirt API Reference
+[%hardbreaks]
+* link:./definitions.html[Types Definition]
+* link:./operations.html[Operations]
+
+__END__
+
+
+# Generate *.html files from *.adoc
+gradle -b $GRADLE_BUILD_FILE asciidoctor --info
+
+echo "SUCCESS"