/*
 * Copyright (c) 2016, Two Sigma Open Source
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * * Redistributions of source code must retain the above copyright notice,
 *   this list of conditions and the following disclaimer.
 *
 * * Redistributions in binary form must reproduce the above copyright notice,
 *   this list of conditions and the following disclaimer in the documentation
 *   and/or other materials provided with the distribution.
 *
 * * Neither the name of git-meta nor the names of its
 *   contributors may be used to endorse or promote products derived from
 *   this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

const co = require("co");

/**
 * This module contains the entrypoint for the `checkout` command.
 */

exports.helpText = `Check out a commit in the meta-repository and each
(visible) submodule.  Fetch commits by SHA as needed for submodules`;

/**
 * Configure the sepcified `parser` for the `checkout` command.
 *
 * @param {ArgumentParser} parser
 */
exports.configureParser = function (parser) {

    parser.addArgument(["committish"], {
        type: "string",
        help: "commit to check out",
    });
};

/**
 * Execute the `checkout` command based on the supplied arguments.
 *
 * @async
 * @param {Object} args
 * @param {String} args.committish
 */
exports.executeableSubcommand = co.wrap(function *(args) {
    const Checkout = require("../util/checkout");
    const GitUtil  = require("../util/git_util");

    const repo = yield GitUtil.getCurrentRepo();
    yield Checkout.checkout(repo, args.committish);
});

@@ -1968,16 +1968,160 @@
 ser) %7B%0A%0A
+    parser.addArgument(%5B%22-b%22%5D, %7B%0A        dest: %22new branch name%22,%0A        help: %60Create a new branch to check out.%60,%0A        nargs: 1,%0A    %7D);%0A%0A
     pars
@@ -2214,16 +2214,64 @@
 k out%22,%0A
+        defaultValue: null,%0A        nargs: %22?%22,%0A
     %7D);%0A
@@ -2480,16 +2480,55 @@
 args) %7B%0A
+    const colors = require(%22colors%22);%0A%0A
     cons
@@ -2538,16 +2538,17 @@
 heckout 
+ 
 = requir
@@ -2589,16 +2589,17 @@
 itUtil  
+ 
 = requir
@@ -2630,104 +2630,739 @@
     
-const repo = yield GitUtil.getCurrentRepo();%0A    yield Checkout.checkout(repo, args.committish);
+let committish = args.committish;%0A    let newBranch = null;%0A%0A    const newBranchNameArr = args%5B%22new branch name%22%5D;%0A    if (newBranchNameArr) %7B%0A        newBranch = newBranchNameArr%5B0%5D;%0A    %7D%0A%0A    const repo = yield GitUtil.getCurrentRepo();%0A    if (null !== committish) %7B%0A        yield Checkout.checkout(repo, committish);%0A    %7D%0A    if (null !== newBranch) %7B%0A        const branch = yield GitUtil.createBranchFromHead(repo, newBranch);%0A        yield repo.setHead(branch.name());%0A        console.log(%60Switched to new branch $%7Bcolors.green(newBranch)%7D.%60);%0A    %7D%0A    else %7B%0A        // TODO display info about whether this is a branch, detached head,%0A        // etc.%0A        console.log(%60Switched to $%7Bcolors.green(committish)%7D.%60);%0A    %7D
 %0A%7D);

Support '-b' option in 'checkout'.