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
|
using System;
using System.Collections;
using System.Collections.Generic;
using System.Diagnostics;
using System.Globalization;
using System.Linq;
using LibGit2Sharp.Core;
using LibGit2Sharp.Core.Handles;
using LibGit2Sharp.Handlers;
namespace LibGit2Sharp
{
/// <summary>
/// The collection of <see cref="Remote"/> in a <see cref="Repository"/>
/// </summary>
[DebuggerDisplay("{DebuggerDisplay,nq}")]
public class RemoteCollection : IEnumerable<Remote>
{
private readonly Repository repository;
/// <summary>
/// Needed for mocking purposes.
/// </summary>
protected RemoteCollection()
{ }
internal RemoteCollection(Repository repository)
{
this.repository = repository;
}
/// <summary>
/// Gets the <see cref="Remote"/> with the specified name.
/// </summary>
/// <param name="name">The name of the remote to retrieve.</param>
/// <returns>The retrived <see cref="Remote"/> if it has been found, null otherwise.</returns>
public virtual Remote this[string name]
{
get { return RemoteForName(name, false); }
}
internal Remote RemoteForName(string name, bool shouldThrowIfNotFound = true)
{
Ensure.ArgumentNotNull(name, "name");
using (RemoteSafeHandle handle = Proxy.git_remote_lookup(repository.Handle, name, shouldThrowIfNotFound))
{
return handle == null ? null : Remote.BuildFromPtr(handle, this.repository);
}
}
/// <summary>
/// Update properties of a remote.
/// </summary>
/// <param name="remote">The remote to update.</param>
/// <param name="actions">Delegate to perform updates on the remote.</param>
/// <returns>The updated remote.</returns>
public virtual Remote Update(Remote remote, params Action<RemoteUpdater>[] actions)
{
using (var updater = new RemoteUpdater(this.repository, remote))
{
foreach (Action<RemoteUpdater> action in actions)
{
action(updater);
}
}
return this[remote.Name];
}
/// <summary>
/// Returns an enumerator that iterates through the collection.
/// </summary>
/// <returns>An <see cref="IEnumerator{T}"/> object that can be used to iterate through the collection.</returns>
public virtual IEnumerator<Remote> GetEnumerator()
{
return Proxy
.git_remote_list(repository.Handle)
.Select(n => this[n])
.GetEnumerator();
}
/// <summary>
/// Returns an enumerator that iterates through the collection.
/// </summary>
/// <returns>An <see cref="IEnumerator"/> object that can be used to iterate through the collection.</returns>
IEnumerator IEnumerable.GetEnumerator()
{
return GetEnumerator();
}
/// <summary>
/// Creates a <see cref="Remote"/> with the specified name and for the repository at the specified location.
/// <para>
/// A default fetch refspec will be added for this remote.
/// </para>
/// </summary>
/// <param name="name">The name of the remote to create.</param>
/// <param name="url">The location of the repository.</param>
/// <returns>A new <see cref="Remote"/>.</returns>
public virtual Remote Add(string name, string url)
{
Ensure.ArgumentNotNull(name, "name");
Ensure.ArgumentNotNull(url, "url");
using (RemoteSafeHandle handle = Proxy.git_remote_create(repository.Handle, name, url))
{
return Remote.BuildFromPtr(handle, this.repository);
}
}
/// <summary>
/// Creates a <see cref="Remote"/> with the specified name and for the repository at the specified location.
/// </summary>
/// <param name="name">The name of the remote to create.</param>
/// <param name="url">The location of the repository.</param>
/// <param name="fetchRefSpec">The refSpec to be used when fetching from this remote.</param>
/// <returns>A new <see cref="Remote"/>.</returns>
public virtual Remote Add(string name, string url, string fetchRefSpec)
{
Ensure.ArgumentNotNull(name, "name");
Ensure.ArgumentNotNull(url, "url");
Ensure.ArgumentNotNull(fetchRefSpec, "fetchRefSpec");
using (RemoteSafeHandle handle = Proxy.git_remote_create_with_fetchspec(repository.Handle, name, url, fetchRefSpec))
{
return Remote.BuildFromPtr(handle, this.repository);
}
}
/// <summary>
/// Deletes the <see cref="Remote"/> with the specified name.
/// </summary>
/// <param name="name">The name of the remote to remove.</param>
/// <returns>A new <see cref="Remote"/>.</returns>
public virtual void Remove(string name)
{
Ensure.ArgumentNotNull(name, "name");
Proxy.git_remote_delete(repository.Handle, name);
}
/// <summary>
/// Renames an existing <see cref="Remote"/>.
/// </summary>
/// <param name="name">The current remote name.</param>
/// <param name="newName">The new name the existing remote should bear.</param>
/// <returns>A new <see cref="Remote"/>.</returns>
public virtual Remote Rename(string name, string newName)
{
return Rename(name, newName, null);
}
/// <summary>
/// Renames an existing <see cref="Remote"/>.
/// </summary>
/// <param name="name">The current remote name.</param>
/// <param name="newName">The new name the existing remote should bear.</param>
/// <param name="callback">The callback to be used when problems with renaming occur. (e.g. non-default fetch refspecs)</param>
/// <returns>A new <see cref="Remote"/>.</returns>
public virtual Remote Rename(string name, string newName, RemoteRenameFailureHandler callback)
{
Ensure.ArgumentNotNull(name, "name");
Ensure.ArgumentNotNull(newName, "newName");
Proxy.git_remote_rename(repository.Handle, name, newName, callback);
return this[newName];
}
private string DebuggerDisplay
{
get
{
return string.Format(CultureInfo.InvariantCulture,
"Count = {0}", this.Count());
}
}
}
}
|
