Add CheckoutCommand
Add the ability to checkout a branch to the working tree. Bug: 330860 Change-Id: Ie06b9e799a9e1be384da0b8996efa7209b32eac3 Signed-off-by: Chris Aniszczyk <caniszczyk@gmail.com>
This commit is contained in:
parent
34962b4700
commit
923443f94f
|
@ -0,0 +1,123 @@
|
||||||
|
/*
|
||||||
|
* Copyright (C) 2010, Chris Aniszczyk <caniszczyk@gmail.com>
|
||||||
|
* and other copyright owners as documented in the project's IP log.
|
||||||
|
*
|
||||||
|
* This program and the accompanying materials are made available
|
||||||
|
* under the terms of the Eclipse Distribution License v1.0 which
|
||||||
|
* accompanies this distribution, is reproduced below, and is
|
||||||
|
* available at http://www.eclipse.org/org/documents/edl-v10.php
|
||||||
|
*
|
||||||
|
* 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 the Eclipse Foundation, Inc. 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 OWNER 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.
|
||||||
|
*/
|
||||||
|
package org.eclipse.jgit.api;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
import org.eclipse.jgit.api.errors.InvalidRefNameException;
|
||||||
|
import org.eclipse.jgit.api.errors.JGitInternalException;
|
||||||
|
import org.eclipse.jgit.api.errors.RefAlreadyExistsException;
|
||||||
|
import org.eclipse.jgit.api.errors.RefNotFoundException;
|
||||||
|
import org.eclipse.jgit.lib.Constants;
|
||||||
|
import org.eclipse.jgit.lib.RefUpdate;
|
||||||
|
import org.eclipse.jgit.lib.RepositoryTestCase;
|
||||||
|
import org.eclipse.jgit.revwalk.RevCommit;
|
||||||
|
|
||||||
|
public class CheckoutCommandTest extends RepositoryTestCase {
|
||||||
|
private Git git;
|
||||||
|
|
||||||
|
RevCommit initialCommit;
|
||||||
|
|
||||||
|
RevCommit secondCommit;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
protected void setUp() throws Exception {
|
||||||
|
super.setUp();
|
||||||
|
git = new Git(db);
|
||||||
|
// commit something
|
||||||
|
writeTrashFile("Test.txt", "Hello world");
|
||||||
|
git.add().addFilepattern("Test.txt").call();
|
||||||
|
initialCommit = git.commit().setMessage("Initial commit").call();
|
||||||
|
|
||||||
|
// create a master branch and switch to it
|
||||||
|
git.branchCreate().setName("test").call();
|
||||||
|
RefUpdate rup = db.updateRef(Constants.HEAD);
|
||||||
|
rup.link("refs/heads/test");
|
||||||
|
|
||||||
|
// commit something on the test branch
|
||||||
|
writeTrashFile("Test.txt", "Some change");
|
||||||
|
git.add().addFilepattern("Test.txt").call();
|
||||||
|
secondCommit = git.commit().setMessage("Second commit").call();
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSimpleCheckout() {
|
||||||
|
try {
|
||||||
|
git.checkout().setName("test").call();
|
||||||
|
} catch (Exception e) {
|
||||||
|
fail(e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCheckout() {
|
||||||
|
try {
|
||||||
|
git.checkout().setName("test").call();
|
||||||
|
assertEquals("[Test.txt, mode:100644, content:Some change]",
|
||||||
|
indexState(CONTENT));
|
||||||
|
git.checkout().setName("master").call();
|
||||||
|
assertEquals("[Test.txt, mode:100644, content:Hello world]",
|
||||||
|
indexState(CONTENT));
|
||||||
|
} catch (Exception e) {
|
||||||
|
fail(e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCreateBranchOnCheckout() throws IOException {
|
||||||
|
try {
|
||||||
|
git.checkout().setCreateBranch(true).setName("test2").call();
|
||||||
|
} catch (Exception e) {
|
||||||
|
fail(e.getMessage());
|
||||||
|
}
|
||||||
|
assertNotNull(db.getRef("test2"));
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCheckoutToNonExistingBranch() throws JGitInternalException,
|
||||||
|
RefAlreadyExistsException, InvalidRefNameException {
|
||||||
|
try {
|
||||||
|
git.checkout().setName("badbranch").call();
|
||||||
|
fail("Should have failed");
|
||||||
|
} catch (RefNotFoundException e) {
|
||||||
|
// except to hit here
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
|
@ -79,6 +79,7 @@ channelMustBeInRange0_255=channel {0} must be in range [0, 255]
|
||||||
characterClassIsNotSupported=The character class {0} is not supported.
|
characterClassIsNotSupported=The character class {0} is not supported.
|
||||||
checkoutConflictWithFile=Checkout conflict with file: {0}
|
checkoutConflictWithFile=Checkout conflict with file: {0}
|
||||||
checkoutConflictWithFiles=Checkout conflict with files: {0}
|
checkoutConflictWithFiles=Checkout conflict with files: {0}
|
||||||
|
checkoutUnexpectedResult=Checkout returned unexpected result {0}
|
||||||
classCastNotA=Not a {0}
|
classCastNotA=Not a {0}
|
||||||
collisionOn=Collision on {0}
|
collisionOn=Collision on {0}
|
||||||
commandWasCalledInTheWrongState=Command {0} was called in the wrong state
|
commandWasCalledInTheWrongState=Command {0} was called in the wrong state
|
||||||
|
|
|
@ -137,6 +137,7 @@ public static JGitText get() {
|
||||||
/***/ public String cantPassMeATree;
|
/***/ public String cantPassMeATree;
|
||||||
/***/ public String channelMustBeInRange0_255;
|
/***/ public String channelMustBeInRange0_255;
|
||||||
/***/ public String characterClassIsNotSupported;
|
/***/ public String characterClassIsNotSupported;
|
||||||
|
/***/ public String checkoutUnexpectedResult;
|
||||||
/***/ public String checkoutConflictWithFile;
|
/***/ public String checkoutConflictWithFile;
|
||||||
/***/ public String checkoutConflictWithFiles;
|
/***/ public String checkoutConflictWithFiles;
|
||||||
/***/ public String classCastNotA;
|
/***/ public String classCastNotA;
|
||||||
|
|
|
@ -0,0 +1,272 @@
|
||||||
|
/*
|
||||||
|
* Copyright (C) 2010, Chris Aniszczyk <caniszczyk@gmail.com>
|
||||||
|
* and other copyright owners as documented in the project's IP log.
|
||||||
|
*
|
||||||
|
* This program and the accompanying materials are made available
|
||||||
|
* under the terms of the Eclipse Distribution License v1.0 which
|
||||||
|
* accompanies this distribution, is reproduced below, and is
|
||||||
|
* available at http://www.eclipse.org/org/documents/edl-v10.php
|
||||||
|
*
|
||||||
|
* 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 the Eclipse Foundation, Inc. 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 OWNER 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.
|
||||||
|
*/
|
||||||
|
package org.eclipse.jgit.api;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.text.MessageFormat;
|
||||||
|
|
||||||
|
import org.eclipse.jgit.JGitText;
|
||||||
|
import org.eclipse.jgit.api.errors.InvalidRefNameException;
|
||||||
|
import org.eclipse.jgit.api.errors.JGitInternalException;
|
||||||
|
import org.eclipse.jgit.api.errors.RefAlreadyExistsException;
|
||||||
|
import org.eclipse.jgit.api.errors.RefNotFoundException;
|
||||||
|
import org.eclipse.jgit.dircache.DirCacheCheckout;
|
||||||
|
import org.eclipse.jgit.errors.AmbiguousObjectException;
|
||||||
|
import org.eclipse.jgit.lib.Constants;
|
||||||
|
import org.eclipse.jgit.lib.ObjectId;
|
||||||
|
import org.eclipse.jgit.lib.Ref;
|
||||||
|
import org.eclipse.jgit.lib.RefUpdate;
|
||||||
|
import org.eclipse.jgit.lib.RefUpdate.Result;
|
||||||
|
import org.eclipse.jgit.lib.Repository;
|
||||||
|
import org.eclipse.jgit.revwalk.RevCommit;
|
||||||
|
import org.eclipse.jgit.revwalk.RevWalk;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checkout a branch to the working tree
|
||||||
|
*
|
||||||
|
* @see <a
|
||||||
|
* href="http://www.kernel.org/pub/software/scm/git/docs/git-checkout.html"
|
||||||
|
* >Git documentation about Checkout</a>
|
||||||
|
*/
|
||||||
|
public class CheckoutCommand extends GitCommand<Ref> {
|
||||||
|
private String name;
|
||||||
|
|
||||||
|
private boolean force = false;
|
||||||
|
|
||||||
|
private boolean createBranch = false;
|
||||||
|
|
||||||
|
private CreateBranchCommand.SetupUpstreamMode upstreamMode;
|
||||||
|
|
||||||
|
private String startPoint = Constants.HEAD;
|
||||||
|
|
||||||
|
private RevCommit startCommit;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param repo
|
||||||
|
*/
|
||||||
|
protected CheckoutCommand(Repository repo) {
|
||||||
|
super(repo);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @throws RefAlreadyExistsException
|
||||||
|
* when trying to create (without force) a branch with a name
|
||||||
|
* that already exists
|
||||||
|
* @throws RefNotFoundException
|
||||||
|
* if the start point or branch can not be found
|
||||||
|
* @throws InvalidRefNameException
|
||||||
|
* if the provided name is <code>null</code> or otherwise
|
||||||
|
* invalid
|
||||||
|
* @return the newly created branch
|
||||||
|
*/
|
||||||
|
public Ref call() throws JGitInternalException, RefAlreadyExistsException,
|
||||||
|
RefNotFoundException, InvalidRefNameException {
|
||||||
|
checkCallable();
|
||||||
|
processOptions();
|
||||||
|
try {
|
||||||
|
|
||||||
|
if(createBranch) {
|
||||||
|
Git git = new Git(repo);
|
||||||
|
CreateBranchCommand command = git.branchCreate();
|
||||||
|
command.setName(name);
|
||||||
|
command.setStartPoint(getStartPoint().name());
|
||||||
|
if (upstreamMode != null)
|
||||||
|
command.setUpstreamMode(upstreamMode);
|
||||||
|
command.call();
|
||||||
|
}
|
||||||
|
|
||||||
|
RevWalk revWalk = new RevWalk(repo);
|
||||||
|
Ref headRef = repo.getRef(Constants.HEAD);
|
||||||
|
RevCommit headCommit = revWalk.parseCommit(headRef.getObjectId());
|
||||||
|
String refLogMessage = "checkout: moving from "
|
||||||
|
+ headRef.getTarget().getName();
|
||||||
|
ObjectId branch = repo.resolve(name);
|
||||||
|
Ref ref = repo.getRef(name);
|
||||||
|
if (branch == null)
|
||||||
|
throw new RefNotFoundException(MessageFormat.format(
|
||||||
|
JGitText.get().refNotResolved, name));
|
||||||
|
|
||||||
|
RevCommit newCommit = revWalk.parseCommit(branch);
|
||||||
|
|
||||||
|
DirCacheCheckout dco = new DirCacheCheckout(repo,
|
||||||
|
headCommit.getTree(), repo.lockDirCache(),
|
||||||
|
newCommit.getTree());
|
||||||
|
dco.setFailOnConflict(true);
|
||||||
|
dco.checkout();
|
||||||
|
RefUpdate refUpdate = repo.updateRef(Constants.HEAD);
|
||||||
|
refUpdate.setForceUpdate(force);
|
||||||
|
refUpdate.setRefLogMessage(
|
||||||
|
refLogMessage + "to " + newCommit.getName(), false);
|
||||||
|
Result updateResult = refUpdate.link(ref.getName());
|
||||||
|
|
||||||
|
setCallable(false);
|
||||||
|
|
||||||
|
boolean ok = false;
|
||||||
|
switch (updateResult) {
|
||||||
|
case NEW:
|
||||||
|
ok = true;
|
||||||
|
break;
|
||||||
|
case NO_CHANGE:
|
||||||
|
case FAST_FORWARD:
|
||||||
|
case FORCED:
|
||||||
|
ok = true;
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!ok)
|
||||||
|
throw new JGitInternalException(MessageFormat.format(
|
||||||
|
JGitText.get().checkoutUnexpectedResult,
|
||||||
|
updateResult
|
||||||
|
.name()));
|
||||||
|
|
||||||
|
Ref result = repo.getRef(name);
|
||||||
|
|
||||||
|
return result;
|
||||||
|
} catch (IOException ioe) {
|
||||||
|
throw new JGitInternalException(ioe.getMessage(), ioe);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private ObjectId getStartPoint() throws AmbiguousObjectException,
|
||||||
|
RefNotFoundException, IOException {
|
||||||
|
if (startCommit != null)
|
||||||
|
return startCommit.getId();
|
||||||
|
ObjectId result = null;
|
||||||
|
try {
|
||||||
|
result = repo.resolve((startPoint == null) ? Constants.HEAD
|
||||||
|
: startPoint);
|
||||||
|
} catch (AmbiguousObjectException e) {
|
||||||
|
throw e;
|
||||||
|
}
|
||||||
|
if (result == null)
|
||||||
|
throw new RefNotFoundException(MessageFormat.format(
|
||||||
|
JGitText.get().refNotResolved,
|
||||||
|
startPoint != null ? startPoint : Constants.HEAD));
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
private void processOptions() throws InvalidRefNameException {
|
||||||
|
if (name == null
|
||||||
|
|| !Repository.isValidRefName(Constants.R_HEADS + name))
|
||||||
|
throw new InvalidRefNameException(MessageFormat.format(JGitText
|
||||||
|
.get().branchNameInvalid, name == null ? "<null>" : name));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param name
|
||||||
|
* the name of the new branch
|
||||||
|
* @return this instance
|
||||||
|
*/
|
||||||
|
public CheckoutCommand setName(String name) {
|
||||||
|
checkCallable();
|
||||||
|
this.name = name;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param createBranch
|
||||||
|
* if <code>true</code> a branch will be created as part of the
|
||||||
|
* checkout and set to the specified start point
|
||||||
|
* @return this instance
|
||||||
|
*/
|
||||||
|
public CheckoutCommand setCreateBranch(boolean createBranch) {
|
||||||
|
checkCallable();
|
||||||
|
this.createBranch = createBranch;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param force
|
||||||
|
* if <code>true</code> and the branch with the given name
|
||||||
|
* already exists, the start-point of an existing branch will be
|
||||||
|
* set to a new start-point; if false, the existing branch will
|
||||||
|
* not be changed
|
||||||
|
* @return this instance
|
||||||
|
*/
|
||||||
|
public CheckoutCommand setForce(boolean force) {
|
||||||
|
checkCallable();
|
||||||
|
this.force = force;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param startPoint
|
||||||
|
* corresponds to the start-point option; if <code>null</code>,
|
||||||
|
* the current HEAD will be used
|
||||||
|
* @return this instance
|
||||||
|
*/
|
||||||
|
public CheckoutCommand setStartPoint(String startPoint) {
|
||||||
|
checkCallable();
|
||||||
|
this.startPoint = startPoint;
|
||||||
|
this.startCommit = null;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param startCommit
|
||||||
|
* corresponds to the start-point option; if <code>null</code>,
|
||||||
|
* the current HEAD will be used
|
||||||
|
* @return this instance
|
||||||
|
*/
|
||||||
|
public CheckoutCommand setStartPoint(RevCommit startCommit) {
|
||||||
|
checkCallable();
|
||||||
|
this.startCommit = startCommit;
|
||||||
|
this.startPoint = null;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param mode
|
||||||
|
* corresponds to the --track/--no-track options; may be
|
||||||
|
* <code>null</code>
|
||||||
|
* @return this instance
|
||||||
|
*/
|
||||||
|
public CheckoutCommand setUpstreamMode(
|
||||||
|
CreateBranchCommand.SetupUpstreamMode mode) {
|
||||||
|
checkCallable();
|
||||||
|
this.upstreamMode = mode;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
}
|
|
@ -269,6 +269,19 @@ public RmCommand rm() {
|
||||||
return new RmCommand(repo);
|
return new RmCommand(repo);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns a command object to execute a {@code checkout} command
|
||||||
|
*
|
||||||
|
* @see <a
|
||||||
|
* href="http://www.kernel.org/pub/software/scm/git/docs/git-checkout.html"
|
||||||
|
* >Git documentation about checkout</a>
|
||||||
|
* @return a {@link CheckoutCommand} used to collect all optional parameters
|
||||||
|
* and to finally execute the {@code checkout} command
|
||||||
|
*/
|
||||||
|
public CheckoutCommand checkout() {
|
||||||
|
return new CheckoutCommand(repo);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @return the git repository this class is interacting with
|
* @return the git repository this class is interacting with
|
||||||
*/
|
*/
|
||||||
|
|
Loading…
Reference in New Issue