Merge pull request #201 from saucelabs/1.1.0_master

Prepare release

Author: sceiler

.github/workflows/java-ci.yml

@@ -8,10 +8,10 @@ jobs:
 
     steps:
       - uses: actions/checkout@v2
-      - name: Set up JDK 8
+      - name: Set up JDK 11
         uses: actions/setup-java@v2
         with:
-          java-version: '8'
+          java-version: '11'
           distribution: 'zulu'
       - name: Build with Maven
         run: mvn clean install -Dgpg.skip -B -V

src/main/java/com/saucelabs/saucerest/ErrorExplainers.java

@@ -61,4 +61,12 @@ static String LogNotFound() {
             " * A error occurred where the job was created on Sauce Labs but no test were executed."
         );
     }
+
+    static String TunnelNotFound() {
+        return String.join(System.lineSeparator(),
+            " * Tunnel id could not be found. Possible reasons:",
+            " * The tunnel id requested does not exist in this data center. Ensure the data center endpoint is correct.",
+            " * A tunnel with this id never existed."
+        );
+    }
 }

src/main/java/com/saucelabs/saucerest/HttpMethod.java

@@ -0,0 +1,17 @@
+package com.saucelabs.saucerest;
+
+public enum HttpMethod {
+    GET("GET"),
+    POST("POST"),
+    PUT("PUT"),
+    DELETE("DELETE"),
+    PATCH("PATCH"),
+    HEAD("HEAD"),
+    OPTIONS("OPTIONS");
+
+    public final String label;
+
+    HttpMethod(String label) {
+        this.label = label;
+    }
+}

src/main/java/com/saucelabs/saucerest/JobSource.java

@@ -0,0 +1,6 @@
+package com.saucelabs.saucerest;
+
+public enum JobSource {
+    RDC,
+    VDC,
+}

src/main/java/com/saucelabs/saucerest/SauceException.java

@@ -32,6 +32,16 @@ public NotAuthorized() {
         }
     }
 
+    public static class NotFound extends SauceException {
+
+        public NotFound(String message) {
+            super(message);
+        }
+
+        public NotFound() {
+        }
+    }
+
     public static class TooManyRequests extends SauceException {
     }
 

src/main/java/com/saucelabs/saucerest/SauceREST.java

@@ -0,0 +1,41 @@
+package com.saucelabs.saucerest;
+
+import javax.crypto.Mac;
+import javax.crypto.spec.SecretKeySpec;
+import java.security.InvalidKeyException;
+import java.security.NoSuchAlgorithmException;
+
+import static java.nio.charset.StandardCharsets.US_ASCII;
+
+/**
+ * Class providing a method to create a shareable test results link of a test executed on Sauce Labs.
+ */
+public class SauceShareableLink {
+    /**
+     * Based on the code from here: https://docs.saucelabs.com/test-results/sharing-test-results/index.html#example---java
+     * @param username Sauce Labs username
+     * @param accessKey Sauce Labs access key
+     * @param sauceJobId Sauce Labs job id
+     * @param server Sauce Labs data center endpoint
+     * @return A url of the test result with an authentication token, so it can be accessed without Sauce Labs credentials.
+     * @throws NoSuchAlgorithmException
+     * @throws InvalidKeyException
+     */
+    public static String getShareableLink(String username, String accessKey, String sauceJobId, String server) throws NoSuchAlgorithmException, InvalidKeyException {
+        String key = String.format("%s:%s", username , accessKey);
+        SecretKeySpec sks = new SecretKeySpec(key.getBytes(US_ASCII), "HmacMD5");
+        Mac mac = Mac.getInstance("HmacMD5");
+        mac.init(sks);
+        byte[] result = mac.doFinal(sauceJobId.getBytes(US_ASCII));
+        StringBuilder hash = new StringBuilder();
+        for (byte b : result) {
+            String hex = Integer.toHexString(0xFF & b);
+            if (hex.length() == 1) {
+                hash.append('0');
+            }
+            hash.append(hex);
+        }
+        String digest = hash.toString();
+        return String.format("%s%s/%s?auth=%s", server, "tests", sauceJobId, digest);
+    }
+}

src/main/java/com/saucelabs/saucerest/SauceShareableLink.java

@@ -0,0 +1,21 @@
+package com.saucelabs.saucerest;
+
+public enum TestAsset {
+    SAUCE_LOG("log.json"),
+    VIDEO("video.mp4"),
+    SELENIUM_LOG("selenium-server.log"),
+    AUTOMATOR_LOG("automator.log"),
+    LOGCAT_LOG("logcat.log"),
+    SYSLOG_LOG("ios-syslog.log"),
+    HAR("network.har"),
+    PERFORMANCE("performance.json"),
+    CONSOLE_LOG("console.json"),
+    SCREENSHOTS("screenshots.zip"),
+    APPIUM_LOG("appium-server.log");
+
+    public final String label;
+
+    TestAsset(String label) {
+        this.label = label;
+    }
+}