add --busy-ignore and --target

Author: wang-su

README.md

@@ -9,6 +9,21 @@
 
 > 在最初的开发过程中,本来的目的是想实现一个自动实时的文件同步工具. 将一些目录内容实时同步到远端的服务器和开发机上. 但考虑使用scp和rsync的条件下, 唯一需要的就是监测文件变化. 并产生一个通知. 于是便在设计上进行了终级简化. 最终变为现在这个小的命令行工具. 用于配合rsync,scp等标准命令行工具使用.
 
+## Change log
+
+* Version 0.0.1 ~ 0.0.6
+
+  fix bug
+
+* Version 0.0.7 
+    
+   添加 --target 参数用于明确指定需要监视的目录名.
+   
+   添加 --busy-ignore 参数用于解决一些文件变动间隔时间过短而处理时间较长而造成的处理堆叠问题.
+   
+   
+----------
+
 
 ## Install
 
@@ -19,12 +34,16 @@
 1. fsfb help - 显示帮助信息
 
 
-2. fsfb dirname [ --exec="commend Tpl" | --exec-tpl-file="file path" [ --charset=utf-8 ]] [ --enable-log ] [ --version | version ] [ --help | help ]
+2. fsfb "dirname" | --target="dirname" [ --exec="commend Tpl" | --exec-tpl-file="file path" [ --charset=utf-8 ]] [ --enable-log ] [ --version | version ] [ --help | help ]
 
 		Params :
 
-		dirname - 将进行监视的目录名
-
+		dirname - 将进行监视的目录名,当第一个参数未指定参数名时, 认为是target,如果后面指定了--target将会被覆盖.
+		
+		--target - 将进行监视的目录名. (>= v_0.0.7)
+		
+		--busy-ignore - 当一次执行未完成时,忽略后续的执行请求. (>= v_0.0.7)
+		
 		--enable-log  显示一些调式信息.大部份情况下没用.
 		
 		--exec 指定命令行模版, 当文件系统产生变化时, 将替换变量值后产生的一个完整的命令行指令并直接执行.
@@ -35,6 +54,10 @@
 		
 		--version 显示版本信息
 
+
+> ***Tips : 关于--busy-ignore , 在处理一些耗时操作时, 添加这个参数将后续请求忽略有可能是必要的. 但是也可能造成一些必要的操作被忽略,所以使用时应当小心评估使用场景. 在未来会添加执行周期限制用于解决这个问题***
+
+
 ### 支持的替换标记 : {xxx}
 
 
@@ -106,5 +129,5 @@ The last thing, run the scrip by fsfb.
 	......
 
 
-
+----------------
 

index.js

@@ -24,14 +24,21 @@ args = args.slice(2);
 var dirname = null;
 
 if(args.length >= 2){
-    //取目标目录, 否则为单参数
-    dirname = args.shift();     
+    // 第一个参数不存在'='时,认为第一个参数为目录名
+    if(args[0].indexOf("=") == -1){
+        //取目标目录, 否则为单参数
+        dirname = args.shift();     
+    }
 }
 
 var enableLog = false;
 var charset = 'utf-8';
 var execTpl = '';
 var execTplFile = '';
+var busyIgnore = false;
+
+// 是否正在执行中
+var working = false;    
 
 var shellTpl = "echo {type}:{fullname}";
 
@@ -48,6 +55,12 @@ while(paramItem = args.pop()){
     key = key.toLowerCase();
 
     switch(key){
+        case '--target':
+            dirname = value || false;
+            break;
+        case '--busy-ignore':
+            busyIgnore = true;
+            break;
         case '--enable-log':
             // 启用log
             enableLog = true;
@@ -111,10 +124,12 @@ if(execTplFile){
  */
 function help () {
 
-    var info = '\nUsage : fsfb dirname [ --exec="commend Tpl" | --exec-tpl-file="file path" [ --charset=utf-8 ]] [ --enable-log ] [ --version | version ] [ --help | help ]';
+    var info = '\nUsage : fsfb dirname|--target="dirname" [ --exec="commend Tpl" | --exec-tpl-file="file path" [ --charset=utf-8 ]] [ --enable-log ] [ --version | version ] [ --help | help ]';
     info += '\n\nParams :';
     info += '\n\tdirname - 将进行监视的目录名';
     info += '\n\t--enable-log - 显示一些调式信息.大部份情况下没用.';
+    info += '\n\t--target - 将进行监视的目录名';
+    info += '\n\t--busy-ignore - 当一次执行未完成时,忽略后续的执行请求.';
     info += '\n\t--exec - 指定命令行模版, 当文件系统产生变化时, 将替换变量值后产生的一个完整的命令行指令并直接执行.';
     info += '\n\t--exec-tpl-file - 从文件读取命令行模版, *考虑性能问题, 在启动监视后,不再读取tpl-file文件变化.';
     info += '\n\t--charset - 指定tpl-file的文件编码,默认为utf-8';
@@ -164,6 +179,13 @@ function start(tplContent){
 
     var feedback = function (type, fname, dirname) {
 
+        if(busyIgnore === true && working !== false){
+            enableLog && console.log("ignore execute at : %s, the last execution at: $s;",Date.now(),  working);
+            return false;
+        }
+        
+        working = Date.now();
+        
         var callback = tplContent.replace(/\{(.*?)\}/g, function (match, p1, index) {
 
             //type, fname, dirname, fulldir, fullname 
@@ -185,12 +207,18 @@ function start(tplContent){
         enableLog && console.log("will to exec : %s ",callback);
 
         exec(callback, function (err, out, errout) {
-            if (err) {
-                console.error(err.stack);
+            try{
+                if (err) {
+                    console.error(err.stack);
+                }
+                
+                out && process.stdout.write(out);
+                errout && process.stderr.write(errout);
+            }finally{
+                // 只有当--busy-ignore打开时,才有可能统计执行时间, 否则working有可能被反复覆盖.
+                enableLog && busyIgnore && console.log("cost time : %s ms. ", Date.now() - working);
+                working = false;
             }
-            
-            out && process.stdout.write(out);
-            errout && process.stderr.write(errout);
         });
     };
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "fsfb",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "file system feedback : watch files change and execute a command",
   "main": "common/observer.js",
   "bin": {