@learnpack/learnpack 2.1.26 → 2.1.27

package/lib/commands/test.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const console_1 = require("../utils/console");
-const SessionCommand_1 = require("../utils/SessionCommand");
-const socket_1 = require("../managers/socket");
-const server_1 = require("../managers/server");
-const exercisesQueue_1 = require("../utils/exercisesQueue");
-class TestCommand extends SessionCommand_1.default {
-    async init() {
-        const { flags } = this.parse(TestCommand);
-        await this.initSession(flags);
-    }
-    async run() {
-        var _a, _b, _c;
-        const { args: { exerciseSlug }, } = this.parse(TestCommand);
-        // Build exercises index
-        (_a = this.configManager) === null || _a === void 0 ? void 0 : _a.buildIndex();
-        let exercises = [];
-        // test all exercises
-        !exerciseSlug ?
-            (exercises = (_b = this.configManager) === null || _b === void 0 ? void 0 : _b.getAllExercises()) :
-            (exercises = [this.configManager.getExercise(exerciseSlug)]);
-        const exercisesQueue = new exercisesQueue_1.default(exercises);
-        const configObject = (_c = this.configManager) === null || _c === void 0 ? void 0 : _c.get();
-        let hasFailed = false;
-        let failedTestsCount = 0;
-        let successTestsCount = 0;
-        const testsToRunCount = exercisesQueue.size();
-        configObject.config.testingFinishedCallback = ({ result }) => {
-            if (result === "failed") {
-                hasFailed = true;
-                failedTestsCount++;
-            }
-            else {
-                successTestsCount++;
-            }
-            if (exercisesQueue.isEmpty()) {
-                console_1.default.info(`${testsToRunCount} test${testsToRunCount > 1 ? "s" : ""} runned`);
-                console_1.default.success(`${successTestsCount} test${successTestsCount > 1 ? "s" : ""} passed`);
-                console_1.default.error(`${failedTestsCount} test${failedTestsCount > 1 ? "s" : ""} failed`);
-                process.exit(hasFailed ? 1 : 0);
-            }
-            else {
-                exercisesQueue.pop().test(this.config, config, socket_1.default);
-            }
-        };
-        const config = configObject === null || configObject === void 0 ? void 0 : configObject.config;
-        const server = await server_1.default(configObject, this.configManager, true);
-        socket_1.default.start(config, server, true);
-        exercisesQueue.pop().test(this.config, config, socket_1.default);
-    }
-}
-TestCommand.description = `Test exercises`;
-TestCommand.args = [
-    {
-        name: "exerciseSlug",
-        required: false,
-        description: "The name of the exercise to test",
-        hidden: false,
-    },
-];
-exports.default = TestCommand;

package/lib/index.d.ts

@@ -1 +0,0 @@
-export * from '@oclif/command';

package/lib/index.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("@oclif/command"), exports);

package/lib/managers/config/allowed_files.d.ts

@@ -1,5 +0,0 @@
-declare const extensions: {
-    extensions: string[];
-    names: string[];
-};
-export default extensions;

package/lib/managers/config/allowed_files.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const extensions = {
-    extensions: [
-        "py",
-        "java",
-        "py",
-        "ruby",
-        "html",
-        "css",
-        "htm",
-        "php",
-        "js",
-        "jsx",
-        "ts",
-        "sh",
-        "bash",
-        "json",
-        "yml",
-        "yaml",
-        "csv",
-        "xml",
-        "txt",
-        "text",
-        "markdown",
-        "readme",
-    ],
-    names: ["package.json", "package-lock.json"],
-};
-exports.default = extensions;

package/lib/managers/config/defaults.d.ts

@@ -1,39 +0,0 @@
-declare const _default: {
-    config: {
-        port: number;
-        editor: {
-            mode: null;
-            agent: null;
-            version: null;
-        };
-        dirPath: string;
-        configPath: string;
-        outputPath: string;
-        publicPath: string;
-        publicUrl: null;
-        contact: string;
-        language: string;
-        autoPlay: boolean;
-        projectType: string;
-        grading: string;
-        exercisesPath: string;
-        webpackTemplate: null;
-        disableGrading: boolean;
-        disabledActions: never[];
-        actions: never[];
-        entries: {
-            html: string;
-            vanillajs: string;
-            react: string;
-            node: string;
-            python3: string;
-            java: string;
-        };
-    };
-    address: string;
-    currentExercise: null;
-    exercises: never[];
-    bugsLink: null;
-    videoSolutions: boolean;
-};
-export default _default;

package/lib/managers/config/defaults.js

@@ -1,40 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = {
-    config: {
-        port: 3000,
-        editor: {
-            mode: null,
-            agent: null,
-            version: null,
-        },
-        dirPath: "./.learn",
-        configPath: "./learn.json",
-        outputPath: "./.learn/dist",
-        publicPath: "/preview",
-        publicUrl: null,
-        contact: "https://github.com/learnpack/learnpack/issues/new",
-        language: "auto",
-        autoPlay: true,
-        projectType: "tutorial",
-        grading: "isolated",
-        exercisesPath: "./",
-        webpackTemplate: null,
-        disableGrading: false,
-        disabledActions: [],
-        actions: [],
-        entries: {
-            html: "index.html",
-            vanillajs: "index.js",
-            react: "app.jsx",
-            node: "app.js",
-            python3: "app.py",
-            java: "app.java",
-        },
-    },
-    address: "http://localhost",
-    currentExercise: null,
-    exercises: [],
-    bugsLink: null,
-    videoSolutions: false,
-};

package/lib/managers/config/exercise.d.ts

@@ -1,36 +0,0 @@
-import { IConfigObj } from "../../models/config";
-import { IFile } from "../../models/file";
-import { IExercise } from "../../models/exercise-obj";
-export declare const exercise: (path: string, position: number, configObject: IConfigObj) => IExercise;
-export declare const validateExerciseDirectoryName: (str: string) => boolean;
-export declare const isCodable: (str: string) => boolean;
-export declare const shouldBeVisible: (file: IFile) => boolean;
-export declare const isDirectory: (source: string) => boolean;
-export declare const detect: (configObject: IConfigObj | undefined, files: Array<string>) => {
-    language: string;
-    entry: string | undefined;
-} | {
-    language: null;
-    entry: null;
-} | undefined;
-export declare const filterFiles: (files: Array<string>, basePath?: string) => {
-    path: string;
-    name: string;
-    hidden: boolean;
-}[];
-declare const _default: {
-    exercise: (path: string, position: number, configObject: IConfigObj) => IExercise;
-    detect: (configObject: IConfigObj | undefined, files: string[]) => {
-        language: string;
-        entry: string | undefined;
-    } | {
-        language: null;
-        entry: null;
-    } | undefined;
-    filterFiles: (files: string[], basePath?: string) => {
-        path: string;
-        name: string;
-        hidden: boolean;
-    }[];
-};
-export default _default;

package/lib/managers/config/exercise.js

@@ -1,233 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterFiles = exports.detect = exports.isDirectory = exports.shouldBeVisible = exports.isCodable = exports.validateExerciseDirectoryName = exports.exercise = void 0;
-const p = require("path");
-// import frontMatter from 'front-matter'
-const fs = require("fs");
-const console_1 = require("../../utils/console");
-const allowed_files_1 = require("./allowed_files");
-// eslint-disable-next-line
-const frontMatter = require("front-matter");
-exports.exercise = (path, position, configObject) => {
-    const { config, exercises } = configObject;
-    let slug = p.basename(path);
-    if (!exports.validateExerciseDirectoryName(slug)) {
-        console_1.default.error(`Exercise directory ${slug} has an invalid name, it has to start with two or three digits followed by words separated by underscors or hyphen (no white spaces). e.g: 01.12-hello-world`);
-    }
-    // get all the files
-    const files = fs.readdirSync(path);
-    /**
-     * build the translation array like:
-     {
-         "us": "path/to/Readme.md",
-          "es": "path/to/Readme.es.md"
-        }
-        */
-    const translations = {};
-    for (const file of files.filter(file => file.toLowerCase().includes("readme"))) {
-        const parts = file.split(".");
-        if (parts.length === 3)
-            translations[parts[1]] = file;
-        else
-            translations.us = file;
-    }
-    // if the slug is a dot, it means there is not "exercises" folder, and its just a single README.md
-    if (slug === ".")
-        slug = "default-index";
-    const detected = exports.detect(configObject, files);
-    const exerciseObj = {
-        position,
-        path,
-        slug,
-        translations,
-        language: detected === null || detected === void 0 ? void 0 : detected.language,
-        entry: (detected === null || detected === void 0 ? void 0 : detected.entry) ? path + "/" + detected.entry : null,
-        title: slug || "Exercise",
-        graded: files.some((file) => file.toLowerCase().startsWith("test.") ||
-            file.toLowerCase().startsWith("tests.")),
-        files: exports.filterFiles(files, path),
-        // if the exercises was on the config before I may keep the status done
-        done: Array.isArray(exercises) &&
-            typeof exercises[position] !== "undefined" &&
-            path.slice(Math.max(0, path.indexOf("exercises/") + 10)) ===
-                exercises[position].slug ?
-            exercises[position].done :
-            false,
-        getReadme: function (lang = null) {
-            if (lang === "us")
-                lang = null; // <-- english is default, no need to append it to the file name
-            if (!fs.existsSync(`${this.path}/README${lang ? "." + lang : ""}.md`)) {
-                console_1.default.error(`Language ${lang} not found for exercise ${slug}, switching to default language`);
-                if (lang)
-                    lang = null;
-                if (!fs.existsSync(`${this.path}/README${lang ? "." + lang : ""}.md`))
-                    throw new Error("Readme file not found for exercise: " + this.path + "/README.md");
-            }
-            const content = fs.readFileSync(`${this.path}/README${lang ? "." + lang : ""}.md`, "utf8");
-            const attr = frontMatter(content);
-            return attr;
-        },
-        getFile: function (name) {
-            const file = this.files.find((f) => f.name === name);
-            if (!file || !fs.existsSync(file.path)) {
-                throw new Error(`File not found: + ${file === null || file === void 0 ? void 0 : file.path}`);
-            }
-            else if (fs.lstatSync(file.path).isDirectory()) {
-                return ("Error: This is not a file to be read, but a directory: " + file.path);
-            }
-            // get file content
-            const content = fs.readFileSync(file.path);
-            // create reset folder
-            if (!fs.existsSync(`${config === null || config === void 0 ? void 0 : config.dirPath}/resets`))
-                fs.mkdirSync(`${config === null || config === void 0 ? void 0 : config.dirPath}/resets`);
-            if (!fs.existsSync(`${config === null || config === void 0 ? void 0 : config.dirPath}/resets/` + this.slug)) {
-                fs.mkdirSync(`${config === null || config === void 0 ? void 0 : config.dirPath}/resets/` + this.slug);
-                for (const _file of this.files) {
-                    const fileContent = fs.readFileSync(_file.path);
-                    if (!fs.existsSync(`${config === null || config === void 0 ? void 0 : config.dirPath}/resets/${this.slug}/${_file.name}`)) {
-                        fs.writeFileSync(`${config === null || config === void 0 ? void 0 : config.dirPath}/resets/${this.slug}/${_file.name}`, fileContent);
-                    }
-                }
-            }
-            return content;
-        },
-        saveFile: function (name, content) {
-            const file = this.files.find((f) => f.name === name);
-            if (file) {
-                if (!fs.existsSync(file.path)) {
-                    throw new Error("File not found: " + file.path);
-                }
-                return fs.writeFileSync(file.path, content, "utf8");
-            }
-        },
-        getTestReport: function () {
-            var _a;
-            const _path = `${(_a = configObject === null || configObject === void 0 ? void 0 : configObject.confPath) === null || _a === void 0 ? void 0 : _a.base}/reports/${this.slug}.json`;
-            if (!fs.existsSync(_path))
-                return {};
-            const content = fs.readFileSync(_path);
-            const data = JSON.parse(`${content}`);
-            return data;
-        },
-    };
-    return exerciseObj;
-};
-exports.validateExerciseDirectoryName = (str) => {
-    if (str === "./")
-        return true;
-    // TODO: Add nameValidationREgex from the config
-    const regex = /^(\d{2,3}(\.\d{1,2})?-([\dA-Za-z]+(-|_)?)+)$/;
-    return regex.test(str);
-};
-exports.isCodable = (str) => {
-    const extension = p.extname(str);
-    return allowed_files_1.default.extensions.includes(extension.slice(1).toLowerCase());
-};
-const isNotConfiguration = (str) => {
-    return !allowed_files_1.default.names.includes(str);
-};
-exports.shouldBeVisible = function (file) {
-    return (
-    // doest not have "test." on their name
-    !file.name.toLocaleLowerCase().includes("test.") &&
-        !file.name.toLocaleLowerCase().includes("tests.") &&
-        !file.name.toLocaleLowerCase().includes(".hide.") &&
-        // ignore hidden files
-        file.name.charAt(0) !== "." &&
-        // ignore learn.json and bc.json
-        !file.name.toLocaleLowerCase().includes("learn.json") &&
-        !file.name.toLocaleLowerCase().includes("bc.json") &&
-        // ignore images, videos, vectors, etc.
-        exports.isCodable(file.name) &&
-        isNotConfiguration(file.name) &&
-        // readme's and directories
-        !file.name.toLowerCase().includes("readme.") &&
-        !exports.isDirectory(file.path) &&
-        file.name.charAt(0) !== "_");
-};
-exports.isDirectory = (source) => {
-    // if(path.basename(source) === path.basename(config.dirPath)) return false
-    return fs.lstatSync(source).isDirectory();
-};
-exports.detect = (configObject, files) => {
-    if (!configObject) {
-        return;
-    }
-    const { config } = configObject;
-    if (!config)
-        throw new Error("No configuration found during the engine detection");
-    if (!config.entries)
-        throw new Error("No configuration found for entries, please add a 'entries' object with the default file name for your exercise entry file that is going to be used while compiling, for example: index.html for html, app.py for python3, etc.");
-    // A language was found on the config object, but this language will only be used as last resort, learnpack will try to guess each exercise language independently based on file extension (js, jsx, html, etc.)
-    let hasFiles = files.filter(f => f.includes(".py"));
-    if (hasFiles.length > 0)
-        return {
-            language: "python3",
-            entry: hasFiles.find(f => config.entries.python3 === f),
-        };
-    hasFiles = files.filter(f => f.includes(".java"));
-    if (hasFiles.length > 0)
-        return {
-            language: "java",
-            entry: hasFiles.find(f => config.entries.java === f),
-        };
-    hasFiles = files.filter(f => f.includes(".jsx"));
-    if (hasFiles.length > 0)
-        return {
-            language: "react",
-            entry: hasFiles.find(f => config.entries.react === f),
-        };
-    const hasHTML = files.filter(f => f.includes("index.html"));
-    const hasIndexJS = files.find(f => f.includes("index.js"));
-    const hasJS = files.filter(f => f.includes(".js"));
-    // angular, vue, vanillajs needs to have at least 2 files (html,css,js),
-    // the test.js and the entry file in js
-    // if not its just another HTML
-    if (hasIndexJS && hasHTML.length > 0)
-        return {
-            language: "vanillajs",
-            entry: hasIndexJS,
-        };
-    if (hasHTML.length > 0)
-        return {
-            language: "html",
-            entry: hasHTML.find(f => config.entries.html === f),
-        };
-    if (hasJS.length > 0)
-        return {
-            language: "node",
-            entry: hasJS.find(f => config.entries.node === f),
-        };
-    return {
-        language: null,
-        entry: null,
-    };
-};
-exports.filterFiles = (files, basePath = ".") => files
-    .map((ex) => ({
-    path: basePath + "/" + ex,
-    name: ex,
-    hidden: !exports.shouldBeVisible({
-        name: ex,
-        path: basePath + "/" + ex,
-    }),
-}))
-    .sort((f1, f2) => {
-    const score = {
-        // sorting priority
-        "index.html": 1,
-        "styles.css": 2,
-        "styles.scss": 2,
-        "style.css": 2,
-        "style.scss": 2,
-        "index.css": 2,
-        "index.scss": 2,
-        "index.js": 3,
-    };
-    return score[f1.name] < score[f2.name] ? -1 : 1;
-});
-exports.default = {
-    exercise: exports.exercise,
-    detect: exports.detect,
-    filterFiles: exports.filterFiles,
-};

package/lib/managers/config/index.d.ts

@@ -1,3 +0,0 @@
-import { IConfigManagerAttributes, IConfigManager } from "../../models/config-manager";
-declare const _default: ({ grading, mode, disableGrading, version, }: IConfigManagerAttributes) => Promise<IConfigManager>;
-export default _default;