jellyfin/MediaBrowser.Controller/Entities/Year.cs

#nullable disable

#pragma warning disable CS1591

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Text.Json.Serialization;
using Jellyfin.Data.Enums;
using Microsoft.Extensions.Logging;

namespace MediaBrowser.Controller.Entities
{
    /// <summary>
    /// Class Year.
    /// </summary>
    [Common.RequiresSourceSerialisation]
    public class Year : BaseItem, IItemByName
    {
        [JsonIgnore]
        public override bool SupportsAncestors => false;

        [JsonIgnore]
        public override bool SupportsPeople => false;

        /// <summary>
        /// Gets the folder containing the item.
        /// If the item is a folder, it returns the folder itself.
        /// </summary>
        /// <value>The containing folder path.</value>
        [JsonIgnore]
        public override string ContainingFolderPath => Path;

        public override bool CanDelete()
        {
            return false;
        }

        public override List<string> GetUserDataKeys()
        {
            var list = base.GetUserDataKeys();

            list.Insert(0, "Year-" + Name);
            return list;
        }

        public override double GetDefaultPrimaryImageAspectRatio()
        {
            double value = 2;
            value /= 3;

            return value;
        }

        public override bool IsSaveLocalMetadataEnabled()
        {
            return true;
        }

        public IReadOnlyList<BaseItem> GetTaggedItems(InternalItemsQuery query)
        {
            if (!int.TryParse(Name, NumberStyles.Integer, CultureInfo.InvariantCulture, out var year))
            {
                return new List<BaseItem>();
            }

            query.Years = new[] { year };

            return LibraryManager.GetItemList(query);
        }

        public TaggedItemCounts GetTaggedItemCounts(InternalItemsQuery query)
        {
            if (!int.TryParse(Name, NumberStyles.Integer, CultureInfo.InvariantCulture, out var year))
            {
                return new TaggedItemCounts();
            }

            query.Years = [year];

            var counts = new TaggedItemCounts();

            query.IncludeItemTypes = [BaseItemKind.MusicAlbum];
            counts.AlbumCount = LibraryManager.GetCount(query);

            query.IncludeItemTypes = [BaseItemKind.MusicArtist];
            counts.ArtistCount = LibraryManager.GetCount(query);

            query.IncludeItemTypes = [BaseItemKind.Episode];
            counts.EpisodeCount = LibraryManager.GetCount(query);

            query.IncludeItemTypes = [BaseItemKind.Movie];
            counts.MovieCount = LibraryManager.GetCount(query);

            query.IncludeItemTypes = [BaseItemKind.MusicVideo];
            counts.MusicVideoCount = LibraryManager.GetCount(query);

            query.IncludeItemTypes = [BaseItemKind.LiveTvProgram];
            counts.ProgramCount = LibraryManager.GetCount(query);

            query.IncludeItemTypes = [BaseItemKind.Series];
            counts.SeriesCount = LibraryManager.GetCount(query);

            query.IncludeItemTypes = [BaseItemKind.Audio];
            counts.SongCount = LibraryManager.GetCount(query);

            query.IncludeItemTypes = [BaseItemKind.Trailer];
            counts.TrailerCount = LibraryManager.GetCount(query);

            return counts;
        }

        public int? GetYearValue()
        {
            if (int.TryParse(Name, NumberStyles.Integer, CultureInfo.InvariantCulture, out var year))
            {
                return year;
            }

            return null;
        }

        public static string GetPath(string name)
        {
            return GetPath(name, true);
        }

        public static string GetPath(string name, bool normalizeName)
        {
            // Trim the period at the end because windows will have a hard time with that
            var validName = normalizeName ?
                FileSystem.GetValidFilename(name).Trim().TrimEnd('.') :
                name;

            return System.IO.Path.Combine(ConfigurationManager.ApplicationPaths.YearPath, validName);
        }

        private string GetRebasedPath()
        {
            return GetPath(System.IO.Path.GetFileName(Path), false);
        }

        public override bool RequiresRefresh()
        {
            var newPath = GetRebasedPath();
            if (!string.Equals(Path, newPath, StringComparison.Ordinal))
            {
                Logger.LogDebug("{0} path has changed from {1} to {2}", GetType().Name, Path, newPath);
                return true;
            }

            return base.RequiresRefresh();
        }

        /// <summary>
        /// This is called before any metadata refresh and returns true if changes were made.
        /// </summary>
        /// <param name="replaceAllMetadata">Whether to replace all metadata.</param>
        /// <returns>true if the item has change, else false.</returns>
        public override bool BeforeMetadataRefresh(bool replaceAllMetadata)
        {
            var hasChanges = base.BeforeMetadataRefresh(replaceAllMetadata);

            var newPath = GetRebasedPath();
            if (!string.Equals(Path, newPath, StringComparison.Ordinal))
            {
                Path = newPath;
                hasChanges = true;
            }

            return hasChanges;
        }
    }
}