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
|
using System;
using System.Collections;
using System.Collections.Generic;
using System.Diagnostics;
using System.Globalization;
using System.Linq;
using LibGit2Sharp.Core;
namespace LibGit2Sharp
{
/// <summary>
/// The collection of <see cref="Stash"/>es in a <see cref="Repository"/>
/// </summary>
[DebuggerDisplay("{DebuggerDisplay,nq}")]
public class StashCollection : IEnumerable<Stash>
{
internal readonly Repository repo;
/// <summary>
/// Needed for mocking purposes.
/// </summary>
protected StashCollection()
{ }
/// <summary>
/// Initializes a new instance of the <see cref="StashCollection"/> class.
/// </summary>
/// <param name="repo">The repo.</param>
internal StashCollection(Repository repo)
{
this.repo = repo;
}
#region Implementation of IEnumerable
/// <summary>
/// Returns an enumerator that iterates through the collection.
/// <para>
/// The enumerator returns the stashes by descending order (last stash is returned first).
/// </para>
/// </summary>
/// <returns>An <see cref="IEnumerator{T}"/> object that can be used to iterate through the collection.</returns>
public virtual IEnumerator<Stash> GetEnumerator()
{
return Proxy.git_stash_foreach(repo.Handle,
(index, message, commitId) => new Stash(repo, new ObjectId(commitId), index)).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();
}
#endregion
/// <summary>
/// Gets the <see cref="Stash"/> corresponding to the specified index (0 being the most recent one).
/// </summary>
public virtual Stash this[int index]
{
get
{
if (index < 0)
{
throw new ArgumentOutOfRangeException("index", "The passed index must be a positive integer.");
}
GitObject stashCommit = repo.Lookup(
string.Format(CultureInfo.InvariantCulture, "stash@{{{0}}}", index), GitObjectType.Commit, LookUpOptions.None);
return stashCommit == null ? null : new Stash(repo, stashCommit.Id, index);
}
}
/// <summary>
/// Creates a stash with the specified message.
/// </summary>
/// <param name="stasher">The <see cref="Signature"/> of the user who stashes </param>
/// <returns>the newly created <see cref="Stash"/></returns>
public virtual Stash Add(Signature stasher)
{
return Add(stasher, null, StashModifiers.Default);
}
/// <summary>
/// Creates a stash with the specified message.
/// </summary>
/// <param name="stasher">The <see cref="Signature"/> of the user who stashes </param>
/// <param name="options">A combination of <see cref="StashModifiers"/> flags</param>
/// <returns>the newly created <see cref="Stash"/></returns>
public virtual Stash Add(Signature stasher, StashModifiers options)
{
return Add(stasher, null, options);
}
/// <summary>
/// Creates a stash with the specified message.
/// </summary>
/// <param name="stasher">The <see cref="Signature"/> of the user who stashes </param>
/// <param name="message">The message of the stash.</param>
/// <returns>the newly created <see cref="Stash"/></returns>
public virtual Stash Add(Signature stasher, string message)
{
return Add(stasher, message, StashModifiers.Default);
}
/// <summary>
/// Creates a stash with the specified message.
/// </summary>
/// <param name="stasher">The <see cref="Signature"/> of the user who stashes </param>
/// <param name="message">The message of the stash.</param>
/// <param name="options">A combination of <see cref="StashModifiers"/> flags</param>
/// <returns>the newly created <see cref="Stash"/></returns>
public virtual Stash Add(Signature stasher, string message, StashModifiers options)
{
Ensure.ArgumentNotNull(stasher, "stasher");
string prettifiedMessage = Proxy.git_message_prettify(string.IsNullOrEmpty(message) ? string.Empty : message, null);
ObjectId oid = Proxy.git_stash_save(repo.Handle, stasher, prettifiedMessage, options);
// in case there is nothing to stash
if (oid == null)
{
return null;
}
return new Stash(repo, oid, 0);
}
/// <summary>
/// Remove a single stashed state from the stash list.
/// </summary>
/// <param name="index">The index of the stash to remove (0 being the most recent one).</param>
public virtual void Remove(int index)
{
if (index < 0)
{
throw new ArgumentException("The passed index must be a positive integer.", "index");
}
Proxy.git_stash_drop(repo.Handle, index);
}
private string DebuggerDisplay
{
get
{
return string.Format(CultureInfo.InvariantCulture,
"Count = {0}", this.Count());
}
}
}
}
|
