diff --git a/.gitignore b/.gitignore index 7701104..62bee05 100644 --- a/.gitignore +++ b/.gitignore @@ -2,4 +2,5 @@ /.gradle /build /out -.DS_Store \ No newline at end of file +.DS_Store +pubring.gpg diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 0000000..5cd0b85 --- /dev/null +++ b/.travis.yml @@ -0,0 +1,44 @@ +language: java +jdk: oraclejdk8 +before_cache: + - rm -f $HOME/.gradle/caches/modules-2/modules-2.lock + - rm -fr $HOME/.gradle/caches/*/plugin-resolution/ +cache: + directories: + - $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: $GITHUB_ACCESS_TOKEN + on: + tags: true + + # Trigger JitPack to build + - provider: script + script: .travis/jitpack.sh $JITPACK_ACCESS_TOKEN $TRAVIS_TAG + on: + tags: true + + # Trigger Travis CI to deploy `extractor.java` + - provider: script + script: .travis/extractor.sh $TRAVIS_ACCESS_TOKEN + on: + 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= + # JITPACK_ACCESS_TOKEN + - secure: A+f57e4haNAGvWEJCz4uN9gEZsRq0Pz1M5V4AfdguJx1IbzedngxZwFMHm9oIVFnxyhpdJGguj1oX+suW+VZjBNhQ6/xats/H2YzP10mauTB84w9KSJTVymL/SyaDs6IbAcdSjAYirCOiqQ6l4YuCMToGjbc0BHMnFPPzJpu2TduVJtqOKcXc4TpA9L/heIvpE8psFw/yl9gToXmO5bGYyaeVltaiAd+045mbieCE4z7Tvb4zPCNeqDYiY9hwwZRID1JJMw8I4RYxUTv6QebWCZPjjKqp0/yz0OCdMjdqdPWEBdnHDi59+VNgaaUd7qqZcruQiI5GzojSz2Q/1dGHveXkOmtWbS/E8c9VF36hvK3Z4oqiNfPWgXFj188+cguPTF/ABcrz9oTyIh8mwHhLYgXWQjWE9pWddJ6FDdyGqtyaAPe1lOF4SR3qqSTuxNdVsx9Ll0VZPGVhWMmrUr6kJfhIIW/eCrUwsQVGoJoeYQEcf3EGEEa/NtzHdNbITy3EZ68Gg29Pf6T+dJE/HtnuMrMvLeaKRovk/Ry60yDPIwTQohBCl3r6uL2pSj7hxacP2byeAB4CxxweBeX/pPIEP6LzqYOdmJ9Tv42JgPFYlbf8gjXS2arJTl3+sOALWgKYO9wsFnCxaP3739j1l6W01hp1Xpc2px0c9+faSMzvRE= \ No newline at end of file diff --git a/.travis/extractor.sh b/.travis/extractor.sh new file mode 100755 index 0000000..06b4f15 --- /dev/null +++ b/.travis/extractor.sh @@ -0,0 +1,22 @@ +#!/usr/bin/env bash + +TRAVIS_ACCESS_TOKEN=$1 +GITHUB_USER="algorithm-visualizer" +GITHUB_REPO="extractor.java" +BODY="{ + \"request\": { + \"branch\": \"master\" + } +}" + +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 diff --git a/.travis/jitpack.sh b/.travis/jitpack.sh new file mode 100755 index 0000000..31b6039 --- /dev/null +++ b/.travis/jitpack.sh @@ -0,0 +1,27 @@ +#!/usr/bin/env bash + +JITPACK_ACCESS_TOKEN=$1 +TRAVIS_TAG=$2 +GROUP_ID="org.algorithm-visualizer" +ARTIFACT_ID="tracers.java" +MAX_RETRIES=42 +INTERVAL=5 + +# Remove the artifact of the same version if it already exists +curl -u${JITPACK_ACCESS_TOKEN}: -X DELETE "https://jitpack.io/api/builds/${GROUP_ID}/${ARTIFACT_ID}/${TRAVIS_TAG}" + +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 diff --git a/README.md b/README.md index f1366e4..674edf6 100644 --- a/README.md +++ b/README.md @@ -1,30 +1,100 @@ -# 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) -> `tracers.java` is a visualization library for Java. +> This repository is part of the project [Algorithm Visualizer](https://github.com/algorithm-visualizer). -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" } + } + } + ``` + +2. Add the dependency. + ```gradle + dependencies { + implementation 'org.algorithm-visualizer:tracers.java:+' + } + ``` -1. Download `algorithm-visualizer.jar` in the [latest release](https://github.com/algorithm-visualizer/tracers.java/releases/latest). +### Maven +1. Add the JitPack repository to `pom.xml`. + ```xml + + + jitpack.io + https://jitpack.io + + + ``` -2. Add it to the classpath. +2. Add the dependency. + ``` + + org.algorithm-visualizer + tracers.java + [1.0.0,) + + ``` ## Usage ```java +// import visualization libraries { import org.algorithm_visualizer.*; +// } class Main { - public static void main(String[] args) { - LogTracer logTracer = new LogTracer("Scratch Paper"); + // define tracer variables { + Array2DTracer array2dTracer = new Array2DTracer("Grid"); + LogTracer logTracer = new LogTracer("Console"); + // } + + // define input variables + String[] messages = { + "Visualize", + "your", + "own", + "code", + "here!", + }; - logTracer.print("Visualize your own algorithm here!"); + // highlight each line of messages recursively + void highlight(int line) { + if (line >= messages.length) return; + String message = messages[line]; + // visualize { + logTracer.println(message); + array2dTracer.selectRow(line, 0, message.length() - 1); + Tracer.delay(); + array2dTracer.deselectRow(line, 0, message.length() - 1); + // } + highlight(line + 1); + } + + Main() { + // visualize { + Layout.setRoot(new VerticalLayout(new Commander[]{array2dTracer, logTracer})); + array2dTracer.set(messages); + Tracer.delay(); + // } + highlight(0); + } + + public static void main(String[] args) { + new Main(); } } ``` -Check out the [API reference](https://github.com/algorithm-visualizer/algorithm-visualizer/wiki) for more information. +Check out the [API reference](https://algorithm-visualizer.github.io/tracers.java/) for more information. ## Contributing diff --git a/build.gradle b/build.gradle index 7053e5e..843d83b 100644 --- a/build.gradle +++ b/build.gradle @@ -1,10 +1,8 @@ -plugins { - id 'com.github.johnrengelman.shadow' version '2.0.4' - id 'java-library' -} +apply plugin: 'java-library' +apply plugin: 'maven' -group = 'org.algorithm_visualizer' -version = '2.3.1' +group = 'org.algorithm-visualizer' +version = '2.3.10' sourceCompatibility = 1.8 repositories { @@ -15,4 +13,17 @@ dependencies { implementation 'com.google.code.gson:gson:2.8.5' } -shadowJar.archiveName = 'algorithm-visualizer.jar' +task sourcesJar(type: Jar) { + classifier = 'sources' + from sourceSets.main.allSource +} + +task javadocJar(type: Jar) { + classifier = 'javadoc' + from javadoc +} + +artifacts { + archives sourcesJar + archives javadocJar +} diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties index d2c45a4..44e7c4d 100644 --- a/gradle/wrapper/gradle-wrapper.properties +++ b/gradle/wrapper/gradle-wrapper.properties @@ -1,5 +1,5 @@ distributionBase=GRADLE_USER_HOME distributionPath=wrapper/dists -distributionUrl=https\://services.gradle.org/distributions/gradle-4.8-bin.zip +distributionUrl=https\://services.gradle.org/distributions/gradle-5.2.1-bin.zip zipStoreBase=GRADLE_USER_HOME zipStorePath=wrapper/dists diff --git a/settings.gradle b/settings.gradle deleted file mode 100644 index f780d24..0000000 --- a/settings.gradle +++ /dev/null @@ -1 +0,0 @@ -rootProject.name = 'tracers' diff --git a/src/test/java/org/algorithm_visualizer/Test.java b/src/test/java/org/algorithm_visualizer/Test.java index c8f1969..3f41bb7 100644 --- a/src/test/java/org/algorithm_visualizer/Test.java +++ b/src/test/java/org/algorithm_visualizer/Test.java @@ -40,6 +40,6 @@ void highlight(int line) { } public static void main(String[] args) { - new Test(); + throw new Error("aweg"); } }