优秀的编程知识分享平台

网站首页 > 技术文章 正文

NodeJS shelljs 模块(node.js shell)

nanyue 2024-08-06 18:18:20 技术文章 6 ℃


安装

npm install --save shelljs

Shell是linux下的脚本语言解析器,拥有丰富且强大的底层操作权限。Shelljs就是基于node的一层命令封装插件,让前端开发者可以不依赖linux也不依赖类似于cmder的转换工具,而是直接在我们最熟悉不过的javascript代码中编写shell命令实现功能。

官方示例(包含注释)

//引入shelljs
var shell = require('shelljs')
 
//检查控制台是否可以运行`git `开头的命令
if (!shell.which('git')) {
 ?//在控制台输出内容
 ?shell.echo('Sorry, this script requires git');
 ?// 以退出码为code退出当前进程
 ?shell.exit(1);
}
 
shell.rm('-rf','out/Release');//强制递归删除`out/Release目录`
shell.cp('-R','stuff/','out/Release');//将`stuff/`中所有内容拷贝至`out/Release`目录
 
shell.cd('lib');//进入`lib`目录
//找出所有的扩展名为js的文件,并遍历进行操作
shell.ls('*.js').forEach(function (file) {
 ?/* 这是第一个难点:sed流编辑器,建议专题学习,-i表示直接作用源文件 */
 ?//将build_version字段替换为'v0.1.2'
 ?shell.sed('-i', 'BUILD_VERSION', 'v0.1.2', file);
 ?//将包含`REMOVE_THIS_LINE`字符串的行删除
 ?shell.sed('-i', /^.*REMOVE_THIS_LINE.*$/, '', file);
 ?//将包含`REPLACE_LINE_WITH_MACRO`字符串的行替换为`macro.js`中的内容
 ?shell.sed('-i', /.*REPLACE_LINE_WITH_MACRO.*\n/, shell.cat('macro.js'), file);
});
 
//返回上一级目录
shell.cd('..');
 
// 同步执行所传入的命令
if (shell.exec('git commit -am "Auto-commit"').code !== 0){
 ? ?shell.echo('Error: Git commit failed');
 ? ?shell.exit(1);
}

命令解释

  • rm删除一个目录中一个或多个文件或目录,一旦删除,无法恢复。 常用参数:-f:强制删除文件;-i:删除之前先询问用户;-r:递归处理目录;-v:显示处理过程;
  • cp([options,] source_array, dest)用来将一个或多个源文件或目录复制到指定的文件或目录。 常用参数:-f:强制删除文件;-i:删除之前先询问用户;-r:递归处理目录;
  • ls用来显示目标列表。 常用参数:-a:显示所有文件;-C:多列显示查询结果;-l:单列长格式显示查询结果(与-C相反);-R:递归处理目录;
  • sed([options,] search_regex, replacement, file_array将file_array中符合search_regex的内容替换为replacement,支持正则的捕获组自引用。一次处理一行内容,处理完成后把缓冲区内容送往屏幕,然后处理下一行,循环直至结束。功能丰富且用法较复杂,建议自行百度进行专题学习。-i:直接作用源文件
  • cat将一个或多个文件内容读入,指定一个文件时读入该文件,指定多个文件时将内容连接在一起读入。
  • exec(command,, options)执行所传入的命令async:是否异步执行,默认false,传入callback时自动开启slient:不输出信息到console,默认falseencoding:默认utf8

文档中其他API概览

  • chmod设置文件调用权限基本语法 :chmod [-cfvR] [--help] [--version] mode file...-c:若文件权限确实被更改,才显示更改动作-f: 权限无法被更改时不显示错误信息-v: 显示权限变更的详细资料-R: 递归,对其目录下所有文件和子文件执行相同操作mode字段格式 : ugoa...rwxX]...u表示该文件拥有者,g表示同一群体者,o表示其他,a表示所有+表示增加权限,-表示取消权限,=表示唯一设定权限r表示可读,w表示可写,x表示可执行,X表示当该文件是个子目录?
  • find(path[,path...])寻找路径
  • grep([options,] regex_filter,file)从指定文件中抓取符合正则的行-v:翻转正则匹配-l:仅打印符合条件的文件名
  • head([{'-n':<num>,}] file)显示指定文件中的前N行-n<num>:显示前<num>行
  • mv移动文件
  • pwd返回当前目录
  • set设置全局变量的值
  • sort将文件的内容逐行排序-r:反转结果-n:依据数值对比
  • tail读取指定文件的末尾n行,对比head命令进行理解
  • test()评估一个表达式是否为真(以下仅为最常见的参数用例)-d,path:如果path是一个路径则返回true-e,path:如果path存在则返回true
  • ShellString()构造器,将一个字符串转化为Shell字符串,转化后的字符串支持链式调用特殊的shell命令
  • ShellString.Prototype.to()将shellString输出至指定文件,相当于脚本语言中的>
  • ShellString.Prototype.toEnd()将shellString追加至指定文件,相当于脚本语言中的>>
  • touch([options,]file)生成文件-m:仅修改编辑时间-c:不创建任何文件-d DATE:指定时间-r FILE:用FILE的时间替代新文件时间
  • env['VAR_NAME']指向process.env
  • Pipes链式调用支持sed,grep,cat,exec,to,toEnd均支持链式调用。

案列

创建一个js文件,通过切换到指定目录后执行命令

var shell = require("shelljs");
shell.cd("/Users/liujiang/Documents/myblog").exec("npm run dev")

执行 node 文件名.js

Tags:

最近发表
标签列表