using API.Data.Metadata; using API.Entities.Enums; namespace API.Parser { /// /// This represents all parsed information from a single file /// public class ParserInfo { /// /// Represents the parsed chapters from a file. By default, will be 0 which means nothing could be parsed. /// The chapters can only be a single float or a range of float ie) 1-2. Mainly floats should be multiples of 0.5 representing specials /// public string Chapters { get; set; } = ""; /// /// Represents the parsed series from the file or folder /// public string Series { get; set; } = string.Empty; /// /// This can be filled in from ComicInfo.xml/Epub during scanning. Will update the SortName field on /// public string SeriesSort { get; set; } = string.Empty; /// /// Represents the parsed volumes from a file. By default, will be 0 which means that nothing could be parsed. /// If Volumes is 0 and Chapters is 0, the file is a special. If Chapters is non-zero, then no volume could be parsed. /// Beastars Vol 3-4 will map to "3-4" /// The volumes can only be a single int or a range of ints ie) 1-2. Float based volumes are not supported. /// public string Volumes { get; set; } = ""; /// /// Filename of the underlying file /// Beastars v01 (digital).cbz /// public string Filename { get; init; } = ""; /// /// Full filepath of the underlying file /// C:/Manga/Beastars v01 (digital).cbz /// public string FullFilePath { get; set; } = ""; /// /// that represents the type of the file /// Mainly used to show in the UI and so caching service knows how to cache for reading. /// public MangaFormat Format { get; set; } = MangaFormat.Unknown; /// /// This can potentially story things like "Omnibus, Color, Full Contact Edition, Extra, Final, etc" /// /// Not Used in Database public string Edition { get; set; } = ""; /// /// If the file contains no volume/chapter information or contains Special Keywords /// public bool IsSpecial { get; set; } /// /// Used for specials or books, stores what the UI should show. /// Manga does not use this field /// public string Title { get; set; } = string.Empty; /// /// If the ParserInfo has the IsSpecial tag or both volumes and chapters are default aka 0 /// /// public bool IsSpecialInfo() { return (IsSpecial || (Volumes == "0" && Chapters == "0")); } /// /// This will contain any EXTRA comicInfo information parsed from the epub or archive. If there is an archive with comicInfo.xml AND it contains /// series, volume information, that will override what we parsed. /// public ComicInfo ComicInfo { get; set; } /// /// Merges non empty/null properties from info2 into this entity. /// /// public void Merge(ParserInfo info2) { if (info2 == null) return; Chapters = string.IsNullOrEmpty(Chapters) || Chapters == "0" ? info2.Chapters: Chapters; Volumes = string.IsNullOrEmpty(Volumes) || Volumes == "0" ? info2.Volumes : Volumes; Edition = string.IsNullOrEmpty(Edition) ? info2.Edition : Edition; Title = string.IsNullOrEmpty(Title) ? info2.Title : Title; Series = string.IsNullOrEmpty(Series) ? info2.Series : Series; IsSpecial = IsSpecial || info2.IsSpecial; } } }