利用node.js开发cli的完整步骤
CLI介绍
命令行界面(英语:command-lineinterface,缩写:CLI),是在图形用户界面得到普及之前使用最为广泛的用户界面,它通常不支持鼠标,用户通过键盘输入指令,计算机接收到指令后,予以执行。
目前前端开发中,CLI是常用的工具。前端三大框架Vue、React、Angular都有对应的CLI,包括现在最流行的前端工程化的打包工具Webpack,也有对应的webpack-cli。
在现代的前端开发中,CLI提高了开发的效率。让相应的前端开发者免去了大量的重复性操作,节省了大量的时间。CLI可以完成的功能,包括但不限于初始化生成对应的项目模板、执行特定的脚本文件、在项目中创建新的模块。下面来介绍一下前端工程师如何使用node.js来完成一个CLI。
创建项目
打开终端,创建moka-cli的目录
mkdirmoka-cli
进入目录,初始化项目
cdmoka-cli npminit-y
根目录下新建bin目录,并新建index.js文件,此时目录结构如下
|--moka-cli |--package.json |--bin |--index.js
开发cli需要借助commander、inquirer、chalk三个库
npminstallcommanderinquirerchalk--save
修改package.json文件,使用esmoudle,并新增moka命令
package.json { "name":"moka-cli", "version":"1.0.0", "description":"", "main":"index.js", +"type":"module", +"bin":{ +"moka":"./bin/index.js" +}, "scripts":{ "test":"echo\"Error:notestspecified\"&&exit1" }, "keywords":[], "author":"", "license":"ISC", "dependencies":{ "chalk":"^4.1.0", "commander":"^6.2.1", "inquirer":"^7.3.3" } }
接下来需要在/bin/index.js中编程,在第一行添加如下代码,这行代码是告诉系统要用node来执行这个文件。
#!/usr/bin/envnode
再添加下面代码
#!/usr/bin/envnode console.log('moka-clirun!')
然后在项目根目录下全局安装项目
npminstall-g
到这里,一个简单的CLI就完成了,可以打开终端,在任意目录下输入moka,控制台就会打印出对应的消息。
$moka moka-clirun!
第三方库介绍
moka-cli希望实现可以创建前端开发模板的功能,可以使用moka命令来创建一个vue或react项目。
先来介绍一下使用到到第三方的库
commander
文档地址
用来实现命令的库,在moka-cli中会用来实现create命令,实现用下面的命令行来创建一个vue-demo的项目
mokacreatevuevue-demo
inquirer
文档地址
实现用户和终端交互的库,在moka-cli中使用create指令的时候会询问是否覆盖已有项目
$mokacreatevuemoka-demo ?Templatenamedmoka-demoisalreadyexisted,areyousuretooverwrite?(Y/n)
chalk
文档地址
可以在终端界面显示出多种颜色的文本和背景
核心功能
在根目录创建actions和templates目录,目录结构如下
|--moka-cli |--package-lock.json |--package.json +|--actions +||--create.js |--bin ||--index.js +|--templates +|--react +||--app.js +||--index.js +||--src +||--index.js +|--vue +|--app.js +|--index.js +|--src +|--index.js
templats下面用来存放通过CLI要生成的项目的模板,在这里先随便创建几个文件展示一下。
修改/bin/index.js文件
#!/usr/bin/envnode importcreatefrom'../actions/create.js'; importcommanderfrom'commander'; const{program}=commander; program.version('0.0.1'); program .command('create[name]') .description('新建项目') .action(create); program.parse(process.argv);
修改./actions/create.js文件
importfsfrom'fs'; importpathfrom'path'; importchalkfrom'chalk'; importinquirerfrom'inquirer'; import{fileURLToPath}from'url'; const__filename=fileURLToPath(import.meta.url); const__dirname=path.dirname(__filename); constTEMPLATES=['vue','react']; consttargetPath=process.cwd(); functioncreateTemplate(template,name){ consttemplatePath=path.join(__dirname,'../',`templates/${template}`); functionreadAndCopyFile(parentPath,tempPath){ letfiles=fs.readdirSync(parentPath); files.forEach((file)=>{ letcurPath=`${parentPath}/${file}`; letstat=fs.statSync(curPath); letfilePath=`${targetPath}/${tempPath}/${file}`; if(stat.isDirectory()){ fs.mkdirSync(filePath); readAndCopyFile(`${parentPath}/${file}`,`${tempPath}/${file}`); }else{ constcontents=fs.readFileSync(curPath,'utf8'); fs.writeFileSync(filePath,contents,'utf8'); } }); } readAndCopyFile(templatePath,name); } functiondeleteTemplate(path){ if(fs.existsSync(path)){ fs.readdirSync(path).forEach(function(file,index){ varcurPath=path+'/'+file; if(fs.lstatSync(curPath).isDirectory()){ //recurse deleteTemplate(curPath); }else{ //deletefile fs.unlinkSync(curPath); } }); fs.rmdirSync(path); } } exportdefaultfunctioncreate(template,name){ if(!TEMPLATES.includes(template)){ console.log(chalk.red(`No${template}Template`)); return; } constprojectPath=path.resolve(targetPath,name); if(fs.existsSync(projectPath)){ inquirer .prompt([ { name:'template-overwrite', type:'confirm', message:`Templatenamed${name}isalreadyexisted,areyousuretooverwrite?`, validate:function(input){ if(input.lowerCase!=='y'&&input.lowerCase!=='n'){ return'Pleaseinputy/n!'; }else{ returntrue; } }, }, ]) .then((answers)=>{ //如果确定覆盖 if(answers['template-overwrite']){ //删除文件夹 deleteTemplate(projectPath); console.log(chalk.yellow(`Templatealreadyexisted,removing!`)); //创建新模块文件夹 fs.mkdirSync(projectPath); createTemplate(template,name); console.log( chalk.green(`${template}templatehasbeencreatedsuccessfully!`) ); } }) .catch((err)=>{ console.log(chalk.red(err)); }); }else{ fs.mkdirSync(projectPath); createTemplate(template,name); console.log( chalk.green(`${template}templatehasbeencreatedsuccessfully!`) ); } }
最后在项目根目录运行以下命令,重新安装一下moka-cli
npminstall-g
随便找一个路径,运行mokacreate[name]命令来生成项目
mokacreatereactreact-demo
效果如下,会在该目录下生成一个react-demo的文件夹,里面存放的就是moka-cli项目中/templates/react下的所有
$mokacreatereactreact-demo reacttemplatehasbeencreatedsuccessfully!
如果在该目录下继续创建一个同名的项目,就会提示是否覆盖,输入y后继续执行
$mokacreatereactreact-demo ?Templatenamedreact-demoisalreadyexisted,areyousuretooverwrite?Yes Templatealreadyexisted,removing! reacttemplatehasbeencreatedsuccessfully!
create命令的核心逻辑是通过node的fs模块来复制/templates下的文件,然后将其放到指定的路径下,具体实现直接看代码就可以来。
总结
CLI是提示前端开发效率的重要工具,如果有长期维护的项目,开发一个CLI来完成一些重复性的工作,是一个不错的选择。
moka-cli还没有上传github,等过段时间完善一些/templates下的项目模板,我会在文章里补充项目地址。
到此这篇关于利用node.js开发cli的文章就介绍到这了,更多相关node.js开发cli内容请搜索毛票票以前的文章或继续浏览下面的相关文章希望大家以后多多支持毛票票!