README.md

@@ -31,7 +31,7 @@ Install CodeRoad from [this link in the VSCode Marketplace](https://marketplace.
 
 - OS: MacOS, Linux (Windows coming soon #227)
 - VSCode 1.40+
-- Node.js 12+ (10+ soon #237)
+- Node.js 10+
 - Git
 
 ## Creating Tutorials

errors/MissingTutorialDependency.md

@@ -0,0 +1,3 @@
+### Missing Tutorial Dependency
+
+The tutorial cannot run because it a dependency is not yet installed. Install the dependency and click "Check Again".

errors/UnmetTutorialDependency.md

@@ -0,0 +1,5 @@
+### Unmet Tutorial Dependency
+
+### Unmet Tutorial Dependency
+
+Tutorial cannot reun because a dependency version doesn't match. Install the correct dependency and click "Check Again".

package.json

@@ -39,6 +39,7 @@
     "@types/jest": "^25.2.1",
     "@types/jsdom": "^16.2.0",
     "@types/node": "^13.11.0",
+    "@types/semver": "^7.1.0",
     "@typescript-eslint/eslint-plugin": "^2.26.0",
     "@typescript-eslint/parser": "^2.26.0",
     "chokidar": "^3.3.0",
@@ -49,6 +50,7 @@
     "jest": "^25.2.7",
     "jsdom": "^16.2.2",
     "prettier": "^2.0.2",
+    "semver": "^7.2.2",
     "ts-jest": "^25.3.1",
     "typescript": "^3.8.3"
   },

src/channel/index.ts

@@ -9,11 +9,12 @@ import tutorialConfig from '../actions/tutorialConfig'
 import { COMMANDS } from '../editor/commands'
 import logger from '../services/logger'
 import Context from './context'
-import { version as gitVersion } from '../services/git'
+import { version, compareVersions } from '../services/dependencies'
 import { openWorkspace, checkWorkspaceEmpty } from '../services/workspace'
 import { readFile } from 'fs'
 import { join } from 'path'
 import { promisify } from 'util'
+import { compare } from 'semver'
 
 const readFileAsync = promisify(readFile)
 
@@ -94,6 +95,55 @@ class Channel implements Channel {
         // setup tutorial config (save watcher, test runner, etc)
         await this.context.setTutorial(this.workspaceState, data)
 
+        // validate dependencies
+        if (data.config.dependencies) {
+          for (const dep of data.config.dependencies) {
+            // check dependency is installed
+            const currentVersion: string | null = await version(name)
+            if (!currentVersion) {
+              // use a custom error message
+              const error = {
+                type: 'MissingTutorialDependency',
+                message: dep.message || `Process ${name} is required but not found. It may need to be installed`,
+                actions: [
+                  {
+                    label: 'Check Again',
+                    transition: 'TRY_AGAIN',
+                  },
+                ],
+              }
+              this.send({ type: 'TUTORIAL_CONFIGURE_FAIL', payload: { error } })
+              return
+            }
+
+            // check dependency version
+            const satisfiedDependency = await compareVersions(currentVersion, dep.version).catch((error: Error) => ({
+              type: 'UnmetTutorialDependency',
+              message: error.message,
+              actions: [
+                {
+                  label: 'Check Again',
+                  transition: 'TRY_AGAIN',
+                },
+              ],
+            }))
+            if (satisfiedDependency !== true) {
+              const error = satisfiedDependency || {
+                type: 'UnknownError',
+                message: `Something went wrong comparing dependency for ${name}`,
+                actions: [
+                  {
+                    label: 'Try Again',
+                    transition: 'TRY_AGAIN',
+                  },
+                ],
+              }
+              this.send({ type: 'TUTORIAL_CONFIGURE_FAIL', payload: { error } })
+              return
+            }
+          }
+        }
+
         const error: E.ErrorMessage | void = await tutorialConfig({ config: data.config }).catch((error: Error) => ({
           type: 'UnknownError',
           message: `Location: tutorial config.\n\n${error.message}`,
@@ -144,7 +194,7 @@ class Channel implements Channel {
         }
         // 2. check Git is installed.
         // Should wait for workspace before running otherwise requires access to root folder
-        const isGitInstalled = await gitVersion()
+        const isGitInstalled = await version('git')
         if (!isGitInstalled) {
           const error: E.ErrorMessage = {
             type: 'GitNotFound',

src/services/dependencies/index.ts

@@ -0,0 +1,25 @@
+import * as TT from 'typings/tutorial'
+import { satisfies } from 'semver'
+import node from '../node'
+
+const semverRegex = /(?<=^v?|\sv?)(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-(?:0|[1-9]\d*|[\da-z-]*[a-z-][\da-z-]*)(?:\.(?:0|[1-9]\d*|[\da-z-]*[a-z-][\da-z-]*))*)?(?:\+[\da-z-]+(?:\.[\da-z-]+)*)?(?=$|\s)/gi
+
+export const version = async (name: string): Promise<string | null> => {
+  const { stdout, stderr } = await node.exec(`${name} --version`)
+  if (!stderr) {
+    const match = stdout.match(semverRegex)
+    if (match) {
+      return match[0]
+    }
+  }
+  return null
+}
+
+export const compareVersions = async (currentVersion: string, expectedVersion: string): Promise<never | boolean> => {
+  // see node-semver docs: https://github.com/npm/node-semver
+  const satisfied: boolean = satisfies(currentVersion, expectedVersion)
+  if (!satisfied) {
+    throw new Error(`Expected ${name} to have version ${expectedVersion}, but found version ${currentVersion}`)
+  }
+  return true
+}

src/services/git/index.ts

@@ -69,19 +69,6 @@ export async function clear(): Promise<Error | void> {
   throw new Error('Error cleaning up current unsaved work')
 }
 
-export async function version(): Promise<string | null> {
-  const { stdout, stderr } = await node.exec('git --version')
-  if (!stderr) {
-    const match = stdout.match(/^git version (\d+\.)?(\d+\.)?(\*|\d+)/)
-    if (match) {
-      // eslint-disable-next-line
-      const [_, major, minor, patch] = match
-      return `${major}${minor}${patch}`
-    }
-  }
-  return null
-}
-
 async function init(): Promise<Error | void> {
   const { stderr } = await node.exec('git init')
   if (stderr) {

typings/tutorial.d.ts

@@ -3,6 +3,7 @@ export type Maybe<T> = T | null
 export type TutorialConfig = {
   testRunner: TutorialTestRunner
   repo: TutorialRepo
+  dependencies?: TutorialDependency[]
 }
 
 /** Logical groupings of tasks */
@@ -57,3 +58,9 @@ export interface TutorialRepo {
   uri: string
   branch: string
 }
+
+export interface TutorialDependency {
+  name: string
+  version: string
+  message?: string
+}