@learnpack/learnpack 5.0.6 → 5.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/README.md +17 -17
  2. package/bin/run +17 -17
  3. package/bin/run.cmd +3 -3
  4. package/lib/commands/audit.js +30 -21
  5. package/lib/commands/clean.js +3 -3
  6. package/lib/commands/download.js +3 -3
  7. package/lib/commands/init.js +29 -4
  8. package/lib/commands/login.js +3 -3
  9. package/lib/commands/logout.js +3 -3
  10. package/lib/utils/rigoActions.d.ts +5 -0
  11. package/lib/utils/rigoActions.js +15 -1
  12. package/oclif.manifest.json +1 -1
  13. package/package.json +152 -152
  14. package/src/commands/audit.ts +449 -443
  15. package/src/commands/clean.ts +29 -29
  16. package/src/commands/download.ts +61 -61
  17. package/src/commands/init.ts +40 -12
  18. package/src/commands/login.ts +42 -42
  19. package/src/commands/logout.ts +43 -43
  20. package/src/commands/test.ts +85 -85
  21. package/src/index.ts +1 -1
  22. package/src/managers/config/allowed_files.ts +29 -29
  23. package/src/managers/gitpod.ts +84 -84
  24. package/src/managers/server/index.ts +78 -78
  25. package/src/managers/telemetry.ts +353 -353
  26. package/src/managers/test.ts +83 -83
  27. package/src/models/audit.ts +16 -16
  28. package/src/models/config-manager.ts +23 -23
  29. package/src/models/counter.ts +11 -11
  30. package/src/models/errors.ts +22 -22
  31. package/src/models/exercise-obj.ts +29 -29
  32. package/src/models/file.ts +5 -5
  33. package/src/models/findings.ts +18 -18
  34. package/src/models/flags.ts +10 -10
  35. package/src/models/front-matter.ts +11 -11
  36. package/src/models/gitpod-data.ts +19 -19
  37. package/src/models/language.ts +4 -4
  38. package/src/models/package.ts +7 -7
  39. package/src/models/plugin-config.ts +17 -17
  40. package/src/models/success-types.ts +1 -1
  41. package/src/plugin/command/compile.ts +17 -17
  42. package/src/plugin/command/test.ts +30 -30
  43. package/src/plugin/index.ts +6 -6
  44. package/src/plugin/plugin.ts +94 -94
  45. package/src/plugin/utils.ts +87 -87
  46. package/src/types/node-fetch.d.ts +1 -1
  47. package/src/ui/download.ts +71 -71
  48. package/src/utils/BaseCommand.ts +48 -48
  49. package/src/utils/SessionCommand.ts +43 -43
  50. package/src/utils/audit.ts +393 -393
  51. package/src/utils/errors.ts +117 -117
  52. package/src/utils/exercisesQueue.ts +51 -51
  53. package/src/utils/fileQueue.ts +199 -199
  54. package/src/utils/misc.ts +23 -23
  55. package/src/utils/osOperations.ts +79 -79
  56. package/src/utils/rigoActions.ts +27 -0
  57. package/src/utils/templates/gitignore.txt +19 -19
  58. package/src/utils/templates/incremental/.learn/exercises/01-hello-world/README.es.md +24 -24
  59. package/src/utils/templates/incremental/.learn/exercises/01-hello-world/README.md +24 -24
  60. package/src/utils/templates/incremental/.vscode/schema.json +121 -121
  61. package/src/utils/templates/incremental/.vscode/settings.json +13 -13
  62. package/src/utils/templates/incremental/README.ejs +4 -4
  63. package/src/utils/templates/incremental/README.es.ejs +4 -4
  64. package/src/utils/templates/isolated/.vscode/schema.json +121 -121
  65. package/src/utils/templates/isolated/.vscode/settings.json +13 -13
  66. package/src/utils/templates/isolated/README.ejs +4 -4
  67. package/src/utils/templates/isolated/README.es.ejs +4 -4
  68. package/src/utils/templates/no-grading/README.ejs +4 -4
  69. package/src/utils/templates/no-grading/README.es.ejs +4 -4
  70. package/src/utils/validators.ts +18 -18
  71. package/src/utils/watcher.ts +27 -27
@@ -1,30 +1,30 @@
1
- import * as fs from "fs"
2
- import { IError } from "../../models/errors"
3
-
4
- const TestingError = (messages: string) => {
5
- const _err: IError = new Error(messages)
6
- _err.status = 400
7
- _err.stdout = messages
8
- _err.type = "testing-error"
9
- return _err
10
- }
11
-
12
- export default {
13
- TestingError,
14
- default: async function (args: any) {
15
- const { action, configuration, socket, exercise } = args
16
-
17
- if (!fs.existsSync(`${configuration.dirPath}/reports`)) {
18
- // reports directory
19
- fs.mkdirSync(`${configuration.dirPath}/reports`)
20
- }
21
-
22
- // compile
23
- const stdout = await action.run(args)
24
-
25
- // mark exercise as done
26
- exercise.done = true
27
-
28
- return stdout
29
- },
30
- }
1
+ import * as fs from "fs"
2
+ import { IError } from "../../models/errors"
3
+
4
+ const TestingError = (messages: string) => {
5
+ const _err: IError = new Error(messages)
6
+ _err.status = 400
7
+ _err.stdout = messages
8
+ _err.type = "testing-error"
9
+ return _err
10
+ }
11
+
12
+ export default {
13
+ TestingError,
14
+ default: async function (args: any) {
15
+ const { action, configuration, socket, exercise } = args
16
+
17
+ if (!fs.existsSync(`${configuration.dirPath}/reports`)) {
18
+ // reports directory
19
+ fs.mkdirSync(`${configuration.dirPath}/reports`)
20
+ }
21
+
22
+ // compile
23
+ const stdout = await action.run(args)
24
+
25
+ // mark exercise as done
26
+ exercise.done = true
27
+
28
+ return stdout
29
+ },
30
+ }
@@ -1,6 +1,6 @@
1
- import CompilationError from "./command/compile"
2
- import TestingError from "./command/test"
3
- import utils from "./utils"
4
- import plugin from "./plugin"
5
-
6
- export default { CompilationError, TestingError, Utils: utils, plugin }
1
+ import CompilationError from "./command/compile"
2
+ import TestingError from "./command/test"
3
+ import utils from "./utils"
4
+ import plugin from "./plugin"
5
+
6
+ export default { CompilationError, TestingError, Utils: utils, plugin }
@@ -1,94 +1,94 @@
1
- import * as shell from "shelljs"
2
- import { IPluginConfig } from "../models/plugin-config"
3
- /**
4
- * Main Plugin Runner, it defines the behavior of a learnpack plugin
5
- * dividing it in "actions" like: Compile, test, etc.
6
- * @param {object} pluginConfig Configuration object that must defined language and each possible action.
7
- */
8
- export default (pluginConfig: IPluginConfig) => {
9
- return async (args: any) => {
10
- const { action, exercise, socket, configuration } = args
11
-
12
- if (pluginConfig.language === undefined)
13
- throw new Error(`Missing language on the plugin configuration object`)
14
-
15
- if (typeof action !== "string") {
16
- throw new TypeError("Missing action property on hook details")
17
- }
18
-
19
- if (!exercise || exercise === undefined) {
20
- throw new Error("Missing exercise information")
21
- }
22
-
23
- type actionType = "compile" | "test";
24
-
25
- // if the action does not exist I don't do anything
26
- if (pluginConfig[action as actionType] === undefined) {
27
- console.log(`Ignoring ${action}`)
28
- return () => null
29
- }
30
-
31
- // ignore if the plugin language its not the same as the exercise language
32
- if (exercise.language !== pluginConfig.language) {
33
- return () => null
34
- }
35
-
36
- if (!exercise.files || exercise.files.length === 0) {
37
- throw new Error(`No files to process`)
38
- }
39
-
40
- try {
41
- const _action = pluginConfig[action as actionType]
42
-
43
- if (_action === null || typeof _action !== "object")
44
- throw new Error(
45
- `The ${pluginConfig.language} ${action} module must export an object configuration`
46
- )
47
- if (_action.validate === undefined)
48
- throw new Error(
49
- `Missing validate method for ${pluginConfig.language} ${action}`
50
- )
51
- if (_action.run === undefined)
52
- throw new Error(
53
- `Missing run method for ${pluginConfig.language} ${action}`
54
- )
55
- if (_action.dependencies !== undefined) {
56
- if (!Array.isArray(_action.dependencies))
57
- throw new Error(
58
- `${action}.dependencies must be an array of package names`
59
- )
60
-
61
- for (const packageName of _action.dependencies) {
62
- if (!shell.which(packageName)) {
63
- throw new Error(
64
- `🚫 You need to have ${packageName} installed to run test the exercises`
65
- )
66
- }
67
- }
68
- }
69
-
70
- const valid = await _action.validate({ exercise, configuration })
71
- if (valid) {
72
- // look for the command standard implementation and execute it
73
- const execute = require("./command/" + action + ".js").default
74
- // no matter the command, the response must always be a stdout
75
- const stdout = await execute({
76
- ...args,
77
- action: _action,
78
- configuration,
79
- })
80
-
81
- // Map the action names to socket messaging standards
82
- const actionToSuccessMapper = { compile: "compiler", test: "testing" }
83
-
84
- socket.success(actionToSuccessMapper[action as actionType], stdout)
85
- return stdout
86
- }
87
- } catch (error: any) {
88
- if (error.type === undefined)
89
- socket.fatal(error)
90
- else
91
- socket.error(error.type, error.stdout)
92
- }
93
- }
94
- }
1
+ import * as shell from "shelljs"
2
+ import { IPluginConfig } from "../models/plugin-config"
3
+ /**
4
+ * Main Plugin Runner, it defines the behavior of a learnpack plugin
5
+ * dividing it in "actions" like: Compile, test, etc.
6
+ * @param {object} pluginConfig Configuration object that must defined language and each possible action.
7
+ */
8
+ export default (pluginConfig: IPluginConfig) => {
9
+ return async (args: any) => {
10
+ const { action, exercise, socket, configuration } = args
11
+
12
+ if (pluginConfig.language === undefined)
13
+ throw new Error(`Missing language on the plugin configuration object`)
14
+
15
+ if (typeof action !== "string") {
16
+ throw new TypeError("Missing action property on hook details")
17
+ }
18
+
19
+ if (!exercise || exercise === undefined) {
20
+ throw new Error("Missing exercise information")
21
+ }
22
+
23
+ type actionType = "compile" | "test";
24
+
25
+ // if the action does not exist I don't do anything
26
+ if (pluginConfig[action as actionType] === undefined) {
27
+ console.log(`Ignoring ${action}`)
28
+ return () => null
29
+ }
30
+
31
+ // ignore if the plugin language its not the same as the exercise language
32
+ if (exercise.language !== pluginConfig.language) {
33
+ return () => null
34
+ }
35
+
36
+ if (!exercise.files || exercise.files.length === 0) {
37
+ throw new Error(`No files to process`)
38
+ }
39
+
40
+ try {
41
+ const _action = pluginConfig[action as actionType]
42
+
43
+ if (_action === null || typeof _action !== "object")
44
+ throw new Error(
45
+ `The ${pluginConfig.language} ${action} module must export an object configuration`
46
+ )
47
+ if (_action.validate === undefined)
48
+ throw new Error(
49
+ `Missing validate method for ${pluginConfig.language} ${action}`
50
+ )
51
+ if (_action.run === undefined)
52
+ throw new Error(
53
+ `Missing run method for ${pluginConfig.language} ${action}`
54
+ )
55
+ if (_action.dependencies !== undefined) {
56
+ if (!Array.isArray(_action.dependencies))
57
+ throw new Error(
58
+ `${action}.dependencies must be an array of package names`
59
+ )
60
+
61
+ for (const packageName of _action.dependencies) {
62
+ if (!shell.which(packageName)) {
63
+ throw new Error(
64
+ `🚫 You need to have ${packageName} installed to run test the exercises`
65
+ )
66
+ }
67
+ }
68
+ }
69
+
70
+ const valid = await _action.validate({ exercise, configuration })
71
+ if (valid) {
72
+ // look for the command standard implementation and execute it
73
+ const execute = require("./command/" + action + ".js").default
74
+ // no matter the command, the response must always be a stdout
75
+ const stdout = await execute({
76
+ ...args,
77
+ action: _action,
78
+ configuration,
79
+ })
80
+
81
+ // Map the action names to socket messaging standards
82
+ const actionToSuccessMapper = { compile: "compiler", test: "testing" }
83
+
84
+ socket.success(actionToSuccessMapper[action as actionType], stdout)
85
+ return stdout
86
+ }
87
+ } catch (error: any) {
88
+ if (error.type === undefined)
89
+ socket.fatal(error)
90
+ else
91
+ socket.error(error.type, error.stdout)
92
+ }
93
+ }
94
+ }
@@ -1,87 +1,87 @@
1
- import * as chalk from "chalk"
2
-
3
- const getMatches = (reg: RegExp, content: string) => {
4
- const inputs = []
5
- let m
6
- while ((m = reg.exec(content)) !== null) {
7
- // This is necessary to avoid infinite loops with zero-width matches
8
- if (m.index === reg.lastIndex)
9
- reg.lastIndex++
10
-
11
- // The result can be accessed through the `m`-variable.
12
- inputs.push(m[1] || null)
13
- }
14
-
15
- return inputs
16
- }
17
-
18
- const cleanStdout = (buffer: string, inputs: string[]) => {
19
- if (Array.isArray(inputs))
20
- for (let i = 0; i < inputs.length; i++)
21
- if (inputs[i])
22
- buffer = buffer.replace(inputs[i], "")
23
-
24
- return buffer
25
- }
26
-
27
- const indent = (string: string, options: any, count = 1) => {
28
- options = {
29
- indent: " ",
30
- includeEmptyLines: false,
31
- ...options,
32
- }
33
-
34
- if (typeof string !== "string") {
35
- throw new TypeError(
36
- `Expected \`input\` to be a \`string\`, got \`${typeof string}\``
37
- )
38
- }
39
-
40
- if (typeof count !== "number") {
41
- throw new TypeError(
42
- `Expected \`count\` to be a \`number\`, got \`${typeof count}\``
43
- )
44
- }
45
-
46
- if (count < 0) {
47
- throw new RangeError(
48
- `Expected \`count\` to be at least 0, got \`${count}\``
49
- )
50
- }
51
-
52
- if (typeof options.indent !== "string") {
53
- throw new TypeError(
54
- `Expected \`options.indent\` to be a \`string\`, got \`${typeof options.indent}\``
55
- )
56
- }
57
-
58
- if (count === 0) {
59
- return string
60
- }
61
-
62
- const regex = options.includeEmptyLines ? /^/gm : /^(?!\s*$)/gm
63
-
64
- return string.replace(regex, options.indent.repeat(count))
65
- }
66
-
67
- const Console = {
68
- // _debug: true,
69
- _debug: process.env.DEBUG === "true",
70
- startDebug: function () {
71
- this._debug = true
72
- },
73
- log: (msg: string, ...args: any[]) => console.log(chalk.gray(msg), ...args),
74
- error: (msg: string, ...args: any[]) =>
75
- console.log(chalk.red("⨉ " + msg), ...args),
76
- success: (msg: string, ...args: any[]) =>
77
- console.log(chalk.green("✓ " + msg), ...args),
78
- info: (msg: string, ...args: any[]) =>
79
- console.log(chalk.blue("ⓘ " + msg), ...args),
80
- help: (msg: string) =>
81
- console.log(`${chalk.white.bold("⚠ help:")} ${chalk.white(msg)}`),
82
- debug(...args: any[]) {
83
- this._debug && console.log(chalk.magentaBright(`⚠ debug: `), args)
84
- },
85
- }
86
-
87
- export default { getMatches, cleanStdout, indent, Console }
1
+ import * as chalk from "chalk"
2
+
3
+ const getMatches = (reg: RegExp, content: string) => {
4
+ const inputs = []
5
+ let m
6
+ while ((m = reg.exec(content)) !== null) {
7
+ // This is necessary to avoid infinite loops with zero-width matches
8
+ if (m.index === reg.lastIndex)
9
+ reg.lastIndex++
10
+
11
+ // The result can be accessed through the `m`-variable.
12
+ inputs.push(m[1] || null)
13
+ }
14
+
15
+ return inputs
16
+ }
17
+
18
+ const cleanStdout = (buffer: string, inputs: string[]) => {
19
+ if (Array.isArray(inputs))
20
+ for (let i = 0; i < inputs.length; i++)
21
+ if (inputs[i])
22
+ buffer = buffer.replace(inputs[i], "")
23
+
24
+ return buffer
25
+ }
26
+
27
+ const indent = (string: string, options: any, count = 1) => {
28
+ options = {
29
+ indent: " ",
30
+ includeEmptyLines: false,
31
+ ...options,
32
+ }
33
+
34
+ if (typeof string !== "string") {
35
+ throw new TypeError(
36
+ `Expected \`input\` to be a \`string\`, got \`${typeof string}\``
37
+ )
38
+ }
39
+
40
+ if (typeof count !== "number") {
41
+ throw new TypeError(
42
+ `Expected \`count\` to be a \`number\`, got \`${typeof count}\``
43
+ )
44
+ }
45
+
46
+ if (count < 0) {
47
+ throw new RangeError(
48
+ `Expected \`count\` to be at least 0, got \`${count}\``
49
+ )
50
+ }
51
+
52
+ if (typeof options.indent !== "string") {
53
+ throw new TypeError(
54
+ `Expected \`options.indent\` to be a \`string\`, got \`${typeof options.indent}\``
55
+ )
56
+ }
57
+
58
+ if (count === 0) {
59
+ return string
60
+ }
61
+
62
+ const regex = options.includeEmptyLines ? /^/gm : /^(?!\s*$)/gm
63
+
64
+ return string.replace(regex, options.indent.repeat(count))
65
+ }
66
+
67
+ const Console = {
68
+ // _debug: true,
69
+ _debug: process.env.DEBUG === "true",
70
+ startDebug: function () {
71
+ this._debug = true
72
+ },
73
+ log: (msg: string, ...args: any[]) => console.log(chalk.gray(msg), ...args),
74
+ error: (msg: string, ...args: any[]) =>
75
+ console.log(chalk.red("⨉ " + msg), ...args),
76
+ success: (msg: string, ...args: any[]) =>
77
+ console.log(chalk.green("✓ " + msg), ...args),
78
+ info: (msg: string, ...args: any[]) =>
79
+ console.log(chalk.blue("ⓘ " + msg), ...args),
80
+ help: (msg: string) =>
81
+ console.log(`${chalk.white.bold("⚠ help:")} ${chalk.white(msg)}`),
82
+ debug(...args: any[]) {
83
+ this._debug && console.log(chalk.magentaBright(`⚠ debug: `), args)
84
+ },
85
+ }
86
+
87
+ export default { getMatches, cleanStdout, indent, Console }
@@ -1 +1 @@
1
- declare module '*';
1
+ declare module '*';
@@ -1,71 +1,71 @@
1
- import {prompt} from 'enquirer'
2
- import Console from '../utils/console'
3
- import api from '../utils/api'
4
- // import fetch from 'node-fetch'
5
-
6
- import {ILanguage} from '../models/language'
7
- import {IPackage} from '../models/package'
8
-
9
- export const askPackage = async () => {
10
- Console.info('No package was specified')
11
- const languages = await api.getLangs()
12
-
13
- return new Promise((resolve, reject) => {
14
- if (languages.length === 0) {
15
- // reject(new Error('No categories available'))
16
- reject('No categories available')
17
- // return null;
18
- }
19
-
20
- // let packages = []
21
- prompt([
22
- {
23
- type: 'select',
24
- name: 'lang',
25
- message: 'What language do you want to practice?',
26
- choices: languages.map((l: ILanguage) => ({
27
- message: l.title,
28
- name: l.slug,
29
- })),
30
- },
31
- ])
32
- .then(({lang}: any) => {
33
- return (async () => {
34
- const response = await api.getAllPackages({lang})
35
- const packages = response.results
36
- if (packages.length === 0) {
37
- const error = new Error(`No packages found for language ${lang}`)
38
- Console.error(error.message) // TODO: Look this
39
- return error
40
- }
41
-
42
- return prompt([
43
- {
44
- type: 'select',
45
- name: 'pack',
46
- message: 'Choose one of the packages available',
47
- choices: packages.map((l: IPackage) => ({
48
- message: `${l.title}, difficulty: ${l.difficulty}, downloads: ${
49
- l.downloads
50
- } ${
51
- l.skills.length > 0 ? `(Skills: ${l.skills.join(',')})` : ''
52
- }`,
53
- name: l.slug,
54
- })),
55
- },
56
- ])
57
- })()
58
- })
59
- .then((resp: any) => {
60
- if (!resp)
61
- reject(resp.message || resp)
62
- else
63
- resolve(resp.pack)
64
- })
65
- .catch(error => {
66
- Console.error(error.message || error)
67
- })
68
- })
69
- }
70
-
71
- export default {askPackage}
1
+ import {prompt} from 'enquirer'
2
+ import Console from '../utils/console'
3
+ import api from '../utils/api'
4
+ // import fetch from 'node-fetch'
5
+
6
+ import {ILanguage} from '../models/language'
7
+ import {IPackage} from '../models/package'
8
+
9
+ export const askPackage = async () => {
10
+ Console.info('No package was specified')
11
+ const languages = await api.getLangs()
12
+
13
+ return new Promise((resolve, reject) => {
14
+ if (languages.length === 0) {
15
+ // reject(new Error('No categories available'))
16
+ reject('No categories available')
17
+ // return null;
18
+ }
19
+
20
+ // let packages = []
21
+ prompt([
22
+ {
23
+ type: 'select',
24
+ name: 'lang',
25
+ message: 'What language do you want to practice?',
26
+ choices: languages.map((l: ILanguage) => ({
27
+ message: l.title,
28
+ name: l.slug,
29
+ })),
30
+ },
31
+ ])
32
+ .then(({lang}: any) => {
33
+ return (async () => {
34
+ const response = await api.getAllPackages({lang})
35
+ const packages = response.results
36
+ if (packages.length === 0) {
37
+ const error = new Error(`No packages found for language ${lang}`)
38
+ Console.error(error.message) // TODO: Look this
39
+ return error
40
+ }
41
+
42
+ return prompt([
43
+ {
44
+ type: 'select',
45
+ name: 'pack',
46
+ message: 'Choose one of the packages available',
47
+ choices: packages.map((l: IPackage) => ({
48
+ message: `${l.title}, difficulty: ${l.difficulty}, downloads: ${
49
+ l.downloads
50
+ } ${
51
+ l.skills.length > 0 ? `(Skills: ${l.skills.join(',')})` : ''
52
+ }`,
53
+ name: l.slug,
54
+ })),
55
+ },
56
+ ])
57
+ })()
58
+ })
59
+ .then((resp: any) => {
60
+ if (!resp)
61
+ reject(resp.message || resp)
62
+ else
63
+ resolve(resp.pack)
64
+ })
65
+ .catch(error => {
66
+ Console.error(error.message || error)
67
+ })
68
+ })
69
+ }
70
+
71
+ export default {askPackage}