@learnpack/learnpack 2.1.26 → 2.1.28

package/src/managers/config/index.ts

@@ -1,24 +1,24 @@
-import * as path from "path";
-import * as fs from "fs";
-import * as shell from "shelljs";
-import Console from "../../utils/console";
-import watch from "../../utils/watcher";
+import * as path from "path"
+import * as fs from "fs"
+import * as shell from "shelljs"
+import Console from "../../utils/console"
+import watch from "../../utils/watcher"
 import {
   ValidationError,
   NotFoundError,
   InternalError,
-} from "../../utils/errors";
+} from "../../utils/errors"
 
-import defaults from "./defaults";
-import { exercise } from "./exercise";
+import defaults from "./defaults"
+import { exercise } from "./exercise"
 
-import { rmSync } from "../file";
-import { IConfigObj, TConfigObjAttributes, TMode } from "../../models/config";
+import { rmSync } from "../file"
+import { IConfigObj, TConfigObjAttributes, TMode } from "../../models/config"
 import {
   IConfigManagerAttributes,
   IConfigManager,
-} from "../../models/config-manager";
-import { IFile } from "../../models/file";
+} from "../../models/config-manager"
+import { IFile } from "../../models/file"
 
 /* exercise folder name standard */
 
@@ -30,49 +30,49 @@ const chalk = require("chalk");
 /* exercise folder name standard */
 
 const getConfigPath = () => {
-  const possibleFileNames = ["learn.json", ".learn/learn.json"];
-  const config = possibleFileNames.find(file => fs.existsSync(file)) || null;
+  const possibleFileNames = ["learn.json", ".learn/learn.json"]
+  const config = possibleFileNames.find(file => fs.existsSync(file)) || null
   if (config && fs.existsSync(".breathecode"))
-    return { config, base: ".breathecode" };
+    return { config, base: ".breathecode" }
   if (config === null)
     throw NotFoundError(
       "learn.json file not found on current folder, is this a learnpack package?"
-    );
-  return { config, base: ".learn" };
-};
+    )
+  return { config, base: ".learn" }
+}
 
 const getExercisesPath = (base: string) => {
-  const possibleFileNames = ["./exercises", base + "/exercises", "./"];
-  return possibleFileNames.find(file => fs.existsSync(file)) || null;
-};
+  const possibleFileNames = ["./exercises", base + "/exercises", "./"]
+  return possibleFileNames.find(file => fs.existsSync(file)) || null
+}
 
 const getGitpodAddress = () => {
   if (shell.exec("gp -h", { silent: true }).code === 0) {
     return shell
       .exec("gp url", { silent: true })
-      .stdout.replace(/(\r\n|\n|\r)/gm, "");
+      .stdout.replace(/(\r\n|\n|\r)/gm, "")
   }
 
-  Console.debug("Gitpod command line tool not found");
-  return "http://localhost";
-};
+  Console.debug("Gitpod command line tool not found")
+  return "http://localhost"
+}
 
 const getCodespacesNamespace = () => {
   // https://orange-rotary-phone-wxpg49q5gcg4rp-3000.app.github.dev
   const codespace_name = shell
     .exec("echo $CODESPACE_NAME", { silent: true })
-    .stdout.replace(/(\r\n|\n|\r)/gm, "");
+    .stdout.replace(/(\r\n|\n|\r)/gm, "")
 
   if (
     !codespace_name ||
     codespace_name === "" ||
     codespace_name === undefined
   ) {
-    return null;
+    return null
   }
 
-  return codespace_name;
-};
+  return codespace_name
+}
 
 export default async ({
   grading,
@@ -80,46 +80,46 @@ export default async ({
   disableGrading,
   version,
 }: IConfigManagerAttributes): Promise<IConfigManager> => {
-  const confPath = getConfigPath();
-  Console.debug("This is the config path: ", confPath);
+  const confPath = getConfigPath()
+  Console.debug("This is the config path: ", confPath)
 
-  let configObj: IConfigObj = {};
+  let configObj: IConfigObj = {}
 
   if (confPath) {
-    const bcContent = fs.readFileSync(confPath.config);
-    let hiddenBcContent = {};
+    const bcContent = fs.readFileSync(confPath.config)
+    let hiddenBcContent = {}
     if (fs.existsSync(confPath.base + "/config.json")) {
-      hiddenBcContent = fs.readFileSync(confPath.base + "/config.json");
-      hiddenBcContent = JSON.parse(hiddenBcContent as string);
+      hiddenBcContent = fs.readFileSync(confPath.base + "/config.json")
+      hiddenBcContent = JSON.parse(hiddenBcContent as string)
       if (!hiddenBcContent)
         throw new Error(
           `Invalid ${confPath.base}/config.json syntax: Unable to parse.`
-        );
+        )
     }
 
-    const jsonConfig = JSON.parse(`${bcContent}`);
+    const jsonConfig = JSON.parse(`${bcContent}`)
     if (!jsonConfig)
-      throw new Error(`Invalid ${confPath.config} syntax: Unable to parse.`);
+      throw new Error(`Invalid ${confPath.config} syntax: Unable to parse.`)
 
-    let session: number;
+    let session: number
 
     // add using id to the installation
     if (!jsonConfig.session) {
-      session = Math.floor(Math.random() * 10_000_000_000_000_000_000);
+      session = Math.floor(Math.random() * 10_000_000_000_000_000_000)
     } else {
-      session = jsonConfig.session;
-      delete jsonConfig.session;
+      session = jsonConfig.session
+      delete jsonConfig.session
     }
 
     configObj = deepMerge(hiddenBcContent, {
       config: jsonConfig,
       session: session,
-    });
-    Console.debug("Content from the configuration .json ", configObj);
+    })
+    Console.debug("Content from the configuration .json ", configObj)
   } else {
     throw ValidationError(
       "No learn.json file has been found, make sure you are in the folder"
-    );
+    )
   }
 
   configObj = deepMerge(defaults || {}, configObj, {
@@ -127,10 +127,10 @@ export default async ({
       grading: grading || configObj.config?.grading,
       configPath: confPath.config,
     },
-  });
+  })
 
   if (configObj.config) {
-    configObj.config.outputPath = confPath.base + "/dist";
+    configObj.config.outputPath = confPath.base + "/dist"
   }
 
   Console.debug("This is your configuration object: ", {
@@ -138,50 +138,50 @@ export default async ({
     exercises: configObj.exercises ?
       configObj.exercises.map(e => e.slug) :
       [],
-  });
+  })
 
   // auto detect agent (if possible)
-  const codespaces_workspace = getCodespacesNamespace();
+  const codespaces_workspace = getCodespacesNamespace()
   if (shell.which("gp") && configObj && configObj.config) {
-    configObj.config.editor.agent = "vscode";
-    configObj.address = getGitpodAddress();
+    configObj.config.editor.agent = "vscode"
+    configObj.address = getGitpodAddress()
     configObj.config.publicUrl = `https://${
       configObj.config.port
-    }-${configObj.address?.slice(8)}`;
+    }-${configObj.address?.slice(8)}`
   } else if (configObj.config && codespaces_workspace) {
-    configObj.config.editor.agent = "vscode";
-    configObj.address = `https://${codespaces_workspace}.github.dev`;
-    configObj.config.publicUrl = `https://${codespaces_workspace}-${configObj.config.port}.app.github.dev`;
+    configObj.config.editor.agent = "vscode"
+    configObj.address = `https://${codespaces_workspace}.github.dev`
+    configObj.config.publicUrl = `https://${codespaces_workspace}-${configObj.config.port}.app.github.dev`
   } else if (configObj.config && !configObj.config.editor.agent) {
-    configObj.config.editor.agent = "localhost";
+    configObj.config.editor.agent = "localhost"
   }
 
   if (configObj.config && !configObj.config.publicUrl)
-    configObj.config.publicUrl = `${configObj.address}:${configObj.config.port}`;
+    configObj.config.publicUrl = `${configObj.address}:${configObj.config.port}`
 
   // Assign default editor mode if not set already
   if (configObj.config && !mode) {
-    configObj.config.editor.mode = mode as TMode;
+    configObj.config.editor.mode = mode as TMode
   }
 
   if (configObj.config && !configObj.config.editor.mode)
     configObj.config.editor.mode =
-      configObj.config.editor.agent === "localhost" ? "standalone" : "preview";
+      configObj.config.editor.agent === "localhost" ? "standalone" : "preview"
 
   if (version && configObj.config) 
-configObj.config.editor.version = version;
+configObj.config.editor.version = version
   else if (configObj.config && configObj.config.editor.version === null) {
-    Console.debug("Config version not found, downloading default.");
+    Console.debug("Config version not found, downloading default.")
     const resp = await fetch(
       "https://raw.githubusercontent.com/learnpack/coding-ide/learnpack/package.json"
-    );
-    const packageJSON = await resp.json();
-    configObj.config.editor.version = packageJSON.version || "1.0.73";
+    )
+    const packageJSON = await resp.json()
+    configObj.config.editor.version = packageJSON.version || "1.0.73"
   }
 
   if (configObj.config) {
-    configObj.config.dirPath = "./" + confPath.base;
-    configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./";
+    configObj.config.dirPath = "./" + confPath.base
+    configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./"
   }
 
   return {
@@ -192,125 +192,125 @@ configObj.config.editor.version = version;
       const alias = (_l: string) => {
         const map: any = {
           python3: "python",
-        };
+        }
         if (map[_l]) 
-return map[_l];
-        return _l;
-      };
+return map[_l]
+        return _l
+      }
 
       // decode aliases
-      language = alias(language);
+      language = alias(language)
 
       if (this.validLanguages[language]) 
-return true;
+return true
 
-      Console.debug(`Validating engine for ${language} compilation`);
-      let result = shell.exec("learnpack plugins", { silent: true });
+      Console.debug(`Validating engine for ${language} compilation`)
+      let result = shell.exec("learnpack plugins", { silent: true })
 
       if (
         result.code === 0 &&
         result.stdout.includes(`learnpack-${language}`)
       ) {
-        this.validLanguages[language] = true;
-        return true;
+        this.validLanguages[language] = true
+        return true
       }
 
-      Console.info(`Language engine for ${language} not found, installing...`);
+      Console.info(`Language engine for ${language} not found, installing...`)
       result = shell.exec(`learnpack plugins:install learnpack-${language}`, {
         silent: true,
-      });
+      })
       if (result.code === 0) {
         socket.log(
           "compiling",
           "Installing the python compiler, you will have to reset the exercises after installation by writing on your terminal: $ learnpack run"
-        );
+        )
         Console.info(
           `Successfully installed the ${language} exercise engine, \n please start learnpack again by running the following command: \n ${chalk.white(
             "$ learnpack start"
           )}\n\n `
-        );
-        server.terminate();
-        return false;
+        )
+        server.terminate()
+        return false
       }
 
-      this.validLanguages[language] = false;
-      socket.error(`Error installing ${language} exercise engine`);
-      Console.error(`Error installing ${language} exercise engine`);
-      Console.log(result.stdout);
-      throw InternalError(`Error installing ${language} exercise engine`);
+      this.validLanguages[language] = false
+      socket.error(`Error installing ${language} exercise engine`)
+      Console.error(`Error installing ${language} exercise engine`)
+      Console.log(result.stdout)
+      throw InternalError(`Error installing ${language} exercise engine`)
     },
     clean: () => {
       if (configObj.config) {
         if (configObj.config.outputPath) {
-          rmSync(configObj.config.outputPath);
+          rmSync(configObj.config.outputPath)
         }
 
-        rmSync(configObj.config.dirPath + "/_app");
-        rmSync(configObj.config.dirPath + "/reports");
-        rmSync(configObj.config.dirPath + "/.session");
-        rmSync(configObj.config.dirPath + "/resets");
+        rmSync(configObj.config.dirPath + "/_app")
+        rmSync(configObj.config.dirPath + "/reports")
+        rmSync(configObj.config.dirPath + "/.session")
+        rmSync(configObj.config.dirPath + "/resets")
 
         // clean tag gz
         if (fs.existsSync(configObj.config.dirPath + "/app.tar.gz"))
-          fs.unlinkSync(configObj.config.dirPath + "/app.tar.gz");
+          fs.unlinkSync(configObj.config.dirPath + "/app.tar.gz")
 
         if (fs.existsSync(configObj.config.dirPath + "/config.json"))
-          fs.unlinkSync(configObj.config.dirPath + "/config.json");
+          fs.unlinkSync(configObj.config.dirPath + "/config.json")
 
         if (fs.existsSync(configObj.config.dirPath + "/vscode_queue.json"))
-          fs.unlinkSync(configObj.config.dirPath + "/vscode_queue.json");
+          fs.unlinkSync(configObj.config.dirPath + "/vscode_queue.json")
       }
     },
     getExercise: slug => {
-      Console.debug("ExercisePath Slug", slug);
+      Console.debug("ExercisePath Slug", slug)
       const exercise = (configObj.exercises || []).find(
         ex => ex.slug === slug
-      );
+      )
       if (!exercise) 
-throw ValidationError(`Exercise ${slug} not found`);
+throw ValidationError(`Exercise ${slug} not found`)
 
-      return exercise;
+      return exercise
     },
     getAllExercises: () => {
-      return configObj.exercises;
+      return configObj.exercises
     },
     startExercise: function (slug: string) {
-      const exercise = this.getExercise(slug);
+      const exercise = this.getExercise(slug)
 
       // set config.json with current exercise
-      configObj.currentExercise = exercise.slug;
+      configObj.currentExercise = exercise.slug
 
-      this.save();
+      this.save()
 
       // eslint-disable-next-line
       exercise.files.forEach((f: IFile) => {
         if (configObj.config) {
-          const _path = configObj.config.outputPath + "/" + f.name;
+          const _path = configObj.config.outputPath + "/" + f.name
           if (f.hidden === false && fs.existsSync(_path)) 
-fs.unlinkSync(_path);
+fs.unlinkSync(_path)
         }
-      });
+      })
 
-      return exercise;
+      return exercise
     },
     noCurrentExercise: function () {
-      configObj.currentExercise = null;
-      this.save();
+      configObj.currentExercise = null
+      this.save()
     },
     reset: slug => {
       if (
         configObj.config &&
         !fs.existsSync(`${configObj.config.dirPath}/resets/` + slug)
       )
-        throw ValidationError("Could not find the original files for " + slug);
+        throw ValidationError("Could not find the original files for " + slug)
 
       const exercise = (configObj.exercises || []).find(
         ex => ex.slug === slug
-      );
+      )
       if (!exercise)
         throw ValidationError(
           `Exercise ${slug} not found on the configuration`
-        );
+        )
 
       if (configObj.config) {
         for (const fileName of fs.readdirSync(
@@ -318,110 +318,110 @@ fs.unlinkSync(_path);
         )) {
           const content = fs.readFileSync(
             `${configObj.config?.dirPath}/resets/${slug}/${fileName}`
-          );
-          fs.writeFileSync(`${exercise.path}/${fileName}`, content);
+          )
+          fs.writeFileSync(`${exercise.path}/${fileName}`, content)
         }
       }
     },
     buildIndex: function () {
-      Console.info("Building the exercise index...");
+      Console.info("Building the exercise index...")
 
       const isDirectory = (source: string) => {
-        const name = path.basename(source);
+        const name = path.basename(source)
         if (name === path.basename(configObj?.config?.dirPath || ""))
-          return false;
+          return false
         // ignore folders that start with a dot
         if (name.charAt(0) === "." || name.charAt(0) === "_") 
-return false;
+return false
 
-        return fs.lstatSync(source).isDirectory();
-      };
+        return fs.lstatSync(source).isDirectory()
+      }
 
       const getDirectories = (source: string) =>
         fs
           .readdirSync(source)
           .map(name => path.join(source, name))
-          .filter(isDirectory);
+          .filter(isDirectory)
       // add the .learn folder
       if (!fs.existsSync(confPath.base)) 
-fs.mkdirSync(confPath.base);
+fs.mkdirSync(confPath.base)
       // add the outout folder where webpack will publish the the html/css/js files
       if (
         configObj.config &&
         configObj.config.outputPath &&
         !fs.existsSync(configObj.config.outputPath)
       )
-        fs.mkdirSync(configObj.config.outputPath);
+        fs.mkdirSync(configObj.config.outputPath)
 
       // TODO: we could use npm library front-mater to read the title of the exercises from the README.md
       const grupedByDirectory = getDirectories(
         configObj?.config?.exercisesPath || ""
-      );
+      )
       configObj.exercises =
         grupedByDirectory.length > 0 ?
           grupedByDirectory.map((path, position) =>
               exercise(path, position, configObj)
             ) :
-          [exercise(configObj?.config?.exercisesPath || "", 0, configObj)];
-      this.save();
+          [exercise(configObj?.config?.exercisesPath || "", 0, configObj)]
+      this.save()
     },
     watchIndex: function (onChange: () => void) {
       if (configObj.config && !configObj.config.exercisesPath)
         throw ValidationError(
           "No exercises directory to watch: " + configObj.config.exercisesPath
-        );
+        )
 
-      this.buildIndex();
+      this.buildIndex()
       watch(configObj?.config?.exercisesPath || "", onChange)
         .then((/* eventname, filename */) => {
-          Console.debug("Changes detected on your exercises");
-          this.buildIndex();
+          Console.debug("Changes detected on your exercises")
+          this.buildIndex()
           if (onChange) 
-onChange();
+onChange()
         })
         .catch(error => {
-          throw error;
-        });
+          throw error
+        })
     },
     save: () => {
-      Console.debug("Saving configuration with: ", configObj);
+      Console.debug("Saving configuration with: ", configObj)
 
       // remove the duplicates form the actions array
       // configObj.config.actions = [...new Set(configObj.config.actions)];
       if (configObj.config) {
         configObj.config.translations = [
           ...new Set(configObj.config.translations),
-        ];
+        ]
         fs.writeFileSync(
           configObj.config.dirPath + "/config.json",
           JSON.stringify(configObj, null, 4)
-        );
+        )
       }
     },
-  } as IConfigManager;
-};
+  } as IConfigManager
+}
 
 function deepMerge(...sources: any): any {
-  let acc: any = {};
+  let acc: any = {}
   for (const source of sources) {
     if (Array.isArray(source)) {
       if (!Array.isArray(acc)) {
-        acc = [];
+        acc = []
       }
 
-      acc = [...source];
+      acc = [...source]
     } else if (source instanceof Object) {
       // eslint-disable-next-line
       for (let [key, value] of Object.entries(source)) {
         if (value instanceof Object && key in acc) {
-          value = deepMerge(acc[key], value);
+          value = deepMerge(acc[key], value)
         }
 
         if (value !== undefined) 
-acc = { ...acc, [key]: value };
+acc = { ...acc, [key]: value }
       }
     }
   }
 
-  return acc;
+  return acc
 }