ApiDescriptionExtensionsTests.cs

// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.

using System.Net.Http;
using Microsoft.AspNetCore.Mvc.ApiExplorer;
using Microsoft.AspNetCore.Routing.Patterns;

public class ApiDescriptionExtensionsTests
{
    [Theory]
    [InlineData("api/todos", "/api/todos")]
    [InlineData("api/todos/{id}", "/api/todos/{id}")]
    [InlineData("api/todos/{id:int:min(10)}", "/api/todos/{id}")]
    [InlineData("{a}/{b}/{c=19}", "/{a}/{b}/{c}")]
    [InlineData("{a}/{b}/{c?}", "/{a}/{b}/{c}")]
    [InlineData("{a:int}/{b}/{c:int}", "/{a}/{b}/{c}")]
    [InlineData("", "/")]
    [InlineData("api", "/api")]
    [InlineData("{p1}/{p2}.{p3?}", "/{p1}/{p2}.{p3}")]
    public void MapRelativePathToItemPath_ReturnsItemPathForApiDescription(string relativePath, string expectedItemPath)
    {
        // Arrange
        var apiDescription = new ApiDescription
        {
            RelativePath = relativePath
        };

        // Act
        var itemPath = apiDescription.MapRelativePathToItemPath();

        // Assert
        Assert.Equal(expectedItemPath, itemPath);
    }

    [Theory]
    [InlineData("/~health", "~health", "/~health")]
    [InlineData("/~api/todos", "~api/todos", "/~api/todos")]
    [InlineData("/~api/todos/{id}", "~api/todos/{id}", "/~api/todos/{id}")]
    [InlineData("~/health", "health", "/health")]
    [InlineData("~/api/todos", "api/todos", "/api/todos")]
    [InlineData("~/api/todos/{id}", "api/todos/{id}", "/api/todos/{id}")]
    public void MapRelativePathToItemPath_WithRoutePattern_HandlesRoutesThatStartWithTilde(string rawPattern, string relativePath, string expectedItemPath)
    {
        // Arrange
        var routePattern = RoutePatternFactory.Parse(rawPattern);
        var apiDescription = new ApiDescription
        {
            RelativePath = relativePath,
            RoutePattern = routePattern
        };

        // Act
        var itemPath = apiDescription.MapRelativePathToItemPath();

        // Assert
        Assert.Equal(expectedItemPath, itemPath);
    }

    public static class HttpMethodTestData
    {
        public static IEnumerable<object[]> TestCases => new List<object[]>
        {
            new object[] { "GET", HttpMethod.Get },
            new object[] { "POST", HttpMethod.Post },
            new object[] { "PUT", HttpMethod.Put },
            new object[] { "DELETE", HttpMethod.Delete },
            new object[] { "PATCH", HttpMethod.Patch },
            new object[] { "HEAD", HttpMethod.Head },
            new object[] { "OPTIONS", HttpMethod.Options },
            new object[] { "TRACE", HttpMethod.Trace },
            new object[] { "QUERY", HttpMethod.Query },
            new object[] { "gEt", HttpMethod.Get },  // Test case-insensitivity
        };
    }

    [Theory]
    [MemberData(nameof(HttpMethodTestData.TestCases), MemberType = typeof(HttpMethodTestData))]
    public void GetHttpMethod_ReturnsHttpMethodForApiDescription(string httpMethod, HttpMethod expectedHttpMethod)
    {
        // Arrange
        var apiDescription = new ApiDescription
        {
            HttpMethod = httpMethod
        };

        // Act
        var result = apiDescription.GetHttpMethod();

        // Assert
        Assert.Equal(expectedHttpMethod, result);
    }

    [Fact]
    public void GetHttpMethod_ReturnsNullForUnsupportedMethod()
    {
        // Arrange - Test that unsupported HTTP methods return null
        var apiDescription = new ApiDescription
        {
            HttpMethod = "UNSUPPORTED"
        };

        // Act
        var result = apiDescription.GetHttpMethod();

        // Assert
        Assert.Null(result);
    }
}