using System; using System.Collections.Generic; using System.Linq; using System.Text; namespace StardewModdingAPI.Framework { /// Manages console commands. internal class CommandManager { /********* ** Fields *********/ /// The commands registered with SMAPI. private readonly IDictionary Commands = new Dictionary(StringComparer.InvariantCultureIgnoreCase); /********* ** Public methods *********/ /// Add a console command. /// The mod adding the command (or null for a SMAPI command). /// The command name, which the user must type to trigger it. /// The human-readable documentation shown when the player runs the built-in 'help' command. /// The method to invoke when the command is triggered. This method is passed the command name and arguments submitted by the user. /// Whether to allow a null argument; this should only used for backwards compatibility. /// The or is null or empty. /// The is not a valid format. /// There's already a command with that name. public void Add(IModMetadata mod, string name, string documentation, Action callback, bool allowNullCallback = false) { name = this.GetNormalisedName(name); // validate format if (string.IsNullOrWhiteSpace(name)) throw new ArgumentNullException(nameof(name), "Can't register a command with no name."); if (name.Any(char.IsWhiteSpace)) throw new FormatException($"Can't register the '{name}' command because the name can't contain whitespace."); if (callback == null && !allowNullCallback) throw new ArgumentNullException(nameof(callback), $"Can't register the '{name}' command because without a callback."); // ensure uniqueness if (this.Commands.ContainsKey(name)) throw new ArgumentException(nameof(callback), $"Can't register the '{name}' command because there's already a command with that name."); // add command this.Commands.Add(name, new Command(mod, name, documentation, callback)); } /// Get a command by its unique name. /// The command name. /// Returns the matching command, or null if not found. public Command Get(string name) { name = this.GetNormalisedName(name); this.Commands.TryGetValue(name, out Command command); return command; } /// Get all registered commands. public IEnumerable GetAll() { return this.Commands .Values .OrderBy(p => p.Name); } /// Try to parse a raw line of user input into an executable command. /// The raw user input. /// The parsed command name. /// The parsed command arguments. /// The command which can handle the input. /// Returns true if the input was successfully parsed and matched to a command; else false. public bool TryParse(string input, out string name, out string[] args, out Command command) { // ignore if blank if (string.IsNullOrWhiteSpace(input)) { name = null; args = null; command = null; return false; } // parse input args = this.ParseArgs(input); name = this.GetNormalisedName(args[0]); args = args.Skip(1).ToArray(); // get command return this.Commands.TryGetValue(name, out command); } /// Trigger a command. /// The command name. /// The command arguments. /// Returns whether a matching command was triggered. public bool Trigger(string name, string[] arguments) { // get normalised name name = this.GetNormalisedName(name); if (name == null) return false; // get command if (this.Commands.TryGetValue(name, out Command command)) { command.Callback.Invoke(name, arguments); return true; } return false; } /********* ** Private methods *********/ /// Parse a string into command arguments. /// The string to parse. private string[] ParseArgs(string input) { bool inQuotes = false; IList args = new List(); StringBuilder currentArg = new StringBuilder(); foreach (char ch in input) { if (ch == '"') inQuotes = !inQuotes; else if (!inQuotes && char.IsWhiteSpace(ch)) { args.Add(currentArg.ToString()); currentArg.Clear(); } else currentArg.Append(ch); } args.Add(currentArg.ToString()); return args.Where(item => !string.IsNullOrWhiteSpace(item)).ToArray(); } /// Get a normalised command name. /// The command name. private string GetNormalisedName(string name) { name = name?.Trim().ToLower(); return !string.IsNullOrWhiteSpace(name) ? name : null; } } }