FilesExpand file tree

master

/

describe.c

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

184 lines (155 loc) · 5.49 KB

master

/

describe.c

Copy path

Top

File metadata and controls

• Code
• Blame

184 lines (155 loc) · 5.49 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

/*

* libgit2 "describe" example - shows how to describe commits

*

* Written by the libgit2 contributors

*

* To the extent possible under law, the author(s) have dedicated all copyright

* and related and neighboring rights to this software to the public domain

* worldwide. This software is distributed without any warranty.

*

* You should have received a copy of the CC0 Public Domain Dedication along

* with this software. If not, see

* <http://creativecommons.org/publicdomain/zero/1.0/>.

*/

#include "common.h"

#include <assert.h>

/**

* The following example partially reimplements the `git describe` command

* and some of its options.

*

* These commands should work:

* - Describe HEAD with default options (`describe`)

* - Describe specified revision (`describe master~2`)

* - Describe specified revisions (`describe master~2 HEAD~3`)

* - Describe HEAD with dirty state suffix (`describe --dirty=*`)

* - Describe consider all refs (`describe --all master`)

* - Describe consider lightweight tags (`describe --tags temp-tag`)

* - Describe show non-default abbreviated size (`describe --abbrev=10`)

* - Describe always output the long format if matches a tag (`describe --long v1.0`)

* - Describe consider only tags of specified pattern (`describe --match v*-release`)

* - Describe show the fallback result (`describe --always`)

* - Describe follow only the first parent commit (`describe --first-parent`)

*

* The command line parsing logic is simplified and doesn't handle

* all of the use cases.

*/

/** describe_options represents the parsed command line options */

typedef struct {

const char **commits;

size_t commit_count;

git_describe_options describe_options;

git_describe_format_options format_options;

} describe_options;

typedef struct args_info args_info;

static void *xrealloc(void *oldp, size_t newsz)

{

void *p = realloc(oldp, newsz);

if (p == NULL) {

fprintf(stderr, "Cannot allocate memory, exiting.\n");

exit(1);

}

return p;

}

static void opts_add_commit(describe_options *opts, const char *commit)

{

size_t sz;

assert(opts != NULL);

sz = ++opts->commit_count * sizeof(opts->commits[0]);

opts->commits = xrealloc(opts->commits, sz);

opts->commits[opts->commit_count - 1] = commit;

}

static void do_describe_single(git_repository *repo, describe_options *opts, const char *rev)

{

git_object *commit;

git_describe_result *describe_result;

git_buf buf = { 0 };

if (rev) {

check_lg2(git_revparse_single(&commit, repo, rev),

"Failed to lookup rev", rev);

check_lg2(git_describe_commit(&describe_result, commit, &opts->describe_options),

"Failed to describe rev", rev);

}

else

check_lg2(git_describe_workdir(&describe_result, repo, &opts->describe_options),

"Failed to describe workdir", NULL);

check_lg2(git_describe_format(&buf, describe_result, &opts->format_options),

"Failed to format describe rev", rev);

printf("%s\n", buf.ptr);

}

static void do_describe(git_repository *repo, describe_options *opts)

{

if (opts->commit_count == 0)

do_describe_single(repo, opts, NULL);

else

{

size_t i;

for (i = 0; i < opts->commit_count; i++)

do_describe_single(repo, opts, opts->commits[i]);

}

}

static void print_usage(void)

{

fprintf(stderr, "usage: see `git help describe`\n");

exit(1);

}

/** Parse command line arguments */

static void parse_options(describe_options *opts, int argc, char **argv)

{

args_info args = ARGS_INFO_INIT;

for (args.pos = 1; args.pos < argc; ++args.pos) {

const char *curr = argv[args.pos];

if (curr[0] != '-') {

opts_add_commit(opts, curr);

} else if (!strcmp(curr, "--all")) {

opts->describe_options.describe_strategy = GIT_DESCRIBE_ALL;

} else if (!strcmp(curr, "--tags")) {

opts->describe_options.describe_strategy = GIT_DESCRIBE_TAGS;

} else if (!strcmp(curr, "--exact-match")) {

opts->describe_options.max_candidates_tags = 0;

} else if (!strcmp(curr, "--long")) {

opts->format_options.always_use_long_format = 1;

} else if (!strcmp(curr, "--always")) {

opts->describe_options.show_commit_oid_as_fallback = 1;

} else if (!strcmp(curr, "--first-parent")) {

opts->describe_options.only_follow_first_parent = 1;

} else if (optional_str_arg(&opts->format_options.dirty_suffix, &args, "--dirty", "-dirty")) {

} else if (match_int_arg((int *)&opts->format_options.abbreviated_size, &args, "--abbrev", 0)) {

} else if (match_int_arg((int *)&opts->describe_options.max_candidates_tags, &args, "--candidates", 0)) {

} else if (match_str_arg(&opts->describe_options.pattern, &args, "--match")) {

} else {

print_usage();

}

}

if (opts->commit_count > 0) {

if (opts->format_options.dirty_suffix)

fatal("--dirty is incompatible with commit-ishes", NULL);

}

else {

if (!opts->format_options.dirty_suffix || !opts->format_options.dirty_suffix[0]) {

opts_add_commit(opts, "HEAD");

}

}

}

/** Initialize describe_options struct */

static void describe_options_init(describe_options *opts)

{

memset(opts, 0, sizeof(*opts));

opts->commits = NULL;

opts->commit_count = 0;

git_describe_init_options(&opts->describe_options, GIT_DESCRIBE_OPTIONS_VERSION);

git_describe_init_format_options(&opts->format_options, GIT_DESCRIBE_FORMAT_OPTIONS_VERSION);

}

int main(int argc, char **argv)

{

git_repository *repo;

describe_options opts;

git_libgit2_init();

check_lg2(git_repository_open_ext(&repo, ".", 0, NULL),

"Could not open repository", NULL);

describe_options_init(&opts);

parse_options(&opts, argc, argv);

do_describe(repo, &opts);

git_repository_free(repo);

git_libgit2_shutdown();

return 0;

}