pyrekordbox 0.4.0__py3-none-any.whl → 0.4.2__py3-none-any.whl

pyrekordbox/__main__.py

@@ -9,7 +9,7 @@ import sys
 import urllib.request
 from pathlib import Path
 
-from pyrekordbox.config import _cache_file, write_db6_key_cache
+from pyrekordbox.config import get_cache_file, write_db6_key_cache
 
 KEY_SOURCES = [
     {
@@ -144,7 +144,8 @@ def download_db6_key():
             dp = match.group("dp")
             break
     if dp:
-        print(f"Found key, updating cache file {_cache_file}")
+        cache_file = get_cache_file()
+        print(f"Found key, updating cache file {cache_file}")
         write_db6_key_cache(dp)
     else:
         print("No key found in the online sources.")

pyrekordbox/_version.py

@@ -1,8 +1,13 @@
-# file generated by setuptools_scm
+# file generated by setuptools-scm
 # don't change, don't track in version control
+
+__all__ = ["__version__", "__version_tuple__", "version", "version_tuple"]
+
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from typing import Tuple, Union
+    from typing import Tuple
+    from typing import Union
+
     VERSION_TUPLE = Tuple[Union[int, str], ...]
 else:
     VERSION_TUPLE = object
@@ -12,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.4.0'
-__version_tuple__ = version_tuple = (0, 4, 0)
+__version__ = version = '0.4.2'
+__version_tuple__ = version_tuple = (0, 4, 2)

pyrekordbox/anlz/tags.py

@@ -162,13 +162,9 @@ class PQTZAnlzTag(AbstractAnlzTag):
         n_bpms = len(bpms)
         n_times = len(times)
         if n_bpms != n_beats:
-            raise ValueError(
-                f"Number of bpms not equal to number of beats: {n_bpms} != {n_beats}"
-            )
+            raise ValueError(f"Number of bpms not equal to number of beats: {n_bpms} != {n_beats}")
         if n_times != n_beats:
-            raise ValueError(
-                f"Number of times not equal to number of beats: {n_bpms} != {n_times}"
-            )
+            raise ValueError(f"Number of times not equal to number of beats: {n_bpms} != {n_times}")
 
         # For now only values of existing beats can be set
         if n_beats != n:
@@ -184,9 +180,7 @@ class PQTZAnlzTag(AbstractAnlzTag):
         n = len(self.content.entries)
         n_new = len(beats)
         if n_new != n:
-            raise ValueError(
-                f"Number of beats not equal to current content length: {n_new} != {n}"
-            )
+            raise ValueError(f"Number of beats not equal to current content length: {n_new} != {n}")
 
         for i, beat in enumerate(beats):
             self.content.entries[i].beat = beat
@@ -195,9 +189,7 @@ class PQTZAnlzTag(AbstractAnlzTag):
         n = len(self.content.entries)
         n_new = len(bpms)
         if n_new != n:
-            raise ValueError(
-                f"Number of bpms not equal to current content length: {n_new} != {n}"
-            )
+            raise ValueError(f"Number of bpms not equal to current content length: {n_new} != {n}")
 
         for i, bpm in enumerate(bpms):
             self.content.entries[i].tempo = int(bpm * 100)
@@ -206,9 +198,7 @@ class PQTZAnlzTag(AbstractAnlzTag):
         n = len(self.content.entries)
         n_new = len(times)
         if n_new != n:
-            raise ValueError(
-                f"Number of times not equal to current content length: {n_new} != {n}"
-            )
+            raise ValueError(f"Number of times not equal to current content length: {n_new} != {n}")
 
         for i, t in enumerate(times):
             self.content.entries[i].time = int(1000 * t)

pyrekordbox/config.py

@@ -30,7 +30,7 @@ logger = logging.getLogger(__name__)
 
 # Cache file for pyrekordbox data
 _cache_file_version = 2
-_cache_file = Path(__file__).parent / "rb.cache"
+_cache_file_name = "rb.cache"
 
 # Define empty pyrekordbox configuration
 __config__ = {
@@ -48,6 +48,29 @@ class InvalidApplicationDirname(Exception):
     pass
 
 
+def get_appdata_dir() -> Path:
+    """Returns the path of the application data directory.
+
+    On Windows, the application data is stored in `/Users/user/AppData/Roaming`.
+    On macOS the application data is stored in `~/Libary/Application Support`.
+    """
+    if sys.platform == "win32":
+        # Windows: located in /Users/user/AppData/Roaming/
+        app_data = Path(os.environ["AppData"])
+    elif sys.platform == "darwin":
+        # MacOS: located in ~/Library/Application Support/
+        app_data = Path("~").expanduser() / "Library" / "Application Support"
+    else:
+        # Linux: not supported
+        logger.warning(f"OS {sys.platform} not supported!")
+        return Path("~").expanduser() / ".local" / "share"
+    return app_data
+
+
+def get_cache_file() -> Path:
+    return get_appdata_dir() / "pyrekordbox" / _cache_file_name
+
+
 def get_pioneer_install_dir(path: Union[str, Path] = None) -> Path:  # pragma: no cover
     """Returns the path of the Pioneer program installation directory.
 
@@ -234,12 +257,7 @@ def read_rekordbox6_asar(rb6_install_dir: Union[str, Path]) -> str:
         if not str(rb6_install_dir).endswith(".app"):
             rb6_install_dir = rb6_install_dir / "rekordbox.app"
         location = (
-            rb6_install_dir
-            / "Contents"
-            / "MacOS"
-            / "rekordboxAgent.app"
-            / "Contents"
-            / "Resources"
+            rb6_install_dir / "Contents" / "MacOS" / "rekordboxAgent.app" / "Contents" / "Resources"
         )
         encoding = "cp437"
     else:
@@ -249,7 +267,7 @@ def read_rekordbox6_asar(rb6_install_dir: Union[str, Path]) -> str:
     # Read asar file
     path = (location / "app.asar").absolute()
     with open(path, "rb") as fh:
-        data = fh.read().decode(encoding)
+        data = fh.read().decode(encoding, errors="replace")
     return data
 
 
@@ -360,9 +378,7 @@ def _get_rb_config(
     return conf
 
 
-def _get_rb5_config(
-    pioneer_prog_dir: Path, pioneer_app_dir: Path, dirname: str = ""
-) -> dict:
+def _get_rb5_config(pioneer_prog_dir: Path, pioneer_app_dir: Path, dirname: str = "") -> dict:
     """Get the program configuration for Rekordbox v5.x.x."""
     major_version = 5
     conf = _get_rb_config(pioneer_prog_dir, pioneer_app_dir, major_version, dirname)
@@ -414,8 +430,7 @@ class KeyExtractor:
         pid = get_rekordbox_pid()
         if pid:
             raise RuntimeError(
-                "Rekordbox is running. "
-                "Please close Rekordbox before running the `KeyExtractor`."
+                "Rekordbox is running. Please close Rekordbox before running the `KeyExtractor`."
             )
         # Spawn Rekordbox process and attach to it
         pid = frida.spawn(self.executable)
@@ -434,12 +449,16 @@ class KeyExtractor:
 
 
 def write_db6_key_cache(key: str) -> None:  # pragma: no cover
-    """Writes the decrypted Rekordbox6 database key to the cache file.
+    r"""Writes the decrypted Rekordbox6 database key to the cache file.
 
     This method can also be used to manually cache the database key, provided
     the user has found the key somewhere else. The key can be, for example,
     found in some other projects that hard-coded it.
 
+    The cache file is stored in the application data directory of pyrekordbox:
+    Windows: `C:\Users\<user>\AppData\Roaming\pyrekordbox`
+    macOS: `~/Library/Application Support/pyrekordbox`
+
     Parameters
     ----------
     key : str
@@ -461,7 +480,12 @@ def write_db6_key_cache(key: str) -> None:  # pragma: no cover
     lines.append(f"version: {_cache_file_version}")
     lines.append("dp: " + key)
     text = "\n".join(lines)
-    with open(_cache_file, "w") as fh:
+
+    cache_file = get_cache_file()
+    if not cache_file.parent.exists():
+        cache_file.parent.mkdir()
+
+    with open(cache_file, "w") as fh:
         fh.write(text)
     # Set the config key to make sure the key is present after calling method
     if __config__["rekordbox6"]:
@@ -473,10 +497,13 @@ def write_db6_key_cache(key: str) -> None:  # pragma: no cover
 def _update_sqlite_key(opts, conf):
     cache_version = 0
     pw, dp = "", ""
-    if _cache_file.exists():  # pragma: no cover
-        logger.debug("Found cache file %s", _cache_file)
+
+    cache_file = get_cache_file()
+
+    if cache_file.exists():  # pragma: no cover
+        logger.debug("Found cache file %s", cache_file)
         # Read cache file
-        with open(_cache_file, "r") as fh:
+        with open(cache_file, "r") as fh:
             text = fh.read()
         lines = text.splitlines()
         if lines[0].startswith("version:"):
@@ -551,9 +578,7 @@ def _update_sqlite_key(opts, conf):
         conf["dp"] = dp
 
 
-def _get_rb6_config(
-    pioneer_prog_dir: Path, pioneer_app_dir: Path, dirname: str = ""
-) -> dict:
+def _get_rb6_config(pioneer_prog_dir: Path, pioneer_app_dir: Path, dirname: str = "") -> dict:
     """Get the program configuration for Rekordbox v6.x.x."""
     major_version = 6
     conf = _get_rb_config(pioneer_prog_dir, pioneer_app_dir, major_version, dirname)
@@ -571,9 +596,7 @@ def _get_rb6_config(
     return conf
 
 
-def _get_rb7_config(
-    pioneer_prog_dir: Path, pioneer_app_dir: Path, dirname: str = ""
-) -> dict:
+def _get_rb7_config(pioneer_prog_dir: Path, pioneer_app_dir: Path, dirname: str = "") -> dict:
     """Get the program configuration for Rekordbox v7.x.x."""
     major_version = 7
     conf = _get_rb_config(pioneer_prog_dir, pioneer_app_dir, major_version, dirname)
@@ -715,27 +738,21 @@ def update_config(
 
     # Update Rekordbox 5 config
     try:
-        conf = _get_rb5_config(
-            pioneer_install_dir, pioneer_app_dir, rb5_install_dirname
-        )
+        conf = _get_rb5_config(pioneer_install_dir, pioneer_app_dir, rb5_install_dirname)
         __config__["rekordbox5"].update(conf)
     except FileNotFoundError as e:
         logger.info(e)
 
     # Update Rekordbox 6 config
     try:
-        conf = _get_rb6_config(
-            pioneer_install_dir, pioneer_app_dir, rb6_install_dirname
-        )
+        conf = _get_rb6_config(pioneer_install_dir, pioneer_app_dir, rb6_install_dirname)
         __config__["rekordbox6"].update(conf)
     except FileNotFoundError as e:
         logger.info(e)
 
     # Update Rekordbox 7 config
     try:
-        conf = _get_rb7_config(
-            pioneer_install_dir, pioneer_app_dir, rb7_install_dirname
-        )
+        conf = _get_rb7_config(pioneer_install_dir, pioneer_app_dir, rb7_install_dirname)
         __config__["rekordbox7"].update(conf)
     except FileNotFoundError as e:
         logger.info(e)

pyrekordbox/db6/database.py

@@ -27,12 +27,16 @@ try:
     from sqlcipher3 import dbapi2 as sqlite3  # noqa
 
     _sqlcipher_available = True
-except ImportError:
+except ImportError:  # pragma: no cover
     import sqlite3
 
     _sqlcipher_available = False
 
 MAX_VERSION = "6.6.5"
+SPECIAL_PLAYLIST_IDS = [
+    "100000",  # Cloud Library Sync
+    "200000",  # CUE Analysis Playlist
+]
 
 logger = logging.getLogger(__name__)
 
@@ -114,20 +118,16 @@ class Rekordbox6Database:
             path = rb_config.get("db_path", "")
             if not path:
                 pdir = get_config("pioneer", "install_dir")
-                raise FileNotFoundError(
-                    f"No Rekordbox v6/v7 directory found in '{pdir}'"
-                )
+                raise FileNotFoundError(f"No Rekordbox v6/v7 directory found in '{pdir}'")
         path = Path(path)
         # make sure file exists
         if not path.exists():
             raise FileNotFoundError(f"File '{path}' does not exist!")
         # Open database
         if unlock:
-            if not _sqlcipher_available:
-                raise ImportError(
-                    "Could not unlock database: 'sqlcipher3' package not found"
-                )
-            if not key:
+            if not _sqlcipher_available:  # pragma: no cover
+                raise ImportError("Could not unlock database: 'sqlcipher3' package not found")
+            if not key:  # pragma: no cover
                 try:
                     key = rb_config["dp"]
                 except KeyError:
@@ -404,17 +404,20 @@ class Rekordbox6Database:
             # Sync the updated_at values of the playlists in the DB and the XML file
             for pl in self.get_playlist():
                 plxml = self.playlist_xml.get(pl.ID)
-                if plxml is None:
-                    raise ValueError(
-                        f"Playlist {pl.ID} not found in masterPlaylists6.xml! "
-                        "Did you add it manually? "
-                        "Use the create_playlist method instead."
-                    )
-                ts = plxml["Timestamp"]
-                diff = pl.updated_at - ts
-                if abs(diff.total_seconds()) > 1:
-                    logger.debug("Updating updated_at of playlist %s in XML", pl.ID)
-                    self.playlist_xml.update(pl.ID, updated_at=pl.updated_at)
+                if plxml is not None:
+                    ts = plxml["Timestamp"]
+                    diff = pl.updated_at - ts
+                    if abs(diff.total_seconds()) > 1:
+                        logger.debug("Updating updated_at of playlist %s in XML", pl.ID)
+                        self.playlist_xml.update(pl.ID, updated_at=pl.updated_at)
+                else:
+                    # Dont warn for special playlists
+                    if pl.ID not in SPECIAL_PLAYLIST_IDS:
+                        logger.warning(
+                            f"Playlist {pl.ID} not found in masterPlaylists6.xml! "
+                            "Did you add it manually? "
+                            "Use the create_playlist method instead."
+                        )
 
             # Save the XML file if it was modified
             if self.playlist_xml.modified:
@@ -726,9 +729,7 @@ class Rekordbox6Database:
 
     # -- Database updates --------------------------------------------------------------
 
-    def generate_unused_id(
-        self, table, is_28_bit: bool = True, id_field_name: str = "ID"
-    ) -> int:
+    def generate_unused_id(self, table, is_28_bit: bool = True, id_field_name: str = "ID") -> int:
         """Generates an unused ID for the given table."""
         max_tries = 1000000
         for _ in range(max_tries):
@@ -803,20 +804,14 @@ class Rekordbox6Database:
         uuid = str(uuid4())
         id_ = str(uuid4())
         now = datetime.datetime.now()
-        nsongs = (
-            self.query(tables.DjmdSongPlaylist)
-            .filter_by(PlaylistID=playlist.ID)
-            .count()
-        )
+        nsongs = self.query(tables.DjmdSongPlaylist).filter_by(PlaylistID=playlist.ID).count()
         if track_no is not None:
             insert_at_end = False
             track_no = int(track_no)
             if track_no < 1:
                 raise ValueError("Track number must be greater than 0")
             if track_no > nsongs + 1:
-                raise ValueError(
-                    f"Track number too high, parent contains {nsongs} items"
-                )
+                raise ValueError(f"Track number too high, parent contains {nsongs} items")
         else:
             insert_at_end = True
             track_no = nsongs + 1
@@ -892,9 +887,7 @@ class Rekordbox6Database:
             playlist = self.get_playlist(ID=playlist)
         if isinstance(song, (int, str)):
             song = self.query(tables.DjmdSongPlaylist).filter_by(ID=song).one()
-        logger.info(
-            "Removing song with ID=%s from playlist with ID=%s", song.ID, playlist.ID
-        )
+        logger.info("Removing song with ID=%s from playlist with ID=%s", song.ID, playlist.ID)
         now = datetime.datetime.now()
         # Remove track from playlist
         track_no = song.TrackNo
@@ -965,11 +958,7 @@ class Rekordbox6Database:
             playlist = self.get_playlist(ID=playlist)
         if isinstance(song, (int, str)):
             song = self.query(tables.DjmdSongPlaylist).filter_by(ID=song).one()
-        nsongs = (
-            self.query(tables.DjmdSongPlaylist)
-            .filter_by(PlaylistID=playlist.ID)
-            .count()
-        )
+        nsongs = self.query(tables.DjmdSongPlaylist).filter_by(PlaylistID=playlist.ID).count()
         if new_track_no < 1:
             raise ValueError("Track number must be greater than 0")
         if new_track_no > nsongs + 1:
@@ -1019,9 +1008,7 @@ class Rekordbox6Database:
         self.registry.enable_tracking()
         self.registry.on_move(moved)
 
-    def _create_playlist(
-        self, name, seq, image_path, parent, smart_list=None, attribute=None
-    ):
+    def _create_playlist(self, name, seq, image_path, parent, smart_list=None, attribute=None):
         """Creates a new playlist object."""
         table = tables.DjmdPlaylist
         id_ = str(self.generate_unused_id(table, is_28_bit=True))
@@ -1046,9 +1033,7 @@ class Rekordbox6Database:
         else:
             # Check if parent exists and is a folder
             parent_id = parent
-            query = self.query(table.ID).filter(
-                table.ID == parent_id, table.Attribute == 1
-            )
+            query = self.query(table.ID).filter(table.ID == parent_id, table.Attribute == 1)
             if not self.query(query.exists()).scalar():
                 raise ValueError("Parent does not exist or is not a folder")
 
@@ -1107,9 +1092,7 @@ class Rekordbox6Database:
 
         # Update masterPlaylists6.xml
         if self.playlist_xml is not None:
-            self.playlist_xml.add(
-                id_, parent_id, attribute, now, lib_type=0, check_type=0
-            )
+            self.playlist_xml.add(id_, parent_id, attribute, now, lib_type=0, check_type=0)
 
         return playlist
 
@@ -1157,9 +1140,7 @@ class Rekordbox6Database:
         '123456'
         """
         logger.info("Creating playlist %s", name)
-        return self._create_playlist(
-            name, seq, image_path, parent, attribute=PlaylistType.PLAYLIST
-        )
+        return self._create_playlist(name, seq, image_path, parent, attribute=PlaylistType.PLAYLIST)
 
     def create_playlist_folder(self, name, parent=None, seq=None, image_path=None):
         """Creates a new playlist folder in the database.
@@ -1199,9 +1180,7 @@ class Rekordbox6Database:
         '123456'
         """
         logger.info("Creating playlist folder %s", name)
-        return self._create_playlist(
-            name, seq, image_path, parent, attribute=PlaylistType.FOLDER
-        )
+        return self._create_playlist(name, seq, image_path, parent, attribute=PlaylistType.FOLDER)
 
     def create_smart_playlist(
         self, name, smart_list: SmartList, parent=None, seq=None, image_path=None
@@ -1276,9 +1255,7 @@ class Rekordbox6Database:
             playlist = self.get_playlist(ID=playlist)
 
         if playlist.Attribute == 1:
-            logger.info(
-                "Deleting playlist folder '%s' with ID=%s", playlist.Name, playlist.ID
-            )
+            logger.info("Deleting playlist folder '%s' with ID=%s", playlist.Name, playlist.ID)
         else:
             logger.info("Deleting playlist '%s' with ID=%s", playlist.Name, playlist.ID)
 
@@ -1391,9 +1368,7 @@ class Rekordbox6Database:
         else:
             # Check if parent exists and is a folder
             parent_id = str(parent)
-            query = self.query(table.ID).filter(
-                table.ID == parent_id, table.Attribute == 1
-            )
+            query = self.query(table.ID).filter(table.ID == parent_id, table.Attribute == 1)
             if not self.query(query.exists()).scalar():
                 raise ValueError("Parent does not exist or is not a folder")
 
@@ -1414,9 +1389,7 @@ class Rekordbox6Database:
                 if seq < 1:
                     raise ValueError("Sequence number must be greater than 0")
                 elif seq > n + 1:
-                    raise ValueError(
-                        f"Sequence number too high, parent contains {n} items"
-                    )
+                    raise ValueError(f"Sequence number too high, parent contains {n} items")
 
             if not insert_at_end:
                 # Get all playlists with seq between old_seq and seq
@@ -1550,9 +1523,7 @@ class Rekordbox6Database:
         with self.registry.disabled():
             playlist.updated_at = now
 
-    def add_album(
-        self, name, artist=None, image_path=None, compilation=None, search_str=None
-    ):
+    def add_album(self, name, artist=None, image_path=None, compilation=None, search_str=None):
         """Adds a new album to the database.
 
         Parameters
@@ -1684,9 +1655,7 @@ class Rekordbox6Database:
 
         id_ = self.generate_unused_id(tables.DjmdArtist)
         uuid = str(uuid4())
-        artist = tables.DjmdArtist.create(
-            ID=id_, Name=name, SearchStr=search_str, UUID=uuid
-        )
+        artist = tables.DjmdArtist.create(ID=id_, Name=name, SearchStr=search_str, UUID=uuid)
         self.add(artist)
         self.flush()
         return artist
@@ -1828,9 +1797,7 @@ class Rekordbox6Database:
             raise ValueError(f"Track with path '{path}' already exists in database")
 
         id_ = self.generate_unused_id(tables.DjmdContent)
-        file_id = self.generate_unused_id(
-            tables.DjmdContent, id_field_name="rb_file_id"
-        )
+        file_id = self.generate_unused_id(tables.DjmdContent, id_field_name="rb_file_id")
         uuid = str(uuid4())
         content_link = self.get_menu_items(Name="TRACK").one()
         date_created = datetime.date.today()
@@ -1987,9 +1954,7 @@ class Rekordbox6Database:
             return AnlzFile.parse_file(path)
         return None
 
-    def update_content_path(
-        self, content, path, save=True, check_path=True, commit=True
-    ):
+    def update_content_path(self, content, path, save=True, check_path=True, commit=True):
         """Update the file path of a track in the Rekordbox v6 database.
 
         This changes the `FolderPath` entry in the ``DjmdContent`` table and the
@@ -2080,9 +2045,7 @@ class Rekordbox6Database:
             logger.debug("Committing changes to the database")
             self.commit()
 
-    def update_content_filename(
-        self, content, name, save=True, check_path=True, commit=True
-    ):
+    def update_content_filename(self, content, name, save=True, check_path=True, commit=True):
         """Update the file name of a track in the Rekordbox v6 database.
 
         This changes the `FolderPath` entry in the ``DjmdContent`` table and the

pyrekordbox/db6/smartlist.py

@@ -179,8 +179,7 @@ class Condition:
     def __post_init__(self):
         if self.property not in PROPERTIES:
             raise ValueError(
-                f"Invalid property: '{self.property}'! "
-                f"Supported properties: {PROPERTIES}"
+                f"Invalid property: '{self.property}'! Supported properties: {PROPERTIES}"
             )
 
         valid_ops = VALID_OPS[self.property]
@@ -232,9 +231,7 @@ def _get_condition_values(cond):
 class SmartList:
     """Rekordbox smart playlist XML handler."""
 
-    def __init__(
-        self, logical_operator: int = LogicalOperator.ALL, auto_update: int = 0
-    ):
+    def __init__(self, logical_operator: int = LogicalOperator.ALL, auto_update: int = 0):
         self.playlist_id: Union[int, str] = ""
         self.logical_operator: int = int(logical_operator)
         self.auto_update: int = auto_update

pyrekordbox/db6/tables.py

@@ -115,6 +115,37 @@ TABLES = [
 ]
 
 
+def datetime_to_str(value: datetime) -> str:
+    s = value.isoformat().replace("T", " ")
+    if value.tzinfo is not None:
+        # Get the timezone info (last 6 characters of the string)
+        tzinfo = s[-6:]
+        s = s[:-9] + " " + tzinfo
+    else:
+        s = s[:-3] + " +00:00"
+    return s
+
+
+def string_to_datetime(value: str) -> datetime:
+    try:
+        dt = datetime.fromisoformat(value)
+    except ValueError:
+        if len(value.strip()) > 23:
+            # Assume the format
+            # "2025-04-12 19:11:29.274 -05:00" or
+            # "2025-04-12 19:11:29.274 -05:00 (Central Daylight Time)"
+            datestr, tzinfo = value[:23], value[23:30]
+            datestr = datestr.strip()
+            tzinfo = tzinfo.strip()
+            assert re.match(r"^[+-]?\d{1,2}:\d{2}", tzinfo)
+            datestr = datestr.strip() + tzinfo
+        else:
+            datestr, tzinfo = value, ""
+        dt = datetime.fromisoformat(datestr)
+    # Convert to local timezone and return without timezone
+    return dt.astimezone().replace(tzinfo=None)
+
+
 class DateTime(TypeDecorator):
     """Custom datetime column with timezone support.
 
@@ -125,23 +156,12 @@ class DateTime(TypeDecorator):
     impl = Text
     cache_ok = True
 
-    def process_bind_param(self, value, dialect):
-        return value.isoformat().replace("T", " ")[:-3] + " +00:00"
+    def process_bind_param(self, value: datetime, dialect) -> str:
+        return datetime_to_str(value)
 
-    def process_result_value(self, value, dialect):
+    def process_result_value(self, value: str, dialect):
         if value:
-            try:
-                dt = datetime.fromisoformat(value)
-            except ValueError:
-                if len(value.strip()) > 23:
-                    datestr, tzinfo = value[:23], value[23:]
-                    datestr = datestr.strip()
-                    tzinfo = tzinfo.strip()
-                    assert re.match(r"^\+\d{2}:\d{2}$", tzinfo)
-                else:
-                    datestr, tzinfo = value, ""
-                dt = datetime.fromisoformat(datestr)
-            return dt
+            return string_to_datetime(value)
         return None
 
 
@@ -187,14 +207,14 @@ class Base(DeclarativeBase):
         return [column.key for column in inspect(cls).relationships]  # noqa
 
     @classmethod
-    def __get_keys__(cls):
+    def __get_keys__(cls):  # pragma: no cover
         """Get all attributes of the table."""
         items = cls.__dict__.items()
         keys = [k for k, v in items if not callable(v) and not k.startswith("_")]
         return keys
 
     @classmethod
-    def keys(cls):
+    def keys(cls):  # pragma: no cover
         """Returns a list of all column names including the relationships."""
         if not cls.__keys__:  # Cache the keys
             cls.__keys__ = cls.__get_keys__()
@@ -228,7 +248,7 @@ class Base(DeclarativeBase):
         """Returns a dictionary of all column names and values."""
         return {key: self.__getitem__(key) for key in self.columns()}
 
-    def pformat(self, indent="   "):
+    def pformat(self, indent="   "):  # pragma: no cover
         lines = [f"{self.__tablename__}"]
         columns = self.columns()
         w = max(len(col) for col in columns)
@@ -240,9 +260,7 @@ class Base(DeclarativeBase):
 class StatsTime:
     """Mixin class for tables that only use time statistics columns."""
 
-    created_at: Mapped[datetime] = mapped_column(
-        DateTime, nullable=False, default=datetime.now
-    )
+    created_at: Mapped[datetime] = mapped_column(DateTime, nullable=False, default=datetime.now)
     """The creation date of the table entry (from :class:`StatsTime`)."""
     updated_at: Mapped[datetime] = mapped_column(
         DateTime, nullable=False, default=datetime.now, onupdate=datetime.now
@@ -271,9 +289,7 @@ class StatsFull:
     rb_local_usn: Mapped[int] = mapped_column(BigInteger, default=None)
     """The local USN (unique sequence number) of the table entry
     (from :class:`StatsFull`)."""
-    created_at: Mapped[datetime] = mapped_column(
-        DateTime, nullable=False, default=datetime.now
-    )
+    created_at: Mapped[datetime] = mapped_column(DateTime, nullable=False, default=datetime.now)
     """The creation date of the table entry (from :class:`StatsFull`)."""
     updated_at: Mapped[datetime] = mapped_column(
         DateTime, nullable=False, default=datetime.now, onupdate=datetime.now
@@ -371,9 +387,7 @@ class ContentActiveCensor(Base, StatsFull):
 
     ID: Mapped[str] = mapped_column(VARCHAR(255), primary_key=True)
     """The ID (primary key) of the table entry."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the :class:`DjmdContent` entry this censor belongs to."""
     ActiveCensors: Mapped[str] = mapped_column(Text, default=None)
     """The active censors of the table entry."""
@@ -396,9 +410,7 @@ class ContentCue(Base, StatsFull):
 
     ID: Mapped[str] = mapped_column(VARCHAR(255), primary_key=True)
     """The ID (primary key) of the table entry."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the :class:`DjmdContent` entry this cue belongs to."""
     Cues: Mapped[str] = mapped_column(Text, default=None)
     """The cues of the table entry."""
@@ -421,9 +433,7 @@ class ContentFile(Base, StatsFull):
 
     ID: Mapped[str] = mapped_column(VARCHAR(255), primary_key=True)
     """The ID (primary key) of the table entry."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the :class:`DjmdContent` entry this file belongs to."""
     Path: Mapped[str] = mapped_column(VARCHAR(255), default=None)
     """The path of the file."""
@@ -468,9 +478,7 @@ class DjmdActiveCensor(Base, StatsFull):
 
     ID: Mapped[str] = mapped_column(VARCHAR(255), primary_key=True)
     """The ID (primary key) of the table entry."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the :class:`DjmdContent` entry this censor belongs to."""
     InMsec: Mapped[int] = mapped_column(Integer, default=None)
     """The in time of the censor (in milliseconds)."""
@@ -483,9 +491,7 @@ class DjmdActiveCensor(Base, StatsFull):
     ContentUUID: Mapped[str] = mapped_column(VARCHAR(255), default=None)
     """The UUID of the :class:`DjmdContent` entry this censor belongs to."""
 
-    Content = relationship(
-        "DjmdContent", foreign_keys=ContentID, back_populates="ActiveCensors"
-    )
+    Content = relationship("DjmdContent", foreign_keys=ContentID, back_populates="ActiveCensors")
     """The content entry this censor belongs to (links to :class:`DjmdContent`)."""
 
 
@@ -616,17 +622,11 @@ class DjmdContent(Base, StatsFull):
     """The short file name of the file corresponding to the content entry."""
     Title: Mapped[str] = mapped_column(VARCHAR(255), default=None)
     """The title of the track."""
-    ArtistID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdArtist.ID"), default=None
-    )
+    ArtistID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdArtist.ID"), default=None)
     """The ID of the :class:`DjmdArtist` entry of the artist of this track."""
-    AlbumID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdAlbum.ID"), default=None
-    )
+    AlbumID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdAlbum.ID"), default=None)
     """The ID of the :class:`DjmdAlbum` entry of the album of this track."""
-    GenreID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdGenre.ID"), default=None
-    )
+    GenreID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdGenre.ID"), default=None)
     """The ID of the :class:`DjmdGenre` entry of the genre of this track."""
     BPM: Mapped[int] = mapped_column(Integer, default=None)
     """The BPM (beats per minute) of the track."""
@@ -646,27 +646,19 @@ class DjmdContent(Base, StatsFull):
     """The rating of the track."""
     ReleaseYear: Mapped[int] = mapped_column(Integer, default=None)
     """The release year of the track."""
-    RemixerID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdArtist.ID"), default=None
-    )
+    RemixerID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdArtist.ID"), default=None)
     """The ID of the :class:`DjmdArtist` entry of the remixer of this track."""
-    LabelID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdLabel.ID"), default=None
-    )
+    LabelID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdLabel.ID"), default=None)
     """The ID of the :class:`DjmdLabel` entry of the label of this track."""
     OrgArtistID: Mapped[str] = mapped_column(
         VARCHAR(255), ForeignKey("djmdArtist.ID"), default=None
     )
     """The ID of the :class:`DjmdArtist` entry of the original artist of this track."""
-    KeyID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdKey.ID"), default=None
-    )
+    KeyID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdKey.ID"), default=None)
     """The ID of the :class:`DjmdKey` entry of the key of this track."""
     StockDate: Mapped[str] = mapped_column(VARCHAR(255), default=None)
     """The stock date of the track."""
-    ColorID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdColor.ID"), default=None
-    )
+    ColorID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdColor.ID"), default=None)
     """The ID of the :class:`DjmdColor` entry of the color of this track."""
     DJPlayCount: Mapped[str] = mapped_column(VARCHAR(255), default=None)
     """The play count of the track."""
@@ -684,9 +676,7 @@ class DjmdContent(Base, StatsFull):
     """The file size of the track."""
     DiscNo: Mapped[int] = mapped_column(Integer, default=None)
     """The number of the disc of the album of the track."""
-    ComposerID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdArtist.ID"), default=None
-    )
+    ComposerID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdArtist.ID"), default=None)
     """The ID of the :class:`DjmdArtist` entry of the composer of this track."""
     Subtitle: Mapped[str] = mapped_column(VARCHAR(255), default=None)
     """The subtitle of the track."""
@@ -718,9 +708,7 @@ class DjmdContent(Base, StatsFull):
     """The analysis updated status of the track."""
     TrackInfoUpdated: Mapped[str] = mapped_column(VARCHAR(255), default=None)
     """The track info updated status of the track."""
-    Lyricist: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdArtist.ID"), default=None
-    )
+    Lyricist: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdArtist.ID"), default=None)
     """The ID of the :class:`DjmdArtist` entry of the lyricist of this track."""
     ISRC: Mapped[str] = mapped_column(VARCHAR(255), default=None)
     """The ISRC of the track."""
@@ -787,9 +775,7 @@ class DjmdContent(Base, StatsFull):
     """The album artist entry of the track (links to :class:`DjmdArtist`)."""
     MyTags = relationship("DjmdSongMyTag", back_populates="Content")
     """The my tags of the track (links to :class:`DjmdSongMyTag`)."""
-    Cues = relationship(
-        "DjmdCue", foreign_keys="DjmdCue.ContentID", back_populates="Content"
-    )
+    Cues = relationship("DjmdCue", foreign_keys="DjmdCue.ContentID", back_populates="Content")
     """The cues of the track (links to :class:`DjmdCue`)."""
     ActiveCensors = relationship("DjmdActiveCensor", back_populates="Content")
     """The active censors of the track (links to :class:`DjmdActiveCensor`)."""
@@ -838,9 +824,7 @@ class DjmdCue(Base, StatsFull):
 
     ID: Mapped[str] = mapped_column(VARCHAR(255), primary_key=True)
     """The ID (primary key) of the table entry."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the content (:class:`DjmdContent`) containing the cue point."""
     InMsec: Mapped[int] = mapped_column(Integer, default=None)
     """The in point of the cue point in milliseconds."""
@@ -943,9 +927,7 @@ class DjmdHistory(Base, StatsFull):
     """The name of the history playlist."""
     Attribute: Mapped[int] = mapped_column(Integer, default=None)
     """The attributes of the history playlist"""
-    ParentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdHistory.ID"), default=None
-    )
+    ParentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdHistory.ID"), default=None)
     """The ID of the parent history playlist (:class:`DjmdHistory`)."""
     DateCreated: Mapped[str] = mapped_column(VARCHAR(255), default=None)
     """The date the history playlist was created."""
@@ -978,13 +960,9 @@ class DjmdSongHistory(Base, StatsFull):
 
     ID: Mapped[str] = mapped_column(VARCHAR(255), primary_key=True)
 
-    HistoryID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdHistory.ID"), default=None
-    )
+    HistoryID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdHistory.ID"), default=None)
     """The ID of the history playlist (:class:`DjmdHistory`)."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the content (:class:`DjmdContent`)."""
     TrackNo: Mapped[int] = mapped_column(Integer, default=None)
     """The track number of the song in the history playlist."""
@@ -1050,9 +1028,7 @@ class DjmdSongHotCueBanklist(Base, StatsFull):
         VARCHAR(255), ForeignKey("djmdHotCueBanklist.ID"), default=None
     )
     """The ID of the hot cue banklist (:class:`DjmdHotCueBanklist`)."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the content (:class:`DjmdContent`)."""
     TrackNo: Mapped[int] = mapped_column(Integer, default=None)
     """The track number of the hot-cue in the hot cue banklist."""
@@ -1160,9 +1136,7 @@ class DjmdMixerParam(Base, StatsFull):
 
     ID: Mapped[str] = mapped_column(VARCHAR(255), primary_key=True)
     """The ID (primary key) of the table entry."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the content (:class:`DjmdContent`)."""
     GainHigh: Mapped[int] = mapped_column(Integer, default=None)
     """The high gain of the mixer parameter."""
@@ -1243,9 +1217,7 @@ class DjmdMyTag(Base, StatsFull):
     """The name of the My-Tag list."""
     Attribute: Mapped[int] = mapped_column(Integer, default=None)
     """The attribute of the My-Tag list."""
-    ParentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdMyTag.ID"), default=None
-    )
+    ParentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdMyTag.ID"), default=None)
     """The ID of the parent My-Tag list (:class:`DjmdMyTag`)."""
 
     MyTags = relationship("DjmdSongMyTag", back_populates="MyTag")
@@ -1274,13 +1246,9 @@ class DjmdSongMyTag(Base, StatsFull):
 
     ID: Mapped[str] = mapped_column(VARCHAR(255), primary_key=True)
     """The ID (primary key) of the table entry."""
-    MyTagID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdMyTag.ID"), default=None
-    )
+    MyTagID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdMyTag.ID"), default=None)
     """The ID of the My-Tag list (links to :class:`DjmdMyTag`)."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the content this item belongs to (:class:`DjmdContent`)."""
     TrackNo: Mapped[int] = mapped_column(Integer, default=None)
     """The track number of the My-Tag item (for ordering)."""
@@ -1314,16 +1282,12 @@ class DjmdPlaylist(Base, StatsFull):
     """The path to the image of the playlist."""
     Attribute: Mapped[int] = mapped_column(Integer, default=None)
     """The attribute of the playlist."""
-    ParentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdPlaylist.ID"), default=None
-    )
+    ParentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdPlaylist.ID"), default=None)
     """The ID of the parent playlist (:class:`DjmdPlaylist`)."""
     SmartList: Mapped[str] = mapped_column(Text, default=None)
     """The smart list settings of the playlist."""
 
-    Songs = relationship(
-        "DjmdSongPlaylist", back_populates="Playlist", cascade="all, delete"
-    )
+    Songs = relationship("DjmdSongPlaylist", back_populates="Playlist", cascade="all, delete")
     """The contents of the playlist (links to :class:`DjmdSongPlaylist`)."""
     Children = relationship(
         "DjmdPlaylist",
@@ -1368,9 +1332,7 @@ class DjmdSongPlaylist(Base, StatsFull):
         VARCHAR(255), ForeignKey("djmdPlaylist.ID"), default=None
     )
     """The ID of the playlist this item is in (:class:`DjmdPlaylist`)."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the content this item belongs to (:class:`DjmdContent`)."""
     TrackNo: Mapped[int] = mapped_column(Integer, default=None)
     """The track number of the playlist item (for ordering)."""
@@ -1441,9 +1403,7 @@ class DjmdSongRelatedTracks(Base, StatsFull):
     )
     """The ID of the related tracks list this item is in
     (:class:`DjmdRelatedTracks`)."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the content this item belongs to (:class:`DjmdContent`)."""
     TrackNo: Mapped[int] = mapped_column(Integer, default=None)
     """The track number of the related tracks list item (for ordering)."""
@@ -1472,9 +1432,7 @@ class DjmdSampler(Base, StatsFull):
     """The name of the sampler list."""
     Attribute: Mapped[int] = mapped_column(Integer, default=None)
     """The attribute of the sampler list."""
-    ParentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdSampler.ID"), default=None
-    )
+    ParentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdSampler.ID"), default=None)
     """The ID of the parent sampler list (:class:`DjmdSampler`)."""
 
     Songs = relationship("DjmdSongSampler", back_populates="Sampler")
@@ -1505,13 +1463,9 @@ class DjmdSongSampler(Base, StatsFull):
 
     ID: Mapped[str] = mapped_column(VARCHAR(255), primary_key=True)
     """The ID (primary key) of the table entry."""
-    SamplerID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdSampler.ID"), default=None
-    )
+    SamplerID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdSampler.ID"), default=None)
     """The ID of the sampler list this item is in (:class:`DjmdSampler`)."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the content this item belongs to (:class:`DjmdContent`)."""
     TrackNo: Mapped[int] = mapped_column(Integer, default=None)
     """The track number of the sampler list item (for ordering)."""
@@ -1529,9 +1483,7 @@ class DjmdSongTagList(Base, StatsFull):
 
     ID: Mapped[str] = mapped_column(VARCHAR(255), primary_key=True)
     """The ID (primary key) of the table entry."""
-    ContentID: Mapped[str] = mapped_column(
-        VARCHAR(255), ForeignKey("djmdContent.ID"), default=None
-    )
+    ContentID: Mapped[str] = mapped_column(VARCHAR(255), ForeignKey("djmdContent.ID"), default=None)
     """The ID of the content this item belongs to (:class:`DjmdContent`)."""
     TrackNo: Mapped[int] = mapped_column(Integer, default=None)
     """The track number of the tag list item (for ordering)."""

pyrekordbox/rbxml.py

@@ -27,9 +27,7 @@ POSMARK_TYPE_MAPPING = bidict.bidict(
         "4": "loop",
     }
 )
-RATING_MAPPING = bidict.bidict(
-    {"0": 0, "51": 1, "102": 2, "153": 3, "204": 4, "255": 5}
-)
+RATING_MAPPING = bidict.bidict({"0": 0, "51": 1, "102": 2, "153": 3, "204": 4, "255": 5})
 NODE_KEYTYPE_MAPPING = bidict.bidict({"0": "TrackID", "1": "Location"})
 
 
@@ -273,9 +271,7 @@ class Tempo(AbstractElement):
     ATTRIBS = ["Inizio", "Bpm", "Metro", "Battito"]
     GETTERS = {"Inizio": float, "Bpm": float, "Battito": int}
 
-    def __init__(
-        self, parent=None, Inizio=0.0, Bpm=0.0, Metro="4/4", Battito=1, element=None
-    ):
+    def __init__(self, parent=None, Inizio=0.0, Bpm=0.0, Metro="4/4", Battito=1, element=None):
         super().__init__(element, parent, Inizio, Bpm, Metro, Battito)
 
     def _init(self, parent, inizio, bpm, metro, battito):
@@ -1046,13 +1042,14 @@ class RekordboxXml:
         >>> track = file.get_track(TrackID=1)
 
         """
-        if index is None and TrackID is None:
-            raise ValueError("Either index or TrackID has to be specified!")
+        if index is None and TrackID is None and Location is None:
+            raise ValueError("Either index, TrackID or Location has to be specified!")
 
         if TrackID is not None:
             el = self._collection.find(f'.//{Track.TAG}[@TrackID="{TrackID}"]')
         elif Location is not None:
-            el = self._collection.find(f'.//{Track.TAG}[@Location="{Location}"]')
+            encoded = encode_path(Location)
+            el = self._collection.find(f'.//{Track.TAG}[@Location="{encoded}"]')
         else:
             el = self._collection.find(f".//{Track.TAG}[{index + 1}]")
         return Track(element=el)
@@ -1095,10 +1092,10 @@ class RekordboxXml:
             node = node.get_playlist(name)
         return node
 
-    def _update_track_count(self):
-        """Updates the track count element."""
-        num_tracks = len(self._collection.findall(f".//{Track.TAG}"))
-        self._collection.attrib["Entries"] = str(num_tracks)
+    # def _update_track_count(self):
+    #     """Updates the track count element."""
+    #     num_tracks = len(self._collection.findall(f".//{Track.TAG}"))
+    #     self._collection.attrib["Entries"] = str(num_tracks)
 
     def _increment_track_count(self):
         """Increment the track count element."""
@@ -1264,9 +1261,7 @@ class RekordboxXml:
         num_tracks = len(self._collection.findall(f".//{Track.TAG}"))
         n = int(self._collection.attrib["Entries"])
         if n != num_tracks:
-            raise ValueError(
-                f"Track count {num_tracks} does not match number of elements {n}"
-            )
+            raise ValueError(f"Track count {num_tracks} does not match number of elements {n}")
         # Generate XML string
         return pretty_xml(self._root, indent, encoding="utf-8")
 

{pyrekordbox-0.4.0.dist-info → pyrekordbox-0.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: pyrekordbox
-Version: 0.4.0
+Version: 0.4.2
 Summary: Inofficial Python package for interacting with the library of Pioneers Rekordbox DJ software.
 Author-email: Dylan Jones <dylanljones94@gmail.com>
 License: MIT License
@@ -61,6 +61,7 @@ Provides-Extra: test
 Requires-Dist: hypothesis>=6.0.0; extra == "test"
 Requires-Dist: pytest>=6.2.0; extra == "test"
 Requires-Dist: pytest-cov; extra == "test"
+Dynamic: license-file
 
 
 <p align="center">
@@ -88,9 +89,9 @@ Pioneers Rekordbox DJ Software. It currently supports
 
 Tested Rekordbox versions: ``5.8.6 | 6.7.7 | 7.0.9``
 
-
-|⚠️| This project is still under development and might contain bugs or have breaking API changes in the future. Check the [changelog][CHANGELOG] for recent changes! |
-|----|:----------------------------------------------------------------------------------------------------------------------------------------------------------------|
+> [!WARNING]
+> This project is still under development and might contain bugs or have breaking API changes in the future.
+> Check the [changelog][CHANGELOG] for recent changes!
 
 
 ## 🔧 Installation
@@ -118,8 +119,10 @@ If this fails, it can be installed manually following the [installation guide][i
 
 [Read the full documentation on ReadTheDocs!][documentation]
 
-| ❗  | Please make sure to back up your Rekordbox collection before making changes with pyrekordbox or developing/testing new features. The backup dialog can be found under "File" > "Library" > "Backup Library" |
-|----|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+> [!CAUTION]
+> Please make sure to back up your Rekordbox collection before making changes with pyrekordbox
+> or developing/testing new features.
+> The backup dialog can be found under "File" > "Library" > "Backup Library"
 
 
 ### Configuration
@@ -174,9 +177,13 @@ can be changed via the corresponding property of the object:
 ````python
 content = db.get_content()[0]
 content.Title = "New Title"
+db.commit()
 ````
-Some fields are stored as references to other tables, for example the artist of a track.
-Check the [documentation][db6-doc] of the corresponding object for more information.
+
+> [!NOTE]
+> Some fields are stored as references to other tables, for example the artist of a track.
+> Check the [documentation][db6-doc] of the corresponding object for more information.
+
 So far only a few tables support adding or deleting entries:
 - ``DjmdContent``: Tracks
 - ``DjmdPlaylist``: Playlists/Playlist Folders

pyrekordbox-0.4.2.dist-info/RECORD

@@ -0,0 +1,25 @@
+pyrekordbox/__init__.py,sha256=hvg2dB7qhgGB6SmcRg8AION6mTGdlsThdHhsDZ9WYfs,622
+pyrekordbox/__main__.py,sha256=ogn1wEOue1RUjGA0BxmgVIphcSCkoM1jZKRND0cAVLA,6016
+pyrekordbox/_version.py,sha256=_F8vLxUxrAtC2alXNPGVa9l3P6_vLpQAzemS6QlnPGQ,511
+pyrekordbox/config.py,sha256=yKRE0N_YU68kek-7bz0vouTgoQOVMXGKLZA21ydePd0,28333
+pyrekordbox/logger.py,sha256=dq1BtXBGavuAjuc45mvjF6mOWaeZqZFzo2aBOJdJ0Ik,483
+pyrekordbox/rbxml.py,sha256=4qx7YX2UegsYQ2ETfqR-Qyus-8jQ89mer1YjEvq1WtQ,38422
+pyrekordbox/utils.py,sha256=hkYIgG5U4rzl2tjN9ESzLnf8OysEFybRQgmr6J7xq-k,4363
+pyrekordbox/anlz/__init__.py,sha256=SEVY0oPX9ohCVViUbsoOLTrBrFewTh-61qJxwXgAJKg,3155
+pyrekordbox/anlz/file.py,sha256=F6axHmprnp0j3pZkqmmp5iiJBUpqtWiAhSzlAJp2H6Y,6951
+pyrekordbox/anlz/structs.py,sha256=Lt4fkb3SAE8w146eWeWGnpgRoP6jhLMWrSMoMwPjG04,7925
+pyrekordbox/anlz/tags.py,sha256=nlPBKyRB8Z9J69bX2K8ZPQk_g1tMazKeVf2ViAqMX-c,13947
+pyrekordbox/db6/__init__.py,sha256=TZX_BPGZIkc4zSTULIc8yd_bf91MAezGtZevKNh3kZ0,856
+pyrekordbox/db6/aux_files.py,sha256=MehdQSc4iryiHvH8RfE9_9xMnD5qjRRDhTo0o0KRLw0,7592
+pyrekordbox/db6/database.py,sha256=IHEEg8X3BiQF2MMfvYg36BvL6yqYY_jpCO-ysP8tU3Q,80738
+pyrekordbox/db6/registry.py,sha256=zYq_B7INM97de7vUTxqmA4N_P53loDkBkYdzdoeSnvY,9725
+pyrekordbox/db6/smartlist.py,sha256=GG6jE0BHMtx0RHgiVRpWYuL-Ex5edTNSLSDQNiCGzK0,12170
+pyrekordbox/db6/tables.py,sha256=rQZ1qtJBtxiSrvmqGQEG61um5sf6UL5GeppFKO2p_zo,68539
+pyrekordbox/mysettings/__init__.py,sha256=6iLTQ1KIjuoq8Zt3thmkjqJSxrRVIi7BrQpxNcsQK04,706
+pyrekordbox/mysettings/file.py,sha256=JBfVe3jsmah_mGJjyC20_EqJZyJ7ftcOcCkRDKcWgv0,12671
+pyrekordbox/mysettings/structs.py,sha256=5Y1F3qTmsP1fRB39_BEHpQVxKx2DO9BytEuJUG_RNcY,8472
+pyrekordbox-0.4.2.dist-info/licenses/LICENSE,sha256=VwG9ZgC2UZnI0gTezGz1qkcAZ7sknBUQ1M62Z2nht54,1074
+pyrekordbox-0.4.2.dist-info/METADATA,sha256=XhI0TjehrWsupNOK1AEQcomb29sE2ydlb2wuU9WEXQ0,15480
+pyrekordbox-0.4.2.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
+pyrekordbox-0.4.2.dist-info/top_level.txt,sha256=bUHkyxIHZDgSB6zhYnF1o4Yf1EQlTGGIkVRq9uEtsa4,12
+pyrekordbox-0.4.2.dist-info/RECORD,,

{pyrekordbox-0.4.0.dist-info → pyrekordbox-0.4.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.0)
+Generator: setuptools (79.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pyrekordbox-0.4.0.dist-info/RECORD

@@ -1,25 +0,0 @@
-pyrekordbox/__init__.py,sha256=hvg2dB7qhgGB6SmcRg8AION6mTGdlsThdHhsDZ9WYfs,622
-pyrekordbox/__main__.py,sha256=BtyDwVSGyoURY9Cy004vRL5Tgkwt4F7eXX_GD_vVYNQ,5976
-pyrekordbox/_version.py,sha256=j90u3VVU4UrJf1fgMUhaZarHK_Do2XGYXr-vZvOFzVo,411
-pyrekordbox/config.py,sha256=_mbzXaykU184XB2hxIBkFu0jlfmen1FKjufMrsZW7o8,27314
-pyrekordbox/logger.py,sha256=dq1BtXBGavuAjuc45mvjF6mOWaeZqZFzo2aBOJdJ0Ik,483
-pyrekordbox/rbxml.py,sha256=IfFjpuzcuX5pMs7eZEuC5GDA1dXE-BgkPz9EIQmQRhU,38390
-pyrekordbox/utils.py,sha256=hkYIgG5U4rzl2tjN9ESzLnf8OysEFybRQgmr6J7xq-k,4363
-pyrekordbox/anlz/__init__.py,sha256=SEVY0oPX9ohCVViUbsoOLTrBrFewTh-61qJxwXgAJKg,3155
-pyrekordbox/anlz/file.py,sha256=F6axHmprnp0j3pZkqmmp5iiJBUpqtWiAhSzlAJp2H6Y,6951
-pyrekordbox/anlz/structs.py,sha256=Lt4fkb3SAE8w146eWeWGnpgRoP6jhLMWrSMoMwPjG04,7925
-pyrekordbox/anlz/tags.py,sha256=2JfideIkjzAnxXwSPWCi-Nb3t6waUszv_nGd6AJQZYM,14097
-pyrekordbox/db6/__init__.py,sha256=TZX_BPGZIkc4zSTULIc8yd_bf91MAezGtZevKNh3kZ0,856
-pyrekordbox/db6/aux_files.py,sha256=MehdQSc4iryiHvH8RfE9_9xMnD5qjRRDhTo0o0KRLw0,7592
-pyrekordbox/db6/database.py,sha256=Qx_prD3wF8laH7gMoJpG-iLM6l3Y_1JMkW1CSrw34Og,80960
-pyrekordbox/db6/registry.py,sha256=zYq_B7INM97de7vUTxqmA4N_P53loDkBkYdzdoeSnvY,9725
-pyrekordbox/db6/smartlist.py,sha256=gmD8koOIrzAHEiqQ90EHmx7WWZMuhrx4FO8k3r-YXeA,12204
-pyrekordbox/db6/tables.py,sha256=KDEqPVZ63VAyqUNBfBTqLp-xZ0RYLBcovs7iIUczt4M,68362
-pyrekordbox/mysettings/__init__.py,sha256=6iLTQ1KIjuoq8Zt3thmkjqJSxrRVIi7BrQpxNcsQK04,706
-pyrekordbox/mysettings/file.py,sha256=JBfVe3jsmah_mGJjyC20_EqJZyJ7ftcOcCkRDKcWgv0,12671
-pyrekordbox/mysettings/structs.py,sha256=5Y1F3qTmsP1fRB39_BEHpQVxKx2DO9BytEuJUG_RNcY,8472
-pyrekordbox-0.4.0.dist-info/LICENSE,sha256=VwG9ZgC2UZnI0gTezGz1qkcAZ7sknBUQ1M62Z2nht54,1074
-pyrekordbox-0.4.0.dist-info/METADATA,sha256=u6RWvAqSJpF0rD2Rq7inisM4YKlhFG40stdSZuzAigk,15799
-pyrekordbox-0.4.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-pyrekordbox-0.4.0.dist-info/top_level.txt,sha256=bUHkyxIHZDgSB6zhYnF1o4Yf1EQlTGGIkVRq9uEtsa4,12
-pyrekordbox-0.4.0.dist-info/RECORD,,