using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
{
/// Provides methods for parsing command-line arguments.
internal class ArgumentParser : IReadOnlyList
{
/*********
** Fields
*********/
/// The command name for errors.
private readonly string CommandName;
/// The arguments to parse.
private readonly string[] Args;
/// Writes messages to the console and log file.
private readonly IMonitor Monitor;
/*********
** Accessors
*********/
/// Get the number of arguments.
public int Count => this.Args.Length;
/// Get the argument at the specified index in the list.
/// The zero-based index of the element to get.
public string this[int index] => this.Args[index];
/// A method which parses a string argument into the given value.
/// The expected argument type.
/// The argument to parse.
/// The parsed value.
/// Returns whether the argument was successfully parsed.
public delegate bool ParseDelegate(string input, out T output);
/*********
** Public methods
*********/
/// Construct an instance.
/// The command name for errors.
/// The arguments to parse.
/// Writes messages to the console and log file.
public ArgumentParser(string commandName, string[] args, IMonitor monitor)
{
this.CommandName = commandName;
this.Args = args;
this.Monitor = monitor;
}
/// Try to read a string argument.
/// The argument index.
/// The argument name for error messages.
/// The parsed value.
/// Whether to show an error if the argument is missing.
/// Require that the argument match one of the given values (case-insensitive).
public bool TryGet(int index, string name, out string value, bool required = true, string[] oneOf = null)
{
value = null;
// validate
if (this.Args.Length < index + 1)
{
if (required)
this.LogError($"Argument {index} ({name}) is required.");
return false;
}
if (oneOf?.Any() == true && !oneOf.Contains(this.Args[index], StringComparer.InvariantCultureIgnoreCase))
{
this.LogError($"Argument {index} ({name}) must be one of {string.Join(", ", oneOf)}.");
return false;
}
// get value
value = this.Args[index];
return true;
}
/// Try to read an integer argument.
/// The argument index.
/// The argument name for error messages.
/// The parsed value.
/// Whether to show an error if the argument is missing.
/// The minimum value allowed.
/// The maximum value allowed.
public bool TryGetInt(int index, string name, out int value, bool required = true, int? min = null, int? max = null)
{
value = 0;
// get argument
if (!this.TryGet(index, name, out string raw, required))
return false;
// parse
if (!int.TryParse(raw, out value))
{
this.LogIntFormatError(index, name, min, max);
return false;
}
// validate
if ((min.HasValue && value < min) || (max.HasValue && value > max))
{
this.LogIntFormatError(index, name, min, max);
return false;
}
return true;
}
/// Returns an enumerator that iterates through the collection.
/// An enumerator that can be used to iterate through the collection.
public IEnumerator GetEnumerator()
{
return ((IEnumerable)this.Args).GetEnumerator();
}
/// Returns an enumerator that iterates through a collection.
/// An object that can be used to iterate through the collection.
IEnumerator IEnumerable.GetEnumerator()
{
return this.GetEnumerator();
}
/*********
** Private methods
*********/
/// Log a usage error.
/// The message describing the error.
private void LogError(string message)
{
this.Monitor.Log($"{message} Type 'help {this.CommandName}' for usage.", LogLevel.Error);
}
/// Print an error for an invalid int argument.
/// The argument index.
/// The argument name for error messages.
/// The minimum value allowed.
/// The maximum value allowed.
private void LogIntFormatError(int index, string name, int? min, int? max)
{
if (min.HasValue && max.HasValue)
this.LogError($"Argument {index} ({name}) must be an integer between {min} and {max}.");
else if (min.HasValue)
this.LogError($"Argument {index} ({name}) must be an integer and at least {min}.");
else if (max.HasValue)
this.LogError($"Argument {index} ({name}) must be an integer and at most {max}.");
else
this.LogError($"Argument {index} ({name}) must be an integer.");
}
}
}