add api route to fetch other album versions

+ add parser functions to extract album version

app/api/album.py

@@ -9,6 +9,7 @@ from flask import Blueprint, request
 from app.db.sqlite.albums import SQLiteAlbumMethods as adb
 from app.db.sqlite.favorite import SQLiteFavoriteMethods as favdb
 from app.models import FavType, Track
+from app.utils.hashing import create_hash
 from app.utils.remove_duplicates import remove_duplicates
 
 from app.store.tracks import TrackStore
@@ -122,3 +123,30 @@ def get_artist_albums():
     albums = [a for a in albums if len(a["albums"]) > 0]
 
     return {"data": albums}
+
+
+@api.route("/album/versions", methods=["POST"])
+def get_album_versions():
+    """
+    Returns other versions of the given album.
+    """
+
+    data = request.get_json()
+
+    if data is None:
+        return {"msg": "No albumartist provided"}
+
+    og_album_title: str = data['og_album_title']
+    album_title: str = data['album_title']
+    artisthash: str = data['artisthash']
+
+    albums = AlbumStore.get_albums_by_artisthash(artisthash)
+
+    albums = [
+        a for a in albums
+        if create_hash(a.title) == create_hash(album_title) and create_hash(og_album_title) != create_hash(a.og_title)
+    ]
+
+    return {
+        "data": albums
+    }

app/utils/parsers.py

@@ -87,8 +87,9 @@ def parse_feat_from_title(title: str) -> tuple[list[str], str]:
     return artists, new_title
 
 
-def get_base_album_title(string):
-    pattern = re.compile(r'\s*(\(|\[).*?(version|remaster|deluxe|edition|expanded).*?(\)|\])', re.IGNORECASE)
+def get_base_album_title(string) -> tuple[str, str | None]:
+    pattern = re.compile(r'\s*(\(|\[).*?(version|remaster|deluxe|edition|expanded|anniversary).*?(\)|\])',
+                         re.IGNORECASE)
     match = pattern.search(string)
     if match:
         removed_block = match.group(0)
@@ -99,18 +100,60 @@ def get_base_album_title(string):
 
 
 class AlbumVersionEnum(Enum):
-    REMASTER = ("remaster", "remastered")
-    DELUXE = ("deluxe",)
+    Explicit = ("explicit",)
+
+    ANNIVERSARY = ("anniversary",)
+    DIAMOND = ("diamond",)
+    Centennial = ("centennial",)
+    GOLDEN = ("gold",)
+    PLATINUM = ('platinum',)
+    SILVER = ("silver",)
+
     EXPANDED = ("expanded",)
-    SUPER_DELUXE = ("super deluxe",)
     EXTENDED = ("extended",)
-    BONUS_TRACK = ("bonus track", "bonus tracks")
-    RE_RECORD = ("re-recorded", "rerecorded")
-    INTL_VERSION = ("international",)
+
+    DELUXE = ("deluxe",)
+    SUPER_DELUXE = ("super deluxe",)
+
+    LEGACY = ("legacy",)
+    SPECIAL = ("special",)
+    COLLECTORS = ("collector",)
+    ARCHIVE = ("archive",)
+
+    Acoustic = ("acoustic",)
+    DOUBLE_DISC = ('double disc', 'double disk')
+
+    SUMMER = ("summer",)
+    WINTER = ("winter",)
+    SPRING = ("spring",)
+    FALL = ("fall",)
+
+    BONUS_TRACK = ("bonus track",)
+
     ORIGINAL = ("original",)
+    INTL_VERSION = ("international",)
+    UK_VERSION = ("uk version",)
+    US_VERSION = ("us version",)
+
+    Limited = ("limited",)
+
+    MONO = ("mono",)
+    STEREO = ("stereo",)
+
+    HI_RES = ("Hi-Res",)
     RE_MIX = ("re-mix",)
     RE_RECORDED = ("re-recorded", "rerecorded")
     REISSUE = ("reissue",)
+    REMASTER = ("remaster",)
+
+
+def get_anniversary(text: str) -> str | None:
+    _end = "anniversary"
+    match = re.search(r"\b\d+\w*(?= anniversary)", text, re.IGNORECASE)
+    if match:
+        return match.group(0).strip().lower() + f" {_end}"
+    else:
+        return _end
 
 
 def get_album_info(bracket_text: str | None) -> list[str]:
@@ -124,11 +167,25 @@ def get_album_info(bracket_text: str | None) -> list[str]:
             if re.search(keyword, bracket_text, re.IGNORECASE):
                 versions.append(version_keywords.name.lower())
                 break
+
+    if "anniversary" in versions:
+        anniversary = get_anniversary(bracket_text)
+        versions.insert(0, anniversary)
+        versions.remove("anniversary")
+
     return versions
 
 
-def get_base_title_and_versions(album: str) -> tuple[str, list[str]]:
-    album_title, version_block = get_base_album_title(album)
+def get_base_title_and_versions(original_album_title: str) -> tuple[str, list[str]]:
+    album_title, version_block = get_base_album_title(original_album_title)
+
+    if version_block is None:
+        return original_album_title, []
+
     versions = get_album_info(version_block)
 
+    # if no version info could be extracted, accept defeat!
+    if len(versions) == 0:
+        album_title = original_album_title
+
     return album_title, versions