spectre.console/src/Spectre.Console/Extensions/AnsiConsoleExtensions.Prompt.cs

using System;

namespace Spectre.Console
{
    /// <summary>
    /// Contains extension methods for <see cref="IAnsiConsole"/>.
    /// </summary>
    public static partial class AnsiConsoleExtensions
    {
        /// <summary>
        /// Displays a prompt to the user.
        /// </summary>
        /// <typeparam name="T">The prompt result type.</typeparam>
        /// <param name="console">The console.</param>
        /// <param name="prompt">The prompt to display.</param>
        /// <returns>The prompt input result.</returns>
        public static T Prompt<T>(this IAnsiConsole console, IPrompt<T> prompt)
        {
            if (prompt is null)
            {
                throw new ArgumentNullException(nameof(prompt));
            }

            return prompt.Show(console);
        }

        /// <summary>
        /// Displays a prompt to the user.
        /// </summary>
        /// <typeparam name="T">The prompt result type.</typeparam>
        /// <param name="console">The console.</param>
        /// <param name="prompt">The prompt markup text.</param>
        /// <returns>The prompt input result.</returns>
        public static T Ask<T>(this IAnsiConsole console, string prompt)
        {
            return new TextPrompt<T>(prompt).Show(console);
        }

        /// <summary>
        /// Displays a prompt with two choices, yes or no.
        /// </summary>
        /// <param name="console">The console.</param>
        /// <param name="prompt">The prompt markup text.</param>
        /// <returns><c>true</c> if the user selected "yes", otherwise <c>false</c>.</returns>
        public static bool Confirm(this IAnsiConsole console, string prompt)
        {
            return new ConfirmationPrompt(prompt).Show(console);
        }
    }
}