Add Rubygems.org version function

Added function to get latest version for a gem from rubygems.org

Related: #24

Author: hughsaunders

CHANGELOG.md

@@ -5,6 +5,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+### Added
+- Retrieve latest version for gem from rubygems.org
 
 ## [2.0.1] - 2020-02-19
 ### Added

README.md

@@ -194,6 +194,15 @@ files within it's directory.
         </ol>
       </td>
     </tr>
+    <tr>
+      <td><a href="test-utils/ruby">Ruby</a></td>
+      <td>Helpers related to ruby infrastructure</td>
+      <td>
+        <ol>
+          <li><b>bl_gem_latest_version</b>: Return the latest version of a gem from rubygems.org</li>
+        </ol>
+      </td>
+    </tr>
     <tr>
       <td><a href="test-utils/lib">test-utils</a></td>
       <td>Helpers for executing tests</td>

init

@@ -26,7 +26,7 @@ BASH_LIB_DIR="${BASH_LIB_DIR_RELATIVE}"
 
 # Load the filehandling module for the abspath
 # function
-for lib in helpers logging filehandling git github k8s test-utils; do
+for lib in helpers logging filehandling git github k8s test-utils ruby; do
     . "${BASH_LIB_DIR_RELATIVE}/${lib}/lib"
 done
 

logging/lib

@@ -68,4 +68,3 @@ function bl_error(){
 function bl_fatal(){
   bl_log fatal "${*}"
 }
-

ruby/lib

@@ -0,0 +1,10 @@
+: "${BASH_LIB_DIR:?BASH_LIB_DIR must be set. Please source bash-lib/init before other scripts from bash-lib.}"
+
+function bl_gem_latest_version(){
+    gem="${1:-}"
+    if [[ -z "${gem}" ]]; then
+        bl_fail "usage: bl_gem_version <gem name>"
+    fi
+    curl https://rubygems.org/api/v1/gems/${gem}.json \
+        |jq -r '.version'
+}

run-tests

@@ -5,11 +5,19 @@
 # shellcheck disable=SC2086
 . "$(dirname ${BASH_SOURCE[0]})/init"
 
-# Run BATS Tests
+bl_info "Checking the changelog complies with keepachangelog.com format"
+docker run \
+    --rm \
+    -v "${PWD}/CHANGELOG.md:/CHANGELOG.md" \
+    cyberark/parse-a-changelog
+
+bl_info "Running BATS Tests"
 "${BASH_LIB_DIR}/tests-for-this-repo/run-bats-tests"
 
-# Run Python Lint
+bl_info "Running Python Lint"
 "${BASH_LIB_DIR}/tests-for-this-repo/run-python-lint"
 
-# Run gitleaks
+bl_info "Running gitleaks"
 "${BASH_LIB_DIR}/tests-for-this-repo/run-gitleaks"
+
+bl_info "Sucess! All tests passed."

tests-for-this-repo/fixtures/ruby/ruby_gems_api_response.json

@@ -0,0 +1,42 @@
+{
+    "name": "parse_a_changelog",
+    "downloads": 6660,
+    "version": "1.0.1",
+    "version_downloads": 168,
+    "platform": "ruby",
+    "authors": "John Tuttle",
+    "info": "Uses a grammar describing the keep-a-changelog format to attempt to parse a given file.",
+    "licenses": [
+      "Apache-2.0"
+    ],
+    "metadata": {},
+    "yanked": false,
+    "sha": "c081ae854570083ba56097d84a1fc66d47dd31f1a015edcb1ba2cbf9e2a4fe4a",
+    "project_uri": "https://rubygems.org/gems/parse_a_changelog",
+    "gem_uri": "https://rubygems.org/gems/parse_a_changelog-1.0.1.gem",
+    "homepage_uri": "http://github.com/cyberark/parse-a-changelog",
+    "wiki_uri": null,
+    "documentation_uri": "http://www.rubydoc.info/gems/parse_a_changelog/1.0.1",
+    "mailing_list_uri": null,
+    "source_code_uri": null,
+    "bug_tracker_uri": null,
+    "changelog_uri": null,
+    "dependencies": {
+      "development": [
+        {
+          "name": "rspec",
+          "requirements": "~> 3.8"
+        },
+        {
+          "name": "rspec_junit_formatter",
+          "requirements": "~> 0.4.1"
+        }
+      ],
+      "runtime": [
+        {
+          "name": "treetop",
+          "requirements": "~> 1.6"
+        }
+      ]
+    }
+}

tests-for-this-repo/ruby.bats

@@ -0,0 +1,25 @@
+. "${BASH_LIB_DIR}/test-utils/bats-support/load.bash"
+. "${BASH_LIB_DIR}/test-utils/bats-assert-1/load.bash"
+
+. "${BASH_LIB_DIR}/init"
+
+teardown(){
+    unset curl
+}
+
+@test "bl_gem_latest_version fails when no gem name is supplied" {
+    run bl_gem_latest_version
+    assert_failure
+    assert_output --partial "usage"
+}
+
+@test "bl_gem_latest_version returns only the version number" {
+    curl(){
+        fixtures_dir="${BASH_LIB_DIR}/tests-for-this-repo/fixtures/ruby"
+        cat ${fixtures_dir}/ruby_gems_api_response.json
+    }
+
+    run bl_gem_latest_version parse_a_changelog
+    assert_success
+    assert_output "1.0.1"
+}