import org.eclipse.jgit.lib.ObjectId;
import org.eclipse.jgit.pgm.internal.CLIText;
import org.kohsuke.args4j.Argument;
+import org.kohsuke.args4j.Option;
@Command(common = true, usage = "usage_Describe")
class Describe extends TextBuiltin {
@Argument(index = 0, metaVar = "metaVar_treeish")
private ObjectId tree;
+ @Option(name = "--long", usage = "usage_LongFormat")
+ private boolean longDesc;
+
@Override
protected void run() throws Exception {
DescribeCommand cmd = new Git(db).describe();
if (tree != null)
cmd.setTarget(tree);
+ cmd.setLong(longDesc);
String result = null;
try {
result = cmd.call();
import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
+import java.util.Arrays;
+import java.util.Collection;
import org.eclipse.jgit.api.errors.GitAPIException;
import org.eclipse.jgit.api.errors.RefNotFoundException;
import org.eclipse.jgit.junit.RepositoryTestCase;
import org.eclipse.jgit.lib.ObjectId;
import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.Parameterized;
+import org.junit.runners.Parameterized.Parameter;
+import org.junit.runners.Parameterized.Parameters;
+@RunWith(Parameterized.class)
public class DescribeCommandTest extends RepositoryTestCase {
private Git git;
+ @Parameter
+ public boolean useAnnotatedTags;
+
+ @Parameters
+ public static Collection<Boolean[]> getUseAnnotatedTagsValues() {
+ return Arrays.asList(new Boolean[][] { { Boolean.TRUE },
+ { Boolean.FALSE } });
+ }
+
@Override
public void setUp() throws Exception {
super.setUp();
ObjectId c4 = modify("ddd");
assertNull(describe(c1));
+ assertNull(describe(c1, true));
assertEquals("t1", describe(c2));
assertEquals("t2", describe(c3));
+ assertEquals("t2-0-g44579eb", describe(c3, true));
assertNameStartsWith(c4, "3e563c5");
// the value verified with git-describe(1)
assertEquals("t2-1-g3e563c5", describe(c4));
+ assertEquals("t2-1-g3e563c5", describe(c4, true));
// test default target
assertEquals("t2-1-g3e563c5", git.describe().call());
assertNameStartsWith(c4, "119892b");
assertEquals("t-2-g119892b", describe(c4)); // 2 commits: c4 and c3
assertNull(describe(c3));
+ assertNull(describe(c3, true));
}
private void branch(String name, ObjectId base) throws GitAPIException {
}
private void tag(String tag) throws GitAPIException {
- git.tag().setName(tag).setMessage(tag).call();
+ TagCommand tagCommand = git.tag().setName(tag)
+ .setAnnotated(useAnnotatedTags);
+ if (useAnnotatedTags)
+ tagCommand.setMessage(tag);
+ tagCommand.call();
}
private static void touch(File f, String contents) throws Exception {
w.close();
}
+ private String describe(ObjectId c1, boolean longDesc)
+ throws GitAPIException, IOException {
+ return git.describe().setTarget(c1).setLong(longDesc).call();
+ }
+
private String describe(ObjectId c1) throws GitAPIException, IOException {
- return git.describe().setTarget(c1).call();
+ return describe(c1, false);
}
private static void assertNameStartsWith(ObjectId c4, String prefix) {
*/
private int maxCandidates = 10;
+ /**
+ * Whether to always use long output format or not.
+ */
+ private boolean longDesc;
+
/**
*
* @param repo
return setTarget(id);
}
+ /**
+ * Determine whether always to use the long format or not. When set to
+ * <code>true</code> the long format is used even the commit matches a tag.
+ *
+ * @param longDesc
+ * <code>true</code> if always the long format should be used.
+ * @return {@code this}
+ *
+ * @see <a
+ * href="https://www.kernel.org/pub/software/scm/git/docs/git-describe.html"
+ * >Git documentation about describe</a>
+ * @since 4.0
+ */
+ public DescribeCommand setLong(boolean longDesc) {
+ this.longDesc = longDesc;
+ return this;
+ }
+
+ private String longDescription(Ref tag, int depth, ObjectId tip)
+ throws IOException {
+ return String.format(
+ "%s-%d-g%s", tag.getName().substring(R_TAGS.length()), //$NON-NLS-1$
+ Integer.valueOf(depth), w.getObjectReader().abbreviate(tip)
+ .name());
+ }
+
/**
* Describes the specified commit. Target defaults to HEAD if no commit was
* set explicitly.
}
String describe(ObjectId tip) throws IOException {
- return String.format("%s-%d-g%s", tag.getName().substring(R_TAGS.length()), //$NON-NLS-1$
- Integer.valueOf(depth), w.getObjectReader().abbreviate(tip).name());
+ return longDescription(tag, depth, tip);
}
+
}
List<Candidate> candidates = new ArrayList<Candidate>(); // all the candidates we find
// is the target already pointing to a tag? if so, we are done!
Ref lucky = tags.get(target);
- if (lucky != null)
- return lucky.getName().substring(R_TAGS.length());
+ if (lucky != null) {
+ return longDesc ? longDescription(lucky, 0, target) : lucky
+ .getName().substring(R_TAGS.length());
+ }
w.markStart(target);
projects / jgit.git / commitdiff