big command factoring

build/bundle.js

@@ -7143,6 +7143,9 @@ var GitError = Errors.GitError;
 var CommandResult = Errors.CommandResult;
 var EventBaton = require('../util/eventBaton').EventBaton;
 
+// REFACTOR in progress
+var Commands = {};
+
 function GitEngine(options) {
   this.rootCommit = null;
   this.refs = {};
@@ -8337,9 +8340,15 @@ GitEngine.prototype.cherrypick = function(commit) {
 };
 
 GitEngine.prototype.commitStarter = function() {
-  this.acceptNoGeneralArgs();
-  if (this.commandOptions['-am'] && (
-      this.commandOptions['-a'] || this.commandOptions['-m'])) {
+  Commands.commit(this, this.command, this.commandOptions);
+};
+
+Commands.commit = function(engine, command) {
+  var commandOptions = command.getSupportedMap();
+  command.acceptNoGeneralArgs();
+
+  if (commandOptions['-am'] && (
+      commandOptions['-a'] || commandOptions['-m'])) {
     throw new GitError({
       msg: intl.str('git-error-options')
     });
@@ -8347,23 +8356,23 @@ GitEngine.prototype.commitStarter = function() {
 
   var msg = null;
   var args = null;
-  if (this.commandOptions['-a']) {
-    this.command.addWarning(intl.str('git-warning-add'));
+  if (commandOptions['-a']) {
+    command.addWarning(intl.str('git-warning-add'));
   }
 
-  if (this.commandOptions['-am']) {
-    args = this.commandOptions['-am'];
-    this.validateArgBounds(args, 1, 1, '-am');
+  if (commandOptions['-am']) {
+    args = commandOptions['-am'];
+    engine.validateArgBounds(args, 1, 1, '-am');
     msg = args[0];
   }
 
-  if (this.commandOptions['-m']) {
-    args = this.commandOptions['-m'];
-    this.validateArgBounds(args, 1, 1, '-m');
+  if (commandOptions['-m']) {
+    args = commandOptions['-m'];
+    engine.validateArgBounds(args, 1, 1, '-m');
     msg = args[0];
   }
 
-  var newCommit = this.commit();
+  var newCommit = engine.commit();
   if (msg) {
     msg = msg
       .replace(/"/g, '"')
@@ -8373,11 +8382,11 @@ GitEngine.prototype.commitStarter = function() {
     newCommit.set('commitMessage', msg);
   }
 
-  var promise = this.animationFactory.playCommitBirthPromiseAnimation(
+  var promise = engine.animationFactory.playCommitBirthPromiseAnimation(
     newCommit,
-    this.gitVisuals
+    engine.gitVisuals
   );
-  this.animationQueue.thenFinish(promise);
+  engine.animationQueue.thenFinish(promise);
 };
 
 GitEngine.prototype.commit = function() {
@@ -13664,6 +13673,7 @@ var GitCommands = require('../git/commands');
 var GitOptionParser = GitCommands.GitOptionParser;
 
 var ParseWaterfall = require('../level/parseWaterfall').ParseWaterfall;
+var intl = require('../intl');
 
 var CommandProcessError = Errors.CommandProcessError;
 var GitError = Errors.GitError;
@@ -13709,6 +13719,53 @@ var Command = Backbone.Model.extend({
     this.set('warnings', []);
   },
 
+  getGeneralArgs: function() {
+    return this.get('generalArgs');
+  },
+
+  getSupportedMap: function() {
+    return this.get('supportedMap');
+  },
+
+  acceptNoGeneralArgs: function() {
+    if (this.getGeneralArgs().length) {
+      throw new GitError({
+        msg: intl.str('git-error-no-general-args')
+      });
+    }
+  },
+
+  // this is a little utility class to help arg validation that happens over and over again
+  validateArgBounds: function(args, lower, upper, option) {
+    var what = (option === undefined) ?
+      'git ' + this.get('method') :
+      this.get('method') + ' ' + option + ' ';
+    what = 'with ' + what;
+
+    if (args.length < lower) {
+      throw new GitError({
+        msg: intl.str(
+          'git-error-args-few',
+          {
+            lower: String(lower),
+            what: what
+          }
+        )
+      });
+    }
+    if (args.length > upper) {
+      throw new GitError({
+        msg: intl.str(
+          'git-error-args-many',
+          {
+            upper: String(upper),
+            what: what
+          }
+        )
+      });
+    }
+  },
+
   validateAtInit: function() {
     if (this.get('rawStr') === null) {
       throw new Error('Give me a string!');
@@ -23885,6 +23942,9 @@ var GitError = Errors.GitError;
 var CommandResult = Errors.CommandResult;
 var EventBaton = require('../util/eventBaton').EventBaton;
 
+// REFACTOR in progress
+var Commands = {};
+
 function GitEngine(options) {
   this.rootCommit = null;
   this.refs = {};
@@ -25079,9 +25139,15 @@ GitEngine.prototype.cherrypick = function(commit) {
 };
 
 GitEngine.prototype.commitStarter = function() {
-  this.acceptNoGeneralArgs();
-  if (this.commandOptions['-am'] && (
-      this.commandOptions['-a'] || this.commandOptions['-m'])) {
+  Commands.commit(this, this.command, this.commandOptions);
+};
+
+Commands.commit = function(engine, command) {
+  var commandOptions = command.getSupportedMap();
+  command.acceptNoGeneralArgs();
+
+  if (commandOptions['-am'] && (
+      commandOptions['-a'] || commandOptions['-m'])) {
     throw new GitError({
       msg: intl.str('git-error-options')
     });
@@ -25089,23 +25155,23 @@ GitEngine.prototype.commitStarter = function() {
 
   var msg = null;
   var args = null;
-  if (this.commandOptions['-a']) {
-    this.command.addWarning(intl.str('git-warning-add'));
+  if (commandOptions['-a']) {
+    command.addWarning(intl.str('git-warning-add'));
   }
 
-  if (this.commandOptions['-am']) {
-    args = this.commandOptions['-am'];
-    this.validateArgBounds(args, 1, 1, '-am');
+  if (commandOptions['-am']) {
+    args = commandOptions['-am'];
+    engine.validateArgBounds(args, 1, 1, '-am');
     msg = args[0];
   }
 
-  if (this.commandOptions['-m']) {
-    args = this.commandOptions['-m'];
-    this.validateArgBounds(args, 1, 1, '-m');
+  if (commandOptions['-m']) {
+    args = commandOptions['-m'];
+    engine.validateArgBounds(args, 1, 1, '-m');
     msg = args[0];
   }
 
-  var newCommit = this.commit();
+  var newCommit = engine.commit();
   if (msg) {
     msg = msg
       .replace(/&quot;/g, '"')
@@ -25115,11 +25181,11 @@ GitEngine.prototype.commitStarter = function() {
     newCommit.set('commitMessage', msg);
   }
 
-  var promise = this.animationFactory.playCommitBirthPromiseAnimation(
+  var promise = engine.animationFactory.playCommitBirthPromiseAnimation(
     newCommit,
-    this.gitVisuals
+    engine.gitVisuals
   );
-  this.animationQueue.thenFinish(promise);
+  engine.animationQueue.thenFinish(promise);
 };
 
 GitEngine.prototype.commit = function() {
@@ -29359,6 +29425,7 @@ var GitCommands = require('../git/commands');
 var GitOptionParser = GitCommands.GitOptionParser;
 
 var ParseWaterfall = require('../level/parseWaterfall').ParseWaterfall;
+var intl = require('../intl');
 
 var CommandProcessError = Errors.CommandProcessError;
 var GitError = Errors.GitError;
@@ -29404,6 +29471,53 @@ var Command = Backbone.Model.extend({
     this.set('warnings', []);
   },
 
+  getGeneralArgs: function() {
+    return this.get('generalArgs');
+  },
+
+  getSupportedMap: function() {
+    return this.get('supportedMap');
+  },
+
+  acceptNoGeneralArgs: function() {
+    if (this.getGeneralArgs().length) {
+      throw new GitError({
+        msg: intl.str('git-error-no-general-args')
+      });
+    }
+  },
+
+  // this is a little utility class to help arg validation that happens over and over again
+  validateArgBounds: function(args, lower, upper, option) {
+    var what = (option === undefined) ?
+      'git ' + this.get('method') :
+      this.get('method') + ' ' + option + ' ';
+    what = 'with ' + what;
+
+    if (args.length < lower) {
+      throw new GitError({
+        msg: intl.str(
+          'git-error-args-few',
+          {
+            lower: String(lower),
+            what: what
+          }
+        )
+      });
+    }
+    if (args.length > upper) {
+      throw new GitError({
+        msg: intl.str(
+          'git-error-args-many',
+          {
+            upper: String(upper),
+            what: what
+          }
+        )
+      });
+    }
+  },
+
   validateAtInit: function() {
     if (this.get('rawStr') === null) {
       throw new Error('Give me a string!');

index.html

@@ -439,7 +439,7 @@
        For a much easier time perusing the source, see the individual files at:
           https://github.com/pcottle/learnGitBranching
   -->
-  <script src="build/bundle.min.681df2a8.js"></script>
+  <script src="build/bundle.js"></script>
 
   <!-- The advantage of github pages: super-easy, simple, slick static hostic.
        The downside? No raw logs to parse for analytics, so I have to include

spec/git.spec.js

@@ -1,6 +1,10 @@
 var HeadlessGit = require('../src/js/git/headless').HeadlessGit;
 var TreeCompare = require('../src/js/git/treeCompare').TreeCompare;
 
+var TIME = 150;
+// useful for throwing garbage and then expecting one commit
+var oneCommit = '{"branches":{"master":{"target":"C2","id":"master"}},"commits":{"C0":{"parents":[],"id":"C0","rootCommit":true},"C1":{"parents":["C0"],"id":"C1"},"C2":{"parents":["C1"],"id":"C2"}},"HEAD":{"target":"master","id":"HEAD"}}';
+
 var loadTree = function(json) {
   return JSON.parse(unescape(json));
 };
@@ -14,12 +18,21 @@ var compareAnswer = function(headless, expectedJSON) {
 
 var expectTreeAsync = function(command, expectedJSON) {
   var headless = new HeadlessGit();
+  var start = Date.now();
+  var haveReported = false;
+
   runs(function() {
     headless.sendCommand(command);
   });
   waitsFor(function() {
+    var diff = (Date.now() - start);
+    if (diff > TIME - 50 && !haveReported) {
+      haveReported = true;
+      console.log('not going to match', command);
+      console.log('expected', loadTree(expectedJSON), 'actual', headless.gitEngine.exportTree());
+    }
     return compareAnswer(headless, expectedJSON);
-  }, 'trees should be equal', 750);
+  }, 'trees should be equal', 100);
 };
 
 describe('GitEngine', function() {
@@ -30,6 +43,20 @@ describe('GitEngine', function() {
     );
   });
 
+  it('handles commit options', function() {
+    expectTreeAsync(
+      'git commit; git commit --amend;',
+      '%7B%22branches%22%3A%7B%22master%22%3A%7B%22target%22%3A%22C2%27%22%2C%22id%22%3A%22master%22%7D%7D%2C%22commits%22%3A%7B%22C0%22%3A%7B%22parents%22%3A%5B%5D%2C%22id%22%3A%22C0%22%2C%22rootCommit%22%3Atrue%7D%2C%22C1%22%3A%7B%22parents%22%3A%5B%22C0%22%5D%2C%22id%22%3A%22C1%22%7D%2C%22C2%22%3A%7B%22parents%22%3A%5B%22C1%22%5D%2C%22id%22%3A%22C2%22%7D%2C%22C2%27%22%3A%7B%22parents%22%3A%5B%22C1%22%5D%2C%22id%22%3A%22C2%27%22%7D%7D%2C%22HEAD%22%3A%7B%22target%22%3A%22master%22%2C%22id%22%3A%22HEAD%22%7D%7D'
+    );
+  });
+
+  it('throws with bad arg options', function() {
+    expectTreeAsync(
+      'git commit foo; git commit -am -m; git commit -am -a; git commit -am "hi" "ho"; git commit',
+      oneCommit
+    );
+  });
+
   it('Checkouts', function() {
     expectTreeAsync(
       'git checkout -b side',

spec/levels.spec.js

@@ -2,6 +2,7 @@ var HeadlessGit = require('../src/js/git/headless').HeadlessGit;
 var TreeCompare = require('../src/js/git/treeCompare').TreeCompare;
 
 var _ = require('underscore');
+var TIME = 150;
 
 var loadTree = function(json) {
   return JSON.parse(unescape(json));
@@ -25,7 +26,7 @@ var expectTreeAsync = function(headless, levelBlob) {
   });
   waitsFor(function() {
     var diff = (Date.now() - start);
-    if (diff > 700) {
+    if (diff > TIME - 50) {
       console.log('not going to match', command);
     }
     var result = compareLevelTree(headless, levelBlob);
@@ -33,7 +34,7 @@ var expectTreeAsync = function(headless, levelBlob) {
       console.log('solved level ' + levelBlob.name.en_US);
     }
     return result;
-  }, 'trees should be equal', 750);
+  }, 'trees should be equal', TIME);
 };
 
 var expectLevelSolved = function(levelBlob) {

src/js/commands/index.js

@@ -0,0 +1,108 @@
+var _ = require('underscore');
+var Q = require('q');
+
+var intl = require('../intl');
+
+var Errors = require('../util/errors');
+var GitError = Errors.GitError;
+var CommandResult = Errors.CommandResult;
+
+var Commands = {
+  commit: function(engine, command) {
+    var commandOptions = command.getSupportedMap();
+    command.acceptNoGeneralArgs();
+
+    if (commandOptions['-am'] && (
+        commandOptions['-a'] || commandOptions['-m'])) {
+      throw new GitError({
+        msg: intl.str('git-error-options')
+      });
+    }
+
+    var msg = null;
+    var args = null;
+    if (commandOptions['-a']) {
+      command.addWarning(intl.str('git-warning-add'));
+    }
+
+    if (commandOptions['-am']) {
+      args = commandOptions['-am'];
+      command.validateArgBounds(args, 1, 1, '-am');
+      msg = args[0];
+    }
+
+    if (commandOptions['-m']) {
+      args = commandOptions['-m'];
+      command.validateArgBounds(args, 1, 1, '-m');
+      msg = args[0];
+    }
+
+    var newCommit = engine.commit();
+    if (msg) {
+      msg = msg
+        .replace(/"/g, '"')
+        .replace(/^"/g, '')
+        .replace(/"$/g, '');
+
+      newCommit.set('commitMessage', msg);
+    }
+
+    var promise = engine.animationFactory.playCommitBirthPromiseAnimation(
+      newCommit,
+      engine.gitVisuals
+    );
+    engine.animationQueue.thenFinish(promise);
+  },
+
+  checkout: function(engine, command) {
+    var commandOptions = command.getSupportedMap();
+    var generalArgs = command.getGeneralArgs();
+
+    var args = null;
+    if (commandOptions['-b']) {
+      if (generalArgs.length) {
+        throw new GitError({
+          msg: intl.str('git-error-options')
+        });
+      }
+
+      // the user is really trying to just make a branch and then switch to it. so first:
+      args = commandOptions['-b'];
+      command.twoArgsImpliedHead(args, '-b');
+
+      var validId = engine.validateBranchName(args[0]);
+      engine.branch(validId, args[1]);
+      engine.checkout(validId);
+      return;
+    }
+
+    if (commandOptions['-']) {
+      // get the heads last location
+      var lastPlace = engine.HEAD.get('lastLastTarget');
+      if (!lastPlace) {
+        throw new GitError({
+          msg: intl.str('git-result-nothing')
+        });
+      }
+      engine.HEAD.set('target', lastPlace);
+      return;
+    }
+
+    if (commandOptions['-B']) {
+      args = commandOptions['-B'];
+      command.twoArgsImpliedHead(args, '-B');
+
+      engine.forceBranch(args[0], args[1]);
+      engine.checkout(args[0]);
+      return;
+    }
+
+    command.validateArgBounds(generalArgs, 1, 1);
+
+    engine.checkout(engine.crappyUnescape(generalArgs[0]));
+  },
+
+  noComma: 123
+};
+
+module.exports = Commands;

src/js/git/index.js

@@ -14,6 +14,8 @@ var GitError = Errors.GitError;
 var CommandResult = Errors.CommandResult;
 var EventBaton = require('../util/eventBaton').EventBaton;
 
+var Commands = require('../commands');
+
 function GitEngine(options) {
   this.rootCommit = null;
   this.refs = {};
@@ -1207,50 +1209,6 @@ GitEngine.prototype.cherrypick = function(commit) {
   return newCommit;
 };
 
-GitEngine.prototype.commitStarter = function() {
-  this.acceptNoGeneralArgs();
-  if (this.commandOptions['-am'] && (
-      this.commandOptions['-a'] || this.commandOptions['-m'])) {
-    throw new GitError({
-      msg: intl.str('git-error-options')
-    });
-  }
-
-  var msg = null;
-  var args = null;
-  if (this.commandOptions['-a']) {
-    this.command.addWarning(intl.str('git-warning-add'));
-  }
-
-  if (this.commandOptions['-am']) {
-    args = this.commandOptions['-am'];
-    this.validateArgBounds(args, 1, 1, '-am');
-    msg = args[0];
-  }
-
-  if (this.commandOptions['-m']) {
-    args = this.commandOptions['-m'];
-    this.validateArgBounds(args, 1, 1, '-m');
-    msg = args[0];
-  }
-
-  var newCommit = this.commit();
-  if (msg) {
-    msg = msg
-      .replace(/"/g, '"')
-      .replace(/^"/g, '')
-      .replace(/"$/g, '');
-
-    newCommit.set('commitMessage', msg);
-  }
-
-  var promise = this.animationFactory.playCommitBirthPromiseAnimation(
-    newCommit,
-    this.gitVisuals
-  );
-  this.animationQueue.thenFinish(promise);
-};
-
 GitEngine.prototype.commit = function() {
   var targetCommit = this.getCommitFromRef(this.HEAD);
   var id = null;
@@ -1856,51 +1814,6 @@ GitEngine.prototype.merge = function(targetSource) {
   return mergeCommit;
 };
 
-GitEngine.prototype.checkoutStarter = function() {
-  var args = null;
-  if (this.commandOptions['-b']) {
-    if (this.generalArgs.length) {
-      throw new GitError({
-        msg: intl.str('git-error-options')
-      });
-    }
-
-    // the user is really trying to just make a branch and then switch to it. so first:
-    args = this.commandOptions['-b'];
-    this.twoArgsImpliedHead(args, '-b');
-
-    var validId = this.validateBranchName(args[0]);
-    this.branch(validId, args[1]);
-    this.checkout(validId);
-    return;
-  }
-
-  if (this.commandOptions['-']) {
-    // get the heads last location
-    var lastPlace = this.HEAD.get('lastLastTarget');
-    if (!lastPlace) {
-      throw new GitError({
-        msg: intl.str('git-result-nothing')
-      });
-    }
-    this.HEAD.set('target', lastPlace);
-    return;
-  }
-
-  if (this.commandOptions['-B']) {
-    args = this.commandOptions['-B'];
-    this.twoArgsImpliedHead(args, '-B');
-
-    this.forceBranch(args[0], args[1]);
-    this.checkout(args[0]);
-    return;
-  }
-
-  this.validateArgBounds(this.generalArgs, 1, 1);
-
-  this.checkout(this.crappyUnescape(this.generalArgs[0]));
-};
-
 GitEngine.prototype.checkout = function(idOrTarget) {
   var target = this.resolveID(idOrTarget);
   if (target.get('id') === 'HEAD') {
@@ -2068,8 +1981,14 @@ GitEngine.prototype.dispatch = function(command, deferred) {
   });
 
   try {
-    var methodName = command.get('method').replace(/-/g, '') + 'Starter';
-    this[methodName]();
+    var methodName = command.get('method').replace(/-/g, '');
+    // first check out module
+    if (Commands[methodName]) {
+      Commands[methodName](this, this.command);
+    } else {
+      var startName = methodName + 'Starter';
+      this[startName]();
+    }
   } catch (err) {
     this.filterError(err);
     // short circuit animation by just setting error and returning

src/js/models/commandModel.js

@@ -7,6 +7,7 @@ var GitCommands = require('../git/commands');
 var GitOptionParser = GitCommands.GitOptionParser;
 
 var ParseWaterfall = require('../level/parseWaterfall').ParseWaterfall;
+var intl = require('../intl');
 
 var CommandProcessError = Errors.CommandProcessError;
 var GitError = Errors.GitError;
@@ -52,6 +53,62 @@ var Command = Backbone.Model.extend({
     this.set('warnings', []);
   },
 
+  getGeneralArgs: function() {
+    return this.get('generalArgs');
+  },
+
+  getSupportedMap: function() {
+    return this.get('supportedMap');
+  },
+
+  acceptNoGeneralArgs: function() {
+    if (this.getGeneralArgs().length) {
+      throw new GitError({
+        msg: intl.str('git-error-no-general-args')
+      });
+    }
+  },
+
+  twoArgsImpliedHead: function(args, option) {
+    // our args we expect to be between 1 and 2
+    this.validateArgBounds(args, 1, 2, option);
+    // and if it's one, add a HEAD to the back
+    if (args.length == 1) {
+      args.push('HEAD');
+    }
+  },
+
+  // this is a little utility class to help arg validation that happens over and over again
+  validateArgBounds: function(args, lower, upper, option) {
+    var what = (option === undefined) ?
+      'git ' + this.get('method') :
+      this.get('method') + ' ' + option + ' ';
+    what = 'with ' + what;
+
+    if (args.length < lower) {
+      throw new GitError({
+        msg: intl.str(
+          'git-error-args-few',
+          {
+            lower: String(lower),
+            what: what
+          }
+        )
+      });
+    }
+    if (args.length > upper) {
+      throw new GitError({
+        msg: intl.str(
+          'git-error-args-many',
+          {
+            upper: String(upper),
+            what: what
+          }
+        )
+      });
+    }
+  },
+
   validateAtInit: function() {
     if (this.get('rawStr') === null) {
       throw new Error('Give me a string!');