< Summary - Jellyfin

Information
Class: MediaBrowser.Providers.TV.EpisodeMetadataService
Assembly: MediaBrowser.Providers
File(s): /srv/git/jellyfin/MediaBrowser.Providers/TV/EpisodeMetadataService.cs
Line coverage
85%
Covered lines: 47
Uncovered lines: 8
Coverable lines: 55
Total lines: 148
Line coverage: 85.4%
Branch coverage
60%
Covered branches: 23
Total branches: 38
Branch coverage: 60.5%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Coverage history

Coverage history 0 25 50 75 100 5/16/2026 - 12:15:55 AM Line coverage: 45% (18/40) Branch coverage: 68.7% (22/32) Total lines: 1235/20/2026 - 12:15:44 AM Line coverage: 45% (18/40) Branch coverage: 40.6% (13/32) Total lines: 12310/29/2026 - 12:17:11 AM Line coverage: 85.4% (47/55) Branch coverage: 60.5% (23/38) Total lines: 148 5/16/2026 - 12:15:55 AM Line coverage: 45% (18/40) Branch coverage: 68.7% (22/32) Total lines: 1235/20/2026 - 12:15:44 AM Line coverage: 45% (18/40) Branch coverage: 40.6% (13/32) Total lines: 12310/29/2026 - 12:17:11 AM Line coverage: 85.4% (47/55) Branch coverage: 60.5% (23/38) Total lines: 148

Coverage delta

Coverage delta 41 -41

Metrics

MethodBranch coverage Crap Score Cyclomatic complexity Line coverage
.ctor(...)100%11100%
BeforeSaveInternal(...)62.5%191678.37%
MergeData(...)59.09%2222100%

File(s)

/srv/git/jellyfin/MediaBrowser.Providers/TV/EpisodeMetadataService.cs

#LineLine coverage
 1using System;
 2using MediaBrowser.Controller.Configuration;
 3using MediaBrowser.Controller.Entities.TV;
 4using MediaBrowser.Controller.IO;
 5using MediaBrowser.Controller.Library;
 6using MediaBrowser.Controller.Persistence;
 7using MediaBrowser.Controller.Providers;
 8using MediaBrowser.Model.Entities;
 9using MediaBrowser.Model.IO;
 10using MediaBrowser.Providers.Manager;
 11using Microsoft.Extensions.Logging;
 12
 13namespace MediaBrowser.Providers.TV;
 14
 15/// <summary>
 16/// Service to manage episode metadata.
 17/// </summary>
 18public class EpisodeMetadataService : MetadataService<Episode, EpisodeInfo>
 19{
 20    /// <summary>
 21    /// Initializes a new instance of the <see cref="EpisodeMetadataService"/> class.
 22    /// </summary>
 23    /// <param name="serverConfigurationManager">Instance of the <see cref="IServerConfigurationManager"/>.</param>
 24    /// <param name="logger">Instance of the <see cref="ILogger"/> interface.</param>
 25    /// <param name="providerManager">Instance of the <see cref="IProviderManager"/> interface.</param>
 26    /// <param name="fileSystem">Instance of the <see cref="IFileSystem"/> interface.</param>
 27    /// <param name="libraryManager">Instance of the <see cref="ILibraryManager"/> interface.</param>
 28    /// <param name="externalDataManager">Instance of the <see cref="IExternalDataManager"/> interface.</param>
 29    /// <param name="itemRepository">Instance of the <see cref="IItemRepository"/> interface.</param>
 30    public EpisodeMetadataService(
 31        IServerConfigurationManager serverConfigurationManager,
 32        ILogger<EpisodeMetadataService> logger,
 33        IProviderManager providerManager,
 34        IFileSystem fileSystem,
 35        ILibraryManager libraryManager,
 36        IExternalDataManager externalDataManager,
 37        IItemRepository itemRepository)
 3638        : base(serverConfigurationManager, logger, providerManager, fileSystem, libraryManager, externalDataManager, ite
 39    {
 3640    }
 41
 42    /// <inheritdoc />
 43    protected override ItemUpdateType BeforeSaveInternal(Episode item, bool isFullRefresh, ItemUpdateType updateType)
 44    {
 645        var updatedType = base.BeforeSaveInternal(item, isFullRefresh, updateType);
 46
 47        // An episode cannot end before it starts.
 648        if (item.IndexNumberEnd < item.IndexNumber)
 49        {
 350            Logger.LogWarning(
 351                "Discarding episode range end {IndexNumberEnd} preceding episode number {IndexNumber} for {Path}",
 352                item.IndexNumberEnd,
 353                item.IndexNumber,
 354                item.Path);
 55
 356            item.IndexNumberEnd = null;
 357            updatedType |= ItemUpdateType.MetadataImport;
 58        }
 359        else if (item.IndexNumberEnd.HasValue && !item.IndexNumber.HasValue)
 60        {
 61            // Without a first episode the end does not describe a range. Promoting it to the episode number
 62            // would invent an identity the metadata never supplied, so drop the orphaned value instead.
 163            Logger.LogWarning(
 164                "Discarding episode range end {IndexNumberEnd} without an episode number for {Path}",
 165                item.IndexNumberEnd,
 166                item.Path);
 67
 168            item.IndexNumberEnd = null;
 169            updatedType |= ItemUpdateType.MetadataImport;
 70        }
 71
 672        var seriesName = item.FindSeriesName();
 673        if (!string.Equals(item.SeriesName, seriesName, StringComparison.Ordinal))
 74        {
 075            item.SeriesName = seriesName;
 076            updatedType |= ItemUpdateType.MetadataImport;
 77        }
 78
 679        var seasonName = item.FindSeasonName();
 680        if (!string.Equals(item.SeasonName, seasonName, StringComparison.Ordinal))
 81        {
 682            item.SeasonName = seasonName;
 683            updatedType |= ItemUpdateType.MetadataImport;
 84        }
 85
 686        var seriesId = item.FindSeriesId();
 687        if (!item.SeriesId.Equals(seriesId))
 88        {
 089            item.SeriesId = seriesId;
 090            updatedType |= ItemUpdateType.MetadataImport;
 91        }
 92
 693        var seasonId = item.FindSeasonId();
 694        if (!item.SeasonId.Equals(seasonId))
 95        {
 096            item.SeasonId = seasonId;
 097            updatedType |= ItemUpdateType.MetadataImport;
 98        }
 99
 6100        var seriesPresentationUniqueKey = item.FindSeriesPresentationUniqueKey();
 6101        if (!string.Equals(item.SeriesPresentationUniqueKey, seriesPresentationUniqueKey, StringComparison.Ordinal))
 102        {
 0103            item.SeriesPresentationUniqueKey = seriesPresentationUniqueKey;
 0104            updatedType |= ItemUpdateType.MetadataImport;
 105        }
 106
 6107        return updatedType;
 108    }
 109
 110    /// <inheritdoc />
 111    protected override void MergeData(MetadataResult<Episode> source, MetadataResult<Episode> target, MetadataField[] lo
 112    {
 3113        base.MergeData(source, target, lockedFields, replaceData, mergeMetadataSettings);
 114
 3115        var sourceItem = source.Item;
 3116        var targetItem = target.Item;
 117
 3118        if (replaceData || !targetItem.AirsBeforeSeasonNumber.HasValue)
 119        {
 3120            targetItem.AirsBeforeSeasonNumber = sourceItem.AirsBeforeSeasonNumber;
 121        }
 122
 3123        if (replaceData || !targetItem.AirsAfterSeasonNumber.HasValue)
 124        {
 3125            targetItem.AirsAfterSeasonNumber = sourceItem.AirsAfterSeasonNumber;
 126        }
 127
 3128        if (replaceData || !targetItem.AirsBeforeEpisodeNumber.HasValue)
 129        {
 3130            targetItem.AirsBeforeEpisodeNumber = sourceItem.AirsBeforeEpisodeNumber;
 131        }
 132
 3133        if (replaceData || !targetItem.IndexNumberEnd.HasValue)
 134        {
 3135            targetItem.IndexNumberEnd = sourceItem.IndexNumberEnd;
 136        }
 137
 138        // Episode season numbers can be set from path parsing before local metadata is merged.
 139        // When a provider supplies an explicit season, prefer it during provider->temp and temp->item merges,
 140        // but avoid clobbering provider data when existing metadata is backfilled into temp.
 3141        if (mergeMetadataSettings
 3142            && sourceItem.ParentIndexNumber.HasValue
 3143            && targetItem.ParentIndexNumber != sourceItem.ParentIndexNumber)
 144        {
 1145            targetItem.ParentIndexNumber = sourceItem.ParentIndexNumber;
 146        }
 3147    }
 148}