這篇文章主要介紹了node如何實現項目工程自動初始化,具有一定借鑒價值,感興趣的朋友可以參考下,希望大家閱讀完這篇文章之后大有收獲,下面讓小編帶著大家一起了解一下。
萊陽ssl適用于網站、小程序/APP、API接口等需要進行數據傳輸應用場景,ssl證書未來市場廣闊!成為創新互聯建站的ssl證書銷售渠道,可以享受市場價格4-6折優惠!如果有意向歡迎電話聯系或者加微信:13518219792(備注:SSL證書合作)期待與您的合作!
傳統的前端項目初始流程一般是這樣:
可以看出,傳統的初始化步驟,花費的時間并不少。而且,人工操作的情況下,總有改漏的情況出現。這個缺點有時很致命。
甚至有馬大哈,沒有更新項目倉庫地址,導致提交代碼到舊倉庫,這就很尷尬了。。。
基于這些情況,編寫命令行工具(CLI)的目的就很明確:
用于新項目工程的初始化利用工具進行初始化,可以節省項目初期的準備時間避免出現改漏的情況杜絕未更新項目版本倉庫地址的問題
以下是新的流程示意圖:
以下是自動化流程圖:
從流程圖可以得出兩個重要的信息:
配置信息模板文件
命令行工具的角色,是負責將兩個信息進行融合,提供一個交互平臺給用戶。
配置信息的獲得,需要靠和用戶進行交互。由于程序員一般是用終端輸入命令進行項目操作。所以,這里選擇了兩個工具進行支撐。
commander
借鑒Ruby commander理念實現的命令行執行補全解決方案
commander
可以接收命令行傳入的參數
例子:
npg-cli --help ? ???? npm-package-cli ? ???? Usage: npg-cli [options] Options: -V, --version output the version number -h, --help output usage information run testcli and edit the setting.
inquirer
常用交互式命令行用戶界面的集合。
inquirer
用詢問式的語句,與用戶進行交互,接收參數
例子:
npg-cli ? ???? npm-package-cli ? ???? Follow the prompts to complete the project configuration. ? project name test ? version 1.0.0 ? description
前端的JavaScript 模板引擎,比如ejs,jade等??梢愿鶕魅氲膮?,對模板標簽進行替換,最終生成html。
如果把所有項目文件,不管文件后綴名,都看成是ejs模板,則可以在文件內容中使用ejs語法。
再根據配置信息進行替換,最終生成新文件。
其實,業界依據這個想法,已經有成熟的工具產生。
mem-fs
mem-fs
是對文件進行讀取,存入內存中。
mem-fs-editor
mem-fs-editor
是對內存中的文件信息,使用ejs語法進行編譯。最后調用commit
方法輸出最終文件。
提示信息,除了console.log
,還可以使用色彩更豐富的chalk
。
這樣,可以輸出更直觀、友好的提示。
文件操作,有業界成熟的shelljs
。
利用shelljs
,可以在項目中簡化以下步驟:
一些項目文件,不需要修改,只用直接copy。可以使用shelljs.copySync
同步方式生成。一些文件夾,需要提前構建,可以使用shelljs.mkdir
進行創建
以下按我做的開源項目——npm-package-cli
的創作過程進行分拆、講解。
新建項目文件夾npm-package-cli
,并在該文件夾下運行npm init
,生成package.json
。
項目結構如下:
npm-package-cli |-- package.json
這里要生成的全局指令是npg-cli
。
新建文件夾bin
,并在文件夾下新建名稱為cli
的shell腳本文件(注意:不能有后綴名)。cli
shell腳本文件內容如下:
#!/usr/bin/env node console.log('hello world');
其中,#!/usr/bin/env node
是告訴編譯器,以node
的方式,運行代碼。
并在package.json
加入以下內容:
"bin": { "npg-cli": "bin/cli" }
此時,項目結構如下:
npm-package-cli |-- bin |-- cli |-- package.json
鏈接指令有兩種方式:
npm link
npm install -g
兩種方式,都需要在npm-package-cli
文件夾下運行,才能生效。
作用是把npg-cli
指令,指向全局的bin
文件下,實現軟鏈。
在任意文件夾下運行命令:
npg-cli # 輸出 hello world
到這里,一個基本的指令就算完成了,接下來是指令的工作內容細化。
Creation
的作用是整合所有操作,并提供接口給指令文件cli
。Creation
的結構如下:
class Creation{ constructor(){ // code } do(){ // code } // other function }
其中do
方法暴露給腳本文件cli
調用。
Creation
類放在src/index.js
中。
此時,項目結構如下:
npm-package-cli |-- bin |-- cli |-- src |-- index.js |-- package.json
cli
文件#!/usr/bin/env node const Creator = require('../src/index.js'); const project = new Creator(); project.do();
這樣,只要實現好do
方法,就可以完成npg-cli
指令的運行了。
實現npg-cli --help
,需要借助上文提到的工具commander
。
新建src/command.js
文件,文件內容如下:
const commander = require('commander'); const chalk = require('chalk'); const packageJson = require('../package.json'); const log = console.log; function initCommand(){ commander.version(packageJson.version) .on('--help', ()=>{ log(chalk.green(' run testcli and edit the setting.')); }) .parse(process.argv); } module.exports = initCommand;
此時,項目結構如下:
npm-package-cli |-- bin |-- cli |-- src |-- command.js |-- index.js |-- package.json
然后在Creation.do
方法內執行initCommand()
即可生效。
// src/index.js Creation const initCommand = require('./command'); class Creation{ // other code do(){ initCommand(); } }
此時,運行npg-cli --help
指令,就可以看到:
Usage: npg-cli [options] Options: -V, --version output the version number -h, --help output usage information run testcli and edit the setting.
要獲取用戶輸入的信息,需要借助工具inquirer
。
新建src/setting.js
文件,文件內容如下:
const inquirer = require('inquirer'); const fse = require('fs-extra'); function initSetting(){ let prompt = [ { type: 'input', name: 'projectName', message: 'project name', validate(input){ if(!input){ return 'project name is required.' } if(fse.existsSync(input)){ return 'project name of folder is exist.' } return true; } }, // other prompt ]; return inquirer.prompt(prompt); } module.exports = initSetting;
此時,項目結構如下:
npm-package-cli |-- bin |-- cli |-- src |-- command.js |-- index.js |-- setting.js |-- package.json
然后在Creation.do
方法內執行initSetting()
即可生效。
// src/index.js Creation const initCommand = require('./command'); const initSetting = require('./setting'); class Creation{ // other code do(){ initCommand(); initSetting().then(setting => { // 用戶輸入完成后,會得到全部輸入信息的json數據 setting }); } }
這里,inquirer.prompt
方法裝載好要收集的問題后,返回的是Promise
對象。收集完成之后,要在then
方法內拿到配置信息,以便進行下一步模板替換的操作。
模板文件替換,要用到工具mem-fs
和mem-fs-editor
。
文件操作,要用到工具shelljs
。
新建src/output.js
文件,文件內容如下(刪除了部分代碼,以下只是示例,完整項目看最后分享鏈接):
const chalk = require('chalk'); const fse = require('fs-extra'); const path = require('path'); const log = console.log; function output(creation){ return new Promise((resolve, reject)=>{ // 拿到配置信息 const setting = creation._setting; const { projectName } = setting; // 獲取當前命令行執行環境所在文件夾 const cwd = process.cwd(); // 初始化文件夾path const projectPath = path.join(cwd, projectName); const projectResolve = getProjectResolve(projectPath); // 新建項目文件夾 fse.mkdirSync(projectPath); // copy文件夾 creation.copy('src', projectResolve('src')); // 根據配置信息,替換文件內容 creation.copyTpl('package.json', projectResolve('package.json'), setting); // 將內存中的文件,輸出到硬盤上 creation._mfs.commit(() => { resolve(); }); }); } module.exports = output;
output方法的作用:
新建項目文件夾
把模板文件讀取出來,根據配置信息,進行替換(調用的是mem-fs-editor的copyTpl方法)
拷貝其他文件
輸出最終文件到硬盤上
這里最重要的一步,是調用mem-fs-editor
的方法后,要執行mem-fs-editor
的commit
方法,輸出內存中的文件到硬盤上。
在Creation.do方法中,調用output方法即可輸出新項目文件。
打開src/index.js文件,文件內容增加如下方法:
// src/index.js Creation const initCommand = require('./command'); const initSetting = require('./setting'); const output = require('./output'); class Creation{ // other code do(){ initCommand(); initSetting().then(setting => { // 用戶輸入完成后,會得到全部輸入信息的json數據 setting this._setting = Object.assign({}, this._setting, setting); // 輸出文件 output(this).then(res => { // 項目輸出完成 }); }); } }
自動初始化一個項目的流程不外乎以下三點:
讀取用戶配置
讀取模板文件
根據配置,編譯模板文件,輸出最終文件
命令行工具,是對這三點的有效整合,串連成一個規范的流程。
命令行工具中,使用的第三方工具包,都需要用--save的方式安裝。
體現在package.json
的表現是dependencies
字段:
"dependencies": { "chalk": "^2.4.2", "commander": "^3.0.0", "fs-extra": "^8.1.0", "inquirer": "^6.5.0", "mem-fs": "^1.1.3", "mem-fs-editor": "^6.0.0", "shelljs": "^0.8.3" },
這樣,其他用戶在安裝你發布的CLI工具時,才會自動安裝這些依賴。
我創作的npm-package-cli
,是專門用于生成個人npm package
項目的CLI工具。
生成的項目,囊括以下功能點:
支持TypeScrpt
mocha+chai自動化測試,支持使用TypeScript編寫測試用例支持測試覆蓋率
coverage支持eslint,包括對TypeScript的lint檢查
Git commit規范提交
Git版本自動打標簽(standard-version),更新CHANGELOG.md
輸出的npm包
支持各種模塊規范(AMD、CMD、CommonJS、ESModule)
CLI工具安裝方式:
npm install -g npm-package-cli
開源倉庫地址:https://github.com/wall-wxk/npm-package-cli
感謝你能夠認真閱讀完這篇文章,希望小編分享的“node如何實現項目工程自動初始化”這篇文章對大家有幫助,同時也希望大家多多支持創新互聯,關注創新互聯行業資訊頻道,更多相關知識等著你來學習!
分享名稱:node如何實現項目工程自動初始化
當前鏈接:http://m.newbst.com/article18/gejjdp.html
成都網站建設公司_創新互聯,為您提供移動網站建設、服務器托管、外貿網站建設、網站內鏈、動態網站、商城網站
聲明:本網站發布的內容(圖片、視頻和文字)以用戶投稿、用戶轉載內容為主,如果涉及侵權請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網站立場,如需處理請聯系客服。電話:028-86922220;郵箱:631063699@qq.com。內容未經允許不得轉載,或轉載時需注明來源: 創新互聯