< Summary - Jellyfin

Information
Class: Jellyfin.Server.Implementations.Item.PeopleRepository
Assembly: Jellyfin.Server.Implementations
File(s): /srv/git/jellyfin/Jellyfin.Server.Implementations/Item/PeopleRepository.cs
Line coverage
0%
Covered lines: 1
Uncovered lines: 118
Coverable lines: 119
Total lines: 263
Line coverage: 0.8%
Branch coverage
0%
Covered branches: 0
Total branches: 60
Branch coverage: 0%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Coverage history

Coverage history 0 25 50 75 100 12/27/2025 - 12:11:51 AM Line coverage: 0.8% (1/114) Branch coverage: 0% (0/50) Total lines: 2532/6/2026 - 12:13:21 AM Line coverage: 0.8% (1/115) Branch coverage: 0% (0/54) Total lines: 2544/6/2026 - 12:13:55 AM Line coverage: 0.8% (1/119) Branch coverage: 0% (0/60) Total lines: 263 12/27/2025 - 12:11:51 AM Line coverage: 0.8% (1/114) Branch coverage: 0% (0/50) Total lines: 2532/6/2026 - 12:13:21 AM Line coverage: 0.8% (1/115) Branch coverage: 0% (0/54) Total lines: 2544/6/2026 - 12:13:55 AM Line coverage: 0.8% (1/119) Branch coverage: 0% (0/60) Total lines: 263

Coverage delta

Coverage delta 1 -1

Metrics

MethodBranch coverage Crap Score Cyclomatic complexity Line coverage
.ctor(...)100%11100%
GetPeople(...)0%2040%
GetPeopleNames(...)0%4260%
UpdatePeople(...)0%210140%
Map(...)0%7280%
Map(...)100%210%
TranslateQuery(...)0%420200%
IsAlphaNumeric(...)0%7280%
IsValidPersonType(...)100%210%

File(s)

/srv/git/jellyfin/Jellyfin.Server.Implementations/Item/PeopleRepository.cs

#LineLine coverage
 1using System;
 2using System.Collections.Generic;
 3using System.Collections.Immutable;
 4using System.Linq;
 5using Jellyfin.Data.Enums;
 6using Jellyfin.Database.Implementations;
 7using Jellyfin.Database.Implementations.Entities;
 8using Jellyfin.Database.Implementations.Entities.Libraries;
 9using Jellyfin.Extensions;
 10using MediaBrowser.Controller.Entities;
 11using MediaBrowser.Controller.Persistence;
 12using Microsoft.EntityFrameworkCore;
 13
 14namespace Jellyfin.Server.Implementations.Item;
 15#pragma warning disable RS0030 // Do not use banned APIs
 16#pragma warning disable CA1304 // Specify CultureInfo
 17#pragma warning disable CA1311 // Specify a culture or use an invariant version
 18#pragma warning disable CA1862 // Use the 'StringComparison' method overloads to perform case-insensitive string compari
 19
 20/// <summary>
 21/// Manager for handling people.
 22/// </summary>
 23/// <param name="dbProvider">Efcore Factory.</param>
 24/// <param name="itemTypeLookup">Items lookup service.</param>
 25/// <remarks>
 26/// Initializes a new instance of the <see cref="PeopleRepository"/> class.
 27/// </remarks>
 28public class PeopleRepository(IDbContextFactory<JellyfinDbContext> dbProvider, IItemTypeLookup itemTypeLookup) : IPeople
 29{
 2130    private readonly IDbContextFactory<JellyfinDbContext> _dbProvider = dbProvider;
 31
 32    /// <inheritdoc/>
 33    public IReadOnlyList<PersonInfo> GetPeople(InternalPeopleQuery filter)
 34    {
 035        using var context = _dbProvider.CreateDbContext();
 036        var dbQuery = TranslateQuery(context.Peoples.AsNoTracking(), context, filter);
 37
 38        // Include PeopleBaseItemMap
 039        if (!filter.ItemId.IsEmpty())
 40        {
 041            dbQuery = dbQuery.Include(p => p.BaseItems!.Where(m => m.ItemId == filter.ItemId))
 042                .OrderBy(e => e.BaseItems!.First(e => e.ItemId == filter.ItemId).ListOrder)
 043                .ThenBy(e => e.PersonType)
 044                .ThenBy(e => e.Name);
 45        }
 46        else
 47        {
 048            dbQuery = dbQuery.OrderBy(e => e.Name);
 49        }
 50
 051        if (filter.Limit > 0)
 52        {
 053            dbQuery = dbQuery.Take(filter.Limit);
 54        }
 55
 056        return dbQuery.AsEnumerable().Select(Map).ToArray();
 057    }
 58
 59    /// <inheritdoc/>
 60    public IReadOnlyList<string> GetPeopleNames(InternalPeopleQuery filter)
 61    {
 062        using var context = _dbProvider.CreateDbContext();
 063        var dbQuery = TranslateQuery(context.Peoples.AsNoTracking(), context, filter).Select(e => e.Name).Distinct();
 64
 065        if (filter.StartIndex.HasValue && filter.StartIndex > 0)
 66        {
 067            dbQuery = dbQuery.Skip(filter.StartIndex.Value);
 68        }
 69
 070        if (filter.Limit > 0)
 71        {
 072            dbQuery = dbQuery.Take(filter.Limit);
 73        }
 74
 075        return dbQuery.ToArray();
 076    }
 77
 78    /// <inheritdoc />
 79    public void UpdatePeople(Guid itemId, IReadOnlyList<PersonInfo> people)
 80    {
 081        foreach (var person in people)
 82        {
 083            person.Name = person.Name.Trim();
 084            person.Role = person.Role?.Trim() ?? string.Empty;
 85        }
 86
 87        // multiple metadata providers can provide the _same_ person
 088        people = people.DistinctBy(e => e.Name + "-" + e.Type).ToArray();
 089        var personKeys = people.Select(e => e.Name + "-" + e.Type).ToArray();
 90
 091        using var context = _dbProvider.CreateDbContext();
 092        using var transaction = context.Database.BeginTransaction();
 093        var existingPersons = context.Peoples.Select(e => new
 094            {
 095                item = e,
 096                SelectionKey = e.Name + "-" + e.PersonType
 097            })
 098            .Where(p => personKeys.Contains(p.SelectionKey))
 099            .Select(f => f.item)
 0100            .ToArray();
 101
 0102        var toAdd = people
 0103            .Where(e => e.Type is not PersonKind.Artist && e.Type is not PersonKind.AlbumArtist)
 0104            .Where(e => !existingPersons.Any(f => f.Name == e.Name && f.PersonType == e.Type.ToString()))
 0105            .Select(Map);
 0106        context.Peoples.AddRange(toAdd);
 0107        context.SaveChanges();
 108
 0109        var personsEntities = toAdd.Concat(existingPersons).ToArray();
 110
 0111        var existingMaps = context.PeopleBaseItemMap.Include(e => e.People).Where(e => e.ItemId == itemId).ToList();
 112
 0113        var listOrder = 0;
 114
 0115        foreach (var person in people)
 116        {
 0117            if (person.Type == PersonKind.Artist || person.Type == PersonKind.AlbumArtist)
 118            {
 119                continue;
 120            }
 121
 0122            var entityPerson = personsEntities.First(e => e.Name == person.Name && e.PersonType == person.Type.ToString(
 0123            var existingMap = existingMaps.FirstOrDefault(e => e.People.Name == person.Name && e.People.PersonType == pe
 0124            if (existingMap is null)
 125            {
 0126                context.PeopleBaseItemMap.Add(new PeopleBaseItemMap()
 0127                {
 0128                    Item = null!,
 0129                    ItemId = itemId,
 0130                    People = null!,
 0131                    PeopleId = entityPerson.Id,
 0132                    ListOrder = listOrder,
 0133                    SortOrder = person.SortOrder,
 0134                    Role = person.Role
 0135                });
 136            }
 137            else
 138            {
 139                // Update the order for existing mappings
 0140                existingMap.ListOrder = listOrder;
 0141                existingMap.SortOrder = person.SortOrder;
 142                // person mapping already exists so remove from list
 0143                existingMaps.Remove(existingMap);
 144            }
 145
 0146            listOrder++;
 147        }
 148
 0149        context.PeopleBaseItemMap.RemoveRange(existingMaps);
 150
 0151        context.SaveChanges();
 0152        transaction.Commit();
 0153    }
 154
 155    private PersonInfo Map(People people)
 156    {
 0157        var mapping = people.BaseItems?.FirstOrDefault();
 0158        var personInfo = new PersonInfo()
 0159        {
 0160            Id = people.Id,
 0161            Name = people.Name,
 0162            Role = mapping?.Role,
 0163            SortOrder = mapping?.SortOrder
 0164        };
 0165        if (Enum.TryParse<PersonKind>(people.PersonType, out var kind))
 166        {
 0167            personInfo.Type = kind;
 168        }
 169
 0170        return personInfo;
 171    }
 172
 173    private People Map(PersonInfo people)
 174    {
 0175        var personInfo = new People()
 0176        {
 0177            Name = people.Name,
 0178            PersonType = people.Type.ToString(),
 0179            Id = people.Id,
 0180        };
 181
 0182        return personInfo;
 183    }
 184
 185    private IQueryable<People> TranslateQuery(IQueryable<People> query, JellyfinDbContext context, InternalPeopleQuery f
 186    {
 0187        if (filter.User is not null && filter.IsFavorite.HasValue)
 188        {
 0189            var personType = itemTypeLookup.BaseItemKindNames[BaseItemKind.Person];
 0190            var oldQuery = query;
 191
 0192            query = context.UserData
 0193                .Where(u => u.Item!.Type == personType && u.IsFavorite == filter.IsFavorite && u.UserId.Equals(filter.Us
 0194                .Join(oldQuery, e => e.Item!.Name, e => e.Name, (item, person) => person)
 0195                .Distinct()
 0196                .AsNoTracking();
 197        }
 198
 0199        if (!filter.ItemId.IsEmpty())
 200        {
 0201            query = query.Where(e => e.BaseItems!.Any(w => w.ItemId.Equals(filter.ItemId)));
 202        }
 203
 0204        if (filter.ParentId != null)
 205        {
 0206            query = query.Where(e => e.BaseItems!.Any(w => context.AncestorIds.Any(i => i.ParentItemId == filter.ParentI
 207        }
 208
 0209        if (!filter.AppearsInItemId.IsEmpty())
 210        {
 0211            query = query.Where(e => e.BaseItems!.Any(w => w.ItemId.Equals(filter.AppearsInItemId)));
 212        }
 213
 0214        var queryPersonTypes = filter.PersonTypes.Where(IsValidPersonType).ToList();
 0215        if (queryPersonTypes.Count > 0)
 216        {
 0217            query = query.Where(e => queryPersonTypes.Contains(e.PersonType));
 218        }
 219
 0220        var queryExcludePersonTypes = filter.ExcludePersonTypes.Where(IsValidPersonType).ToList();
 221
 0222        if (queryExcludePersonTypes.Count > 0)
 223        {
 0224            query = query.Where(e => !queryPersonTypes.Contains(e.PersonType));
 225        }
 226
 0227        if (filter.MaxListOrder.HasValue && !filter.ItemId.IsEmpty())
 228        {
 0229            query = query.Where(e => e.BaseItems!.First(w => w.ItemId == filter.ItemId).ListOrder <= filter.MaxListOrder
 230        }
 231
 0232        if (!string.IsNullOrWhiteSpace(filter.NameContains))
 233        {
 0234            var nameContainsUpper = filter.NameContains.ToUpper();
 0235            query = query.Where(e => e.Name.ToUpper().Contains(nameContainsUpper));
 236        }
 237
 0238        return query;
 239    }
 240
 241    private bool IsAlphaNumeric(string str)
 242    {
 0243        if (string.IsNullOrWhiteSpace(str))
 244        {
 0245            return false;
 246        }
 247
 0248        for (int i = 0; i < str.Length; i++)
 249        {
 0250            if (!char.IsLetter(str[i]) && !char.IsNumber(str[i]))
 251            {
 0252                return false;
 253            }
 254        }
 255
 0256        return true;
 257    }
 258
 259    private bool IsValidPersonType(string value)
 260    {
 0261        return IsAlphaNumeric(value);
 262    }
 263}