@sasjs/cli 4.5.1 → 4.7.0

package/build/commands/docs/spec/docsCommand.spec.js

@@ -358,7 +358,6 @@ var setupMocks = function () {
     jest
         .spyOn(configUtils, 'findTargetInConfiguration')
         .mockImplementation(function () { return Promise.resolve({ target: target, isLocal: true }); });
-    jest.spyOn(process.logger, 'error');
     jest
         .spyOn(configUtils, 'getLocalConfig')
         .mockImplementation(function () { return Promise.resolve(config); });

package/build/commands/help/help.js

@@ -322,6 +322,17 @@ function printHelpText() {
                         "[2spaces]NOTE: Providing outDirectory flag is optional. If not present, CLI will use save outputs into sasjsresults folder.",
                         "[2spaces]NOTE: Providing force (--force or -f) flag is optional. If present, CLI will force command to finish running all tests and will not return an error code even when some are failing. Useful when the requirement is not to make CI Pipeline fail."
                     ]
+                },
+                {
+                    name: 'snippets',
+                    title: 'snippets',
+                    description: [
+                        "Generates VS Code snippets from the Doxygen headers in the SAS Macros.",
+                        "[2spaces]command example: sasjs snippets --outDirectory <folderPath> --target <targetName>",
+                        "",
+                        "[2spaces]NOTE: Providing <folderPath> is optional. If not present, generated snippets will be saved to 'sasjsresults/sasjs-macro-snippets.json' file.",
+                        "[2spaces]NOTE: more information can be found here https://cli.sasjs.io/snippets/."
+                    ]
                 }
             ];
             aliases = [

package/build/commands/snippets/snippets.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates VS Code snippets from the Doxygen headers in the SAS Macros.
+ * @param macroFolders an array of file paths of SAS Macros.
+ * @param outDirectory a folder path where generated snippets should be put into. If ends with '<file name>.json' then provided file name will be used, otherwise default file name ('sasjs-macro-snippets.json') will be used.
+ * @returns a promise that resolves into a file path with generated VS Code snippets.
+ */
+export declare function generateSnippets(macroFolders: string[], outDirectory?: string): Promise<string>;

package/build/commands/snippets/snippets.js

@@ -0,0 +1,192 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSnippets = void 0;
+var utils_1 = require("@sasjs/utils");
+var path_1 = __importDefault(require("path"));
+var sasRegExp = /\.sas$/; // to check if file has .sas extension
+var briefRegExp = /^\s\s@brief\s/; // to get lines that has @brief keyword
+var paramRegExp = /^\s\s@param\s/; // to get lines that has @param keyword
+/**
+ * Generates VS Code snippets from the Doxygen headers in the SAS Macros.
+ * @param macroFolders an array of file paths of SAS Macros.
+ * @param outDirectory a folder path where generated snippets should be put into. If ends with '<file name>.json' then provided file name will be used, otherwise default file name ('sasjs-macro-snippets.json') will be used.
+ * @returns a promise that resolves into a file path with generated VS Code snippets.
+ */
+function generateSnippets(macroFolders, outDirectory) {
+    return __awaiter(this, void 0, void 0, function () {
+        var snippets, defaultOutputFileName, buildDestinationResultsFolder, snippetsFilePath;
+        var _this = this;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    snippets = {};
+                    // return an error if no macro folders has been provided
+                    if (!macroFolders.length) {
+                        return [2 /*return*/, Promise.reject("\"macroFolders\" array was not found in sasjs/sasjsconfig.json.")];
+                    }
+                    // generate snippets from all .sas file in macro folders
+                    return [4 /*yield*/, (0, utils_1.asyncForEach)(macroFolders, function (folder) { return __awaiter(_this, void 0, void 0, function () {
+                            var sasFiles;
+                            var _this = this;
+                            return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0: return [4 /*yield*/, (0, utils_1.listSasFilesInFolder)(folder, true)];
+                                    case 1:
+                                        sasFiles = (_a.sent())
+                                            .map(function (file) { return path_1.default.join(folder, file); })
+                                            .filter(function (file) { return !(0, utils_1.isTestFile)(file); });
+                                        return [4 /*yield*/, (0, utils_1.asyncForEach)(sasFiles, function (file) { return __awaiter(_this, void 0, void 0, function () {
+                                                var macro, _a, _b;
+                                                return __generator(this, function (_c) {
+                                                    switch (_c.label) {
+                                                        case 0:
+                                                            macro = file.split(path_1.default.sep).pop().replace(sasRegExp, '');
+                                                            // put generated snippet into snippets object
+                                                            _a = snippets;
+                                                            _b = macro;
+                                                            return [4 /*yield*/, createSnippetFromMacro(file)];
+                                                        case 1:
+                                                            // put generated snippet into snippets object
+                                                            _a[_b] = _c.sent();
+                                                            return [2 /*return*/];
+                                                    }
+                                                });
+                                            }); })];
+                                    case 2:
+                                        _a.sent();
+                                        return [2 /*return*/];
+                                }
+                            });
+                        }); })
+                        // return an error if no snippets has been generated
+                    ];
+                case 1:
+                    // generate snippets from all .sas file in macro folders
+                    _a.sent();
+                    // return an error if no snippets has been generated
+                    if (!Object.keys(snippets).length) {
+                        return [2 /*return*/, Promise.reject('No VS Code snippets has been found.')];
+                    }
+                    defaultOutputFileName = 'sasjs-macro-snippets.json';
+                    buildDestinationResultsFolder = process.sasjsConstants.buildDestinationResultsFolder;
+                    snippetsFilePath = path_1.default.join(outDirectory ? process.projectDir : buildDestinationResultsFolder, outDirectory
+                        ? /\.json$/.test(outDirectory)
+                            ? outDirectory
+                            : path_1.default.join(outDirectory, defaultOutputFileName)
+                        : defaultOutputFileName);
+                    // create file with generated VS Code snippets
+                    return [4 /*yield*/, (0, utils_1.createFile)(snippetsFilePath, JSON.stringify(snippets, null, 2))
+                        // return file path with generated VS Code snippets
+                    ];
+                case 2:
+                    // create file with generated VS Code snippets
+                    _a.sent();
+                    // return file path with generated VS Code snippets
+                    return [2 /*return*/, Promise.resolve(snippetsFilePath)];
+            }
+        });
+    });
+}
+exports.generateSnippets = generateSnippets;
+/**
+ * Creates a VS Code snippet from SAS macro.
+ * @param file file path of SAS macro.
+ * @returns promise that resolves with VS Code snippet.
+ */
+var createSnippetFromMacro = function (file) { return __awaiter(void 0, void 0, void 0, function () {
+    var fileContent, lineEnding, lines, brief, params, macro, description;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, utils_1.readFile)(file)];
+            case 1:
+                fileContent = _a.sent();
+                lineEnding = (0, utils_1.getLineEnding)(fileContent) // LF or CRLF
+                ;
+                lines = fileContent.split(lineEnding);
+                brief = lines.filter(function (line) { return briefRegExp.test(line); });
+                params = lines.filter(function (line) { return paramRegExp.test(line); });
+                macro = file.split(path_1.default.sep).pop().replace(sasRegExp, '') // macro name
+                ;
+                // if brief present, remove @brief keyword
+                if (brief.length)
+                    brief = [brief[0].replace(briefRegExp, '')];
+                // if params present, add a line break before list of params and a prefix to each param
+                if (params.length) {
+                    brief.push('\r');
+                    params = params.map(function (param) { return param.replace(paramRegExp, '-'); });
+                }
+                description = __spreadArray(__spreadArray(__spreadArray([], __read(brief), false), [
+                    params.length ? "Params:" : ''
+                ], false), __read(params), false).filter(function (line) { return line; });
+                return [2 /*return*/, {
+                        prefix: "%".concat(macro),
+                        body: "%".concat(macro, "($1)"),
+                        description: description
+                    }];
+        }
+    });
+}); };

package/build/commands/snippets/snippetsCommand.d.ts

@@ -0,0 +1,13 @@
+import { ReturnCode } from '../../types/command';
+import { TargetCommand } from '../../types/command/targetCommand';
+/**
+ * 'snippets' command class.
+ */
+export declare class SnippetsCommand extends TargetCommand {
+    constructor(args: string[]);
+    /**
+     * Command execution method.
+     * @returns promise that results into return code.
+     */
+    execute(): Promise<ReturnCode>;
+}

package/build/commands/snippets/snippetsCommand.js

@@ -0,0 +1,122 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnippetsCommand = void 0;
+var snippets_1 = require("./snippets");
+var command_1 = require("../../types/command");
+var targetCommand_1 = require("../../types/command/targetCommand");
+var utils_1 = require("../../utils");
+var syntax = 'snippets';
+var usage = 'sasjs snippets';
+var description = "Generates VS Code snippets from the Doxygen headers in the SAS Macros.";
+var examples = [
+    {
+        command: 'sasjs snippets',
+        description: description
+    }
+];
+var parseOptions = {
+    outDirectory: {
+        type: 'string',
+        alias: 'o',
+        description: 'Path to the directory where the VS Code snippets output will be generated.'
+    }
+};
+/**
+ * 'snippets' command class.
+ */
+var SnippetsCommand = /** @class */ (function (_super) {
+    __extends(SnippetsCommand, _super);
+    function SnippetsCommand(args) {
+        return _super.call(this, args, { syntax: syntax, usage: usage, description: description, examples: examples, parseOptions: parseOptions }) || this;
+    }
+    /**
+     * Command execution method.
+     * @returns promise that results into return code.
+     */
+    SnippetsCommand.prototype.execute = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var target, macroFolders, outDirectory;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.getTargetInfo()];
+                    case 1:
+                        target = (_a.sent()).target;
+                        return [4 /*yield*/, (0, utils_1.getMacroFolders)(target)];
+                    case 2:
+                        macroFolders = _a.sent();
+                        outDirectory = this.parsed.outDirectory;
+                        return [4 /*yield*/, (0, snippets_1.generateSnippets)(macroFolders, outDirectory)
+                                .then(function (filePath) {
+                                var _a, _b;
+                                // handle command execution success
+                                (_a = process.logger) === null || _a === void 0 ? void 0 : _a.success("VS Code snippets generated! File location: ".concat(filePath));
+                                (_b = process.logger) === null || _b === void 0 ? void 0 : _b.info("Follow these instructions https://cli.sasjs.io/snippets/#import-snippets-to-vs-code to import generated VS Code snippets into your VS Code.");
+                                return command_1.ReturnCode.Success;
+                            })
+                                .catch(function (err) {
+                                var _a;
+                                // handle command execution failure
+                                (_a = process.logger) === null || _a === void 0 ? void 0 : _a.error('Error generating VS Code snippets: ', err);
+                                return command_1.ReturnCode.InternalError;
+                            })];
+                    case 3: 
+                    // Generate snippets
+                    return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
+    return SnippetsCommand;
+}(targetCommand_1.TargetCommand));
+exports.SnippetsCommand = SnippetsCommand;

package/build/commands/snippets/spec/snippets.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/build/commands/snippets/spec/snippets.spec.js

@@ -0,0 +1,250 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var snippets_1 = require("../snippets");
+var utils_1 = require("@sasjs/utils");
+var path_1 = __importDefault(require("path"));
+var utils_2 = require("../../../utils");
+describe('sasjs snippets', function () {
+    var testMacroFolder1 = 'testMacros';
+    var testMacroFolder2 = 'testMacros2';
+    var emptyMacroFolder = 'empty';
+    var customOutputFilePath = 'snippets.json';
+    var defaultFileName = 'sasjs-macro-snippets.json';
+    var defaultOutputFilePath = path_1.default.join(__dirname, 'sasjsresults', defaultFileName);
+    var customOutputFolder = 'snippets';
+    var customOutputFolderWithDefaultFileName = path_1.default.join(__dirname, customOutputFolder, defaultFileName);
+    var buildDestinationResultsFolder = path_1.default.join(__dirname, 'sasjsresults');
+    beforeAll(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, (0, utils_2.setConstants)(false)];
+                case 1:
+                    _a.sent();
+                    process.projectDir = __dirname;
+                    process.sasjsConstants.buildDestinationResultsFolder =
+                        buildDestinationResultsFolder;
+                    process.sasjsConstants.buildSourceFolder = __dirname;
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    afterAll(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, (0, utils_1.deleteFolder)(path_1.default.join(__dirname, customOutputFolder))];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, (0, utils_1.deleteFile)(path_1.default.join(__dirname, customOutputFilePath))];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, (0, utils_1.deleteFolder)(buildDestinationResultsFolder)];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('should generate snippets', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var target, config, macroFolders, outputFilePath, expectedSnippets, generatedSnippets, _a, _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    target = new utils_1.Target({
+                        name: 'test',
+                        appLoc: '/Public/test/',
+                        serverType: utils_1.ServerType.SasViya,
+                        macroFolders: [testMacroFolder1]
+                    });
+                    config = {
+                        macroFolders: [testMacroFolder2],
+                        targets: [target]
+                    };
+                    process.sasjsConfig = config;
+                    return [4 /*yield*/, (0, utils_2.getMacroFolders)(target)];
+                case 1:
+                    macroFolders = _c.sent();
+                    return [4 /*yield*/, (0, snippets_1.generateSnippets)(macroFolders, customOutputFilePath)];
+                case 2:
+                    _c.sent();
+                    outputFilePath = path_1.default.join(__dirname, customOutputFilePath);
+                    return [4 /*yield*/, expect((0, utils_1.fileExists)(outputFilePath)).resolves.toEqual(true)];
+                case 3:
+                    _c.sent();
+                    expectedSnippets = {
+                        macro2: {
+                            prefix: '%macro2',
+                            body: '%macro2($1)',
+                            description: [
+                                'Macro 2',
+                                '\r',
+                                'Params:',
+                                '-msg The message to be printed'
+                            ]
+                        },
+                        badMacro: {
+                            prefix: '%badMacro',
+                            body: '%badMacro($1)',
+                            description: []
+                        },
+                        example: {
+                            prefix: '%example',
+                            body: '%example($1)',
+                            description: [
+                                'An example macro',
+                                '\r',
+                                'Params:',
+                                '-msg The message to be printed'
+                            ]
+                        },
+                        subMacro: {
+                            prefix: '%subMacro',
+                            body: '%subMacro($1)',
+                            description: [
+                                'A sub macro',
+                                '\r',
+                                'Params:',
+                                '-msg The message to be printed'
+                            ]
+                        },
+                        subSubMacro: {
+                            prefix: '%subSubMacro',
+                            body: '%subSubMacro($1)',
+                            description: [
+                                'A sub sub macro',
+                                '\r',
+                                'Params:',
+                                '-msg The message to be printed'
+                            ]
+                        }
+                    };
+                    _b = (_a = JSON).parse;
+                    return [4 /*yield*/, (0, utils_1.readFile)(outputFilePath)];
+                case 4:
+                    generatedSnippets = _b.apply(_a, [_c.sent()]);
+                    expect(generatedSnippets).toEqual(expectedSnippets);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('should generate snippets with default file name', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var targetWithoutMacroFolders, config, macroFolders;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    targetWithoutMacroFolders = new utils_1.Target({
+                        name: 'test',
+                        appLoc: '/Public/test/',
+                        serverType: utils_1.ServerType.SasViya
+                    });
+                    config = {
+                        macroFolders: [testMacroFolder2],
+                        targets: [targetWithoutMacroFolders]
+                    };
+                    process.sasjsConfig = config;
+                    return [4 /*yield*/, (0, utils_2.getMacroFolders)(targetWithoutMacroFolders)];
+                case 1:
+                    macroFolders = _a.sent();
+                    return [4 /*yield*/, (0, snippets_1.generateSnippets)(macroFolders)];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, expect((0, utils_1.fileExists)(defaultOutputFilePath)).resolves.toEqual(true)];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('should generate snippets with custom folder and default file name', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var config, macroFolders;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    config = { macroFolders: [testMacroFolder2] };
+                    process.sasjsConfig = config;
+                    return [4 /*yield*/, (0, utils_2.getMacroFolders)()];
+                case 1:
+                    macroFolders = _a.sent();
+                    return [4 /*yield*/, (0, snippets_1.generateSnippets)(macroFolders, customOutputFolder)];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, expect((0, utils_1.fileExists)(customOutputFolderWithDefaultFileName)).resolves.toEqual(true)];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('should return an error if macroFolders array was not provided', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var config, macroFolders;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    config = {};
+                    process.sasjsConfig = config;
+                    return [4 /*yield*/, (0, utils_2.getMacroFolders)()];
+                case 1:
+                    macroFolders = _a.sent();
+                    return [4 /*yield*/, expect((0, snippets_1.generateSnippets)(macroFolders)).rejects.toEqual('"macroFolders" array was not found in sasjs/sasjsconfig.json.')];
+                case 2:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('should return an error if macros were not found', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var config, macroFolders;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    config = { macroFolders: [emptyMacroFolder] };
+                    process.sasjsConfig = config;
+                    return [4 /*yield*/, (0, utils_2.getMacroFolders)()];
+                case 1:
+                    macroFolders = _a.sent();
+                    return [4 /*yield*/, expect((0, snippets_1.generateSnippets)(macroFolders)).rejects.toEqual('No VS Code snippets has been found.')];
+                case 2:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});

package/build/commands/snippets/spec/snippetsCommand.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/build/commands/snippets/spec/snippetsCommand.spec.js

@@ -0,0 +1,195 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var snippetsCommand_1 = require("../snippetsCommand");
+var snippetsModule = __importStar(require("../snippets"));
+var command_1 = require("../../../types/command");
+var utils_1 = require("@sasjs/utils");
+var configUtils = __importStar(require("../../../utils/config"));
+var setConstantsUtils = __importStar(require("../../../utils/setConstants"));
+var logger_1 = require("@sasjs/utils/logger");
+var utils_2 = require("../../../utils");
+var target = new utils_1.Target({
+    name: 'test',
+    appLoc: '/Public/test/',
+    serverType: utils_1.ServerType.SasViya,
+    contextName: 'test context'
+});
+var config = {};
+describe('SnippetsCommand', function () {
+    var defaultArgs = ['node', 'sasjs'];
+    var commandName = 'snippets';
+    beforeAll(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, (0, utils_2.setConstants)(false)];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    beforeEach(function () {
+        setupMocks();
+    });
+    it('should parse sasjs snippets command without flags', function () {
+        var args = __spreadArray(__spreadArray([], __read(defaultArgs), false), [commandName], false);
+        var command = new snippetsCommand_1.SnippetsCommand(args);
+        expect(command.name).toEqual(commandName);
+    });
+    it('should call snippets handler when executed', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var args, command, returnCode;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    args = __spreadArray(__spreadArray([], __read(defaultArgs), false), [commandName], false);
+                    command = new snippetsCommand_1.SnippetsCommand(args);
+                    return [4 /*yield*/, command.execute()];
+                case 1:
+                    returnCode = _a.sent();
+                    expect(returnCode).toEqual(command_1.ReturnCode.Success);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('should parse a sasjs snippets command with a target', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var args, command, targetInfo;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    args = __spreadArray(__spreadArray([], __read(defaultArgs), false), [commandName, '-t', 'test'], false);
+                    command = new snippetsCommand_1.SnippetsCommand(args);
+                    return [4 /*yield*/, command.getTargetInfo()];
+                case 1:
+                    targetInfo = _a.sent();
+                    expect(command.name).toEqual(commandName);
+                    expect(command.subCommand).toEqual('');
+                    expect(targetInfo.target).toEqual(target);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('should return with the error code when execution fails', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var args, command, returnCode;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    args = __spreadArray(__spreadArray([], __read(defaultArgs), false), [commandName], false);
+                    jest
+                        .spyOn(snippetsModule, 'generateSnippets')
+                        .mockImplementation(function () { return Promise.reject(); });
+                    command = new snippetsCommand_1.SnippetsCommand(args);
+                    return [4 /*yield*/, command.execute()];
+                case 1:
+                    returnCode = _a.sent();
+                    expect(returnCode).toEqual(command_1.ReturnCode.InternalError);
+                    expect(process.logger.error).toHaveBeenCalled();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+var setupMocks = function () {
+    jest.resetAllMocks();
+    jest
+        .spyOn(snippetsModule, 'generateSnippets')
+        .mockImplementation(function () { return Promise.resolve(''); });
+    jest
+        .spyOn(configUtils, 'findTargetInConfiguration')
+        .mockImplementation(function () { return Promise.resolve({ target: target, isLocal: true }); });
+    jest
+        .spyOn(configUtils, 'getLocalConfig')
+        .mockImplementation(function () { return Promise.resolve(config); });
+    jest
+        .spyOn(configUtils, 'findTargetInConfiguration')
+        .mockImplementation(function () { return Promise.resolve({ target: target, isLocal: true }); });
+    jest
+        .spyOn(setConstantsUtils, 'setConstants')
+        .mockImplementation(function () { return Promise.resolve(); });
+    process.logger = new logger_1.Logger(logger_1.LogLevel.Off);
+    jest.spyOn(process.logger, 'success');
+    jest.spyOn(process.logger, 'error');
+};

package/build/types/command/commandFactory.js

@@ -24,6 +24,7 @@ var jobCommand_1 = require("../../commands/job/jobCommand");
 var lintCommand_1 = require("../../commands/lint/lintCommand");
 var flowCommand_1 = require("../../commands/flow/flowCommand");
 var fsCommand_1 = require("../../commands/fs/fsCommand");
+var snippetsCommand_1 = require("../../commands/snippets/snippetsCommand");
 exports.commandFactory = new Map([
     ['add', function (args) { return new addCommand_1.AddCommand(args); }],
     ['build', function (args) { return new buildCommand_1.BuildCommand(args); }],
@@ -48,6 +49,7 @@ exports.commandFactory = new Map([
     ['request', function (args) { return new requestCommand_1.RequestCommand(args); }],
     ['run', function (args) { return new runCommand_1.RunCommand(args); }],
     ['servicepack', function (args) { return new servicePackCommand_1.ServicePackCommand(args); }],
+    ['snippets', function (args) { return new snippetsCommand_1.SnippetsCommand(args); }],
     ['version', function (args) { return new versionCommand_1.VersionCommand(args); }],
     ['test', function (args) { return new testCommand_1.TestCommand(args); }],
     ['web', function (args) { return new webCommand_1.WebCommand(args); }]

package/build/utils/config.js

@@ -1148,7 +1148,16 @@ exports.getTestTearDown = getTestTearDown;
  * @returns - instance of @sasjs/adapter.
  */
 function getSASjs(target) {
-    var verbose = process.env.VERBOSE;
+    var _a = process.env, VERBOSE = _a.VERBOSE, LOG_LEVEL = _a.LOG_LEVEL;
+    var verbose = false;
+    // verbose mode should be enabled if VERBOSE environment variable present and is equal to 'on'(case insensitive)
+    if (typeof VERBOSE === 'string' && /on/i.test(VERBOSE)) {
+        verbose = true;
+    }
+    // verbose mode should be enabled if LOG_LEVEL environment variable present and is equal to 'trace'(case insensitive)
+    else if (typeof LOG_LEVEL === 'string' && /trace/i.test(LOG_LEVEL)) {
+        verbose = true;
+    }
     return new node_1.default({
         serverUrl: target.serverUrl,
         appLoc: target.appLoc,
@@ -1157,7 +1166,7 @@ function getSASjs(target) {
         httpsAgentOptions: target.httpsAgentOptions,
         debug: true,
         useComputeApi: target.serverType === utils_1.ServerType.SasViya,
-        verbose: typeof verbose === 'string' ? /on/i.test(verbose) : false // only string equal to 'on'(case insensitive) will enable verbose mode
+        verbose: verbose
     });
 }
 exports.getSASjs = getSASjs;

package/build/utils/spec/config.spec.js

@@ -782,15 +782,29 @@ describe('getSASjs', function () {
         verbose = sasjsConfig.verbose;
         expect(verbose).toEqual(true);
     });
-    it('should disable verbose mode if VERBOSE env is not present', function () {
+    it("should enable verbose mode if LOG_LEVEL env is present and is equal to 'trace'(case insensitive)", function () {
+        process.env.LOG_LEVEL = 'trace';
+        var sasjs = (0, config_1.getSASjs)({});
+        var sasjsConfig = sasjs.getSasjsConfig();
+        var verbose = sasjsConfig.verbose;
+        expect(verbose).toEqual(true);
+        process.env.LOG_LEVEL = 'TRACE';
+        sasjs = (0, config_1.getSASjs)({});
+        sasjsConfig = sasjs.getSasjsConfig();
+        verbose = sasjsConfig.verbose;
+        expect(verbose).toEqual(true);
+    });
+    it('should disable verbose mode if VERBOSE and LOG_LEVEL env are not present', function () {
         process.env.VERBOSE = '';
+        process.env.LOG_LEVEL = '';
         var sasjs = (0, config_1.getSASjs)({});
         var sasjsConfig = sasjs.getSasjsConfig();
         var verbose = sasjsConfig.verbose;
         expect(verbose).toEqual(false);
     });
-    it("should disable verbose mode if VERBOSE env is present and is not equal to 'on'(case insensitive)", function () {
+    it("should disable verbose mode if VERBOSE env is present and is not equal to 'on'(case insensitive) and LOG_LEVEL env is present and is not equal to 'trace'(case insensitive)", function () {
         process.env.VERBOSE = 'start';
+        process.env.LOG_LEVEL = 'Info';
         var sasjs = (0, config_1.getSASjs)({});
         var sasjsConfig = sasjs.getSasjsConfig();
         var verbose = sasjsConfig.verbose;

package/package.json

@@ -54,7 +54,7 @@
     "@sasjs/adapter": "4.8.0",
     "@sasjs/core": "4.46.3",
     "@sasjs/lint": "2.3.1",
-    "@sasjs/utils": "3.3.0",
+    "@sasjs/utils": "3.4.0",
     "adm-zip": "0.5.9",
     "chalk": "4.1.2",
     "dotenv": "16.0.3",
@@ -104,5 +104,5 @@
     "typescript": "4.9.5",
     "util": "0.12.4"
   },
-  "version": "4.5.1"
+  "version": "4.7.0"
 }