smartscaf/ts/smartscaf.classes.smartscaf.ts

235 lines
7.2 KiB
TypeScript
Raw Permalink Normal View History

import * as plugins from './smartscaf.plugins';
import * as helpers from './smartscaf.helpers';
2017-04-28 22:44:23 +00:00
// interfaces
import { Smartfile } from '@pushrocks/smartfile';
2017-04-28 22:44:23 +00:00
export interface ScafTemplateContructorOptions {
name?: string;
description?: string;
sourceDir?: string;
2017-04-28 22:44:23 +00:00
}
export class ScafTemplate {
2019-01-27 17:55:38 +00:00
static async createTemplateFromDir() {}
2018-10-04 14:04:42 +00:00
/**
* the name of the template
*/
name: string;
2018-10-04 14:04:42 +00:00
/**
* the descriptions of the template
*/
description: string;
2018-10-04 14:04:42 +00:00
/**
* the location on disk of the template
*/
dirPath: string;
2018-10-04 14:04:42 +00:00
/**
* the files of the template as array of Smartfiles
*/
templateSmartfileArray: Smartfile[];
requiredVariables: string[];
defaultVariables: any;
suppliedVariables: any = {};
missingVariables: string[] = [];
2017-04-28 22:44:23 +00:00
constructor(dirPathArg: string) {
this.dirPath = plugins.path.resolve(dirPathArg);
}
2017-04-28 22:44:23 +00:00
/**
* read a template from a directory
*/
async readTemplateFromDir() {
this.templateSmartfileArray = await plugins.smartfile.fs.fileTreeToObject(this.dirPath, '**/*');
await this._resolveTemplateDependencies();
await this._findVariablesInTemplate();
await this._checkSuppliedVariables();
await this._checkDefaultVariables();
2017-04-28 22:44:23 +00:00
}
2017-04-30 21:58:03 +00:00
/**
* supply the variables to render the teplate with
2017-05-25 16:32:53 +00:00
* @param variablesArg gets merged with this.suppliedVariables
2017-04-30 21:58:03 +00:00
*/
async supplyVariables(variablesArg) {
this.suppliedVariables = {
...this.suppliedVariables,
...variablesArg
};
this.missingVariables = await this._checkSuppliedVariables();
2017-04-28 22:44:23 +00:00
}
2017-05-05 22:47:27 +00:00
/**
* Will ask for the missing variables by cli interaction
*/
async askCliForMissingVariables() {
this.missingVariables = await this._checkSuppliedVariables();
let localSmartInteract = new plugins.smartinteract.SmartInteract();
2017-05-06 23:23:03 +00:00
for (let missingVariable of this.missingVariables) {
localSmartInteract.addQuestions([
{
name: missingVariable,
type: 'input',
default: (() => {
if (this.defaultVariables && this.defaultVariables[missingVariable]) {
return this.defaultVariables[missingVariable];
} else {
return 'undefined variable';
}
})(),
message: `What is the value of ${missingVariable}?`
}
]);
2017-05-06 23:23:03 +00:00
}
let answerBucket = await localSmartInteract.runQueue();
2018-10-04 14:04:42 +00:00
await answerBucket.answerMap.forEach(async answer => {
await helpers.deepAddToObject(this.suppliedVariables, answer.name, answer.value);
});
2017-05-05 22:47:27 +00:00
}
2018-10-04 14:04:42 +00:00
/**
* writes a file to disk
* @param destinationDirArg
*/
async writeToDisk(destinationDirArg) {
2018-10-04 14:04:42 +00:00
const smartfileArrayToWrite: Smartfile[] = [];
for (let smartfile of this.templateSmartfileArray) {
// lets filter out template files
2019-01-27 17:55:38 +00:00
if (smartfile.path === '.smartscaf.yml') {
2018-10-04 14:04:42 +00:00
continue;
}
// render the template
let template = await plugins.smarthbs.getTemplateForString(smartfile.contents.toString());
let renderedTemplateString = template(this.suppliedVariables);
// handle frontmatter
const smartfmInstance = new plugins.smartfm.Smartfm({
2019-01-27 17:55:38 +00:00
fmType: 'yaml'
});
let parsedTemplate = smartfmInstance.parse(renderedTemplateString) as any;
if (parsedTemplate.data.fileName) {
smartfile.updateFileName(parsedTemplate.data.fileName);
}
smartfile.contents = Buffer.from(parsedTemplate.content);
2018-10-04 14:04:42 +00:00
smartfileArrayToWrite.push(smartfile);
2017-05-26 13:32:50 +00:00
}
await plugins.smartfile.memory.smartfileArrayToFs(smartfileArrayToWrite, destinationDirArg);
2017-05-26 13:32:50 +00:00
}
2017-04-28 22:44:23 +00:00
/**
2017-05-25 16:32:53 +00:00
* finds all variables in a Template in as string
* e.g. myobject.someKey and myobject.someOtherKey
2017-04-28 22:44:23 +00:00
*/
private async _findVariablesInTemplate() {
let templateVariables: string[] = [];
2017-05-25 16:32:53 +00:00
for (let templateSmartfile of this.templateSmartfileArray) {
let localTemplateVariables = await plugins.smarthbs.findVarsInHbsString(
templateSmartfile.contents.toString()
);
templateVariables = [...templateVariables, ...localTemplateVariables];
2017-04-30 21:58:03 +00:00
}
templateVariables = templateVariables.filter((value, index, self) => {
return self.indexOf(value) === index;
});
2017-04-28 22:44:23 +00:00
}
/**
* checks if supplied Variables satisfy the template
*/
private async _checkSuppliedVariables() {
let missingVars: string[] = [];
2017-05-25 16:32:53 +00:00
for (let templateSmartfile of this.templateSmartfileArray) {
2017-05-03 07:45:22 +00:00
let localMissingVars = await plugins.smarthbs.checkVarsSatisfaction(
2017-05-25 16:32:53 +00:00
templateSmartfile.contents.toString(),
2017-05-06 23:23:03 +00:00
this.suppliedVariables
);
2018-10-04 14:04:42 +00:00
// combine with other missingVars
missingVars = [...missingVars, ...localMissingVars];
2017-05-03 07:45:22 +00:00
}
2018-10-04 14:04:42 +00:00
// dedupe
missingVars = missingVars.filter((value, index, self) => {
return self.indexOf(value) === index;
});
return missingVars;
2017-04-28 22:44:23 +00:00
}
2017-05-25 16:32:53 +00:00
/**
2018-10-04 14:04:42 +00:00
* checks the smartscaf.yml default values at the root of a template
2017-05-25 16:32:53 +00:00
* allows 2 ways of notation in YAML:
* >> myObject.myKey.someDeeperKey: someValue
* >> myObject.yourKey.yourDeeperKey: yourValue
* or
* >> myObject:
* >> - someKey:
* >> - someDeeperKey: someValue
* >> - yourKey:
* >> - yourDeeperKey: yourValue
*/
private async _checkDefaultVariables() {
2018-10-04 14:04:42 +00:00
let smartscafSmartfile = this.templateSmartfileArray.find(smartfileArg => {
return smartfileArg.parsedPath.base === '.smartscaf.yml';
});
2017-05-25 16:32:53 +00:00
2018-10-04 14:04:42 +00:00
if (smartscafSmartfile) {
const smartscafObject = await plugins.smartyaml.yamlStringToObject(
smartscafSmartfile.contents.toString()
);
2018-10-04 14:04:42 +00:00
const defaultObject = smartscafObject.defaults;
this.defaultVariables = defaultObject;
2018-10-04 14:04:42 +00:00
}
// safeguard against non existent defaults
if (!this.defaultVariables) {
2019-01-27 17:55:38 +00:00
console.log('this template does not specify defaults');
this.defaultVariables = {};
2017-05-25 16:32:53 +00:00
}
}
/**
* resolve template dependencies
*/
private async _resolveTemplateDependencies() {
2018-10-04 14:04:42 +00:00
const smartscafSmartfile = this.templateSmartfileArray.find(smartfileArg => {
return smartfileArg.parsedPath.base === '.smartscaf.yml';
});
2019-01-27 17:55:38 +00:00
if (!smartscafSmartfile) {
console.log('No further template dependencies defined!');
return;
}
console.log('Found template dependencies! Resolving them now!');
2018-10-04 14:04:42 +00:00
console.log('looking at templates to merge!');
2019-01-27 17:55:38 +00:00
const smartscafYamlObject = await plugins.smartyaml.yamlStringToObject(
smartscafSmartfile.contentBuffer.toString()
);
if (!smartscafYamlObject) {
2018-10-04 14:04:42 +00:00
console.log('Something seems strange about the supplied dependencies.yml file.');
return;
}
for (const dependency of smartscafYamlObject.dependencies.merge) {
console.log(`Now resolving ${dependency}`);
const templatePathToMerge = plugins.path.join(this.dirPath, dependency);
2019-01-27 17:55:38 +00:00
if (!plugins.smartfile.fs.isDirectory(templatePathToMerge)) {
console.log(
`dependency ${dependency} resolves to ${templatePathToMerge} which ist NOT a directory`
);
2018-10-04 14:04:42 +00:00
continue;
2019-01-27 17:55:38 +00:00
}
const templateSmartfileArray = await plugins.smartfile.fs.fileTreeToObject(
templatePathToMerge,
'**/*'
);
2018-10-04 14:04:42 +00:00
this.templateSmartfileArray = this.templateSmartfileArray.concat(templateSmartfileArray);
}
}
2017-04-28 22:44:23 +00:00
}