/// <summary>
/// Executes the given executable to process the given command.
/// </summary>
/// <param name="workingDirectory">
/// The working directory while executing the command.
/// </param>
/// <param name="executable">
/// The full path to and name of the executable to execute.
/// </param>
/// <param name="command">
/// The options to the executable.
/// </param>
/// <param name="environmentVariables">
/// An array of <see cref="KeyValuePair{TKey,TValue}"/> objects, containing environment variable
/// overrides to use while executing the executable.
/// </param>
/// <param name="specialArguments">
/// Any special arguments to pass to the executable, not defined by the <paramref name="command"/>
/// object, typically common arguments that should always be passed to the executable.
/// </param>
/// <exception cref="ArgumentNullException">
/// <para><paramref name="workingDirectory"/> is <c>null</c> or empty.</para>
/// <para>- or -</para>
/// <para><paramref name="executable"/> is <c>null</c> or empty.</para>
/// <para>- or -</para>
/// <para><paramref name="command"/> is <c>null</c>.</para>
/// <para>- or -</para>
/// <para><paramref name="environmentVariables"/> is <c>null</c>.</para>
/// <para>- or -</para>
/// <para><paramref name="specialArguments"/> is <c>null</c>.</para>
/// </exception>
/// <exception cref="MercurialException">
/// <para>The executable did not finish in the allotted time.</para>
/// </exception>
public static void Execute(
string workingDirectory, string executable, ICommand command, KeyValuePair <string, string>[] environmentVariables,
IEnumerable <string> specialArguments)
{
if (StringEx.IsNullOrWhiteSpace(workingDirectory))
{
throw new ArgumentNullException("workingDirectory");
}
if (StringEx.IsNullOrWhiteSpace(executable))
{
throw new ArgumentNullException("executable");
}
if (command == null)
{
throw new ArgumentNullException("command");
}
if (environmentVariables == null)
{
throw new ArgumentNullException("environmentVariables");
}
if (specialArguments == null)
{
throw new ArgumentNullException("specialArguments");
}
command.Validate();
command.Before();
IEnumerable <string> arguments = specialArguments;
arguments = arguments.Concat(command.Arguments.Where(a => !StringEx.IsNullOrWhiteSpace(a)));
arguments = arguments.Concat(command.AdditionalArguments.Where(a => !StringEx.IsNullOrWhiteSpace(a)));
string argumentsString = string.Join(" ", arguments.ToArray());
var psi = new ProcessStartInfo
{
FileName = executable,
WorkingDirectory = workingDirectory,
RedirectStandardInput = true,
RedirectStandardOutput = true,
RedirectStandardError = true,
CreateNoWindow = true,
WindowStyle = ProcessWindowStyle.Hidden,
UseShellExecute = false,
ErrorDialog = false,
Arguments = command.Command + " " + argumentsString,
};
foreach (var kvp in environmentVariables)
{
psi.EnvironmentVariables[kvp.Key] = kvp.Value;
}
ClientExecutable.LazyInitialize();
psi.StandardErrorEncoding = ClientExecutable.GetMainEncoding();
psi.StandardOutputEncoding = ClientExecutable.GetMainEncoding();
if (command.Observer != null)
{
command.Observer.Executing(command.Command, argumentsString);
}
Process process = Process.Start(psi);
try
{
Func <StreamReader, Action <string>, string> reader;
if (command.Observer != null)
{
reader = delegate(StreamReader streamReader, Action <string> logToObserver)
{
var output = new StringBuilder();
string line;
while ((line = streamReader.ReadLine()) != null)
{
logToObserver(line);
if (output.Length > 0)
{
output.Append(Environment.NewLine);
}
output.Append(line);
}
return(output.ToString());
};
}
else
{
reader = (StreamReader streamReader, Action <string> logToObserver) => streamReader.ReadToEnd();
}
IAsyncResult outputReader = reader.BeginInvoke(process.StandardOutput, line => command.Observer.Output(line), null, null);
IAsyncResult errorReader = reader.BeginInvoke(process.StandardError, line => command.Observer.ErrorOutput(line), null, null);
int timeout = Timeout.Infinite;
if (command.Timeout > 0)
{
timeout = 1000 * command.Timeout;
}
if (!process.WaitForExit(timeout))
{
if (command.Observer != null)
{
command.Observer.Executed(psi.FileName, psi.Arguments, 0, string.Empty, string.Empty);
}
throw new MercurialException("The executable did not complete within the allotted time");
}
string standardOutput = reader.EndInvoke(outputReader);
string errorOutput = reader.EndInvoke(errorReader);
if (command.Observer != null)
{
command.Observer.Executed(command.Command, argumentsString, process.ExitCode, standardOutput, errorOutput);
}
command.After(process.ExitCode, standardOutput, errorOutput);
}
finally
{
process.Dispose();
}
}
/// <summary>
/// Parse the given XML lazily and return a collection of <see cref="Changeset"/>
/// objects for the information contained in it, in the order the changesets
/// appear in the xml.
/// </summary>
/// <param name="xml">
/// The XML to parse.
/// </param>
/// <returns>
/// A collection of <see cref="Changeset"/> objects.
/// </returns>
/// <exception cref="InvalidOperationException">
/// <para>An unknown path action character was detected in the log output.</para>
/// <para>- or -</para>
/// <para>The XML content was not legal according to the expected format.</para>
/// </exception>
public static IEnumerable <Changeset> LazyParse(string xml)
{
if (StringEx.IsNullOrWhiteSpace(xml))
{
yield break;
}
var serializer = new XmlSerializer(typeof(LogEntryNode));
foreach (string entryXml in LazyExtractChangesetXmlPieces(xml))
{
var entry = (LogEntryNode)serializer.Deserialize(new StringReader(entryXml));
var changeset = new Changeset
{
Timestamp = entry.Timestamp,
AuthorName = (entry.Author ?? new LogEntryAuthorNode()).Name,
AuthorEmailAddress = (entry.Author ?? new LogEntryAuthorNode()).Email,
CommitMessage = entry.CommitMessage ?? string.Empty,
Branch = entry.Branch ?? "default",
Hash = entry.Hash,
RevisionNumber = entry.Revision,
Revision = RevSpec.Single(entry.Hash),
Tags = entry.Tags.Select(t => t.Name).ToArray(),
};
switch (entry.Parents.Count)
{
case 2:
changeset.RightParentHash = entry.Parents[1].Hash;
changeset.RightParentRevision = entry.Parents[1].Revision;
goto case 1;
case 1:
changeset.LeftParentHash = entry.Parents[0].Hash;
changeset.LeftParentRevision = entry.Parents[0].Revision;
break;
case 0:
changeset.LeftParentRevision = changeset.RevisionNumber - 1;
break;
}
foreach (LogEntryPathNode action in entry.PathActions)
{
var pathAction = new ChangesetPathAction
{
Path = action.Path,
};
switch (action.Action)
{
case "M":
pathAction.Action = ChangesetPathActionType.Modify;
break;
case "A":
pathAction.Action = ChangesetPathActionType.Add;
LogEntryCopyNode copySource = entry.Copies.Where(c => c.Destination == action.Path).FirstOrDefault();
if (copySource != null)
{
pathAction.Source = copySource.Source;
}
break;
case "R":
pathAction.Action = ChangesetPathActionType.Remove;
break;
default:
throw new InvalidOperationException("Unknown path action: " + action.Action);
}
changeset.PathActions.Add(pathAction);
}
yield return(changeset);
}
}