@learnpack/learnpack 5.0.7 → 5.0.9
Sign up to get free protection for your applications and to get access to all the features.
- package/README.md +17 -17
- package/bin/run +17 -17
- package/bin/run.cmd +3 -3
- package/lib/commands/audit.js +34 -22
- package/lib/commands/clean.js +3 -3
- package/lib/commands/download.js +3 -3
- package/lib/commands/login.js +3 -3
- package/lib/commands/logout.js +3 -3
- package/lib/managers/config/index.d.ts +10 -0
- package/lib/managers/config/index.js +3 -1
- package/oclif.manifest.json +1 -1
- package/package.json +152 -152
- package/src/commands/audit.ts +449 -443
- package/src/commands/clean.ts +29 -29
- package/src/commands/download.ts +61 -61
- package/src/commands/login.ts +42 -42
- package/src/commands/logout.ts +43 -43
- package/src/commands/publish.ts +249 -249
- package/src/commands/test.ts +85 -85
- package/src/index.ts +1 -1
- package/src/managers/config/allowed_files.ts +29 -29
- package/src/managers/config/index.ts +6 -4
- package/src/managers/gitpod.ts +84 -84
- package/src/managers/server/index.ts +78 -78
- package/src/managers/telemetry.ts +353 -353
- package/src/managers/test.ts +83 -83
- package/src/models/audit.ts +16 -16
- package/src/models/config-manager.ts +23 -23
- package/src/models/counter.ts +11 -11
- package/src/models/errors.ts +22 -22
- package/src/models/exercise-obj.ts +29 -29
- package/src/models/file.ts +5 -5
- package/src/models/findings.ts +18 -18
- package/src/models/flags.ts +10 -10
- package/src/models/front-matter.ts +11 -11
- package/src/models/gitpod-data.ts +19 -19
- package/src/models/language.ts +4 -4
- package/src/models/package.ts +7 -7
- package/src/models/plugin-config.ts +17 -17
- package/src/models/success-types.ts +1 -1
- package/src/plugin/command/compile.ts +17 -17
- package/src/plugin/command/test.ts +30 -30
- package/src/plugin/index.ts +6 -6
- package/src/plugin/plugin.ts +94 -94
- package/src/plugin/utils.ts +87 -87
- package/src/types/node-fetch.d.ts +1 -1
- package/src/ui/download.ts +71 -71
- package/src/utils/BaseCommand.ts +48 -48
- package/src/utils/SessionCommand.ts +43 -43
- package/src/utils/audit.ts +393 -393
- package/src/utils/errors.ts +117 -117
- package/src/utils/exercisesQueue.ts +51 -51
- package/src/utils/fileQueue.ts +199 -199
- package/src/utils/misc.ts +23 -23
- package/src/utils/osOperations.ts +79 -79
- package/src/utils/templates/gitignore.txt +19 -19
- package/src/utils/templates/incremental/.learn/exercises/01-hello-world/README.es.md +24 -24
- package/src/utils/templates/incremental/.learn/exercises/01-hello-world/README.md +24 -24
- package/src/utils/templates/incremental/.vscode/schema.json +121 -121
- package/src/utils/templates/incremental/.vscode/settings.json +13 -13
- package/src/utils/templates/incremental/README.ejs +4 -4
- package/src/utils/templates/incremental/README.es.ejs +4 -4
- package/src/utils/templates/isolated/.vscode/schema.json +121 -121
- package/src/utils/templates/isolated/.vscode/settings.json +13 -13
- package/src/utils/templates/isolated/README.ejs +4 -4
- package/src/utils/templates/isolated/README.es.ejs +4 -4
- package/src/utils/templates/no-grading/README.ejs +4 -4
- package/src/utils/templates/no-grading/README.es.ejs +4 -4
- package/src/utils/validators.ts +18 -18
- package/src/utils/watcher.ts +27 -27
package/src/commands/audit.ts
CHANGED
@@ -1,443 +1,449 @@
|
|
1
|
-
import * as fs from "fs"
|
2
|
-
import { validateExerciseDirectoryName } from "../managers/config/exercise"
|
3
|
-
import Console from "../utils/console"
|
4
|
-
import Audit from "../utils/audit"
|
5
|
-
import SessionCommand from "../utils/SessionCommand"
|
6
|
-
import * as path from "path"
|
7
|
-
import { IFile } from "../models/file"
|
8
|
-
import { IExercise } from "../models/exercise-obj"
|
9
|
-
import { IFrontmatter } from "../models/front-matter"
|
10
|
-
import { IAuditErrors } from "../models/audit"
|
11
|
-
import { ICounter } from "../models/counter"
|
12
|
-
import { IFindings } from "../models/findings"
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
const
|
31
|
-
const
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
86
|
-
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
if
|
106
|
-
|
107
|
-
|
108
|
-
|
109
|
-
|
110
|
-
// check if the
|
111
|
-
if (!config!.config?.
|
112
|
-
|
113
|
-
exercise: undefined,
|
114
|
-
msg: "The
|
115
|
-
})
|
116
|
-
// check if the
|
117
|
-
if (!config!.config?.
|
118
|
-
|
119
|
-
exercise: undefined,
|
120
|
-
msg: "The
|
121
|
-
})
|
122
|
-
// check if the
|
123
|
-
if (config!.config?.
|
124
|
-
warnings.push({
|
125
|
-
exercise: undefined,
|
126
|
-
msg: "The
|
127
|
-
})
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
-
|
136
|
-
|
137
|
-
|
138
|
-
|
139
|
-
|
140
|
-
|
141
|
-
// These two lines check if the '
|
142
|
-
Console.debug(
|
143
|
-
"Checking if the
|
144
|
-
)
|
145
|
-
if (!config!.config?.
|
146
|
-
errors.push({
|
147
|
-
exercise: undefined,
|
148
|
-
msg: "The
|
149
|
-
})
|
150
|
-
|
151
|
-
|
152
|
-
|
153
|
-
|
154
|
-
|
155
|
-
|
156
|
-
|
157
|
-
|
158
|
-
|
159
|
-
|
160
|
-
|
161
|
-
|
162
|
-
|
163
|
-
|
164
|
-
|
165
|
-
|
166
|
-
|
167
|
-
|
168
|
-
|
169
|
-
|
170
|
-
|
171
|
-
|
172
|
-
|
173
|
-
|
174
|
-
|
175
|
-
|
176
|
-
|
177
|
-
|
178
|
-
|
179
|
-
|
180
|
-
|
181
|
-
|
182
|
-
|
183
|
-
|
184
|
-
|
185
|
-
|
186
|
-
|
187
|
-
|
188
|
-
|
189
|
-
|
190
|
-
|
191
|
-
|
192
|
-
|
193
|
-
|
194
|
-
|
195
|
-
|
196
|
-
|
197
|
-
|
198
|
-
|
199
|
-
|
200
|
-
|
201
|
-
|
202
|
-
|
203
|
-
|
204
|
-
|
205
|
-
|
206
|
-
|
207
|
-
|
208
|
-
|
209
|
-
|
210
|
-
|
211
|
-
|
212
|
-
|
213
|
-
|
214
|
-
|
215
|
-
)
|
216
|
-
|
217
|
-
|
218
|
-
|
219
|
-
|
220
|
-
|
221
|
-
|
222
|
-
|
223
|
-
|
224
|
-
|
225
|
-
|
226
|
-
|
227
|
-
|
228
|
-
|
229
|
-
|
230
|
-
|
231
|
-
|
232
|
-
|
233
|
-
|
234
|
-
|
235
|
-
|
236
|
-
|
237
|
-
|
238
|
-
|
239
|
-
|
240
|
-
|
241
|
-
|
242
|
-
|
243
|
-
|
244
|
-
|
245
|
-
|
246
|
-
|
247
|
-
|
248
|
-
|
249
|
-
|
250
|
-
|
251
|
-
|
252
|
-
|
253
|
-
|
254
|
-
|
255
|
-
|
256
|
-
|
257
|
-
|
258
|
-
|
259
|
-
|
260
|
-
|
261
|
-
|
262
|
-
|
263
|
-
|
264
|
-
|
265
|
-
|
266
|
-
|
267
|
-
|
268
|
-
|
269
|
-
|
270
|
-
|
271
|
-
|
272
|
-
|
273
|
-
|
274
|
-
|
275
|
-
|
276
|
-
|
277
|
-
|
278
|
-
|
279
|
-
|
280
|
-
|
281
|
-
|
282
|
-
|
283
|
-
|
284
|
-
|
285
|
-
|
286
|
-
|
287
|
-
|
288
|
-
|
289
|
-
|
290
|
-
|
291
|
-
|
292
|
-
|
293
|
-
|
294
|
-
|
295
|
-
|
296
|
-
|
297
|
-
|
298
|
-
|
299
|
-
|
300
|
-
|
301
|
-
|
302
|
-
|
303
|
-
|
304
|
-
|
305
|
-
|
306
|
-
|
307
|
-
|
308
|
-
|
309
|
-
|
310
|
-
|
311
|
-
|
312
|
-
|
313
|
-
|
314
|
-
|
315
|
-
|
316
|
-
|
317
|
-
|
318
|
-
|
319
|
-
|
320
|
-
|
321
|
-
|
322
|
-
|
323
|
-
|
324
|
-
|
325
|
-
|
326
|
-
|
327
|
-
|
328
|
-
|
329
|
-
|
330
|
-
|
331
|
-
|
332
|
-
|
333
|
-
|
334
|
-
|
335
|
-
if (
|
336
|
-
|
337
|
-
|
338
|
-
|
339
|
-
)
|
340
|
-
}
|
341
|
-
|
342
|
-
|
343
|
-
|
344
|
-
|
345
|
-
|
346
|
-
|
347
|
-
|
348
|
-
|
349
|
-
|
350
|
-
|
351
|
-
|
352
|
-
|
353
|
-
|
354
|
-
|
355
|
-
|
356
|
-
|
357
|
-
|
358
|
-
|
359
|
-
|
360
|
-
|
361
|
-
|
362
|
-
|
363
|
-
|
364
|
-
|
365
|
-
|
366
|
-
|
367
|
-
|
368
|
-
|
369
|
-
|
370
|
-
|
371
|
-
|
372
|
-
|
373
|
-
|
374
|
-
|
375
|
-
|
376
|
-
|
377
|
-
|
378
|
-
|
379
|
-
|
380
|
-
|
381
|
-
|
382
|
-
|
383
|
-
|
384
|
-
|
385
|
-
|
386
|
-
|
387
|
-
|
388
|
-
|
389
|
-
|
390
|
-
|
391
|
-
|
392
|
-
|
393
|
-
}
|
394
|
-
|
395
|
-
|
396
|
-
|
397
|
-
|
398
|
-
|
399
|
-
|
400
|
-
|
401
|
-
|
402
|
-
|
403
|
-
|
404
|
-
|
405
|
-
|
406
|
-
|
407
|
-
|
408
|
-
|
409
|
-
|
410
|
-
|
411
|
-
|
412
|
-
|
413
|
-
|
414
|
-
|
415
|
-
|
416
|
-
|
417
|
-
|
418
|
-
|
419
|
-
|
420
|
-
|
421
|
-
|
422
|
-
|
423
|
-
|
424
|
-
|
425
|
-
|
426
|
-
|
427
|
-
|
428
|
-
|
429
|
-
|
430
|
-
|
431
|
-
|
432
|
-
|
433
|
-
|
434
|
-
|
435
|
-
|
436
|
-
|
437
|
-
|
438
|
-
|
439
|
-
|
440
|
-
|
441
|
-
|
442
|
-
|
443
|
-
|
1
|
+
import * as fs from "fs"
|
2
|
+
import { validateExerciseDirectoryName } from "../managers/config/exercise"
|
3
|
+
import Console from "../utils/console"
|
4
|
+
import Audit from "../utils/audit"
|
5
|
+
import SessionCommand from "../utils/SessionCommand"
|
6
|
+
import * as path from "path"
|
7
|
+
import { IFile } from "../models/file"
|
8
|
+
import { IExercise } from "../models/exercise-obj"
|
9
|
+
import { IFrontmatter } from "../models/front-matter"
|
10
|
+
import { IAuditErrors } from "../models/audit"
|
11
|
+
import { ICounter } from "../models/counter"
|
12
|
+
import { IFindings } from "../models/findings"
|
13
|
+
import { getConfigPath } from "../managers/config/index"
|
14
|
+
|
15
|
+
// eslint-disable-next-line
|
16
|
+
const fetch = require("node-fetch");
|
17
|
+
|
18
|
+
class AuditCommand extends SessionCommand {
|
19
|
+
async init() {
|
20
|
+
const { flags } = this.parse(AuditCommand)
|
21
|
+
await this.initSession(flags)
|
22
|
+
}
|
23
|
+
|
24
|
+
async run() {
|
25
|
+
Console.log("Running command audit...")
|
26
|
+
|
27
|
+
// Checking the "learn.json" file:
|
28
|
+
let learnjson
|
29
|
+
try {
|
30
|
+
const configPath: string = getConfigPath().config
|
31
|
+
const learnJsonContent: Buffer = fs.readFileSync(configPath)
|
32
|
+
learnjson = JSON.parse(learnJsonContent.toString())
|
33
|
+
} catch (_error: any) {
|
34
|
+
Console.error("Invalid JSON syntax in learn.json file:", _error.message)
|
35
|
+
process.exit(1)
|
36
|
+
}
|
37
|
+
|
38
|
+
// Get configuration object.
|
39
|
+
let config = this.configManager?.get()
|
40
|
+
|
41
|
+
if (config) {
|
42
|
+
const errors: IAuditErrors[] = []
|
43
|
+
const warnings: IAuditErrors[] = []
|
44
|
+
if (config?.config?.projectType === "tutorial") {
|
45
|
+
const counter: ICounter = {
|
46
|
+
images: {
|
47
|
+
error: 0,
|
48
|
+
total: 0,
|
49
|
+
},
|
50
|
+
links: {
|
51
|
+
error: 0,
|
52
|
+
total: 0,
|
53
|
+
},
|
54
|
+
exercises: 0,
|
55
|
+
readmeFiles: 0,
|
56
|
+
}
|
57
|
+
|
58
|
+
// Checks if learnpack clean has been run
|
59
|
+
Audit.checkLearnpackClean(config, errors)
|
60
|
+
|
61
|
+
// Build exercises if they are not built yet.
|
62
|
+
this.configManager?.buildIndex()
|
63
|
+
config = this.configManager?.get()
|
64
|
+
|
65
|
+
// Check if the exercises folder has some files within any ./exercise
|
66
|
+
const exercisesPath: string = config!.config!.exercisesPath
|
67
|
+
|
68
|
+
fs.readdir(exercisesPath, (err, files) => {
|
69
|
+
if (err) {
|
70
|
+
return console.log("Unable to scan directory: " + err)
|
71
|
+
}
|
72
|
+
|
73
|
+
// listing all files using forEach
|
74
|
+
for (const file of files) {
|
75
|
+
// Do whatever you want to do with the file
|
76
|
+
const filePath: string = path.join(exercisesPath, file)
|
77
|
+
if (fs.statSync(filePath).isFile())
|
78
|
+
warnings.push({
|
79
|
+
exercise: file!,
|
80
|
+
msg: "This file is not inside any exercise folder.",
|
81
|
+
})
|
82
|
+
}
|
83
|
+
})
|
84
|
+
|
85
|
+
// This function is being created because the find method doesn't work with promises.
|
86
|
+
const find = async (file: IFile, lang: string, exercise: IExercise) => {
|
87
|
+
if (file.name === lang) {
|
88
|
+
await Audit.checkUrl(
|
89
|
+
config!,
|
90
|
+
file.path,
|
91
|
+
file.name,
|
92
|
+
exercise,
|
93
|
+
errors,
|
94
|
+
warnings,
|
95
|
+
counter
|
96
|
+
)
|
97
|
+
return true
|
98
|
+
}
|
99
|
+
|
100
|
+
return false
|
101
|
+
}
|
102
|
+
|
103
|
+
Console.debug("config", config)
|
104
|
+
|
105
|
+
Console.info(" Checking if the config file is fine...")
|
106
|
+
// These two lines check if the 'slug' property is inside the configuration object.
|
107
|
+
Console.debug(
|
108
|
+
"Checking if the slug property is inside the configuration object..."
|
109
|
+
)
|
110
|
+
// check if the slug property is in the configuration object
|
111
|
+
if (!config!.config?.slug)
|
112
|
+
errors.push({
|
113
|
+
exercise: undefined,
|
114
|
+
msg: "The slug property is not in the configuration object",
|
115
|
+
})
|
116
|
+
// check if the duration property is in the configuration object
|
117
|
+
if (!config!.config?.duration)
|
118
|
+
warnings.push({
|
119
|
+
exercise: undefined,
|
120
|
+
msg: "The duration property is not in the configuration object",
|
121
|
+
})
|
122
|
+
// check if the difficulty property is in the configuration object
|
123
|
+
if (!config!.config?.difficulty)
|
124
|
+
warnings.push({
|
125
|
+
exercise: undefined,
|
126
|
+
msg: "The difficulty property is not in the configuration object",
|
127
|
+
})
|
128
|
+
// check if the bugs_link property is in the configuration object
|
129
|
+
if (!config!.config?.bugsLink)
|
130
|
+
errors.push({
|
131
|
+
exercise: undefined,
|
132
|
+
msg: "The bugsLink property is not in the configuration object",
|
133
|
+
})
|
134
|
+
// check if the video_solutions property is in the configuration object
|
135
|
+
if (config!.config?.videoSolutions === undefined)
|
136
|
+
warnings.push({
|
137
|
+
exercise: undefined,
|
138
|
+
msg: "The videoSolutions property is not in the configuration object",
|
139
|
+
})
|
140
|
+
|
141
|
+
// These two lines check if the 'repository' property is inside the configuration object.
|
142
|
+
Console.debug(
|
143
|
+
"Checking if the repository property is inside the configuration object..."
|
144
|
+
)
|
145
|
+
if (!config!.config?.repository)
|
146
|
+
errors.push({
|
147
|
+
exercise: undefined,
|
148
|
+
msg: "The repository property is not in the configuration object",
|
149
|
+
})
|
150
|
+
else
|
151
|
+
Audit.isUrl(config!.config?.repository, errors, counter)
|
152
|
+
|
153
|
+
// These two lines check if the 'description' property is inside the configuration object.
|
154
|
+
Console.debug(
|
155
|
+
"Checking if the description property is inside the configuration object..."
|
156
|
+
)
|
157
|
+
if (!config!.config?.description)
|
158
|
+
errors.push({
|
159
|
+
exercise: undefined,
|
160
|
+
msg: "The description property is not in the configuration object",
|
161
|
+
})
|
162
|
+
if (!config!.config?.projectType)
|
163
|
+
errors.push({
|
164
|
+
exercise: undefined,
|
165
|
+
msg: "The projectType property mandatory in the configuration object",
|
166
|
+
})
|
167
|
+
|
168
|
+
if (errors.length === 0)
|
169
|
+
Console.log("The config file is ok")
|
170
|
+
|
171
|
+
// Validates if images and links are working at every README file.
|
172
|
+
const exercises = config!.exercises
|
173
|
+
const readmeFiles = []
|
174
|
+
|
175
|
+
if (exercises && exercises.length > 0) {
|
176
|
+
Console.info(" Checking if the images are working...")
|
177
|
+
for (const index in exercises) {
|
178
|
+
if (Object.prototype.hasOwnProperty.call(exercises, index)) {
|
179
|
+
const exercise = exercises[index]
|
180
|
+
if (!validateExerciseDirectoryName(exercise.title))
|
181
|
+
errors.push({
|
182
|
+
exercise: exercise.title,
|
183
|
+
msg: `The exercise ${exercise.title} has an invalid name.`,
|
184
|
+
})
|
185
|
+
let readmeFilesCount = { exercise: exercise.title, count: 0 }
|
186
|
+
if (Object.keys(exercise.translations!).length === 0)
|
187
|
+
errors.push({
|
188
|
+
exercise: exercise.title,
|
189
|
+
msg: `The exercise ${exercise.title} doesn't have a README.md file.`,
|
190
|
+
})
|
191
|
+
|
192
|
+
if (
|
193
|
+
exercise.language === "python3" ||
|
194
|
+
exercise.language === "python"
|
195
|
+
) {
|
196
|
+
for (const f of exercise.files.map(f => f)) {
|
197
|
+
if (
|
198
|
+
f.path.includes("test.py") ||
|
199
|
+
f.path.includes("tests.py")
|
200
|
+
) {
|
201
|
+
const content = fs.readFileSync(f.path).toString()
|
202
|
+
const isEmpty = Audit.checkForEmptySpaces(content)
|
203
|
+
if (isEmpty || !content)
|
204
|
+
errors.push({
|
205
|
+
exercise: exercise.title,
|
206
|
+
msg: `This file (${f.name}) doesn't have any content inside.`,
|
207
|
+
})
|
208
|
+
}
|
209
|
+
}
|
210
|
+
} else {
|
211
|
+
for (const f of exercise.files.map(f => f)) {
|
212
|
+
if (
|
213
|
+
f.path.includes("test.js") ||
|
214
|
+
f.path.includes("tests.js")
|
215
|
+
) {
|
216
|
+
const content = fs.readFileSync(f.path).toString()
|
217
|
+
const isEmpty: boolean = Audit.checkForEmptySpaces(content)
|
218
|
+
if (isEmpty || !content)
|
219
|
+
errors.push({
|
220
|
+
exercise: exercise.title,
|
221
|
+
msg: `This file (${f.name}) doesn't have any content inside.`,
|
222
|
+
})
|
223
|
+
}
|
224
|
+
}
|
225
|
+
}
|
226
|
+
|
227
|
+
for (const lang in exercise.translations) {
|
228
|
+
if (
|
229
|
+
Object.prototype.hasOwnProperty.call(
|
230
|
+
exercise.translations,
|
231
|
+
lang
|
232
|
+
)
|
233
|
+
) {
|
234
|
+
const files: any[] = []
|
235
|
+
const findResultPromises = []
|
236
|
+
for (const file of exercise.files) {
|
237
|
+
const found = find(
|
238
|
+
file,
|
239
|
+
exercise.translations[lang],
|
240
|
+
exercise
|
241
|
+
)
|
242
|
+
findResultPromises.push(found)
|
243
|
+
}
|
244
|
+
// eslint-disable-next-line
|
245
|
+
let findResults = await Promise.all(findResultPromises);
|
246
|
+
for (const found of findResults) {
|
247
|
+
if (found) {
|
248
|
+
readmeFilesCount = {
|
249
|
+
...readmeFilesCount,
|
250
|
+
count: readmeFilesCount.count + 1,
|
251
|
+
}
|
252
|
+
files.push(found)
|
253
|
+
}
|
254
|
+
}
|
255
|
+
|
256
|
+
if (!files.includes(true))
|
257
|
+
errors.push({
|
258
|
+
exercise: exercise.title,
|
259
|
+
msg: "This exercise doesn't have a README.md file.",
|
260
|
+
})
|
261
|
+
}
|
262
|
+
}
|
263
|
+
|
264
|
+
readmeFiles.push(readmeFilesCount)
|
265
|
+
}
|
266
|
+
}
|
267
|
+
} else
|
268
|
+
errors.push({
|
269
|
+
exercise: undefined,
|
270
|
+
msg: "The exercises array is empty.",
|
271
|
+
})
|
272
|
+
|
273
|
+
Console.log(
|
274
|
+
`${counter.images.total - counter.images.error} images ok from ${
|
275
|
+
counter.images.total
|
276
|
+
}`
|
277
|
+
)
|
278
|
+
|
279
|
+
Console.info(
|
280
|
+
" Checking if important files are missing... (README's, translations, gitignore...)"
|
281
|
+
)
|
282
|
+
// Check if all the exercises has the same ammount of README's, this way we can check if they have the same ammount of translations.
|
283
|
+
const files: string[] = []
|
284
|
+
let count = 0
|
285
|
+
for (const item of readmeFiles) {
|
286
|
+
if (count < item.count)
|
287
|
+
count = item.count
|
288
|
+
}
|
289
|
+
|
290
|
+
for (const item of readmeFiles) {
|
291
|
+
if (item.count !== count)
|
292
|
+
files.push(` ${item.exercise}`)
|
293
|
+
}
|
294
|
+
|
295
|
+
if (files.length > 0) {
|
296
|
+
const filesString: string = files.join(",")
|
297
|
+
warnings.push({
|
298
|
+
exercise: undefined,
|
299
|
+
msg:
|
300
|
+
files.length === 1 ?
|
301
|
+
`This exercise is missing translations:${filesString}` :
|
302
|
+
`These exercises are missing translations:${filesString}`,
|
303
|
+
})
|
304
|
+
}
|
305
|
+
|
306
|
+
// Checks if the .gitignore file exists.
|
307
|
+
if (!fs.existsSync(".gitignore"))
|
308
|
+
warnings.push({
|
309
|
+
exercise: undefined,
|
310
|
+
msg: ".gitignore file doesn't exist",
|
311
|
+
})
|
312
|
+
|
313
|
+
counter.exercises = exercises!.length
|
314
|
+
for (const readme of readmeFiles) {
|
315
|
+
counter.readmeFiles += readme.count
|
316
|
+
}
|
317
|
+
} else {
|
318
|
+
// This is the audit code for Projects
|
319
|
+
|
320
|
+
if (!learnjson) {
|
321
|
+
Console.error(
|
322
|
+
"There is no learn.json file located in the root of the project."
|
323
|
+
)
|
324
|
+
process.exit(1)
|
325
|
+
}
|
326
|
+
|
327
|
+
// Checking the README.md files and possible translations.
|
328
|
+
let readmeFiles: any[] = []
|
329
|
+
const translations: string[] = []
|
330
|
+
const translationRegex = /README\.([a-z]{2,3})\.md/
|
331
|
+
|
332
|
+
try {
|
333
|
+
const data = await fs.promises.readdir("./")
|
334
|
+
readmeFiles = data.filter(file => file.includes("README"))
|
335
|
+
if (readmeFiles.length === 0)
|
336
|
+
errors.push({
|
337
|
+
exercise: undefined!,
|
338
|
+
msg: `There is no README file in the repository.`,
|
339
|
+
})
|
340
|
+
} catch (error) {
|
341
|
+
if (error)
|
342
|
+
Console.error(
|
343
|
+
"There was an error getting the directory files",
|
344
|
+
error
|
345
|
+
)
|
346
|
+
}
|
347
|
+
|
348
|
+
for (const readmeFile of readmeFiles) {
|
349
|
+
// Checking the language of each README file.
|
350
|
+
if (readmeFile === "README.md")
|
351
|
+
translations.push("us")
|
352
|
+
else {
|
353
|
+
const regexGroups = translationRegex.exec(readmeFile)
|
354
|
+
if (regexGroups)
|
355
|
+
translations.push(regexGroups[1])
|
356
|
+
}
|
357
|
+
|
358
|
+
const readme = fs.readFileSync(path.resolve(readmeFile)).toString()
|
359
|
+
|
360
|
+
const isEmpty = Audit.checkForEmptySpaces(readme)
|
361
|
+
if (isEmpty || !readme) {
|
362
|
+
errors.push({
|
363
|
+
exercise: undefined!,
|
364
|
+
msg: `This file "${readmeFile}" doesn't have any content inside.`,
|
365
|
+
})
|
366
|
+
continue
|
367
|
+
}
|
368
|
+
|
369
|
+
if (readme.length < 800)
|
370
|
+
errors.push({
|
371
|
+
exercise: undefined,
|
372
|
+
msg: `The "${readmeFile}" file should have at least 800 characters (It currently have: ${readme.length}).`,
|
373
|
+
})
|
374
|
+
|
375
|
+
// eslint-disable-next-line
|
376
|
+
await Audit.checkUrl(
|
377
|
+
config!,
|
378
|
+
path.resolve(readmeFile),
|
379
|
+
readmeFile,
|
380
|
+
undefined,
|
381
|
+
errors,
|
382
|
+
warnings,
|
383
|
+
// eslint-disable-next-line
|
384
|
+
undefined
|
385
|
+
)
|
386
|
+
}
|
387
|
+
|
388
|
+
// Adding the translations to the learn.json
|
389
|
+
learnjson.translations = translations
|
390
|
+
|
391
|
+
// Checking if the preview image (from the learn.json) is OK.
|
392
|
+
try {
|
393
|
+
const res = await fetch(learnjson.preview, { method: "HEAD" })
|
394
|
+
if (res.status > 399 && res.status < 500) {
|
395
|
+
errors.push({
|
396
|
+
exercise: undefined,
|
397
|
+
msg: `The link of the "preview" is broken: ${learnjson.preview}`,
|
398
|
+
})
|
399
|
+
}
|
400
|
+
} catch {
|
401
|
+
errors.push({
|
402
|
+
exercise: undefined,
|
403
|
+
msg: `The link of the "preview" is broken: ${learnjson.preview}`,
|
404
|
+
})
|
405
|
+
}
|
406
|
+
|
407
|
+
const date = new Date()
|
408
|
+
learnjson.validationAt = date.getTime()
|
409
|
+
|
410
|
+
if (errors.length > 0)
|
411
|
+
learnjson.validationStatus = "error"
|
412
|
+
else if (warnings.length > 0)
|
413
|
+
learnjson.validationStatus = "warning"
|
414
|
+
else
|
415
|
+
learnjson.validationStatus = "success"
|
416
|
+
|
417
|
+
// Writes the "learn.json" file with all the new properties
|
418
|
+
await fs.promises.writeFile("./learn.json", JSON.stringify(learnjson))
|
419
|
+
}
|
420
|
+
|
421
|
+
await Audit.showWarnings(warnings)
|
422
|
+
// eslint-disable-next-line
|
423
|
+
await Audit.showErrors(errors, undefined);
|
424
|
+
}
|
425
|
+
}
|
426
|
+
}
|
427
|
+
|
428
|
+
AuditCommand.description = `learnpack audit is the command in charge of creating an auditory of the repository
|
429
|
+
...
|
430
|
+
learnpack audit checks for the following information in a repository:
|
431
|
+
1. The configuration object has slug, repository and description. (Error)
|
432
|
+
2. The command learnpack clean has been run. (Error)
|
433
|
+
3. If a markdown or test file doesn't have any content. (Error)
|
434
|
+
4. The links are accessing to valid servers. (Error)
|
435
|
+
5. The relative images are working (If they have the shortest path to the image or if the images exists in the assets). (Error)
|
436
|
+
6. The external images are working (If they are pointing to a valid server). (Error)
|
437
|
+
7. The exercises directory names are valid. (Error)
|
438
|
+
8. If an exercise doesn't have a README file. (Error)
|
439
|
+
9. The exercises array (Of the config file) has content. (Error)
|
440
|
+
10. The exercses have the same translations. (Warning)
|
441
|
+
11. The .gitignore file exists. (Warning)
|
442
|
+
12. If there is a file within the exercises folder but not inside of any particular exercise's folder. (Warning)
|
443
|
+
`
|
444
|
+
|
445
|
+
AuditCommand.flags = {
|
446
|
+
// name: flags.string({char: 'n', description: 'name to print'}),
|
447
|
+
}
|
448
|
+
|
449
|
+
export default AuditCommand
|