(enh) Runtime.assertVersion (#15)

* (enh) Runtime.assertVersion
* add tests for runtime

Author: joshgoebel

package.wren

@@ -7,7 +7,7 @@ class Package is WrenPackage {
   version { "0.2.90" }
   dependencies {
     return [
-      Dependency.new("wren-testie", "0.1.1", "https://github.com/joshgoebel/wren-testie.git"),
+      Dependency.new("wren-testie", "0.3.0", "https://github.com/joshgoebel/wren-testie.git"),
       Dependency.new("wren-assert", "HEAD", "https://github.com/RobLoach/wren-assert.git")
     ]
   }

src/module/runtime.wren

@@ -11,13 +11,33 @@ class Runtime {
   static NAME { "wren-console" }
   static WREN_VERSION { "0.4.0" }
   static VERSION { "0.2.91" }
+  // allows simple numeric comparison of semantic version strings
+  // by turning them into large integers
+  static versionToNumber_(v) {
+    var segments = v.split(".").map { |x| Num.fromString(x) }.toList
+    return segments[0] * 1000000 + segments[1] * 10000 + segments[2] * 100
+  }
+  // takes a semantic version string, ex "3.0.0" and aborts if the currently running
+  // version of wren-console is less than the version specified
+  //
+  // If we running Wren Console 0.3:
+  //
+  //   Runtime.assertVersion("1.0") // aborts with error about version mismatch
+  //   Runtime.assertVersion("0.1") // ok
+  //   Runtime.assertVersion("0.3") // ok
+  static assertVersion(desiredMinimalVersion) {
+    if (versionToNumber_(Runtime.VERSION) < versionToNumber_(desiredMinimalVersion)) {
+      Fiber.abort("wren-console version %(desiredMinimalVersion) or higher required.")
+    }
+  }
   static details {
     return {
       "name": Runtime.NAME,
       "wrenVersion": Runtime.WREN_VERSION,
       "version": Runtime.VERSION,
       "capabilities": [
         Capability.new("essentials"),
+        Capability.new("json"),
         Capability.new("mirror")
       ]
     }

src/module/runtime.wren.inc

@@ -15,13 +15,33 @@ static const char* runtimeModuleSource =
 "  static NAME { \"wren-console\" }\n"
 "  static WREN_VERSION { \"0.4.0\" }\n"
 "  static VERSION { \"0.2.91\" }\n"
+"  // allows simple numeric comparison of semantic version strings\n"
+"  // by turning them into large integers\n"
+"  static versionToNumber_(v) {\n"
+"    var segments = v.split(\".\").map { |x| Num.fromString(x) }.toList\n"
+"    return segments[0] * 1000000 + segments[1] * 10000 + segments[2] * 100\n"
+"  }\n"
+"  // takes a semantic version string, ex \"3.0.0\" and aborts if the currently running\n"
+"  // version of wren-console is less than the version specified\n"
+"  //\n"
+"  // If we running Wren Console 0.3:\n"
+"  //\n"
+"  //   Runtime.assertVersion(\"1.0\") // aborts with error about version mismatch\n"
+"  //   Runtime.assertVersion(\"0.1\") // ok\n"
+"  //   Runtime.assertVersion(\"0.3\") // ok\n"
+"  static assertVersion(desiredMinimalVersion) {\n"
+"    if (versionToNumber_(Runtime.VERSION) < versionToNumber_(desiredMinimalVersion)) {\n"
+"      Fiber.abort(\"wren-console version %(desiredMinimalVersion) or higher required.\")\n"
+"    }\n"
+"  }\n"
 "  static details {\n"
 "    return {\n"
 "      \"name\": Runtime.NAME,\n"
 "      \"wrenVersion\": Runtime.WREN_VERSION,\n"
 "      \"version\": Runtime.VERSION,\n"
 "      \"capabilities\": [\n"
 "        Capability.new(\"essentials\"),\n"
+"        Capability.new(\"json\"),\n"
 "        Capability.new(\"mirror\")\n"
 "      ]\n"
 "    }\n"

test/unit/runtime_test.wren

@@ -0,0 +1,29 @@
+// nontest
+import "wren-testie/testie" for Testie, Expect
+import "../../src/cli/path" for Path
+import "runtime" for Runtime
+
+Testie.test("Runtime") { |it, skip|
+  it.should("have class level constants") {
+    Expect.value(Runtime.NAME).toEqual("wren-console")
+    Expect.value(Runtime.WREN_VERSION).toEqual("0.4.0")
+    Expect.value(Runtime.VERSION).toEqual("0.2.91")
+  }
+  it.should("have details") {
+    var details = Runtime.details
+    Expect.value(details["name"]).toEqual("wren-console")
+    Expect.value(details["wrenVersion"]).toEqual("0.4.0")
+    Expect.value(details["version"]).toEqual("0.2.91")
+  }
+  it.should("assertVersion") {
+    Runtime.assertVersion("0.1.0")
+    Runtime.assertVersion("0.2.91")
+    Expect.that { Runtime.assertVersion("12.0.0") }
+      .toAbortWith("wren-console version 12.0.0 or higher required.")
+  }
+  it.should("have capabilities") {
+    var details = Runtime.details
+    Expect.value(details.where { |x| x.name == "essentials"}).toBeDefined()
+    Expect.value(details.where { |x| x.name == "json"}).toBeDefined()
+  }
+}