feat: add function to check if artifact is available on repo.

Author: iocanel

README.org

@@ -3,6 +3,7 @@
 
 ** Features
 *** automating releases
+*** check if artifact is available on repo.
 
 ** Automating Releases
 
@@ -30,3 +31,30 @@
    | --staging-profile-id | false    | The staging profile id (as seen in the nexus console) |
    | --nexus-rul          | false    | The nexus server url                                  |
    | --dry-run            | false    | Dry run. No release will take place                   |
+
+** Checking if artifact is available on repository.   
+   
+   When automating a release process its often desirable to wait until the release is available and synchronization of artifacts to the target repository has been completed.
+   For this purpose *is_release_available* has been created. This function accepts two arguments (groupId, artifactId and version) and optionally the repository url and return true or false.   
+
+
+   | Option     | Required | Description                                                  |
+   |------------+----------+--------------------------------------------------------------|
+   | --repo-url | true     | The url of the target repository (including the path prefix) |
+   |            |          |                                                              |
+
+This function is meant to be used along with a polling mechanism. 
+
+For example it can play nicely with [[https://github.com/shellib/wait][shellib's wait utility]].
+
+#+BEGIN_SRC shell
+  #!/bin/bash
+  source $(grab github.com/shellib/maven)
+  source $(grab github.com/shellib/wait)
+
+  is_on_central() {
+      is_release_available my.group.id my-artifact-id 1.0.0
+  }
+
+  wait_for --function is_on_central --backoff-multiplier 3 --max-wait-time 7200
+#+END_SRC

library.sh

@@ -6,6 +6,8 @@ DEFAULT_NEXUS_URL="https://oss.sonatype.org"
 DEFAULT_NEXUS_STAGING_PLUGIN_VERSION="1.6.8"
 DEFAULT_NEXUS_SERVER_ID="oss-sonatype-staging"
 
+DEFAULT_REPO_URL="http://repo1.maven.org/maven2"
+
 REPO_ANNOUNCEMENT_PREFIX="OpenedStagingProfile"
 
 
@@ -62,6 +64,26 @@ drop_staging_repository() {
     with_staging_repository "drop" $*
 }
 
+#
+# Check if maven release is available
+is_release_available() {
+    local groupId=$1
+    local artifactId=$2
+    local version=$3
+
+    if [ -z "$groupId" ] || [ -z "$artifactId" ] || [ -z "$version" ]; then
+        exit 1
+    fi
+
+    local repo_url=$(or $(readopt --repo-url $*) $DEFAULT_REPO_URL)
+    local group_path=`echo $groupId | sed "s/\./\//g"`
+    local artifact_url="$repo_url/$group_path/$artifactId/$version/"
+    local status_code=`curl -o /dev/null -sw '%{http_code}' $artifact_url`
+    if [ $status_code -eq 200 ]; then
+        echo "true"
+    fi
+}
+
 #
 # Performs the actual release
 maven_release() {

library_test.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+source ./library.sh 
+
+# Test Cases
+should_succeed() {
+    result=`is_release_available io.fabric8 kubernetes-client 3.1.12`
+    if [ "$result" != "true" ]; then
+        echo "FAIL: Release for groupId: io.fabric8 artfactId: kubernetes-client version: 3.1.12 exist, but got negative response: $result!"
+        exit 1
+    fi
+}
+
+
+should_fail() {
+    result=`is_release_available this artifact does not exist`
+    if [ "$result" == "true" ]; then
+        echo "FAIL: Release doesn't exist but got positive response: $result!"
+        exit 1
+    fi
+}
+
+
+should_succeed
+should_fail