File: WebApplicationFactoryContentRootAttribute.cs
Web Access
Project: src\src\Mvc\Mvc.Testing\src\Microsoft.AspNetCore.Mvc.Testing.csproj (Microsoft.AspNetCore.Mvc.Testing)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System.Globalization;
using System.Reflection;
 
namespace Microsoft.AspNetCore.Mvc.Testing;
 
/// <summary>
/// Metadata that <see cref="WebApplicationFactory{TEntryPoint}"/> uses to find out the content
/// root for the web application represented by <c>TEntryPoint</c>.
/// <see cref="WebApplicationFactory{TEntryPoint}"/> will iterate over all the instances of
/// <see cref="WebApplicationFactoryContentRootAttribute"/>, filter the instances whose
/// <see cref="Key"/> is equal to <c>TEntryPoint</c> <see cref="Assembly.FullName"/>,
/// order them by <see cref="Priority"/> in ascending order.
/// <see cref="WebApplicationFactory{TEntryPoint}"/> will check for the existence of the marker
/// in <c>Path.Combine(<see cref="ContentRootPath"/>, Path.GetFileName(<see cref="ContentRootTest"/>))"</c>
/// and if the file exists it will set the content root to <see cref="ContentRootPath"/>.
/// </summary>
[AttributeUsage(AttributeTargets.Assembly, Inherited = false, AllowMultiple = true)]
public sealed class WebApplicationFactoryContentRootAttribute : Attribute
{
    /// <summary>
    /// Initializes a new instance of <see cref="WebApplicationFactoryContentRootAttribute"/>.
    /// </summary>
    /// <param name="key">
    /// The key of this <see cref="WebApplicationFactoryContentRootAttribute"/>. This
    /// key is used by <see cref="WebApplicationFactory{TEntryPoint}"/> to determine what of the
    /// <see cref="WebApplicationFactoryContentRootAttribute"/> instances on the test assembly should be used
    /// to match a given TEntryPoint class.
    /// </param>
    /// <param name="contentRootPath">The path to the content root. This path can be either relative or absolute.
    /// In case the path is relative, the path will be combined with
    /// <see cref="Directory.GetCurrentDirectory()"/></param>
    /// <param name="contentRootTest">
    /// A file that will be use as a marker to determine that the content root path for the given context is correct.
    /// </param>
    /// <param name="priority">
    /// The priority of this content root attribute compared to other attributes. When
    /// multiple <see cref="WebApplicationFactoryContentRootAttribute"/> instances are applied for the
    /// same key, they are processed with <see cref="int.Parse(string)"/>, ordered in ascending order and applied
    /// in priority until a match is found.
    /// </param>
    public WebApplicationFactoryContentRootAttribute(
        string key,
        string contentRootPath,
        string contentRootTest,
        string priority)
    {
        Key = key;
        ContentRootPath = contentRootPath;
        ContentRootTest = contentRootTest;
        if (int.TryParse(priority, NumberStyles.Integer, CultureInfo.InvariantCulture, out var parsedPriority))
        {
            Priority = parsedPriority;
        }
    }
 
    /// <summary>
    /// Gets the key for the content root associated with this project. Typically <see cref="Assembly.FullName"/>.
    /// </summary>
    public string Key { get; }
 
    /// <summary>
    /// Gets the content root path for a given project. This content root can be relative or absolute. If it is a
    /// relative path, it will be combined with <see cref="AppContext.BaseDirectory"/>.
    /// </summary>
    public string ContentRootPath { get; }
 
    /// <summary>
    /// A marker file used to ensure that the path the content root is being set to is correct.
    /// </summary>
    public string ContentRootTest { get; }
 
    /// <summary>
    /// Gets a number for determining the probing order when multiple <see cref="WebApplicationFactoryContentRootAttribute"/>
    /// instances with the same key are present on the test <see cref="Assembly"/>.
    /// </summary>
    public int Priority { get; }
}