From f54e883566970f4b9884755b9aedbee47b511010 Mon Sep 17 00:00:00 2001 From: Chris Aniszczyk Date: Thu, 12 Aug 2010 11:25:31 -0500 Subject: [PATCH] Add TagCommand A tag command is added to the Git porcelain API. Tests were also added to stress test the tag command. Change-Id: Iab282a918eb51b0e9c55f628a3396ff01c9eb9eb Signed-off-by: Chris Aniszczyk Signed-off-by: Matthias Sohn --- .../org/eclipse/jgit/api/TagCommandTest.java | 116 +++++++ .../org/eclipse/jgit/JGitText.properties | 4 + .../src/org/eclipse/jgit/JGitText.java | 4 + .../src/org/eclipse/jgit/api/Git.java | 14 + .../jgit/api/InvalidTagNameException.java | 50 +++ .../src/org/eclipse/jgit/api/TagCommand.java | 310 ++++++++++++++++++ 6 files changed, 498 insertions(+) create mode 100644 org.eclipse.jgit.test/tst/org/eclipse/jgit/api/TagCommandTest.java create mode 100644 org.eclipse.jgit/src/org/eclipse/jgit/api/InvalidTagNameException.java create mode 100644 org.eclipse.jgit/src/org/eclipse/jgit/api/TagCommand.java diff --git a/org.eclipse.jgit.test/tst/org/eclipse/jgit/api/TagCommandTest.java b/org.eclipse.jgit.test/tst/org/eclipse/jgit/api/TagCommandTest.java new file mode 100644 index 000000000..79054fba6 --- /dev/null +++ b/org.eclipse.jgit.test/tst/org/eclipse/jgit/api/TagCommandTest.java @@ -0,0 +1,116 @@ +/* + * Copyright (C) 2010, Chris Aniszczyk + * 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 org.eclipse.jgit.errors.UnmergedPathException; +import org.eclipse.jgit.lib.RepositoryTestCase; +import org.eclipse.jgit.revwalk.RevCommit; +import org.eclipse.jgit.revwalk.RevTag; + +public class TagCommandTest extends RepositoryTestCase { + + public void testTaggingOnHead() throws NoHeadException, NoMessageException, + UnmergedPathException, ConcurrentRefUpdateException, + JGitInternalException, WrongRepositoryStateException, + InvalidTagNameException { + Git git = new Git(db); + RevCommit commit = git.commit().setMessage("initial commit").call(); + RevTag tag = git.tag().setName("tag").call(); + assertEquals(commit.getId(), tag.getObject().getId()); + } + + public void testTagging() throws NoHeadException, NoMessageException, + UnmergedPathException, ConcurrentRefUpdateException, + JGitInternalException, WrongRepositoryStateException, + InvalidTagNameException { + Git git = new Git(db); + git.commit().setMessage("initial commit").call(); + RevCommit commit = git.commit().setMessage("second commit").call(); + git.commit().setMessage("third commit").call(); + RevTag tag = git.tag().setObjectId(commit).setName("tag").call(); + assertEquals(commit.getId(), tag.getObject().getId()); + } + + public void testEmptyTagName() throws NoHeadException, NoMessageException, + UnmergedPathException, ConcurrentRefUpdateException, + JGitInternalException, WrongRepositoryStateException { + Git git = new Git(db); + git.commit().setMessage("initial commit").call(); + try { + // forget to tag name + git.tag().setMessage("some message").call(); + fail("We should have failed without a tag name"); + } catch (InvalidTagNameException e) { + // should hit here + } + } + + public void testInvalidTagName() throws NoHeadException, + NoMessageException, UnmergedPathException, + ConcurrentRefUpdateException, JGitInternalException, + WrongRepositoryStateException { + Git git = new Git(db); + git.commit().setMessage("initial commit").call(); + try { + git.tag().setName("bad~tag~name").setMessage("some message").call(); + fail("We should have failed due to a bad tag name"); + } catch (InvalidTagNameException e) { + // should hit here + } + } + + public void testFailureOnSignedTags() throws NoHeadException, + NoMessageException, UnmergedPathException, + ConcurrentRefUpdateException, JGitInternalException, + WrongRepositoryStateException, InvalidTagNameException { + Git git = new Git(db); + git.commit().setMessage("initial commit").call(); + try { + git.tag().setSigned(true).setName("tag").call(); + fail("We should have failed with an UnsupportedOperationException due to signed tag"); + } catch (UnsupportedOperationException e) { + // should hit here + } + } + +} diff --git a/org.eclipse.jgit/resources/org/eclipse/jgit/JGitText.properties b/org.eclipse.jgit/resources/org/eclipse/jgit/JGitText.properties index b9e270ec5..0b97d68f0 100644 --- a/org.eclipse.jgit/resources/org/eclipse/jgit/JGitText.properties +++ b/org.eclipse.jgit/resources/org/eclipse/jgit/JGitText.properties @@ -146,6 +146,7 @@ errorReadingInfoRefs=error reading info/refs exceptionCaughtDuringExecutionOfAddCommand=Exception caught during execution of add command exceptionCaughtDuringExecutionOfCommitCommand=Exception caught during execution of commit command exceptionCaughtDuringExecutionOfMergeCommand=Exception caught during execution of merge command. {0} +exceptionCaughtDuringExecutionOfTagCommand=Exception caught during execution of tag command exceptionOccuredDuringAddingOfOptionToALogCommand=Exception occured during adding of {0} as option to a Log command exceptionOccuredDuringReadingOfGIT_DIR=Exception occured during reading of $GIT_DIR/{0}. {1} expectedACKNAKFoundEOF=Expected ACK/NAK, found EOF @@ -331,6 +332,7 @@ shortCompressedStreamAt=Short compressed stream at {0} shortReadOfBlock=Short read of block. shortReadOfOptionalDIRCExtensionExpectedAnotherBytes=Short read of optional DIRC extension {0}; expected another {1} bytes within the section. shortSkipOfBlock=Short skip of block. +signingNotSupportedOnTag=Signing isn't supported on tag operations yet. similarityScoreMustBeWithinBounds=Similarity score must be between 0 and 100. sizeExceeds2GB=Path {0} size {1} exceeds 2 GiB limit. smartHTTPPushDisabled=smart HTTP push disabled @@ -343,6 +345,8 @@ startingReadStageWithoutWrittenRequestDataPendingIsNotSupported=Starting read st statelessRPCRequiresOptionToBeEnabled=stateless RPC requires {0} to be enabled submodulesNotSupported=Submodules are not supported symlinkCannotBeWrittenAsTheLinkTarget=Symlink "{0}" cannot be written as the link target cannot be read from within Java. +tagNameInvalid=tag name {0} is invalid +tagOnRepoWithoutHEADCurrentlyNotSupported=Tag on repository without HEAD currently not supported tSizeMustBeGreaterOrEqual1=tSize must be >= 1 theFactoryMustNotBeNull=The factory must not be null timerAlreadyTerminated=Timer already terminated diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/JGitText.java b/org.eclipse.jgit/src/org/eclipse/jgit/JGitText.java index 928a0f765..d6b496783 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/JGitText.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/JGitText.java @@ -206,6 +206,7 @@ public static JGitText get() { /***/ public String exceptionCaughtDuringExecutionOfAddCommand; /***/ public String exceptionCaughtDuringExecutionOfCommitCommand; /***/ public String exceptionCaughtDuringExecutionOfMergeCommand; + /***/ public String exceptionCaughtDuringExecutionOfTagCommand; /***/ public String exceptionOccuredDuringAddingOfOptionToALogCommand; /***/ public String exceptionOccuredDuringReadingOfGIT_DIR; /***/ public String expectedACKNAKFoundEOF; @@ -390,6 +391,7 @@ public static JGitText get() { /***/ public String shortReadOfBlock; /***/ public String shortReadOfOptionalDIRCExtensionExpectedAnotherBytes; /***/ public String shortSkipOfBlock; + /***/ public String signingNotSupportedOnTag; /***/ public String similarityScoreMustBeWithinBounds; /***/ public String sizeExceeds2GB; /***/ public String smartHTTPPushDisabled; @@ -402,6 +404,8 @@ public static JGitText get() { /***/ public String statelessRPCRequiresOptionToBeEnabled; /***/ public String submodulesNotSupported; /***/ public String symlinkCannotBeWrittenAsTheLinkTarget; + /***/ public String tagNameInvalid; + /***/ public String tagOnRepoWithoutHEADCurrentlyNotSupported; /***/ public String tSizeMustBeGreaterOrEqual1; /***/ public String theFactoryMustNotBeNull; /***/ public String timerAlreadyTerminated; diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/api/Git.java b/org.eclipse.jgit/src/org/eclipse/jgit/api/Git.java index 8a6401703..f96c52239 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/api/Git.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/api/Git.java @@ -1,5 +1,6 @@ /* * Copyright (C) 2010, Christian Halstrick + * Copyright (C) 2010, Chris Aniszczyk * and other copyright owners as documented in the project's IP log. * * This program and the accompanying materials are made available @@ -145,6 +146,19 @@ public AddCommand add() { return new AddCommand(repo); } + /** + * Returns a command object to execute a {@code Tag} command + * + * @see Git documentation about Tag + * @return a {@link TagCommand} used to collect all optional parameters + * and to finally execute the {@code Tag} command + */ + public TagCommand tag() { + return new TagCommand(repo); + } + /** * @return the git repository this class is interacting with */ diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/api/InvalidTagNameException.java b/org.eclipse.jgit/src/org/eclipse/jgit/api/InvalidTagNameException.java new file mode 100644 index 000000000..ceff63784 --- /dev/null +++ b/org.eclipse.jgit/src/org/eclipse/jgit/api/InvalidTagNameException.java @@ -0,0 +1,50 @@ +/* + * Copyright (C) 2010, Chris Aniszczyk 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; + +/** + * Exception thrown when a tag command was called with an invalid tag name (or + * null), such as bad~tag. + */ +public class InvalidTagNameException extends GitAPIException { + private static final long serialVersionUID = 1L; + + InvalidTagNameException(String msg) { + super(msg); + } +} diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/api/TagCommand.java b/org.eclipse.jgit/src/org/eclipse/jgit/api/TagCommand.java new file mode 100644 index 000000000..77a8825d0 --- /dev/null +++ b/org.eclipse.jgit/src/org/eclipse/jgit/api/TagCommand.java @@ -0,0 +1,310 @@ +/* + * Copyright (C) 2010, Chris Aniszczyk + * 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.lib.Constants; +import org.eclipse.jgit.lib.ObjectId; +import org.eclipse.jgit.lib.ObjectInserter; +import org.eclipse.jgit.lib.PersonIdent; +import org.eclipse.jgit.lib.RefUpdate; +import org.eclipse.jgit.lib.RefUpdate.Result; +import org.eclipse.jgit.lib.Repository; +import org.eclipse.jgit.lib.RepositoryState; +import org.eclipse.jgit.lib.TagBuilder; +import org.eclipse.jgit.revwalk.RevObject; +import org.eclipse.jgit.revwalk.RevTag; +import org.eclipse.jgit.revwalk.RevWalk; + +/** + * A class used to execute a {@code Tag} command. It has setters for all + * supported options and arguments of this command and a {@link #call()} method + * to finally execute the command. + * + * @see Git documentation about Tag + */ +public class TagCommand extends GitCommand { + private RevObject id; + + private String name; + + private String message; + + private PersonIdent tagger; + + private boolean signed; + + private boolean forceUpdate; + + /** + * @param repo + */ + protected TagCommand(Repository repo) { + super(repo); + } + + /** + * Executes the {@code tag} command with all the options and parameters + * collected by the setter methods of this class. Each instance of this + * class should only be used for one invocation of the command (means: one + * call to {@link #call()}) + * + * @return a {@link RevTag} object representing the successful tag + * @throws NoHeadException + * when called on a git repo without a HEAD reference + * @throws JGitInternalException + * a low-level exception of JGit has occurred. The original + * exception can be retrieved by calling + * {@link Exception#getCause()}. Expect only + * {@code IOException's} to be wrapped. + */ + public RevTag call() throws JGitInternalException, + ConcurrentRefUpdateException, InvalidTagNameException, NoHeadException { + checkCallable(); + + RepositoryState state = repo.getRepositoryState(); + processOptions(state); + + try { + // create the tag object + TagBuilder newTag = new TagBuilder(); + newTag.setTag(name); + newTag.setMessage(message); + newTag.setTagger(tagger); + + // if no id is set, we should attempt to use HEAD + if (id == null) { + ObjectId objectId = repo.resolve(Constants.HEAD + "^{commit}"); + if (objectId == null) + throw new NoHeadException( + JGitText.get().tagOnRepoWithoutHEADCurrentlyNotSupported); + + newTag.setObjectId(objectId, Constants.OBJ_COMMIT); + } else { + newTag.setObjectId(id); + } + + // write the tag object + ObjectInserter inserter = repo.newObjectInserter(); + try { + ObjectId tagId = inserter.insert(newTag); + inserter.flush(); + + RevWalk revWalk = new RevWalk(repo); + try { + RevTag revTag = revWalk.parseTag(newTag.getTagId()); + String refName = Constants.R_TAGS + newTag.getTag(); + RefUpdate tagRef = repo.updateRef(refName); + tagRef.setNewObjectId(tagId); + tagRef.setForceUpdate(forceUpdate); + Result updateResult = tagRef.update(revWalk); + switch (updateResult) { + case NEW: + case FORCED: + return revTag; + case LOCK_FAILURE: + throw new ConcurrentRefUpdateException( + JGitText.get().couldNotLockHEAD, + tagRef.getRef(), updateResult); + default: + throw new JGitInternalException(MessageFormat.format( + JGitText.get().updatingRefFailed, refName, + newTag.toString(), updateResult)); + } + + } finally { + revWalk.release(); + } + + } finally { + inserter.release(); + } + + } catch (IOException e) { + throw new JGitInternalException( + JGitText.get().exceptionCaughtDuringExecutionOfTagCommand, + e); + } + } + + /** + * Sets default values for not explicitly specified options. Then validates + * that all required data has been provided. + * + * @param state + * the state of the repository we are working on + * + * @throws InvalidTagNameException + * if the tag name is null or invalid + * @throws UnsupportedOperationException + * if the tag is signed (not supported yet) + */ + private void processOptions(RepositoryState state) + throws InvalidTagNameException { + if (tagger == null) + tagger = new PersonIdent(repo); + if (name == null || !Repository.isValidRefName(Constants.R_TAGS + name)) + throw new InvalidTagNameException(MessageFormat.format(JGitText + .get().tagNameInvalid, name == null ? "" : name)); + if (signed) + throw new UnsupportedOperationException( + JGitText.get().signingNotSupportedOnTag); + } + + /** + * @param name + * the tag name used for the {@code tag} + * @return {@code this} + */ + public TagCommand setName(String name) { + checkCallable(); + this.name = name; + return this; + } + + /** + * @return the tag name used for the tag + */ + public String getName() { + return name; + } + + /** + * @return the tag message used for the tag + */ + public String getMessage() { + return message; + } + + /** + * @param message + * the tag message used for the {@code tag} + * @return {@code this} + */ + public TagCommand setMessage(String message) { + checkCallable(); + this.message = message; + return this; + } + + /** + * @return whether the tag is signed + */ + public boolean isSigned() { + return signed; + } + + /** + * If set to true the Tag command creates a signed tag object. This + * corresponds to the parameter -s on the command line. + * + * @param signed + * @return {@code this} + */ + public TagCommand setSigned(boolean signed) { + this.signed = signed; + return this; + } + + /** + * Sets the tagger of the tag. If the tagger is null, a PersonIdent will be + * created from the info in the repository. + * + * @param tagger + * @return {@code this} + */ + public TagCommand setTagger(PersonIdent tagger) { + this.tagger = tagger; + return this; + } + + /** + * @return the tagger of the tag + */ + public PersonIdent getTagger() { + return tagger; + } + + /** + * @return the object id of the tag + */ + public RevObject getObjectId() { + return id; + } + + /** + * Sets the object id of the tag. If the object id is null, the commit + * pointed to from HEAD will be used. + * + * @param id + * @return {@code this} + */ + public TagCommand setObjectId(RevObject id) { + this.id = id; + return this; + } + + /** + * @return is this a force update + */ + public boolean isForceUpdate() { + return forceUpdate; + } + + /** + * If set to true the Tag command may replace an existing tag object. This + * corresponds to the parameter -f on the command line. + * + * @param forceUpdate + * @return {@code this} + */ + public TagCommand setForceUpdate(boolean forceUpdate) { + this.forceUpdate = forceUpdate; + return this; + } + +}