cv-script使用手册

介绍

1. 这是一个复制粘贴脚本
2. 它可以复制一个文件，并替换文件中你想要替换的字符
3. 他可以复制一个文件夹（只支持单层），并替换文件中你想要替换的字符

talk is cheap

// 导入包
const CvScript = require('cv-script').default;
const path = require('path');
// 导入常用的工具
const { fileDataMap, moduleNameQuestion } = require('cv-script/dist/utils');

// 模板路径
const templatePath = path.join(__dirname, 'templates');

// 这是文件需要复制到哪里的路径
const distPath = path.join(__dirname, '..', '..', 'src', 'modules');


const cvs = new CvScript({
  questions: [moduleNameQuestion], // 这是你要在控制台收集的问题配置
  templateDirPath: templatePath, // 这是存放文件夹模板的路径
  templateFilePath: templatePath, // 这是存放文件模板的路径
  distPath: distPath, // 这是文件需要复制到哪里的路径
  fileDataMaps: [fileDataMap], // 这是文件内容替换工具函数
  filterSelectTemplate: templates => templates.filter(t => t.templateName !== 'uselessTemplateName'), // 过滤无用的模板
  mapWriteFile: (files, params, isCvDir) => { // 对需要拷贝的文件做最终处理 
      let finalFiles = [...files];
      return finalFiles;
  }
});

// 开始执行
cvs.start();

questions: Question[]

export interface Question {
	question: string | any[]; 
	paramName: string;
	check?: (userInput: string) => boolean;
	type?: 'input' | 'select';
}

• Question有两种类型，一种是用户输入的交互，另一种是用户选择的交互，这里用的是三方插件readline-sync
• type为input类型时，question只能是string，默认input
• type是select时候，question必须是以下数据结构

// question
[['选项1', '选项2', '选项2'], '请选择'];

• paramName是你根据参数名称拿到用户输入或选择的值；这个值在fileDataMaps函数中获取
• check是你检查用户输入的值是否符合要求，不符合会重新询问用户，返回true或false，入参是用户在控制台输入的值

fileDataMaps: FileDataMap

在fileDataMap函数中，你会收到模板文件的字符串（fileData），还有用户输入的数据（params）以及模板的信息（template） 你需要返回处理后的文件字符串，供脚本生成文件

type Template = {
    templateName: string,
    templatePath: string,
    data?: string,
    distPath?: string,
    fileName?: string,
    isCvDir?: boolean,
}

type Params = {
    fileName: string;
}

type FileDataMap<T extends {[k: string]: string;} = any> = (fileData: string, params: T & Params, template: Template) => string;

filterSelectTemplate: (t: Templates[]) => Templates[]

在询问用户选择模板之前，会对识别的模板进行自定义筛选

mapWriteFile，对最终需要拷贝的文件进行处理

export type Template = {
    templateName: string,
    templatePath: string,
    data?: string, // 最终拷贝的文件数据
    distPath?: string, // 文件拷贝的地址
    fileName?: string, // 文件名
    isCvDir?: boolean, // 此文件是，文件夹拷贝类型还是文件拷贝类型
}

export type WriteFile = Required<Template>;

export type Params = {
    fileName: string;
}

type MapWriteFile = (files: WriteFile[], params: Params & {[k: string]: string}, isCvDir: boolean) => WriteFile[];