Automate publishing Javadoc and deploying extractor.java

Author: 64json

.travis.yml

@@ -5,12 +5,38 @@ before_cache:
   - rm -fr $HOME/.gradle/caches/*/plugin-resolution/
 cache:
   directories:
-    - $HOME/.gradle/caches/
-    - $HOME/.gradle/wrapper/
+    - "$HOME/.gradle/caches/"
+    - "$HOME/.gradle/wrapper/"
 deploy:
+  # Publish Javadoc to GitHub Pages
+  - provider: pages
+    skip_cleanup: true
+    github_token: $GITHUB_ACCESS_TOKEN
+    local_dir: build/docs/javadoc
+    keep_history: true
+    on:
+      tags: true
+
+  # Create a GitHub release
   - provider: releases
-    api_key:
-      secure: Va5i+Jn2pDMm+65t3rA7rA7AkOl0zmQhecCXkvHTdxq/ETWlWGlt9YBN17wWW8rHQx4BPfN/PSpvisTaevTyWBlc7bVnHJlPOBVYk13El0q8H45EMmNuGZveL9suN7q+l6oZk3ZHA8Y5OCHr7jvnXnMa5XfBM5N1am27lFXrSx/+CsPyVnmP+m2g2U0iLAJNnW4H/eU3hJzKsf9LwbPlLGdH6t1CdOQOhBsMr/yOe3ThRjkRQ49XGwl8XXewkA7AsItGUxBQkAqMBwv5NuiGCcNK7oiiDGI8z8ZDZasedHzWlx9NgIdCLv6XGXV/5UK/MsuFjF2V+Bx4WRryh7ERwjMmcucutEejpxO/zlPwdKD6nCmcYZQmR9ITlp2v1Efn41p7x/uyFfmIGJGNTJ3hLK5uHPQSn+ahCbF/0y5Mbwz3u8U0mYxukOKHRoJs812ubezsM2IOvyPCkYtBiSHVLB13l9uuWZfVU85nUuyHzcLMacIvqic7YxDgbbP4c4ZW8kYeHONRGu+sgWj00iLMRClcjR+UdjISEqBxa36XCxUVaHq3btVnhiUq37YBLoorEtxN1Pz27JGAmxDlTm9s3cx4FLW+A1CbAg17D6eg9tqziOkcBEzAkAD0DvH/GWEZkuSuE3aiujJTc7qhOWONU3WR062Ow/c6QU2bCMpQPOs=
+    api_key: $GITHUB_ACCESS_TOKEN
+    on:
+      tags: true
+
+  # Trigger JitPack to build
+  - provider: script
+    script: .travis/jitpack.sh $TRAVIS_TAG
+    on:
+      tags: true
+
+  # Trigger Travis CI to deploy `extractor.java`
+  - provider: script
+    script: .travis/extractor.sh $TRAVIS_TAG $TRAVIS_ACCESS_TOKEN
     on:
-      branch: master
       tags: true
+env:
+  global:
+    # GITHUB_ACCESS_TOKEN
+    - secure: hEgt5ke7q8FouZlRjKTq6eXWSKOAzEK3Li8ffBl7WdcXgorRH7C6dY4aXldHNaG4+R2FCOSzwf8ke5XYZRJT/J45QKWAapJ/hTOqzjD2kWBf0sBcshLrSsyKWx3o6n0jaO8Owv+pgw0f4IcEIOoGW0Lj6Sq1RmErn6i8Whi9FIV9BSKG/ICpyPA+iqqpwYdZzP87D/w4wrlYzSOwLfmM08m46n/xsBiazNFH+Urj4/a9Lo2doA6FoCcFyc8wPQ0naX/y1Mj2UyJdlhVAqgmHGZ06DWpl8sUAXos/gCLOrSRgittjyDh+echRsziIJCBuIHdx1vSyUWiGpLzrb42FM6QuD0GoqqXbK84dm9rdK43rO/jBbGgib5xJK3itguqRk6BlSgMoYMZ5Fiv4uo42UDwgz+XF6xfw84eJdbwk+GtGzN5VgH9Qgnkl6sDsEkvPUAR6tlXvqP8s9Jkvkc4Xte4pXDL/m8Penv3ZBfwGsQQXB6tYEVS452HbhqPPRgrGM0LTGXIf/GyfLq2wEl1xVHZNcb7IP/I61X5A6B9szhtITqft6YEmAgyB8wdoQh8g/7pl8cFIh1kRvzS/MzMBaYhORS1kDbukYFLvscVwLwedUohsNlfpek744E1OUP26YYxwPF1NU2ym1R/hZ/M8O/C2gwAa8bZtRKQcQDDv/GY=
+    # TRAVIS_ACCESS_TOKEN
+    - secure: r2CXlCj8MkmlF+TPpBaRXy8Kl7leMAY5LrkUcQ4dU0MvCoAH1oGmGTitCIfjny0AFhCaGZu7jelTGI2SqZ115c1HYF/e4sXglrXWRU84LZjR+zro8hHmGTXrYZfhO5zYHmQYU6CfO8N5LWFlAzPgxrgRVJRKTyxv1JEc/dhIY0zjdbxE4cdCCIsLykPA6YG65w8OJbMnP4iZugmoBumh+Nr51bg8Ml72new8z6amVjKQC+xBVdwR+WWHPa7OE77B5eRd55jlLuUc9P8KZjYXm5VMVEQJnuTtI2X7roTDVszXGNT3cVCJQH44m3H4w1W8GHFU+SBOiyO4Yu0f0ecncvuH/P0LrwGvxotkpZiDK7CIfAoJKrNiCitUcU8ouuE+vX1wLio30L3CkrWxSHryp/MPYQTES1s26MeXuISf2R+twozmXQg/Cnpxw5WS8txzKNbwISlEJVXYMn80qHs7Jk9yGVzxgWEF3TZyWJwupRZbpruzQzz9+khPkyvyZd5kICb+85nL1Pxdbp3IirIoBJ40opnDahFWbx+KAkEx9OcVcxofDGr2gqRu15VW2OPhVE4NMtxMFeXFp+rhec32Pj2nhxk+IU8DwhG26yw/g/uUchIAN/7QXrppPsHY1D6hwtAkdg/42lZdzJHnivebLE58biRlFumBa24i4uyMWXU=

.travis/extractor.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+TRAVIS_TAG=$1
+TRAVIS_ACCESS_TOKEN=$2
+GITHUB_USER="algorithm-visualizer"
+GITHUB_REPO="extractor.java"
+
+BODY="{
+  \"request\": {
+    \"branch\": \"master\",
+    \"config\": {
+      \"env\": {
+        \"TRACERS_VERSION\": \"${TRAVIS_TAG}\"
+      }
+    }
+  }
+}"
+
+STATUS_CODE=$(curl -s -o /dev/stderr -w "%{http_code}" -X POST \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json" \
+  -H "Travis-API-Version: 3" \
+  -H "Authorization: token ${TRAVIS_ACCESS_TOKEN}" \
+  -d "${BODY}" \
+  "https://api.travis-ci.com/repo/${GITHUB_USER}%2F${GITHUB_REPO}/requests")
+
+if [[ ${STATUS_CODE} != 2* ]]; then
+    exit 1
+fi

.travis/jitpack.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+TRAVIS_TAG=$1
+MAX_RETRIES=42
+INTERVAL=5
+
+for (( i=1; i<=MAX_RETRIES; ++i)); do
+  STATUS_CODE=$(curl -s -o /dev/stderr -w "%{http_code}" \
+    -H "Content-Type: application/json" \
+    -H "Accept: application/json" \
+    -H "Travis-API-Version: 3" \
+    "https://jitpack.io/org/algorithm-visualizer/tracers.java/${TRAVIS_TAG}/tracers.java-${TRAVIS_TAG}.pom")
+  if [[ ${STATUS_CODE} == 2* ]]; then
+    exit 0
+  fi
+  echo " (${i}/${MAX_RETRIES})"
+  if [[ ${i} < ${MAX_RETRIES} ]]; then
+    sleep ${INTERVAL}
+  fi
+done
+exit 1

README.md

@@ -1,24 +1,45 @@
-# tracers.java [![Maven Central](https://img.shields.io/maven-central/v/org.algorithm-visualizer/tracers-java.svg?style=flat-square)](https://search.maven.org/artifact/org.algorithm-visualizer/tracers-java) [![API reference](https://img.shields.io/badge/documentation-java-red.svg?style=flat-square)](https://javadoc.io/doc/org.algorithm-visualizer/tracers-java/) [![Travis (.com)](https://img.shields.io/travis/com/algorithm-visualizer/tracers.java.svg?style=flat-square)](https://travis-ci.com/algorithm-visualizer/tracers.java)
+# tracers.java [![JitPack](https://img.shields.io/jitpack/v/github/algorithm-visualizer/tracers.java.svg?style=flat-square)](https://jitpack.io/#org.algorithm-visualizer/tracers.java) [![API reference](https://img.shields.io/badge/documentation-java-red.svg?style=flat-square)](https://algorithm-visualizer.github.io/tracers.java/) [![Travis (.com)](https://img.shields.io/travis/com/algorithm-visualizer/tracers.java.svg?style=flat-square)](https://travis-ci.com/algorithm-visualizer/tracers.java)
 
 > This repository is part of the project [Algorithm Visualizer](https://github.com/algorithm-visualizer).
 
 `tracers.java` is a visualization library for Java.
 You can use it on [algorithm-visualizer.org](https://algorithm-visualizer.org/) or locally on your machine.
 
 ## Installation
+### Gradle
+1. Add the JitPack repository to `build.gradle`.
+    ```gradle
+    allprojects {
+      repositories {
+        jcenter()
+        maven { url "https://jitpack.io" }
+      }
+    }
+    ```
 
-- Gradle
+2. Add the dependency.
     ```gradle
     dependencies {
-      implementation 'org.algorithm-visualizer:tracers-java:+'
+      implementation 'org.algorithm-visualizer:tracers.java:+'
     }
     ```
 
-- Maven
+### Maven
+1. Add the JitPack repository to `pom.xml`.
     ```xml
+    <repositories>
+      <repository>
+          <id>jitpack.io</id>
+          <url>https://jitpack.io</url>
+      </repository>
+    </repositories>
+    ```
+
+2. Add the dependency.
+    ```
     <dependency>
       <groupId>org.algorithm-visualizer</groupId>
-      <artifactId>tracers-java</artifactId>
+      <artifactId>tracers.java</artifactId>
       <version>[1.0.0,)</version>
     </dependency>
     ```
@@ -37,7 +58,7 @@ class Main {
 }
 ```
 
-Check out the [API reference](https://javadoc.io/doc/org.algorithm-visualizer/tracers-java/) for more information.
+Check out the [API reference](https://algorithm-visualizer.github.io/tracers.java/) for more information.
 
 ## Contributing
 

build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'java-library'
 apply plugin: 'maven'
 
 group = 'org.algorithm-visualizer'
-version = '2.3.7'
+version = '2.3.8'
 sourceCompatibility = 1.8
 
 repositories {