CliFx/CliFx.Tests/RoutingSpecs.cs

using System;
using System.Threading.Tasks;
using CliFx.Tests.Commands;
using FluentAssertions;
using Xunit;
using Xunit.Abstractions;

namespace CliFx.Tests
{
    public class RoutingSpecs
    {
        private readonly ITestOutputHelper _output;

        public RoutingSpecs(ITestOutputHelper testOutput) => _output = testOutput;

        [Fact]
        public async Task Default_command_is_executed_if_provided_arguments_do_not_match_any_named_command()
        {
            // Arrange
            var (console, stdOut, _) = VirtualConsole.CreateBuffered();

            var application = new CliApplicationBuilder()
                .AddCommand<DefaultCommand>()
                .AddCommand<NamedCommand>()
                .AddCommand<NamedSubCommand>()
                .UseConsole(console)
                .Build();

            // Act
            var exitCode = await application.RunAsync(Array.Empty<string>());

            // Assert
            exitCode.Should().Be(0);
            stdOut.GetString().Trim().Should().Be(DefaultCommand.ExpectedOutputText);

            _output.WriteLine(stdOut.GetString());
        }

        [Fact]
        public async Task Specific_named_command_is_executed_if_provided_arguments_match_its_name()
        {
            // Arrange
            var (console, stdOut, _) = VirtualConsole.CreateBuffered();

            var application = new CliApplicationBuilder()
                .AddCommand<DefaultCommand>()
                .AddCommand<NamedCommand>()
                .AddCommand<NamedSubCommand>()
                .UseConsole(console)
                .Build();

            // Act
            var exitCode = await application.RunAsync(new[] {"named"});

            // Assert
            exitCode.Should().Be(0);
            stdOut.GetString().Trim().Should().Be(NamedCommand.ExpectedOutputText);

            _output.WriteLine(stdOut.GetString());
        }

        [Fact]
        public async Task Specific_named_sub_command_is_executed_if_provided_arguments_match_its_name()
        {
            // Arrange
            var (console, stdOut, _) = VirtualConsole.CreateBuffered();

            var application = new CliApplicationBuilder()
                .AddCommand<DefaultCommand>()
                .AddCommand<NamedCommand>()
                .AddCommand<NamedSubCommand>()
                .UseConsole(console)
                .Build();

            // Act
            var exitCode = await application.RunAsync(new[] {"named", "sub"});

            // Assert
            exitCode.Should().Be(0);
            stdOut.GetString().Trim().Should().Be(NamedSubCommand.ExpectedOutputText);

            _output.WriteLine(stdOut.GetString());
        }

        [Fact]
        public async Task Help_text_is_printed_if_no_arguments_were_provided_and_default_command_is_not_defined()
        {
            // Arrange
            var (console, stdOut, _) = VirtualConsole.CreateBuffered();

            var application = new CliApplicationBuilder()
                .AddCommand<NamedCommand>()
                .AddCommand<NamedSubCommand>()
                .UseConsole(console)
                .UseDescription("This will be visible in help")
                .Build();

            // Act
            var exitCode = await application.RunAsync(Array.Empty<string>());

            // Assert
            exitCode.Should().Be(0);
            stdOut.GetString().Should().Contain("This will be visible in help");

            _output.WriteLine(stdOut.GetString());
        }

        [Fact]
        public async Task Help_text_is_printed_if_provided_arguments_contain_the_help_option()
        {
            // Arrange
            var (console, stdOut, _) = VirtualConsole.CreateBuffered();

            var application = new CliApplicationBuilder()
                .AddCommand<DefaultCommand>()
                .AddCommand<NamedCommand>()
                .AddCommand<NamedSubCommand>()
                .UseConsole(console)
                .Build();

            // Act
            var exitCode = await application.RunAsync(new[] {"--help"});

            // Assert
            exitCode.Should().Be(0);
            stdOut.GetString().Should().ContainAll(
                "Default command description",
                "Usage"
            );

            _output.WriteLine(stdOut.GetString());
        }

        [Fact]
        public async Task Help_text_is_printed_if_provided_arguments_contain_the_help_option_even_if_default_command_is_not_defined()
        {
            // Arrange
            var (console, stdOut, _) = VirtualConsole.CreateBuffered();

            var application = new CliApplicationBuilder()
                .AddCommand<NamedCommand>()
                .AddCommand<NamedSubCommand>()
                .UseDescription("This will be visible in help")
                .UseConsole(console)
                .Build();

            // Act
            var exitCode = await application.RunAsync(new[] {"--help"});

            // Assert
            exitCode.Should().Be(0);
            stdOut.GetString().Should().Contain("This will be visible in help");

            _output.WriteLine(stdOut.GetString());
        }

        [Fact]
        public async Task Help_text_for_a_specific_named_command_is_printed_if_provided_arguments_match_its_name_and_contain_the_help_option()
        {
            // Arrange
            var (console, stdOut, _) = VirtualConsole.CreateBuffered();

            var application = new CliApplicationBuilder()
                .AddCommand<DefaultCommand>()
                .AddCommand<NamedCommand>()
                .AddCommand<NamedSubCommand>()
                .UseConsole(console)
                .Build();

            // Act
            var exitCode = await application.RunAsync(new[] {"named", "--help"});

            // Assert
            exitCode.Should().Be(0);
            stdOut.GetString().Should().ContainAll(
                "Named command description",
                "Usage",
                "named"
            );

            _output.WriteLine(stdOut.GetString());
        }

        [Fact]
        public async Task Help_text_for_a_specific_named_sub_command_is_printed_if_provided_arguments_match_its_name_and_contain_the_help_option()
        {
            // Arrange
            var (console, stdOut, _) = VirtualConsole.CreateBuffered();

            var application = new CliApplicationBuilder()
                .AddCommand<DefaultCommand>()
                .AddCommand<NamedCommand>()
                .AddCommand<NamedSubCommand>()
                .UseConsole(console)
                .Build();

            // Act
            var exitCode = await application.RunAsync(new[] {"named", "sub", "--help"});

            // Assert
            exitCode.Should().Be(0);
            stdOut.GetString().Should().ContainAll(
                "Named sub command description",
                "Usage",
                "named", "sub"
            );

            _output.WriteLine(stdOut.GetString());
        }

        [Fact]
        public async Task Version_is_printed_if_the_only_provided_argument_is_the_version_option()
        {
            // Arrange
            var (console, stdOut, _) = VirtualConsole.CreateBuffered();

            var application = new CliApplicationBuilder()
                .AddCommand<DefaultCommand>()
                .AddCommand<NamedCommand>()
                .AddCommand<NamedSubCommand>()
                .UseVersionText("v6.9")
                .UseConsole(console)
                .Build();

            // Act
            var exitCode = await application.RunAsync(new[] {"--version"});

            // Assert
            exitCode.Should().Be(0);
            stdOut.GetString().Trim().Should().Be("v6.9");

            _output.WriteLine(stdOut.GetString());
        }
    }
}