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

using System;
using System.Diagnostics.CodeAnalysis;
using System.IO;

namespace Microsoft.Extensions.FileProviders
{
    /// <summary>
    /// Represents a nonexistent file.
    /// </summary>
    public class NotFoundFileInfo : IFileInfo
    {
        /// <summary>
        /// Initializes a new instance of the <see cref="NotFoundFileInfo"/> class.
        /// </summary>
        /// <param name="name">The name of the file that could not be found.</param>
        public NotFoundFileInfo(string name)
        {
            Name = name;
        }

        /// <summary>
        /// Gets a value that's always <see langword="false"/>.
        /// </summary>
        public bool Exists => false;

        /// <summary>
        /// Gets a value that's always <see langword="false"/>.
        /// </summary>
        public bool IsDirectory => false;

        /// <summary>
        /// Gets <see cref="DateTimeOffset.MinValue"/>.
        /// </summary>
        public DateTimeOffset LastModified => DateTimeOffset.MinValue;

        /// <summary>
        /// Gets a value that's always -1.
        /// </summary>
        public long Length => -1;

        /// <inheritdoc />
        public string Name { get; }

        /// <summary>
        /// Gets a value that's always <see langword="null"/>.
        /// </summary>
        public string? PhysicalPath => null;

        /// <summary>
        /// Always throws. A stream cannot be created for a nonexistent file.
        /// </summary>
        /// <exception cref="FileNotFoundException">In all cases.</exception>
        /// <returns>Does not return.</returns>
        [DoesNotReturn]
        public Stream CreateReadStream()
        {
            throw new FileNotFoundException(SR.Format(SR.FileNotExists, Name));
        }
    }
}