Add interleaved option to "args" module parser.

lib/args.js

@@ -324,7 +324,7 @@ exports.Parser.prototype.check = function () {
 
 // TODO break this into sub-functions
 // TODO wrap with a try catch and print the progress through the arguments
-exports.Parser.prototype.parse = function (args, options, noCommand) {
+exports.Parser.prototype.parse = function (args, options, noCommand, allowInterleaved) {
     var self = this;
 
     this.check();
@@ -375,6 +375,8 @@ exports.Parser.prototype.parse = function (args, options, noCommand) {
             options[option.getName()] = option._def;
     });
 
+    var interleavedArgs = [];
+
     // walk args
     ARGS: while (args.length) {
         var arg = args.shift();
@@ -464,15 +466,16 @@ exports.Parser.prototype.parse = function (args, options, noCommand) {
             }
 
         } else {
-            // TODO permit options interleaved with arguments,
-            //  with associated actions, for any of positional
-            //  args, variadic args, and accumulated args
-            args.unshift(arg);
-            break;
+            interleavedArgs.push(arg);
+            if (!allowInterleaved)
+                break;
         }
 
     }
 
+    // add the interleaved arguments back in
+    args.unshift.apply(args, interleavedArgs)
+
     if (util.len(this._commands)) {
         if (args.length) {
             if (util.has(this._commands, args[0])) {