/
RepositoryExtensions.cs
162 lines (146 loc) · 9.2 KB
/
RepositoryExtensions.cs
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
using System;
using LibGit2Sharp.Core;
namespace LibGit2Sharp
{
/// <summary>
/// Provides helper overloads to a <see cref = "Repository" />.
/// </summary>
public static class RepositoryExtensions
{
/// <summary>
/// Try to lookup an object by its sha or a reference name.
/// </summary>
/// <typeparam name = "T"></typeparam>
/// <param name = "repository">The <see cref = "Repository" /> being looked up.</param>
/// <param name = "objectish">The revparse spec for the object to lookup.</param>
/// <returns></returns>
public static T Lookup<T>(this IRepository repository, string objectish) where T : GitObject
{
return (T)repository.Lookup(objectish, GitObject.TypeToTypeMap[typeof (T)]);
}
/// <summary>
/// Try to lookup an object by its <see cref = "ObjectId" />.
/// </summary>
/// <typeparam name = "T"></typeparam>
/// <param name = "repository">The <see cref = "Repository" /> being looked up.</param>
/// <param name = "id">The id.</param>
/// <returns></returns>
public static T Lookup<T>(this IRepository repository, ObjectId id) where T : GitObject
{
return (T)repository.Lookup(id, GitObject.TypeToTypeMap[typeof(T)]);
}
/// <summary>
/// Creates a lightweight tag with the specified name. This tag will point at the commit pointed at by the <see cref = "Repository.Head" />.
/// </summary>
/// <param name = "repository">The <see cref = "Repository" /> being worked with.</param>
/// <param name = "tagName">The name of the tag to create.</param>
public static Tag ApplyTag(this IRepository repository, string tagName)
{
return ApplyTag(repository, tagName, repository.Head.CanonicalName);
}
/// <summary>
/// Creates a lightweight tag with the specified name. This tag will point at the <paramref name = "target" />.
/// </summary>
/// <param name = "repository">The <see cref = "Repository" /> being worked with.</param>
/// <param name = "tagName">The name of the tag to create.</param>
/// <param name = "target">The canonical reference name or sha which should be pointed at by the Tag.</param>
public static Tag ApplyTag(this IRepository repository, string tagName, string target)
{
return repository.Tags.Add(tagName, target);
}
/// <summary>
/// Creates an annotated tag with the specified name. This tag will point at the commit pointed at by the <see cref = "Repository.Head" />.
/// </summary>
/// <param name = "repository">The <see cref = "Repository" /> being worked with.</param>
/// <param name = "tagName">The name of the tag to create.</param>
/// <param name = "tagger">The identity of the creator of this tag.</param>
/// <param name = "message">The annotation message.</param>
public static Tag ApplyTag(this IRepository repository, string tagName, Signature tagger, string message)
{
return ApplyTag(repository, tagName, repository.Head.CanonicalName, tagger, message);
}
/// <summary>
/// Creates an annotated tag with the specified name. This tag will point at the <paramref name = "target" />.
/// </summary>
/// <param name = "repository">The <see cref = "Repository" /> being worked with.</param>
/// <param name = "tagName">The name of the tag to create.</param>
/// <param name = "target">The canonical reference name or sha which should be pointed at by the Tag.</param>
/// <param name = "tagger">The identity of the creator of this tag.</param>
/// <param name = "message">The annotation message.</param>
public static Tag ApplyTag(this IRepository repository, string tagName, string target, Signature tagger, string message)
{
return repository.Tags.Add(tagName, target, tagger, message);
}
/// <summary>
/// Creates a branch with the specified name. This branch will point at the commit pointed at by the <see cref = "Repository.Head" />.
/// </summary>
/// <param name = "repository">The <see cref = "Repository" /> being worked with.</param>
/// <param name = "branchName">The name of the branch to create.</param>
public static Branch CreateBranch(this IRepository repository, string branchName)
{
return CreateBranch(repository, branchName, repository.Head.CanonicalName);
}
/// <summary>
/// Creates a branch with the specified name. This branch will point at <paramref name="target"/>.
/// </summary>
/// <param name = "repository">The <see cref = "Repository" /> being worked with.</param>
/// <param name = "branchName">The name of the branch to create.</param>
/// <param name = "target">The commit which should be pointed at by the Branch.</param>
public static Branch CreateBranch(this IRepository repository, string branchName, Commit target)
{
Ensure.ArgumentNotNull(target, "target");
return CreateBranch(repository, branchName, target.Id.Sha);
}
/// <summary>
/// Creates a branch with the specified name. This branch will point at the commit pointed at by the <see cref = "Repository.Head" />.
/// </summary>
/// <param name = "repository">The <see cref = "Repository" /> being worked with.</param>
/// <param name = "branchName">The name of the branch to create.</param>
/// <param name = "target">The canonical reference name or sha which should be pointed at by the Branch.</param>
public static Branch CreateBranch(this IRepository repository, string branchName, string target)
{
return repository.Branches.Add(branchName, target);
}
/// <summary>
/// Stores the content of the <see cref = "Repository.Index" /> as a new <see cref = "LibGit2Sharp.Commit" /> into the repository.
/// The tip of the <see cref = "Repository.Head"/> will be used as the parent of this new Commit.
/// Once the commit is created, the <see cref = "Repository.Head"/> will move forward to point at it.
/// <para>Both the Author and Committer will be guessed from the Git configuration. An exception will be raised if no configuration is reachable.</para>
/// </summary>
/// <param name = "repository">The <see cref = "Repository" /> being worked with.</param>
/// <param name = "message">The description of why a change was made to the repository.</param>
/// <param name = "amendPreviousCommit">True to amend the current <see cref = "LibGit2Sharp.Commit"/> pointed at by <see cref = "Repository.Head"/>, false otherwise.</param>
/// <returns>The generated <see cref = "LibGit2Sharp.Commit" />.</returns>
public static Commit Commit(this IRepository repository, string message, bool amendPreviousCommit = false)
{
Signature author = BuildSignatureFromGlobalConfiguration(repository, DateTimeOffset.Now);
return repository.Commit(message, author, amendPreviousCommit);
}
/// <summary>
/// Stores the content of the <see cref = "Repository.Index" /> as a new <see cref = "LibGit2Sharp.Commit" /> into the repository.
/// The tip of the <see cref = "Repository.Head"/> will be used as the parent of this new Commit.
/// Once the commit is created, the <see cref = "Repository.Head"/> will move forward to point at it.
/// <para>The Committer will be guessed from the Git configuration. An exception will be raised if no configuration is reachable.</para>
/// </summary>
/// <param name = "repository">The <see cref = "Repository" /> being worked with.</param>
/// <param name = "author">The <see cref = "Signature" /> of who made the change.</param>
/// <param name = "message">The description of why a change was made to the repository.</param>
/// <param name = "amendPreviousCommit">True to amend the current <see cref = "LibGit2Sharp.Commit"/> pointed at by <see cref = "Repository.Head"/>, false otherwise.</param>
/// <returns>The generated <see cref = "LibGit2Sharp.Commit" />.</returns>
public static Commit Commit(this IRepository repository, string message, Signature author, bool amendPreviousCommit = false)
{
Signature committer = BuildSignatureFromGlobalConfiguration(repository, DateTimeOffset.Now);
return repository.Commit(message, author, committer, amendPreviousCommit);
}
private static Signature BuildSignatureFromGlobalConfiguration(IRepository repository, DateTimeOffset now)
{
var name = repository.Config.Get<string>("user.name", null);
var email = repository.Config.Get<string>("user.email", null);
if ((name == null) || (email == null))
{
throw new LibGit2SharpException("Can not find Name and Email settings of the current user in Git configuration.");
}
return new Signature(name, email, now);
}
}
}