< Summary - Jellyfin

Information
Class: MediaBrowser.Controller.Entities.TV.Season
Assembly: MediaBrowser.Controller
File(s): /srv/git/jellyfin/MediaBrowser.Controller/Entities/TV/Season.cs
Line coverage
0%
Covered lines: 0
Uncovered lines: 76
Coverable lines: 76
Total lines: 291
Line coverage: 0%
Branch coverage
0%
Covered branches: 0
Total branches: 40
Branch coverage: 0%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Coverage history

Coverage history 0 25 50 75 100 1/23/2026 - 12:11:06 AM Line coverage: 0% (0/75) Branch coverage: 0% (0/38) Total lines: 2882/27/2026 - 12:13:29 AM Line coverage: 0% (0/77) Branch coverage: 0% (0/40) Total lines: 2935/4/2026 - 12:15:16 AM Line coverage: 0% (0/76) Branch coverage: 0% (0/40) Total lines: 291 1/23/2026 - 12:11:06 AM Line coverage: 0% (0/75) Branch coverage: 0% (0/38) Total lines: 2882/27/2026 - 12:13:29 AM Line coverage: 0% (0/77) Branch coverage: 0% (0/40) Total lines: 2935/4/2026 - 12:15:16 AM Line coverage: 0% (0/76) Branch coverage: 0% (0/40) Total lines: 291

Coverage delta

Coverage delta 1 -1

Metrics

File(s)

/srv/git/jellyfin/MediaBrowser.Controller/Entities/TV/Season.cs

#LineLine coverage
 1#nullable disable
 2
 3#pragma warning disable CS1591
 4
 5using System;
 6using System.Collections.Generic;
 7using System.Globalization;
 8using System.Linq;
 9using System.Text.Json.Serialization;
 10using System.Threading;
 11using Jellyfin.Data.Enums;
 12using Jellyfin.Database.Implementations.Entities;
 13using Jellyfin.Extensions;
 14using MediaBrowser.Common;
 15using MediaBrowser.Controller.Dto;
 16using MediaBrowser.Controller.Providers;
 17using MediaBrowser.Model.Querying;
 18
 19namespace MediaBrowser.Controller.Entities.TV
 20{
 21    /// <summary>
 22    /// Class Season.
 23    /// </summary>
 24    [RequiresSourceSerialisation]
 25    public class Season : Folder, IHasSeries, IHasLookupInfo<SeasonInfo>
 26    {
 27        [JsonIgnore]
 028        public override bool SupportsAddingToPlaylist => true;
 29
 30        [JsonIgnore]
 031        public override bool IsPreSorted => true;
 32
 33        [JsonIgnore]
 034        public override bool SupportsDateLastMediaAdded => false;
 35
 36        [JsonIgnore]
 037        public override bool SupportsPeople => true;
 38
 39        [JsonIgnore]
 040        public override bool SupportsInheritedParentImages => true;
 41
 42        [JsonIgnore]
 043        public override Guid DisplayParentId => SeriesId;
 44
 45        /// <summary>
 46        /// Gets this Episode's Series Instance.
 47        /// </summary>
 48        /// <value>The series.</value>
 49        [JsonIgnore]
 50        public Series Series
 51        {
 52            get
 53            {
 054                var seriesId = SeriesId;
 055                if (seriesId.IsEmpty())
 56                {
 057                    seriesId = FindSeriesId();
 58                }
 59
 060                return seriesId.IsEmpty() ? null : (LibraryManager.GetItemById(seriesId) as Series);
 61            }
 62        }
 63
 64        [JsonIgnore]
 65        public string SeriesPath
 66        {
 67            get
 68            {
 069                var series = Series;
 70
 071                if (series is not null)
 72                {
 073                    return series.Path;
 74                }
 75
 076                return System.IO.Path.GetDirectoryName(Path);
 77            }
 78        }
 79
 80        [JsonIgnore]
 81        public string SeriesPresentationUniqueKey { get; set; }
 82
 83        [JsonIgnore]
 84        public string SeriesName { get; set; }
 85
 86        [JsonIgnore]
 87        public Guid SeriesId { get; set; }
 88
 89        public override double GetDefaultPrimaryImageAspectRatio()
 90        {
 091            double value = 2;
 092            value /= 3;
 93
 094            return value;
 95        }
 96
 97        public string FindSeriesSortName()
 98        {
 099            var series = Series;
 0100            return series is null ? SeriesName : series.SortName;
 101        }
 102
 103        public override List<string> GetUserDataKeys()
 104        {
 0105            var list = base.GetUserDataKeys();
 106
 0107            var series = Series;
 0108            if (series is not null)
 109            {
 0110                var newList = series.GetUserDataKeys();
 0111                var suffix = (IndexNumber ?? 0).ToString("000", CultureInfo.InvariantCulture);
 0112                for (int i = 0; i < newList.Count; i++)
 113                {
 0114                    newList[i] = newList[i] + suffix;
 115                }
 116
 0117                newList.AddRange(list);
 0118                list = newList;
 119            }
 120
 0121            return list;
 122        }
 123
 124        public override int GetChildCount(User user)
 125        {
 0126            var result = GetChildren(user, true, null).Count;
 127
 0128            return result;
 129        }
 130
 131        public override string CreatePresentationUniqueKey()
 132        {
 0133            if (IndexNumber.HasValue)
 134            {
 0135                var series = Series;
 0136                if (series is not null)
 137                {
 0138                    return series.PresentationUniqueKey + "-" + IndexNumber.Value.ToString("000", CultureInfo.InvariantC
 139                }
 140            }
 141
 0142            return base.CreatePresentationUniqueKey();
 143        }
 144
 145        /// <summary>
 146        /// Creates the name of the sort.
 147        /// </summary>
 148        /// <returns>System.String.</returns>
 149        protected override string CreateSortName()
 150        {
 0151            return IndexNumber is not null ? IndexNumber.Value.ToString("0000", CultureInfo.InvariantCulture) : Name;
 152        }
 153
 154        protected override QueryResult<BaseItem> GetItemsInternal(InternalItemsQuery query)
 155        {
 0156            if (SourceType == SourceType.Channel)
 157            {
 158                try
 159                {
 0160                    query.Parent = this;
 0161                    query.ChannelIds = new[] { ChannelId };
 0162                    return ChannelManager.GetChannelItemsInternal(query, new Progress<double>(), CancellationToken.None)
 163                }
 0164                catch
 165                {
 166                    // Already logged at lower levels
 0167                    return new QueryResult<BaseItem>();
 168                }
 169            }
 170
 0171            if (query.User is null)
 172            {
 0173                return base.GetItemsInternal(query);
 174            }
 175
 0176            var user = query.User;
 177
 0178            var items = UserViewBuilder.Filter(GetEpisodes(user, query.DtoOptions, true), user, query, UserDataManager, 
 179
 0180            return PostFilterAndSort(items, query);
 0181        }
 182
 183        /// <summary>
 184        /// Gets the episodes.
 185        /// </summary>
 186        /// <param name="user">The user.</param>
 187        /// <param name="options">The options to use.</param>
 188        /// <param name="shouldIncludeMissingEpisodes">If missing episodes should be included.</param>
 189        /// <returns>Set of episodes.</returns>
 190        public List<BaseItem> GetEpisodes(User user, DtoOptions options, bool shouldIncludeMissingEpisodes)
 191        {
 0192            return GetEpisodes(Series, user, options, shouldIncludeMissingEpisodes);
 193        }
 194
 195        public List<BaseItem> GetEpisodes(Series series, User user, DtoOptions options, bool shouldIncludeMissingEpisode
 196        {
 0197            return GetEpisodes(series, user, null, options, shouldIncludeMissingEpisodes);
 198        }
 199
 200        public List<BaseItem> GetEpisodes(Series series, User user, IEnumerable<Episode> allSeriesEpisodes, DtoOptions o
 201        {
 0202            if (series is null)
 203            {
 0204                return [];
 205            }
 206
 0207            return series.GetSeasonEpisodes(this, user, allSeriesEpisodes, options, shouldIncludeMissingEpisodes);
 208        }
 209
 210        public List<BaseItem> GetEpisodes()
 211        {
 0212            return GetEpisodes(Series, null, null, new DtoOptions(true), true);
 213        }
 214
 215        public override List<BaseItem> GetChildren(User user, bool includeLinkedChildren, InternalItemsQuery query)
 216        {
 0217            return GetEpisodes(user, new DtoOptions(true), true);
 218        }
 219
 220        protected override bool GetBlockUnratedValue(User user)
 221        {
 222            // Don't block. Let either the entire series rating or episode rating determine it
 0223            return false;
 224        }
 225
 226        public override UnratedItem GetBlockUnratedType()
 227        {
 0228            return UnratedItem.Series;
 229        }
 230
 231        public string FindSeriesPresentationUniqueKey()
 232        {
 0233            var series = Series;
 0234            return series is null ? null : series.PresentationUniqueKey;
 235        }
 236
 237        public string FindSeriesName()
 238        {
 0239            var series = Series;
 0240            return series is null ? SeriesName : series.Name;
 241        }
 242
 243        public Guid FindSeriesId()
 244        {
 0245            var series = FindParent<Series>();
 0246            return series?.Id ?? Guid.Empty;
 247        }
 248
 249        /// <summary>
 250        /// Gets the lookup information.
 251        /// </summary>
 252        /// <returns>SeasonInfo.</returns>
 253        public SeasonInfo GetLookupInfo()
 254        {
 0255            var id = GetItemLookupInfo<SeasonInfo>();
 256
 0257            var series = Series;
 258
 0259            if (series is not null)
 260            {
 0261                id.SeriesProviderIds = series.ProviderIds;
 0262                id.SeriesDisplayOrder = series.DisplayOrder;
 263            }
 264
 0265            return id;
 266        }
 267
 268        /// <summary>
 269        /// This is called before any metadata refresh and returns true or false indicating if changes were made.
 270        /// </summary>
 271        /// <param name="replaceAllMetadata"><c>true</c> to replace metadata, <c>false</c> to not.</param>
 272        /// <returns><c>true</c> if XXXX, <c>false</c> otherwise.</returns>
 273        public override bool BeforeMetadataRefresh(bool replaceAllMetadata)
 274        {
 0275            var hasChanges = base.BeforeMetadataRefresh(replaceAllMetadata);
 276
 0277            if (!IndexNumber.HasValue && !string.IsNullOrEmpty(Path))
 278            {
 0279                IndexNumber ??= LibraryManager.GetSeasonNumberFromPath(Path, ParentId);
 280
 281                // If a change was made record it
 0282                if (IndexNumber.HasValue)
 283                {
 0284                    hasChanges = true;
 285                }
 286            }
 287
 0288            return hasChanges;
 289        }
 290    }
 291}