@learnpack/learnpack 2.0.21 → 2.1.0

package/src/utils/fileQueue.ts

@@ -1,198 +1,198 @@
-import logger from "../utils/console";
-import * as fs from "fs";
-// import em from "events"
-import * as XXH from "xxhashjs";
-
-// possible events to dispatch
-const events = {
-  START_EXERCISE: "start_exercise",
-  INIT: "initializing",
-  RUNNING: "configuration_loaded",
-  END: "connection_ended",
-  RESET_EXERCISE: "reset_exercise",
-  OPEN_FILES: "open_files",
-  OPEN_WINDOW: "open_window",
-  INSTRUCTIONS_CLOSED: "instructions_closed",
-};
-
-let options = {
-  path: null,
-  create: false,
-};
-let lastHash: any = null;
-let watcher: any = null; // subscribe to file and listen to changes
-let actions: any = null; // action queue
-
-const loadDispatcher = (opts: any) => {
-  actions = [{ name: "initializing", time: now() }];
-  logger.debug(`Loading from ${opts.path}`);
-
-  let exists = fs.existsSync(opts.path);
-  if (opts.create) {
-    if (exists) 
-actions.push({ name: "reset", time: now() });
-    fs.writeFileSync(opts.path, JSON.stringify(actions), { flag: "w" });
-    exists = true;
-  }
-
-  if (!exists)
-    throw new Error(`Invalid queue path, missing file at: ${opts.path}`);
-
-  let incomingActions = [];
-  try {
-    const content = fs.readFileSync(opts.path, "utf-8");
-    incomingActions = JSON.parse(content);
-    if (!Array.isArray(incomingActions)) 
-incomingActions = [];
-  } catch {
-    incomingActions = [];
-    logger.debug("Error loading VSCode Actions file");
-  }
-
-  logger.debug("Actions load ", incomingActions);
-  return incomingActions;
-};
-
-// eslint-disable-next-line
-const enqueue = (name: string, data: any | undefined = undefined) => {
-  if (!Object.values(events).includes(name)) {
-    logger.debug(`Invalid event ${name}`);
-    throw new Error(`Invalid action ${name}`);
-  }
-
-  if (!actions) 
-actions = [];
-
-  actions.push({ name, time: now(), data: data });
-  logger.debug(`EMIT -> ${name}:Exporting changes to ${options.path}`);
-
-  return fs.writeFileSync(options.path || "", JSON.stringify(actions));
-};
-
-const now = () => {
-  const hrTime = process.hrtime();
-  // eslint-disable-next-line
-  const htTime0 = hrTime[0] * 1000000;
-  return (htTime0 + hrTime[1]) / 1000;
-};
-
-const loadFile = (filePath: string) => {
-  if (!fs.existsSync(filePath))
-    throw new Error(`No queue.json file to load on ${filePath}`);
-
-  const content = fs.readFileSync(filePath, "utf8");
-  const newHash = XXH.h32(content, 0xAB_CD).toString(16);
-  const isUpdated = lastHash !== newHash;
-  lastHash = newHash;
-  const incomingActions = JSON.parse(content);
-  return { isUpdated, incomingActions };
-};
-
-const dequeue = () => {
-  // first time dequeue loads
-  if (!actions) 
-actions = [];
-
-  const { isUpdated, incomingActions } = loadFile(options.path || "");
-
-  if (!isUpdated) {
-    /**
-     * make sure no tasks are executed from the queue by matching both
-     * queues (the incoming with current one)
-     */
-    actions = incomingActions;
-    logger.debug(
-      `No new actions to process: ${actions.length}/${incomingActions.length}`
-    );
-    return null;
-  }
-
-  // do i need to reset actions to zero?
-  if (actions.length > 0 && actions[0].time !== incomingActions[0].time) {
-    actions = [];
-  }
-
-  const action = incomingActions[incomingActions.length - 1];
-  logger.debug("Dequeing action ", action);
-  actions.push(action);
-  return action;
-};
-
-const pull = (callback: (T: any) => any) => {
-  logger.debug("Pulling actions");
-  let incoming = dequeue();
-  while (incoming) {
-    callback(incoming);
-    incoming = dequeue();
-  }
-};
-
-const reset = (callback: (T?: any) => any) => {
-  logger.debug("Queue reseted");
-  actions = [];
-  if (fs.existsSync(options.path || "")) {
-    fs.writeFileSync(options.path || "", "[]");
-    callback();
-  }
-};
-
-const onPull = (callback: (T?: any) => any) => {
-  // eslint-disable-next-line
-  const chokidar = require("chokidar");
-
-  logger.debug("Starting to listen...");
-  try {
-    loadFile(options.path || "");
-  } catch {
-    logger.debug("No previeues queue file, waiting for it to be created...");
-  }
-
-  if (!watcher) {
-    logger.debug(`Watching ${options.path}`);
-    watcher = chokidar.watch(`${options.path}`, {
-      persistent: true,
-    });
-  } else 
-logger.debug("Already watching queue path");
-
-  watcher.on("add", () => pull(callback)).on("change", () => pull(callback));
-
-  return true;
-};
-
-const onReset = (callback: (T?: any) => any) => {
-  // eslint-disable-next-line
-  const chokidar = require("chokidar");
-
-  if (!watcher) {
-    logger.debug(`Watching ${options.path}`);
-    watcher = chokidar.watch(`${options.path}`, {
-      persistent: true,
-    });
-  }
-
-  watcher.on("unlink", () => reset(callback));
-
-  return true;
-};
-
-export default {
-  events,
-  dispatcher: (opts: any = {}) => {
-    if (!actions) {
-      options = { ...options, ...opts };
-      logger.debug("Initializing queue dispatcher", options);
-      actions = loadDispatcher(options);
-    }
-
-    return { enqueue, events };
-  },
-  listener: (opts: any = {}) => {
-    if (!actions) {
-      options = { ...options, ...opts };
-      logger.debug("Initializing queue listener", options);
-    }
-
-    return { onPull, onReset, events };
-  },
-};
+import logger from "../utils/console";
+import * as fs from "fs";
+// import em from "events"
+import * as XXH from "xxhashjs";
+
+// possible events to dispatch
+const events = {
+  START_EXERCISE: "start_exercise",
+  INIT: "initializing",
+  RUNNING: "configuration_loaded",
+  END: "connection_ended",
+  RESET_EXERCISE: "reset_exercise",
+  OPEN_FILES: "open_files",
+  OPEN_WINDOW: "open_window",
+  INSTRUCTIONS_CLOSED: "instructions_closed",
+};
+
+let options = {
+  path: null,
+  create: false,
+};
+let lastHash: any = null;
+let watcher: any = null; // subscribe to file and listen to changes
+let actions: any = null; // action queue
+
+const loadDispatcher = (opts: any) => {
+  actions = [{ name: "initializing", time: now() }];
+  logger.debug(`Loading from ${opts.path}`);
+
+  let exists = fs.existsSync(opts.path);
+  if (opts.create) {
+    if (exists) 
+actions.push({ name: "reset", time: now() });
+    fs.writeFileSync(opts.path, JSON.stringify(actions), { flag: "w" });
+    exists = true;
+  }
+
+  if (!exists)
+    throw new Error(`Invalid queue path, missing file at: ${opts.path}`);
+
+  let incomingActions = [];
+  try {
+    const content = fs.readFileSync(opts.path, "utf-8");
+    incomingActions = JSON.parse(content);
+    if (!Array.isArray(incomingActions)) 
+incomingActions = [];
+  } catch {
+    incomingActions = [];
+    logger.debug("Error loading VSCode Actions file");
+  }
+
+  logger.debug("Actions load ", incomingActions);
+  return incomingActions;
+};
+
+// eslint-disable-next-line
+const enqueue = (name: string, data: any | undefined = undefined) => {
+  if (!Object.values(events).includes(name)) {
+    logger.debug(`Invalid event ${name}`);
+    throw new Error(`Invalid action ${name}`);
+  }
+
+  if (!actions) 
+actions = [];
+
+  actions.push({ name, time: now(), data: data });
+  logger.debug(`EMIT -> ${name}:Exporting changes to ${options.path}`);
+
+  return fs.writeFileSync(options.path || "", JSON.stringify(actions));
+};
+
+const now = () => {
+  const hrTime = process.hrtime();
+  // eslint-disable-next-line
+  const htTime0 = hrTime[0] * 1000000;
+  return (htTime0 + hrTime[1]) / 1000;
+};
+
+const loadFile = (filePath: string) => {
+  if (!fs.existsSync(filePath))
+    throw new Error(`No queue.json file to load on ${filePath}`);
+
+  const content = fs.readFileSync(filePath, "utf8");
+  const newHash = XXH.h32(content, 0xAB_CD).toString(16);
+  const isUpdated = lastHash !== newHash;
+  lastHash = newHash;
+  const incomingActions = JSON.parse(content);
+  return { isUpdated, incomingActions };
+};
+
+const dequeue = () => {
+  // first time dequeue loads
+  if (!actions) 
+actions = [];
+
+  const { isUpdated, incomingActions } = loadFile(options.path || "");
+
+  if (!isUpdated) {
+    /**
+     * make sure no tasks are executed from the queue by matching both
+     * queues (the incoming with current one)
+     */
+    actions = incomingActions;
+    logger.debug(
+      `No new actions to process: ${actions.length}/${incomingActions.length}`
+    );
+    return null;
+  }
+
+  // do i need to reset actions to zero?
+  if (actions.length > 0 && actions[0].time !== incomingActions[0].time) {
+    actions = [];
+  }
+
+  const action = incomingActions[incomingActions.length - 1];
+  logger.debug("Dequeing action ", action);
+  actions.push(action);
+  return action;
+};
+
+const pull = (callback: (T: any) => any) => {
+  logger.debug("Pulling actions");
+  let incoming = dequeue();
+  while (incoming) {
+    callback(incoming);
+    incoming = dequeue();
+  }
+};
+
+const reset = (callback: (T?: any) => any) => {
+  logger.debug("Queue reseted");
+  actions = [];
+  if (fs.existsSync(options.path || "")) {
+    fs.writeFileSync(options.path || "", "[]");
+    callback();
+  }
+};
+
+const onPull = (callback: (T?: any) => any) => {
+  // eslint-disable-next-line
+  const chokidar = require("chokidar");
+
+  logger.debug("Starting to listen...");
+  try {
+    loadFile(options.path || "");
+  } catch {
+    logger.debug("No previoues queue file, waiting for it to be created...");
+  }
+
+  if (!watcher) {
+    logger.debug(`Watching ${options.path}`);
+    watcher = chokidar.watch(`${options.path}`, {
+      persistent: true,
+    });
+  } else 
+logger.debug("Already watching queue path");
+
+  watcher.on("add", () => pull(callback)).on("change", () => pull(callback));
+
+  return true;
+};
+
+const onReset = (callback: (T?: any) => any) => {
+  // eslint-disable-next-line
+  const chokidar = require("chokidar");
+
+  if (!watcher) {
+    logger.debug(`Watching ${options.path}`);
+    watcher = chokidar.watch(`${options.path}`, {
+      persistent: true,
+    });
+  }
+
+  watcher.on("unlink", () => reset(callback));
+
+  return true;
+};
+
+export default {
+  events,
+  dispatcher: (opts: any = {}) => {
+    if (!actions) {
+      options = { ...options, ...opts };
+      logger.debug("Initializing queue dispatcher", options);
+      actions = loadDispatcher(options);
+    }
+
+    return { enqueue, events };
+  },
+  listener: (opts: any = {}) => {
+    if (!actions) {
+      options = { ...options, ...opts };
+      logger.debug("Initializing queue listener", options);
+    }
+
+    return { onPull, onReset, events };
+  },
+};

package/src/utils/templates/incremental/.learn/exercises/01-hello-world/README.es.md

@@ -1,24 +1,24 @@
-# `01` Hello World
-
-Puedes tener un archivo README el cual será como una página de un libro, sin archivos de código.
-
-También puedes agregar un archivo `README.[lenguaje].md` para traducciones, por ejemplo `README.es.md` para español.
-
-## Inserta videos
-
-Si quieres incluir algún video introductorio para cada ejercicio, agrega la propiedad `intro` en el inicio del README.md para ese ejercicio en particular:
-
-```markdown
----
-intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
----
-```
-
-Tambien puedes agregar un video explicando la solución para cada ejercicio agregando la propiedad `tutorial` al inicio del markdown del README.md correspondiente:
-
-```markdown
----
-intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
-tutorial: "https://www.youtube.com/watch?v=YkgkThdzX-8"
----
-```
+# `01` Hello World
+
+Puedes tener un archivo README el cual será como una página de un libro, sin archivos de código.
+
+También puedes agregar un archivo `README.[lenguaje].md` para traducciones, por ejemplo `README.es.md` para español.
+
+## Inserta videos
+
+Si quieres incluir algún video introductorio para cada ejercicio, agrega la propiedad `intro` en el inicio del README.md para ese ejercicio en particular:
+
+```markdown
+---
+intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+---
+```
+
+Tambien puedes agregar un video explicando la solución para cada ejercicio agregando la propiedad `tutorial` al inicio del markdown del README.md correspondiente:
+
+```markdown
+---
+intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+tutorial: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+---
+```

package/src/utils/templates/incremental/.learn/exercises/01-hello-world/README.md

@@ -1,24 +1,24 @@
-# `01` Hello World
-
-You can have just a README file and it will be like a page in a book, no code files.
-
-You can also add a `README.[lang].md` file for translations, for example: `README.es.md` for spanish.
-
-## Video compatibility
-
-If you want to include some video introduction for each exercise, add a `intro` property in the markdown frontmatter of the README.md for that particular exercise:
-
-```markdown
----
-intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
----
-```
-
-You can also add a video solution for each exercise by adding a `tutorial` property on the markdown frontmatter of it's README.md:
-
-```markdown
----
-intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
-tutorial: "https://www.youtube.com/watch?v=YkgkThdzX-8"
----
-```
+# `01` Hello World
+
+You can have just a README file and it will be like a page in a book, no code files.
+
+You can also add a `README.[lang].md` file for translations, for example: `README.es.md` for spanish.
+
+## Video compatibility
+
+If you want to include some video introduction for each exercise, add a `intro` property in the markdown frontmatter of the README.md for that particular exercise:
+
+```markdown
+---
+intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+---
+```
+
+You can also add a video solution for each exercise by adding a `tutorial` property on the markdown frontmatter of it's README.md:
+
+```markdown
+---
+intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+tutorial: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+---
+```

package/src/utils/watcher.ts

@@ -1,27 +1,26 @@
-import * as chokidar from "chokidar";
-import * as debounce from "debounce";
-
-export default (path: string) =>
-  new Promise((resolve /* , reject */) => {
-    const watcher = chokidar.watch(path, {
-      // TODO: This watcher is not ready yet
-      // ignored: (_path: string, _stats: any) => {
-      //   return new RegExp(_path)
-      // },
-      persistent: true,
-      depth: 1,
-      ignoreInitial: true,
-    });
-
-    const onChange = (eventname: string, _filename: string) => {
-      resolve(eventname /* , filename */);
-    };
-
-    watcher.on("all", debounce(onChange, 500, true));
-    // watcher.on('all', onChange)
-
-    process.on("SIGINT", function () {
-      watcher.close();
-      process.exit();
-    });
-  });
+import * as chokidar from "chokidar";
+import Console from "./console";
+import * as debounce from "debounce";
+
+export default (path: string, reloadSocket: () => void) =>
+  new Promise((resolve /* , reject */) => {
+    const watcher = chokidar.watch(path, {
+      // TODO: This watcher is not ready yet
+      // ignored: (_path: string, _stats: any) => {
+      //   return new RegExp(_path)
+      // },
+      ignoreInitial: true,
+    });
+    const onChange = (eventname: string, _filename: string) => {
+      resolve(eventname /* , filename */);
+      reloadSocket();
+    };
+
+    watcher.on("all", debounce(onChange, 500, true));
+    // watcher.on('all', onChange)
+
+    process.on("SIGINT", function () {
+      watcher.close();
+      process.exit();
+    });
+  });