pyrekordbox 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

build/lib/pyrekordbox/db6/database.py

@@ -1,1808 +0,0 @@
-# -*- coding: utf-8 -*-
-# Author: Dylan Jones
-# Date:   2023-08-13
-
-import logging
-import datetime
-import secrets
-from uuid import uuid4
-from pathlib import Path
-from typing import Optional
-from sqlalchemy import create_engine, or_, event, MetaData
-from sqlalchemy.orm import Session
-from sqlalchemy.exc import NoResultFound
-from sqlalchemy.sql.sqltypes import DateTime, String
-from packaging import version
-from ..utils import get_rekordbox_pid
-from ..config import get_config
-from ..anlz import get_anlz_paths, read_anlz_files
-from .registry import RekordboxAgentRegistry
-from .aux_files import MasterPlaylistXml
-from .tables import DjmdContent
-from . import tables
-
-try:
-    from sqlcipher3 import dbapi2 as sqlite3  # noqa
-except ImportError:
-    import sqlite3
-
-MAX_VERSION = version.parse("6.6.5")
-
-logger = logging.getLogger(__name__)
-
-rb6_config = get_config("rekordbox6")
-
-
-class IncompatibleVersionError(Exception):
-    def __init__(self, rb_version):
-        super().__init__(
-            f"Incompatible rekordbox 6 version\n"
-            f"Your are using rekordbox {rb_version} but the key extraction only works "
-            f"for versions lower than {MAX_VERSION}.\n"
-            "Please use the `key` parameter to manually provide the database key."
-        )
-
-
-def open_rekordbox_database(path=None, key="", unlock=True, sql_driver=None):
-    """Opens a connection to the Rekordbox v6 master.db SQLite3 database.
-
-    Parameters
-    ----------
-    path : str or Path, optional
-        The path of the Rekordbox v6 database file. By default, pyrekordbox
-        automatically finds the Rekordbox v6 master.db database file.
-        This parameter is only required for opening other databases or if the
-        configuration fails.
-    key : str, optional
-        The database key. By default, pyrekordbox automatically reads the database
-        key from the Rekordbox v6 configuration file. This parameter is only required
-        if the key extraction fails.
-    unlock: bool, optional
-        Flag if the database needs to be decrypted. Set to False if you are opening
-        an unencrypted test database.
-    sql_driver : Callable, optional
-        The SQLite driver to used for opening the database. The standard ``sqlite3``
-        package is used as default driver.
-
-    Returns
-    -------
-    con : sql_driver.Connection
-        The opened Rekordbox v6 database connection.
-
-    Examples
-    --------
-    Open the Rekordbox v6 master.db database:
-
-    >>> db = open_rekordbox_database()
-
-    Open a copy of the database:
-
-    >>> db = open_rekordbox_database("path/to/master_copy.db")
-
-    Open a decrypted copy of the database:
-
-    >>> db = open_rekordbox_database("path/to/master_unlocked.db", unlock=False)
-
-    To use the ``pysqlcipher3`` package as SQLite driver, either import it as
-
-    >>> from sqlcipher3 import dbapi2 as sqlite3  # noqa
-    >>> db = open_rekordbox_database("path/to/master_copy.db")
-
-    or supply the package as driver:
-
-    >>> from sqlcipher3 import dbapi2  # noqa
-    >>> db = open_rekordbox_database("path/to/master_copy.db", sql_driver=dbapi2)
-    """
-    if not path:
-        path = rb6_config["db_path"]
-    path = Path(path)
-    if not path.exists():
-        raise FileNotFoundError(f"File '{path}' does not exist!")
-    logger.info("Opening %s", path)
-
-    # Open database
-    if sql_driver is None:
-        # Use default sqlite3 package
-        # This requires that the 'sqlite3.dll' was replaced by the 'sqlcipher.dll'
-        sql_driver = sqlite3
-    con = sql_driver.connect(str(path))
-
-    if unlock:
-        if not key:
-            ver = version.parse(rb6_config["version"])
-            if ver >= MAX_VERSION:
-                raise IncompatibleVersionError(rb6_config["version"])
-            try:
-                key = rb6_config["dp"]
-            except KeyError:
-                raise ValueError("Could not unlock database: No key found")
-            logger.info("Key: %s", key)
-        # Unlock database
-        con.execute(f"PRAGMA key='{key}'")
-
-    # Check connection
-    try:
-        con.execute("SELECT name FROM sqlite_master WHERE type='table';")
-    except sqlite3.DatabaseError as e:
-        msg = f"Opening database failed: '{e}'. Check if the database key is correct!"
-        raise sqlite3.DatabaseError(msg)
-    else:
-        logger.info("Database unlocked!")
-
-    return con
-
-
-def _parse_query_result(query, kwargs):
-    if "ID" in kwargs or "registry_id" in kwargs:
-        try:
-            query = query.one()
-        except NoResultFound:
-            return None
-    return query
-
-
-class Rekordbox6Database:
-    """Rekordbox v6 master.db database handler.
-
-    Parameters
-    ----------
-    path : str or Path, optional
-        The path of the Rekordbox v6 database file. By default, pyrekordbox
-        automatically finds the Rekordbox v6 master.db database file.
-        This parameter is only required for opening other databases or if the
-        configuration fails.
-    db_dir: str, optional
-        The path of the Rekordbox v6 database directory. By default, pyrekordbox
-        automatically finds the Rekordbox v6 database directory. Usually this is also
-        the root directory of the analysis files. This parameter is only required for
-        finding the analysis root directory if you are opening a database, that is
-        stored somewhere else.
-    key : str, optional
-        The database key. By default, pyrekordbox automatically reads the database
-        key from the Rekordbox v6 configuration file. This parameter is only required
-        if the key extraction fails.
-    unlock: bool, optional
-        Flag if the database needs to be decrypted. Set to False if you are opening
-        an unencrypted test database.
-
-    Attributes
-    ----------
-    engine : sqlalchemy.engine.Engine
-        The SQLAlchemy engine instance for the Rekordbox v6 database.
-    session : sqlalchemy.orm.Session
-        The SQLAlchemy session instance bound to the engine.
-
-    See Also
-    --------
-    pyrekordbox.db6.tables: Rekordbox v6 database table definitions
-    create_rekordbox_engine: Creates the SQLAlchemy engine for the Rekordbox v6 database
-
-    Examples
-    --------
-    Pyrekordbox automatically finds the Rekordbox v6 master.db database file and
-    opens it when initializing the object:
-
-    >>> db = Rekordbox6Database()
-
-    Use the included getters for querying the database:
-
-    >>> db.get_content()[0]
-    <DjmdContent(40110712   Title=NOISE)>
-    """
-
-    def __init__(self, path=None, db_dir="", key="", unlock=True):
-        pid = get_rekordbox_pid()
-        if pid:
-            logger.warning("Rekordbox is running!")
-
-        if not path:
-            # Get path from the RB config
-            path = rb6_config.get("db_path", "")
-            if not path:
-                pdir = get_config("pioneer", "install_dir")
-                raise FileNotFoundError(f"No Rekordbox v6 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 key:
-                ver = version.parse(rb6_config["version"])
-                if ver >= MAX_VERSION:
-                    raise IncompatibleVersionError(rb6_config["version"])
-                try:
-                    key = rb6_config["dp"]
-                except KeyError:
-                    raise ValueError("Could not unlock database: No key found")
-                logger.info("Key: %s", key)
-            # Unlock database and create engine
-            url = f"sqlite+pysqlcipher://:{key}@/{path}?"
-            engine = create_engine(url, module=sqlite3)
-        else:
-            engine = create_engine(f"sqlite:///{path}")
-
-        if not db_dir:
-            db_dir = path.parent
-        db_dir = Path(db_dir)
-        if not db_dir.exists():
-            raise FileNotFoundError(f"Database directory '{db_dir}' does not exist!")
-
-        self.engine = engine
-        self.session: Optional[Session] = None
-
-        self.registry = RekordboxAgentRegistry(self)
-        self._events = dict()
-        try:
-            self.playlist_xml = MasterPlaylistXml(db_dir=db_dir)
-        except FileNotFoundError:
-            logger.warning(f"No masterPlaylists6.xml found in {db_dir}")
-            self.playlist_xml = None
-
-        self._db_dir = db_dir
-        self._share_dir = db_dir / "share"
-
-        self.open()
-
-    @property
-    def no_autoflush(self):
-        """Creates a no-autoflush context."""
-        return self.session.no_autoflush
-
-    @property
-    def db_directory(self):
-        return self._db_dir
-
-    @property
-    def share_directory(self):
-        return self._share_dir
-
-    def open(self):
-        """Open the database by instantiating a new session using the SQLAchemy engine.
-
-        A new session instance is only created if the session was closed previously.
-
-        Examples
-        --------
-        >>> db = Rekordbox6Database()
-        >>> db.close()
-        >>> db.open()
-        """
-        if self.session is None:
-            self.session = Session(bind=self.engine)
-            self.registry.clear_buffer()
-
-    def close(self):
-        """Close the currently active session."""
-        for key in self._events:
-            self.unregister_event(key)
-        self.registry.clear_buffer()
-        self.session.close()
-        self.session = None
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        self.close()
-
-    def register_event(self, identifier, fn):
-        """Registers a session event callback.
-
-        Parameters
-        ----------
-        identifier : str
-            The identifier of the event, for example 'before_flush', 'after_commit', ...
-            See the SQLAlchemy documentation for a list of valid event identifiers.
-        fn : callable
-            The event callback method.
-        """
-        event.listen(self.session, identifier, fn)
-        self._events[identifier] = fn
-
-    def unregister_event(self, identifier):
-        """Removes an existing session event callback.
-
-        Parameters
-        ----------
-        identifier : str
-            The identifier of the event
-        """
-        fn = self._events[identifier]
-        event.remove(self.session, identifier, fn)
-
-    def query(self, *entities, **kwargs):
-        """Creates a new SQL query for the given entities.
-
-        Parameters
-        ----------
-        *entities : Base
-            The table objects for which the query is created.
-        **kwargs
-            Arbitrary keyword arguments used for creating the query.
-
-        Returns
-        -------
-        query : sqlalchemy.orm.query.Query
-            The SQLAlchemy ``Query`` object.
-
-        Examples
-        --------
-        Query the ``DjmdContent`` table
-
-        >>> db = Rekordbox6Database()
-        >>> query = db.query(DjmdContent)
-
-        Query the `Title` attribute of the ``DjmdContent`` table
-
-        >>> db = Rekordbox6Database()
-        >>> query = db.query(DjmdContent.Title)
-        """
-        return self.session.query(*entities, **kwargs)
-
-    def add(self, instance):
-        """Add an element to the Rekordbox database.
-
-        Parameters
-        ----------
-        instance : tables.Base
-            The table entry to add.
-        """
-        self.session.add(instance)
-        self.registry.on_create(instance)
-
-    def delete(self, instance):
-        """Delete an element from the Rekordbox database.
-
-        Parameters
-        ----------
-        instance : tables.Base
-            The table entry to delte.
-        """
-        self.session.delete(instance)
-        self.registry.on_delete(instance)
-
-    def get_local_usn(self):
-        """Returns the local sequence number (update count) of Rekordbox.
-
-        Any changes made to the `Djmd...` tables increments the local update count of
-        Rekordbox. The ``usn`` entry of the changed row is set to the corresponding
-        update count.
-
-        Returns
-        -------
-        usn : int
-            The value of the local update count.
-        """
-        return self.registry.get_local_update_count()
-
-    def set_local_usn(self, usn):
-        """Sets the local sequence number (update count) of Rekordbox.
-
-        Parameters
-        ----------
-        usn : int or str
-            The new update sequence number.
-        """
-        self.registry.set_local_update_count(usn)
-
-    def increment_local_usn(self, num=1):
-        """Increments the local update sequence number (update count) of Rekordbox.
-
-        Parameters
-        ----------
-        num : int, optional
-            The number of times to increment the update counter. By default, the counter
-            is incremented by 1.
-
-        Returns
-        -------
-        usn : int
-            The value of the incremented local update count.
-
-        Examples
-        --------
-        >>> db = Rekordbox6Database()
-        >>> db.get_local_usn()
-        70500
-
-        >>> db.increment_local_usn()
-        70501
-
-        >>> db.get_local_usn()
-        70501
-        """
-        return self.registry.increment_local_update_count(num)
-
-    def autoincrement_usn(self, set_row_usn=True):
-        """Auto-increments the local USN for all uncommited changes.
-
-        Parameters
-        ----------
-        set_row_usn : bool, optional
-            If True, set the ``rb_local_usn`` value of updated or added rows according
-            to the uncommited update sequence.
-
-        Returns
-        -------
-        new_usn : int
-            The new local update sequence number after applying all updates.
-
-        Examples
-        --------
-        >>> db = Rekordbox6Database()
-        >>> db.get_local_usn()
-        70500
-
-        >>> content = db.get_content().first()
-        >>> playlist = db.get_playlist().first()
-        >>> content.Title = "New Title"
-        >>> playlist.Name = "New Name"
-        >>> db.autoincrement_usn(set_row_usn=True)
-        >>> db.get_local_usn()
-        70502
-        """
-        return self.registry.autoincrement_local_update_count(set_row_usn)
-
-    def flush(self):
-        """Flushes the buffer of the SQLAlchemy session instance."""
-        self.session.flush()
-
-    def commit(self, autoinc=True):
-        """Commit the changes made to the database.
-
-        Parameters
-        ----------
-        autoinc : bool, optional
-            If True, auto-increment the local and row USN's before commiting the
-            changes made to the database.
-
-        See Also
-        --------
-        autoincrement_usn : Auto-increments the local Rekordbox USN's.
-        """
-        pid = get_rekordbox_pid()
-        if pid:
-            raise RuntimeError(
-                "Rekordbox is running. Please close Rekordbox before commiting changes."
-            )
-        if autoinc:
-            self.registry.autoincrement_local_update_count(set_row_usn=True)
-        self.session.commit()
-        self.registry.clear_buffer()
-
-        # Update the masterPlaylists6.xml file
-        if self.playlist_xml is not None:
-            # 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)
-
-            # Save the XML file if it was modified
-            if self.playlist_xml.modified:
-                self.playlist_xml.save()
-
-    def rollback(self):
-        """Rolls back the uncommited changes to the database."""
-        self.session.rollback()
-        self.registry.clear_buffer()
-
-    # -- Table queries -----------------------------------------------------------------
-
-    def get_active_censor(self, **kwargs):
-        """Creates a filtered query for the ``DjmdActiveCensor`` table."""
-        query = self.query(tables.DjmdActiveCensor).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_album(self, **kwargs):
-        """Creates a filtered query for the ``DjmdAlbum`` table."""
-        query = self.query(tables.DjmdAlbum).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_artist(self, **kwargs):
-        """Creates a filtered query for the ``DjmdArtist`` table."""
-        query = self.query(tables.DjmdArtist).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_category(self, **kwargs):
-        """Creates a filtered query for the ``DjmdCategory`` table."""
-        query = self.query(tables.DjmdCategory).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_color(self, **kwargs):
-        """Creates a filtered query for the ``DjmdColor`` table."""
-        query = self.query(tables.DjmdColor).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_content(self, **kwargs):
-        """Creates a filtered query for the ``DjmdContent`` table."""
-        query = self.query(tables.DjmdContent).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    # noinspection PyUnresolvedReferences
-    def search_content(self, text):
-        """Searches the contents of the ``DjmdContent`` table.
-
-        The search is case-insensitive and includes the following collumns of the
-        ``DjmdContent`` table:
-
-        - `Album`
-        - `Artist`
-        - `Commnt`
-        - `Composer`
-        - `Genre`
-        - `Key`
-        - `OrgArtist`
-        - `Remixer`
-
-        Parameters
-        ----------
-        text : str
-            The search text.
-
-        Returns
-        -------
-        results : list[DjmdContent]
-            The resulting content elements.
-        """
-        # Search standard columns
-        query = self.query(tables.DjmdContent).filter(
-            or_(
-                DjmdContent.Title.contains(text),
-                DjmdContent.Commnt.contains(text),
-                DjmdContent.SearchStr.contains(text),
-            )
-        )
-        results = set(query.all())
-
-        # Search artist (Artist, OrgArtist, Composer and Remixer)
-        artist_attrs = ["Artist", "OrgArtist", "Composer", "Remixer"]
-        for attr in artist_attrs:
-            query = self.query(DjmdContent).join(getattr(DjmdContent, attr))
-            results.update(query.filter(tables.DjmdArtist.Name.contains(text)).all())
-
-        # Search album
-        query = self.query(DjmdContent).join(DjmdContent.Album)
-        results.update(query.filter(tables.DjmdAlbum.Name.contains(text)).all())
-
-        # Search Genre
-        query = self.query(DjmdContent).join(DjmdContent.Genre)
-        results.update(query.filter(tables.DjmdGenre.Name.contains(text)).all())
-
-        # Search Key
-        query = self.query(DjmdContent).join(DjmdContent.Key)
-        results.update(query.filter(tables.DjmdKey.ScaleName.contains(text)).all())
-
-        results = list(results)
-        results.sort(key=lambda x: x.ID)
-        return results
-
-    def get_cue(self, **kwargs):
-        """Creates a filtered query for the ``DjmdCue`` table."""
-        query = self.query(tables.DjmdCue).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_device(self, **kwargs):
-        """Creates a filtered query for the ``DjmdDevice`` table."""
-        query = self.query(tables.DjmdDevice).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_genre(self, **kwargs):
-        """Creates a filtered query for the ``DjmdGenre`` table."""
-        query = self.query(tables.DjmdGenre).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_history(self, **kwargs):
-        """Creates a filtered query for the ``DjmdHistory`` table."""
-        query = self.query(tables.DjmdHistory).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_history_songs(self, **kwargs):
-        """Creates a filtered query for the ``DjmdSongHistory`` table."""
-        query = self.query(tables.DjmdSongHistory).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_hot_cue_banklist(self, **kwargs):
-        """Creates a filtered query for the ``DjmdHotCueBanklist`` table."""
-        query = self.query(tables.DjmdHotCueBanklist).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_hot_cue_banklist_songs(self, **kwargs):
-        """Creates a filtered query for the ``DjmdSongHotCueBanklist`` table."""
-        query = self.query(tables.DjmdSongHotCueBanklist).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_key(self, **kwargs):
-        """Creates a filtered query for the ``DjmdKey`` table."""
-        query = self.query(tables.DjmdKey).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_label(self, **kwargs):
-        """Creates a filtered query for the ``DjmdLabel`` table."""
-        query = self.query(tables.DjmdLabel).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_menu_items(self, **kwargs):
-        """Creates a filtered query for the ``DjmdMenuItems`` table."""
-        query = self.query(tables.DjmdMenuItems).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_mixer_param(self, **kwargs):
-        """Creates a filtered query for the ``DjmdMixerParam`` table."""
-        query = self.query(tables.DjmdMixerParam).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_my_tag(self, **kwargs):
-        """Creates a filtered query for the ``DjmdMyTag`` table."""
-        query = self.query(tables.DjmdMyTag).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_my_tag_songs(self, **kwargs):
-        """Creates a filtered query for the ``DjmdSongMyTag`` table."""
-        query = self.query(tables.DjmdSongMyTag).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_playlist(self, **kwargs):
-        """Creates a filtered query for the ``DjmdPlaylist`` table."""
-        query = self.query(tables.DjmdPlaylist).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_playlist_songs(self, **kwargs):
-        """Creates a filtered query for the ``DjmdSongPlaylist`` table."""
-        query = self.query(tables.DjmdSongPlaylist).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_property(self, **kwargs):
-        """Creates a filtered query for the ``DjmdProperty`` table."""
-        query = self.query(tables.DjmdProperty).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_related_tracks(self, **kwargs):
-        """Creates a filtered query for the ``DjmdRelatedTracks`` table."""
-        query = self.query(tables.DjmdRelatedTracks).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_related_tracks_songs(self, **kwargs):
-        """Creates a filtered query for the ``DjmdSongRelatedTracks`` table."""
-        query = self.query(tables.DjmdSongRelatedTracks).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_sampler(self, **kwargs):
-        """Creates a filtered query for the ``DjmdSampler`` table."""
-        query = self.query(tables.DjmdSampler).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_sampler_songs(self, **kwargs):
-        """Creates a filtered query for the ``DjmdSongSampler`` table."""
-        query = self.query(tables.DjmdSongSampler).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_tag_list_songs(self, **kwargs):
-        """Creates a filtered query for the ``DjmdSongTagList`` table."""
-        query = self.query(tables.DjmdSongTagList).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_sort(self, **kwargs):
-        """Creates a filtered query for the ``DjmdSort`` table."""
-        query = self.query(tables.DjmdSort).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_agent_registry(self, **kwargs):
-        """Creates a filtered query for the ``AgentRegistry`` table."""
-        query = self.query(tables.AgentRegistry).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_cloud_agent_registry(self, **kwargs):
-        """Creates a filtered query for the ``CloudAgentRegistry`` table."""
-        query = self.query(tables.CloudAgentRegistry).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_content_active_censor(self, **kwargs):
-        """Creates a filtered query for the ``ContentActiveCensor`` table."""
-        query = self.query(tables.ContentActiveCensor).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_content_cue(self, **kwargs):
-        """Creates a filtered query for the ``ContentCue`` table."""
-        query = self.query(tables.ContentCue).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_content_file(self, **kwargs):
-        """Creates a filtered query for the ``ContentFile`` table."""
-        query = self.query(tables.ContentFile).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_hot_cue_banklist_cue(self, **kwargs):
-        """Creates a filtered query for the ``HotCueBanklistCue`` table."""
-        query = self.query(tables.HotCueBanklistCue).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_image_file(self, **kwargs):
-        """Creates a filtered query for the ``ImageFile`` table."""
-        query = self.query(tables.ImageFile).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_setting_file(self, **kwargs):
-        """Creates a filtered query for the ``SettingFile`` table."""
-        query = self.query(tables.SettingFile).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    def get_uuid_map(self, **kwargs):
-        """Creates a filtered query for the ``UuidIDMap`` table."""
-        query = self.query(tables.UuidIDMap).filter_by(**kwargs)
-        return _parse_query_result(query, kwargs)
-
-    # -- Database updates --------------------------------------------------------------
-
-    def generate_unused_id(self, table, is_28_bit: bool = True) -> int:
-        """Generates an unused ID for the given table."""
-        max_tries = 1000000
-        for _ in range(max_tries):
-            # Generate random ID
-            buf = secrets.token_bytes(4)
-            id_ = (buf[0] << 24) + (buf[1] << 16) + (buf[2] << 8) + buf[3] >> 0
-            if is_28_bit:
-                id_ = id_ >> 4
-            if id_ < 100:
-                continue
-            # Check if ID is already used
-            query = self.query(table.ID).filter(table.ID == id_)
-            used = self.query(query.exists()).scalar()
-            if not used:
-                return id_
-
-        raise ValueError("Could not generate unused ID")
-
-    def add_to_playlist(self, playlist, content, track_no=None):
-        """Adds a track to a playlist.
-
-        Creates a new :class:`DjmdSongPlaylist` object corresponding to the given
-        content and adds it to the playlist.
-
-        Parameters
-        ----------
-        playlist : DjmdPlaylist or int or str
-            The playlist to add the track to. Can either be a :class:`DjmdPlaylist`
-            object or a playlist ID.
-        content : DjmdContent or int or str
-            The content to add to the playlist. Can either be a :class:`DjmdContent`
-            object or a content ID.
-        track_no : int, optional
-            The track number to add the content to. If not specified, the track
-            will be added to the end of the playlist.
-
-        Returns
-        -------
-        song: DjmdSongPlaylist
-            The song playlist object that was created from the content.
-
-        Raises
-        ------
-        ValueError : If the playlist is a folder or smart playlist.
-        ValueError : If the track number is less than 1 or to large.
-
-        Examples
-        --------
-        Add a track to the end of a playlist:
-
-        >>> db = Rekordbox6Database()
-        >>> cid = 12345  # Content ID
-        >>> pid = 56789  # Playlist ID
-        >>> db.add_to_playlist(pid, cid)
-        <DjmdSongPlaylist(c803dfde-2236-4659-b3d7-e57221663375)>
-
-        Add a track to the beginning of a playlist:
-
-        >>> new_song = db.add_to_playlist(pid, cid, track_no=1)
-        >>> new_song.TrackNo
-        1
-        """
-        if isinstance(playlist, (int, str)):
-            playlist = self.get_playlist(ID=playlist)
-        if isinstance(content, (int, str)):
-            content = self.get_content(ID=content)
-        # Check playlist attribute (can't be folder or smart playlist)
-        if playlist.Attribute != 0:
-            raise ValueError("Playlist must be a normal playlist")
-
-        uuid = str(uuid4())
-        id_ = str(uuid4())
-        now = datetime.datetime.now()
-        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"
-                )
-        else:
-            insert_at_end = True
-            track_no = nsongs + 1
-
-        cid = content.ID
-        pid = playlist.ID
-
-        logger.info("Adding content with ID=%s to playlist with ID=%s:", cid, pid)
-        logger.debug("Content ID:  %s", cid)
-        logger.debug("Playlist ID: %s", pid)
-        logger.debug("ID:          %s", id_)
-        logger.debug("UUID:        %s", uuid)
-        logger.debug("TrackNo:     %s", track_no)
-
-        moved = list()
-        if not insert_at_end:
-            self.registry.disable_tracking()
-            # Update track numbers higher than the removed track
-            query = (
-                self.query(tables.DjmdSongPlaylist)
-                .filter(
-                    tables.DjmdSongPlaylist.PlaylistID == playlist.ID,
-                    tables.DjmdSongPlaylist.TrackNo >= track_no,
-                )
-                .order_by(tables.DjmdSongPlaylist.TrackNo)
-            )
-            for song in query:
-                song.TrackNo += 1
-                song.updated_at = now
-                moved.append(song)
-            self.registry.enable_tracking()
-
-        # Add song to playlist
-        song = tables.DjmdSongPlaylist.create(
-            ID=id_,
-            PlaylistID=str(pid),
-            ContentID=str(cid),
-            TrackNo=track_no,
-            UUID=uuid,
-            created_at=now,
-            updated_at=now,
-        )
-        self.add(song)
-        if not insert_at_end:
-            moved.append(song)
-            self.registry.on_move(moved)
-
-        return song
-
-    def remove_from_playlist(self, playlist, song):
-        """Removes a track from a playlist.
-
-        Parameters
-        ----------
-        playlist : DjmdPlaylist or int or str
-            The playlist to remove the track from. Can either be a :class:`DjmdPlaylist`
-            object or a playlist ID.
-        song : DjmdSongPlaylist or int or str
-            The song to remove from the playlist. Can either be a
-            :class:`DjmdSongPlaylist` object or a song ID.
-
-        Examples
-        --------
-        Remove a track from a playlist:
-
-        >>> db = Rekordbox6Database()
-        >>> pid = 56789
-        >>> pl = db.get_playlist(ID=pid)
-        >>> song = pl.Songs[0]
-        >>> db.remove_from_playlist(pl, song)
-        """
-        if isinstance(playlist, (int, str)):
-            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
-        )
-        now = datetime.datetime.now()
-        # Remove track from playlist
-        track_no = song.TrackNo
-        self.delete(song)
-        self.commit()
-        # Update track numbers higher than the removed track
-        query = (
-            self.query(tables.DjmdSongPlaylist)
-            .filter(
-                tables.DjmdSongPlaylist.PlaylistID == playlist.ID,
-                tables.DjmdSongPlaylist.TrackNo > track_no,
-            )
-            .order_by(tables.DjmdSongPlaylist.TrackNo)
-        )
-        moved = list()
-        self.registry.disable_tracking()
-        for song in query:
-            song.TrackNo -= 1
-            song.updated_at = now
-            moved.append(song)
-        self.registry.enable_tracking()
-        if moved:
-            self.registry.on_move(moved)
-
-    def move_song_in_playlist(self, playlist, song, new_track_no):
-        """Sets a new track number of a song.
-
-        Also updates the track numbers of the other songs in the playlist.
-
-        Parameters
-        ----------
-        playlist : DjmdPlaylist or int or str
-            The playlist the track is in. Can either be a :class:`DjmdPlaylist`
-            object or a playlist ID.
-        song : DjmdSongPlaylist or int or str
-            The song to move inside the playlist. Can either be a
-            :class:`DjmdSongPlaylist` object or a song ID.
-        new_track_no : int
-            The new track number of the song. Must be greater than 0 and less than
-            the number of songs in the playlist.
-
-        Examples
-        --------
-        Take a playlist containing a few tracks:
-
-        >>> db = Rekordbox6Database()
-        >>> pid = 56789
-        >>> pl = db.get_playlist(ID=pid)
-        >>> songs = sorted(pl.Songs, key=lambda x: x.TrackNo)
-        >>> [s.Content.Title for s in songs]  # noqa
-        ['Demo Track 1', 'Demo Track 2', 'HORN', 'NOISE']
-
-        Move a track forward in a playlist:
-
-        >>> song = songs[2]
-        >>> db.move_song_in_playlist(pl, song, new_track_no=1)
-        >>> [s.Content.Title for s in sorted(pl.Songs, key=lambda x: x.TrackNo)]  # noqa
-        ['HORN', 'Demo Track 1', 'Demo Track 2', 'NOISE']
-
-        Move a track backward in a playlist:
-
-        >>> song = songs[1]
-        >>> db.move_song_in_playlist(pl, song, new_track_no=4)
-        >>> [s.Content.Title for s in sorted(pl.Songs, key=lambda x: x.TrackNo)]  # noqa
-        ['Demo Track 1', 'HORN', 'NOISE', 'Demo Track 2']
-        """
-        if isinstance(playlist, (int, str)):
-            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()
-        )
-        if new_track_no < 1:
-            raise ValueError("Track number must be greater than 0")
-        if new_track_no > nsongs + 1:
-            raise ValueError(f"Track number too high, parent contains {nsongs} items")
-        logger.info(
-            "Moving song with ID=%s in playlist with ID=%s to %s",
-            song.ID,
-            playlist.ID,
-            new_track_no,
-        )
-        now = datetime.datetime.now()
-        old_track_no = song.TrackNo
-
-        self.registry.disable_tracking()
-        moved = list()
-        if new_track_no > old_track_no:
-            query = (
-                self.query(tables.DjmdSongPlaylist)
-                .filter(
-                    tables.DjmdSongPlaylist.PlaylistID == playlist.ID,
-                    old_track_no < tables.DjmdSongPlaylist.TrackNo,
-                    tables.DjmdSongPlaylist.TrackNo <= new_track_no,
-                )
-                .order_by(tables.DjmdSongPlaylist.TrackNo)
-            )
-            for other_song in query:
-                other_song.TrackNo -= 1
-                other_song.updated_at = now
-                moved.append(other_song)
-        elif new_track_no < old_track_no:
-            query = self.query(tables.DjmdSongPlaylist).filter(
-                tables.DjmdSongPlaylist.PlaylistID == playlist.ID,
-                new_track_no <= tables.DjmdSongPlaylist.TrackNo,
-                tables.DjmdSongPlaylist.TrackNo < old_track_no,
-            )
-            for other_song in query:
-                other_song.TrackNo += 1
-                other_song.updated_at = now
-                moved.append(other_song)
-        else:
-            return
-
-        song.TrackNo = new_track_no
-        song.updated_at = now
-        moved.append(song)
-
-        self.registry.enable_tracking()
-        self.registry.on_move(moved)
-
-    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))
-        uuid = str(uuid4())
-        now = datetime.datetime.now()
-
-        if parent is None:
-            # If no parent is given, use root playlist
-            parent_id = "root"
-        elif isinstance(parent, tables.DjmdPlaylist):
-            # Check if parent is a folder
-            parent_id = parent.ID
-            if parent.Attribute != 1:
-                raise ValueError("Parent is not a folder")
-        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
-            )
-            if not self.query(query.exists()).scalar():
-                raise ValueError("Parent does not exist or is not a folder")
-
-        n = self.get_playlist(ParentID=parent_id).count()
-        logger.debug("Parent playlist with ID=%s contains %s items", parent_id, n)
-
-        if seq is None:
-            # New playlist is last in parents
-            seq = n + 1
-            insert_at_end = True
-        else:
-            # Check if sequence number is valid
-            insert_at_end = False
-            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")
-
-        logger.debug("ID:          %s", id_)
-        logger.debug("UUID:        %s", uuid)
-        logger.debug("Name:        %s", name)
-        logger.debug("Parent ID:   %s", parent_id)
-        logger.debug("Seq:         %s", seq)
-        logger.debug("Attribute:   %s", attribute)
-        logger.debug("Smart List:  %s", smart_list)
-        logger.debug("Image Path:  %s", image_path)
-
-        # Update seq numbers higher than the new seq number
-        if not insert_at_end:
-            query = self.query(tables.DjmdPlaylist).filter(
-                tables.DjmdPlaylist.ParentID == parent_id,
-                tables.DjmdPlaylist.Seq >= seq,
-            )
-            for pl in query:
-                pl.Seq += 1
-                self.registry.disable_tracking()
-                pl.updated_at = now
-                self.registry.enable_tracking()
-
-        # Add new playlist to database
-        # First create with name 'New playlist'
-        playlist = table.create(
-            ID=id_,
-            Seq=seq,
-            Name="New playlist",
-            ImagePath=image_path,
-            Attribute=attribute,
-            ParentID=parent_id,
-            SmartList=smart_list,
-            UUID=uuid,
-            created_at=now,
-            updated_at=now,
-        )
-        self.add(playlist)
-        # Then update with correct name for correct USN
-        playlist.Name = name
-
-        # 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
-            )
-
-        return playlist
-
-    def create_playlist(self, name, parent=None, seq=None, image_path=None):
-        """Creates a new playlist in the database.
-
-        Parameters
-        ----------
-        name : str
-            The name of the new playlist.
-        parent : DjmdPlaylist or int or str, optional
-            The parent playlist of the new playlist. If not given, the playlist will be
-            added to the root playlist. Can either be a :class:`DjmdPlaylist` object or
-            a playlist ID.
-        seq : int, optional
-            The sequence number of the new playlist. If not given, the playlist will be
-            added at the end of the parent playlist.
-        image_path : str, optional
-            The path to the image file of the new playlist.
-
-        Returns
-        -------
-        playlist : DjmdPlaylist
-            The newly created playlist.
-
-        Raises
-        ------
-        ValueError : If the parent playlist is not a folder.
-        ValueError : If the sequence number is less than 1 or to large.
-
-        Examples
-        --------
-        Create a new playlist in the root playlist:
-
-        >>> db = Rekordbox6Database()
-        >>> pl = db.create_playlist("My Playlist")
-        >>> pl.ParentID
-        'root'
-
-        Create a new playlist in a folder:
-
-        >>> folder = db.get_playlist(Name="My Folder").one()
-        >>> pl = db.create_playlist("My Playlist", parent=folder)
-        >>> pl.ParentID
-        '123456'
-        """
-        logger.info("Creating playlist %s", name)
-        return self._create_playlist(name, seq, image_path, parent, attribute=0)
-
-    def create_playlist_folder(self, name, parent=None, seq=None, image_path=None):
-        """Creates a new playlist folder in the database.
-
-        Parameters
-        ----------
-        name : str
-            The name of the new playlist folder.
-        parent : DjmdPlaylist or int or str, optional
-            The parent playlist of the new folder. If not given, the playlist will be
-            added to the root playlist. Can either be a :class:`DjmdPlaylist` object or
-            a playlist ID.
-        seq : int, optional
-            The sequence number of the new folder. If not given, the playlist will be
-            added at the end of the parent playlist.
-        image_path : str, optional
-            The path to the image file of the new playlist.
-
-        Returns
-        -------
-        playlist_folder : DjmdPlaylist
-            The newly created playlist folder.
-
-        Examples
-        --------
-        Create a new playlist folder in the root playlist:
-
-        >>> db = Rekordbox6Database()
-        >>> folder1 = db.create_playlist_folder("My Playlist Folder")
-        >>> folder1.ParentID
-        'root'
-
-        Create a new playlist folder in the other folder:
-
-        >>> folder2 = db.create_playlist("My Playlist Folder2", parent=folder1)
-        >>> folder2.ParentID
-        '123456'
-        """
-        logger.info("Creating playlist folder %s", name)
-        return self._create_playlist(name, seq, image_path, parent, attribute=1)
-
-    def delete_playlist(self, playlist):
-        """Deletes a playlist or playlist folder from the database.
-
-        Parameters
-        ----------
-        playlist : DjmdPlaylist or int or str
-            The playlist or playlist folder to delete. Can either be a
-            :class:`DjmdPlaylist` object or a playlist ID.
-
-        Examples
-        --------
-        Delete a playlist:
-
-        >>> db = Rekordbox6Database()
-        >>> pl = db.get_playlist(Name="My Playlist").one()
-        >>> db.delete_playlist(pl)
-
-        Delete a playlist folder:
-
-        >>> folder = db.get_playlist(Name="My Folder").one()
-        >>> db.delete_playlist(folder)
-        """
-        if isinstance(playlist, (int, str)):
-            playlist = self.get_playlist(ID=playlist)
-
-        if playlist.Attribute == 1:
-            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)
-
-        now = datetime.datetime.now()
-        seq = playlist.Seq
-        parent_id = playlist.ParentID
-
-        self.registry.disable_tracking()
-        # Update seq numbers higher than the deleted seq number
-        query = (
-            self.query(tables.DjmdPlaylist)
-            .filter(
-                tables.DjmdPlaylist.ParentID == parent_id,
-                tables.DjmdPlaylist.Seq > seq,
-            )
-            .order_by(tables.DjmdPlaylist.Seq)
-        )
-        moved = list()
-        for pl in query:
-            pl.Seq -= 1
-            pl.updated_at = now
-            moved.append(pl)
-        moved.append(playlist)
-
-        children = [playlist]
-        # Get all child playlist IDs
-        child_ids = list()
-        while len(children):
-            new_children = list()
-            for child in children:
-                child_ids.append(child.ID)
-                new_children.extend(list(child.Children))
-            children = new_children
-
-        # First ID in 'child_ids' is always the deleted playlist, others are children
-
-        # Remove playlist from masterPlaylists6.xml
-        if self.playlist_xml is not None:
-            for pid in child_ids:
-                self.playlist_xml.remove(pid)
-
-        # Remove playlist from database
-        self.delete(playlist)
-        self.registry.enable_tracking()
-        if len(child_ids) > 1:
-            # The playlist folder had children: on extra USN increment
-            self.registry.on_delete(child_ids[1:])
-        self.registry.on_delete(moved)
-
-    def move_playlist(self, playlist, parent=None, seq=None):
-        """Moves a playlist (folder) in the current parent folder or to a new one.
-
-        Parameters
-        ----------
-        playlist : DjmdPlaylist or int or str
-            The playlist or playlist folder to move. Can either be a
-            :class:`DjmdPlaylist` object or a playlist ID.
-        parent : DjmdPlaylist or int or str, optional
-            The new parent playlist of the playlist. If not given, the playlist will
-            be moved to `seq` in the current parent playlist. Can either be a
-            :class:`DjmdPlaylist` object or a playlist ID.
-        seq : int, optional
-            The new sequence number of the playlist. If the `parent` argument is given,
-            the playlist will be moved to `seq` in the new parent playlist or to
-            the end of the new parent folder if `seq=None`. If the `parent` argument is
-            not given, the playlist will be moved to `seq` in the current parent.
-
-        Examples
-        --------
-        Take the following playlist tree:
-
-        >>> db = Rekordbox6Database()
-        >>> playlists = db.get_playlist().order_by(tables.DjmdPlaylist.Seq)
-        >>> [pl.Name for pl in playlists]  # noqa
-        ['Folder 1', 'Folder 2', 'Playlist 1', 'Playlist 2', 'Playlist 3']
-
-        The playlists and folders above are all in the `root` plalyist folder.
-        Move a playlist in the current parent folder:
-
-        >>> pl = db.get_playlist(Name="Playlist 2").one()  # noqa
-        >>> db.move_playlist(pl, seq=2)
-        >>> playlists = db.get_playlist().order_by(tables.DjmdPlaylist.Seq)
-        >>> [pl.Name for pl in playlists]  # noqa
-        ['Folder 1', 'Playlist 2', 'Folder 2', 'Playlist 1', 'Playlist 3']
-
-        Move a playlist to a new parent folder:
-
-        >>> pl = db.get_playlist(Name="Playlist 1").one()  # noqa
-        >>> parent = db.get_playlist(Name="Folder 1").one()  # noqa
-        >>> db.move_playlist(pl, parent=parent)
-        >>> db.get_playlist(ParentID=parent.ID).all()
-        ['Playlist 1']
-        """
-        if parent is None and seq is None:
-            raise ValueError("Either parent or seq must be given")
-        if isinstance(playlist, (int, str)):
-            playlist = self.get_playlist(ID=playlist)
-
-        now = datetime.datetime.now()
-        table = tables.DjmdPlaylist
-
-        if parent is None:
-            # If no parent is given, keep the current parent
-            parent_id = playlist.ParentID
-        elif isinstance(parent, tables.DjmdPlaylist):
-            # Check if parent is a folder
-            parent_id = parent.ID
-            if parent.Attribute != 1:
-                raise ValueError("Parent is not a folder")
-        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
-            )
-            if not self.query(query.exists()).scalar():
-                raise ValueError("Parent does not exist or is not a folder")
-
-        n = self.get_playlist(ParentID=parent_id).count()
-        old_seq = playlist.Seq
-
-        if parent_id != playlist.ParentID:
-            # Move to new parent
-
-            old_parent_id = playlist.ParentID
-            if seq is None:
-                # New playlist is last in parents
-                seq = n + 1
-                insert_at_end = True
-            else:
-                # Check if sequence number is valid
-                insert_at_end = False
-                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"
-                    )
-
-            if not insert_at_end:
-                # Get all playlists with seq between old_seq and seq
-                query = (
-                    self.query(tables.DjmdPlaylist)
-                    .filter(
-                        tables.DjmdPlaylist.ParentID == parent_id,
-                        tables.DjmdPlaylist.Seq >= seq,
-                    )
-                    .order_by(tables.DjmdPlaylist.Seq)
-                )
-                other_playlists = query.all()
-            # Set seq number and update time *before* other playlists to ensure
-            # right USN increment order
-            playlist.ParentID = parent_id
-            self.registry.disable_tracking()
-            playlist.Seq = seq
-            playlist.updated_at = now
-            self.registry.enable_tracking()
-
-            if not insert_at_end:
-                # Update seq numbers higher than the new seq number in *new* parent
-                # noinspection PyUnboundLocalVariable
-                for pl in other_playlists:
-                    # Update time of other playlists are left unchanged
-                    pl.Seq += 1
-                    # Each move counts as one USN increment, so disable for update time
-                    self.registry.disable_tracking()
-                    pl.updated_at = now
-                    self.registry.enable_tracking()
-
-            # Update seq numbers higher than the old seq number in *old* parent
-            # USN is not updated here
-            self.registry.disable_tracking()
-            query = (
-                self.query(tables.DjmdPlaylist)
-                .filter(
-                    tables.DjmdPlaylist.ParentID == old_parent_id,
-                    tables.DjmdPlaylist.Seq > old_seq,
-                )
-                .order_by(tables.DjmdPlaylist.Seq)
-            )
-            for pl in query:
-                # Update time of other playlists are left unchanged
-                pl.Seq -= 1
-                pl.updated_at = now
-            self.registry.enable_tracking()
-
-        else:
-            # Keep parent, only change seq number
-
-            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")
-
-            if seq > old_seq:
-                # Get all playlists with seq between old_seq and seq
-                query = (
-                    self.query(tables.DjmdPlaylist)
-                    .filter(
-                        tables.DjmdPlaylist.ParentID == playlist.ParentID,
-                        old_seq < tables.DjmdPlaylist.Seq,
-                        tables.DjmdPlaylist.Seq <= seq,
-                    )
-                    .order_by(tables.DjmdPlaylist.Seq)
-                )
-                other_playlists = query.all()
-                delta_seq = -1
-            elif seq < old_seq:
-                query = (
-                    self.query(tables.DjmdPlaylist)
-                    .filter(
-                        tables.DjmdPlaylist.ParentID == playlist.ParentID,
-                        seq <= tables.DjmdPlaylist.Seq,
-                        tables.DjmdPlaylist.Seq < old_seq,
-                    )
-                    .order_by(tables.DjmdPlaylist.Seq)
-                )
-                other_playlists = query.all()
-                delta_seq = +1
-            else:
-                return
-
-            # Set seq number and update time *before* other playlists to ensure
-            # right USN increment order
-            playlist.Seq = seq
-            # Each move counts as one USN increment, so disable for update time
-            self.registry.disable_tracking()
-            playlist.updated_at = now
-            self.registry.enable_tracking()
-
-            # Set seq number and update time for playlists between old_seq and seq
-            for pl in other_playlists:
-                pl.Seq += delta_seq
-                # Each move counts as one USN increment, so disable for update time
-                self.registry.disable_tracking()
-                pl.updated_at = now
-                self.registry.enable_tracking()
-
-    def rename_playlist(self, playlist, name):
-        """Renames a playlist or playlist folder.
-
-        Parameters
-        ----------
-        playlist : DjmdPlaylist or int or str
-            The playlist or playlist folder to move. Can either be a
-            :class:`DjmdPlaylist` object or a playlist ID.
-        name : str
-            The new name of the playlist or playlist folder.
-
-        Examples
-        --------
-        Take the following playlist tree:
-
-        >>> db = Rekordbox6Database()
-        >>> playlists = db.get_playlist().order_by(tables.DjmdPlaylist.Seq)
-        >>> [pl.Name for pl in playlists]  # noqa
-        ['Playlist 1', 'Playlist 2']
-
-        Rename a playlist:
-
-        >>> pl = db.get_playlist(Name="Playlist 1").one()  # noqa
-        >>> db.rename_playlist(pl, name="Playlist new")
-        >>> playlists = db.get_playlist().order_by(tables.DjmdPlaylist.Seq)
-        >>> [pl.Name for pl in playlists]  # noqa
-        ['Playlist new', 'Playlist 2']
-        """
-        if isinstance(playlist, (int, str)):
-            playlist = self.get_playlist(ID=playlist)
-        now = datetime.datetime.now()
-        # Update name of playlist
-        playlist.Name = name
-        # Update update time: USN not incremented
-        self.registry.disable_tracking()
-        playlist.updated_at = now
-        self.registry.enable_tracking()
-
-    # ----------------------------------------------------------------------------------
-
-    def get_mysetting_paths(self):
-        """Returns the file paths of the local Rekordbox MySetting files.
-
-        Returns
-        -------
-        paths : list[str]
-            the file paths of the local MySetting files.
-        """
-        paths = list()
-        for item in self.get_setting_file():
-            paths.append(self._db_dir / item.Path.lstrip("/\\"))
-        return paths
-
-    def get_anlz_dir(self, content):
-        """Returns the directory path containing the ANLZ analysis files of a track.
-
-        Parameters
-        ----------
-        content : DjmdContent or int or str
-            The content corresponding to a track in the Rekordbox v6 database.
-            If an integer is passed the database is queried for the ``DjmdContent``
-            entry.
-
-        Returns
-        -------
-        anlz_dir : Path
-            The path of the directory containing the analysis files for the content.
-        """
-        if isinstance(content, (int, str)):
-            content = self.get_content(ID=content)
-
-        dat_path = Path(content.AnalysisDataPath.strip("\\/"))
-        path = self._share_dir / dat_path.parent
-        return path
-
-    def get_anlz_paths(self, content):
-        """Returns all existing ANLZ analysis file paths of a track.
-
-        Parameters
-        ----------
-        content : DjmdContent or int or str
-            The content corresponding to a track in the Rekordbox v6 database.
-            If an integer is passed the database is queried for the ``DjmdContent``
-            entry.
-
-        Returns
-        -------
-        anlz_paths : dict[str, Path]
-            The analysis file paths for the content as dictionary. The keys of the
-            dictionary are the file types ("DAT", "EXT" or "EX2").
-        """
-        root = self.get_anlz_dir(content)
-        return get_anlz_paths(root)
-
-    def read_anlz_files(self, content):
-        """Reads all existing ANLZ analysis files of a track.
-
-        Parameters
-        ----------
-        content : DjmdContent or int or str
-            The content corresponding to a track in the Rekordbox v6 database.
-            If an integer is passed the database is queried for the ``DjmdContent``
-            entry.
-
-        Returns
-        -------
-        anlz_files : dict[str, AnlzFile]
-            The analysis files for the content as dictionary. The keys of the
-            dictionary are the file paths.
-        """
-        root = self.get_anlz_dir(content)
-        return read_anlz_files(root)
-
-    def update_content_path(self, content, path, save=True, check_path=True):
-        """Update the file path of a track in the Rekordbox v6 database.
-
-        This changes the `FolderPath` entry in the ``DjmdContent`` table and the
-        path tag (PPTH) of the corresponding ANLZ analysis files.
-
-        Parameters
-        ----------
-        content : DjmdContent or int or str
-            The ``DjmdContent`` element to change. If an integer is passed the database
-            is queried for the content.
-        path : str or Path
-            The new file path of the database entry.
-        save : bool, optional
-            If True, the changes made are written to disc.
-        check_path : bool, optional
-            If True, raise an assertion error if the given file path does not exist.
-
-        Examples
-        --------
-        If, for example, the file `NOISE.wav` was moved up a few directories
-        (from `.../Sampler/OSC_SAMPLER/PRESET ONESHOT/` to `.../Sampler/`) the file
-        could no longer be opened in Rekordbox, since the database still contains the
-        old file path:
-
-        >>> db = Rekordbox6Database()
-        >>> cont = db.get_content()[0]
-        >>> cont.FolderPath
-        C:/Music/PioneerDJ/Sampler/OSC_SAMPLER/PRESET ONESHOT/NOISE.wav
-
-        Updating the path changes the database entry
-
-        >>> new_path = "C:/Music/PioneerDJ/Sampler/PRESET ONESHOT/NOISE.wav"
-        >>> db.update_content_path(cont, new_path)
-        >>> cont.FolderPath
-        C:/Music/PioneerDJ/Sampler/PRESET ONESHOT/NOISE.wav
-
-        and updates the file path in the corresponding ANLZ analysis files:
-
-        >>> files = self.read_anlz_files(cont.ID)
-        >>> file = list(files.values())[0]
-        >>> file.get("path")
-        C:/Music/PioneerDJ/Sampler/PRESET ONESHOT/NOISE.wav
-
-        """
-        if isinstance(content, (int, str)):
-            content = self.get_content(ID=content)
-        cid = content.ID
-
-        path = Path(path)
-        # Check and format path (the database and ANLZ files use "/" as path delimiter)
-        if check_path:
-            assert path.exists()
-        path = str(path).replace("\\", "/")
-        old_path = content.FolderPath
-        logger.info("Replacing '%s' with '%s' of content [%s]", old_path, path, cid)
-
-        # Update path in ANLZ files
-        anlz_files = self.read_anlz_files(cid)
-        for anlz_path, anlz in anlz_files.items():
-            logger.debug("Updating path of %s: %s", anlz_path, path)
-            anlz.set_path(path)
-
-        # Update path in database (DjmdContent)
-        logger.debug("Updating database file path: %s", path)
-        content.FolderPath = path
-
-        if save:
-            logger.debug("Saving changes")
-            # Save ANLZ files
-            for anlz_path, anlz in anlz_files.items():
-                anlz.save(anlz_path)
-            # Commit database changes
-            self.commit()
-
-    def update_content_filename(self, content, name, save=True, check_path=True):
-        """Update the file name of a track in the Rekordbox v6 database.
-
-        This changes the `FolderPath` entry in the ``DjmdContent`` table and the
-        path tag (PPTH) of the corresponding ANLZ analysis files.
-
-        Parameters
-        ----------
-        content : DjmdContent or int or str
-            The ``DjmdContent`` element to change. If an integer is passed the database
-            is queried for the content.
-        name : str
-            The new file name of the database entry.
-        save : bool, optional
-            If True, the changes made are written to disc.
-        check_path : bool, optional
-            If True, raise an assertion error if the new file path does not exist.
-
-        See Also
-        --------
-        update_content_path: Update the file path of a track in the Rekordbox database.
-
-        Examples
-        --------
-        Updating the file name changes the database entry
-
-        >>> db = Rekordbox6Database()
-        >>> cont = db.get_content()[0]
-        >>> cont.FolderPath
-        C:/Music/PioneerDJ/Sampler/OSC_SAMPLER/PRESET ONESHOT/NOISE.wav
-
-        >>> new_name = "noise"
-        >>> db.update_content_filename(cont, new_name)
-        >>> cont.FolderPath
-        C:/Music/PioneerDJ/Sampler/OSC_SAMPLER/PRESET ONESHOT/noise.wav
-
-        and updates the file path in the corresponding ANLZ analysis files:
-
-        >>> files = self.read_anlz_files(cont.ID)
-        >>> file = list(files.values())[0]
-        >>> cont.FolderPath == file.get("path")
-        True
-
-        """
-        if isinstance(content, (int, str)):
-            content = self.get_content(ID=content)
-
-        old_path = Path(content.FolderPath)
-        ext = old_path.suffix
-        new_path = old_path.parent / name
-        new_path = new_path.with_suffix(ext)
-        self.update_content_path(content, new_path, save, check_path)
-
-    def to_dict(self, verbose=False):
-        """Convert the database to a dictionary.
-
-        Parameters
-        ----------
-        verbose: bool, optional
-            If True, print the name of the table that is currently converted.
-
-        Returns
-        -------
-        dict
-            A dictionary containing the database tables as keys and the table data as
-            a list of dicts.
-        """
-        data = dict()
-        for table_name in tables.__all__:
-            if table_name.startswith("Stats") or table_name == "Base":
-                continue
-            if verbose:
-                print(f"Converting table: {table_name}")
-            table = getattr(tables, table_name)
-            columns = table.columns()
-            table_data = list()
-            for row in self.query(table).all():
-                table_data.append({column: row[column] for column in columns})
-            data[table_name] = table_data
-        return data
-
-    def to_json(self, file, indent=4, sort_keys=True, verbose=False):
-        """Convert the database to a JSON file."""
-        import json
-
-        def json_serial(obj):
-            if isinstance(obj, (datetime.datetime, datetime.date)):
-                return obj.isoformat()
-            raise TypeError(f"Type {type(obj)} not serializable")
-
-        data = self.to_dict(verbose=verbose)
-        with open(file, "w") as fp:
-            json.dump(data, fp, indent=indent, sort_keys=sort_keys, default=json_serial)
-
-    def copy_unlocked(self, output_file):
-        src_engine = self.engine
-        src_metadata = MetaData()
-        exclude_tables = ("sqlite_master", "sqlite_sequence", "sqlite_temp_master")
-
-        dst_engine = create_engine(f"sqlite:///{output_file}")
-        dst_metadata = MetaData()
-
-        @event.listens_for(src_metadata, "column_reflect")
-        def genericize_datatypes(inspector, tablename, column_dict):
-            type_ = column_dict["type"].as_generic(allow_nulltype=True)
-            if isinstance(type_, DateTime):
-                type_ = String
-            column_dict["type"] = type_
-
-        src_conn = src_engine.connect()
-        dst_conn = dst_engine.connect()
-        dst_metadata.reflect(bind=dst_engine)
-        # drop all tables in target database
-        for table in reversed(dst_metadata.sorted_tables):
-            if table.name not in exclude_tables:
-                print("dropping table =", table.name)
-                table.drop(bind=dst_engine)
-        # Delete all data in target database
-        for table in reversed(dst_metadata.sorted_tables):
-            table.delete()
-        dst_metadata.clear()
-        dst_metadata.reflect(bind=dst_engine)
-        src_metadata.reflect(bind=src_engine)
-        # create all tables in target database
-        for table in src_metadata.sorted_tables:
-            if table.name not in exclude_tables:
-                table.create(bind=dst_engine)
-        # refresh metadata before you can copy data
-        dst_metadata.clear()
-        dst_metadata.reflect(bind=dst_engine)
-        # Copy all data from src to target
-        print("Copying data...")
-        string = "\rCopying table {name}: Inserting row {row}"
-        index = 0
-        for table in dst_metadata.sorted_tables:
-            src_table = src_metadata.tables[table.name]
-            stmt = table.insert()
-            for index, row in enumerate(src_conn.execute(src_table.select())):
-                print(string.format(name=table.name, row=index), end="", flush=True)
-                dst_conn.execute(stmt.values(row))
-            print(f"\rCopying table {table.name}: Inserted {index} rows", flush=True)
-
-        dst_conn.commit()