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

pyrekordbox/db6/tables.py

@@ -5,15 +5,28 @@
 """Rekordbox 6 `master.db` SQLAlchemy table declarations."""
 
 import math
+import re
 import struct
-import numpy as np
-from enum import IntEnum
 from datetime import datetime
-from sqlalchemy import Column, Integer, VARCHAR, BigInteger, SmallInteger, Text, Float
-from sqlalchemy import ForeignKey, TypeDecorator
-from sqlalchemy.orm import DeclarativeBase, relationship, backref, mapped_column, Mapped
+from enum import IntEnum
+from typing import List
+
+import numpy as np
+from sqlalchemy import (
+    VARCHAR,
+    BigInteger,
+    Column,
+    Float,
+    ForeignKey,
+    Integer,
+    SmallInteger,
+    Text,
+    TypeDecorator,
+)
 from sqlalchemy.ext.associationproxy import association_proxy
 from sqlalchemy.inspection import inspect
+from sqlalchemy.orm import DeclarativeBase, Mapped, backref, mapped_column, relationship
+
 from .registry import RekordboxAgentRegistry
 
 __all__ = [
@@ -106,7 +119,6 @@ class DateTime(TypeDecorator):
     """Custom datetime column with timezone support.
 
     The datetime format in the database is `YYYY-MM-DD HH:MM:SS.SSS +00:00`.
-    The timezone seems to always be `+00:00` (UTC).
     This format is not supported by the `DateTime` column of SQLAlchemy 2.
     """
 
@@ -125,7 +137,7 @@ class DateTime(TypeDecorator):
                     datestr, tzinfo = value[:23], value[23:]
                     datestr = datestr.strip()
                     tzinfo = tzinfo.strip()
-                    assert tzinfo == "+00:00", tzinfo
+                    assert re.match(r"^\+\d{2}:\d{2}$", tzinfo)
                 else:
                     datestr, tzinfo = value, ""
                 dt = datetime.fromisoformat(datestr)
@@ -139,6 +151,15 @@ class PlaylistType(IntEnum):
     SMART_PLAYLIST = 4
 
 
+class FileType(IntEnum):
+    MP3 = 1
+    M4A = 4
+    FLAC = 5
+    WAV = 11
+    AIFF = 12
+    AIF = 12
+
+
 # -- Base- and Mixin classes -----------------------------------------------------------
 
 
@@ -146,6 +167,7 @@ class Base(DeclarativeBase):
     """Base class used to initialize the declarative base for all tables."""
 
     __tablename__: str
+    __keys__: List[str] = []
 
     @classmethod
     def create(cls, **kwargs):
@@ -164,13 +186,23 @@ class Base(DeclarativeBase):
         """Returns a list of all relationship names."""
         return [column.key for column in inspect(cls).relationships]  # noqa
 
+    @classmethod
+    def __get_keys__(cls):
+        """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):
+        """Returns a list of all column names including the relationships."""
+        if not cls.__keys__:  # Cache the keys
+            cls.__keys__ = cls.__get_keys__()
+        return cls.__keys__
+
     def __iter__(self):
         """Iterates over all columns and relationship names."""
-        insp = inspect(self.__class__)
-        for column in insp.c:
-            yield column.name
-        for column in insp.relationships:  # noqa
-            yield column.key
+        return iter(self.keys())
 
     def __len__(self):
         return sum(1 for _ in self.__iter__())
@@ -184,10 +216,6 @@ class Base(DeclarativeBase):
             RekordboxAgentRegistry.on_update(self, key, value)
         super().__setattr__(key, value)
 
-    def keys(self):
-        """Returns a list of all column names including the relationships."""
-        return list(self.__iter__())
-
     def values(self):
         """Returns a list of all column values including the relationships."""
         return [self.__getitem__(key) for key in self.keys()]

pyrekordbox/logger.py

@@ -20,4 +20,3 @@ logger.addHandler(sh)
 
 # Set logging level
 logger.setLevel(logging.WARNING)
-logging.root.setLevel(logging.NOTSET)

pyrekordbox/mysettings/__init__.py

@@ -4,14 +4,15 @@
 
 import re
 from pathlib import Path
+
 from . import structs
 from .file import (
     FILES,
-    SettingsFile,
-    MySettingFile,
-    MySetting2File,
-    DjmMySettingFile,
     DevSettingFile,
+    DjmMySettingFile,
+    MySetting2File,
+    MySettingFile,
+    SettingsFile,
 )
 
 RE_MYSETTING = re.compile(".*SETTING[0-9]?.DAT$")

pyrekordbox/mysettings/file.py

@@ -5,8 +5,10 @@
 """Rekordbox My-Setting file handlers."""
 
 import re
-from construct import Struct
 from collections.abc import MutableMapping
+
+from construct import Struct
+
 from . import structs
 
 # fmt: off

pyrekordbox/rbxml.py

@@ -7,10 +7,12 @@ r"""Rekordbox XML database file handler."""
 import logging
 import os.path
 import urllib.parse
+import xml.etree.cElementTree as xml
 from abc import abstractmethod
 from collections import abc
-import xml.etree.cElementTree as xml
+
 import bidict
+
 from .utils import pretty_xml
 
 logger = logging.getLogger(__name__)
@@ -658,7 +660,7 @@ class Node:
 
     @property
     def key_type(self):
-        """str: The type of key used by the playlist node"""
+        """str: The type of key used by the playlist node."""
         return NODE_KEYTYPE_MAPPING.get(self._element.attrib.get("KeyType"))
 
     @property
@@ -1280,7 +1282,7 @@ class RekordboxXml:
             The default is 3 spaces.
         """
         string = self.tostring(indent)
-        with open(path, "w") as fh:
+        with open(path, "w", encoding="utf-8") as fh:
             fh.write(string)
 
     def __repr__(self):

pyrekordbox/utils.py

@@ -6,9 +6,10 @@
 
 import os
 import warnings
-import psutil
-from xml.dom import minidom
 import xml.etree.cElementTree as xml
+from xml.dom import minidom
+
+import psutil
 
 warnings.simplefilter("always", DeprecationWarning)
 
@@ -122,7 +123,7 @@ def get_rekordbox_agent_pid(raise_exec=False):
 
 
 def pretty_xml(element, indent=None, encoding="utf-8"):
-    """Generates a formatted string of an XML element.
+    r"""Generates a formatted string of an XML element.
 
     Parameters
     ----------

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: pyrekordbox
-Version: 0.3.2
+Version: 0.4.0
 Summary: Inofficial Python package for interacting with the library of Pioneers Rekordbox DJ software.
 Author-email: Dylan Jones <dylanljones94@gmail.com>
 License: MIT License
@@ -47,19 +47,20 @@ Classifier: Topic :: Multimedia :: Sound/Audio
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: bidict >=0.21.0
-Requires-Dist: blowfish >=0.6.0
-Requires-Dist: construct >=2.10.0
-Requires-Dist: numpy >=1.19.0
+Requires-Dist: bidict>=0.21.0
+Requires-Dist: blowfish>=0.6.0
+Requires-Dist: construct>=2.10.0
+Requires-Dist: numpy>=1.19.0
 Requires-Dist: packaging
-Requires-Dist: psutil >=5.9.0
-Requires-Dist: sqlalchemy >=2.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: sqlcipher3-wheels
 Requires-Dist: frida-tools
 Requires-Dist: python-dateutil
 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'
+Requires-Dist: hypothesis>=6.0.0; extra == "test"
+Requires-Dist: pytest>=6.2.0; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
 
 
 <p align="center">
@@ -85,7 +86,7 @@ Pioneers Rekordbox DJ Software. It currently supports
 - Analysis files (ANLZ)
 - My-Setting files
 
-Tested Rekordbox versions: ``5.8.6 | 6.5.3 | 6.7.7``
+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! |
@@ -107,32 +108,10 @@ where `VERSION` is a release, tag or branch name.
 
 ### Dependencies
 
-Unlocking the new Rekordbox 6 `master.db` database file requires [SQLCipher][sqlcipher].
-Pyrekordbox makes no attempt to download/install SQLCipher, as it is a
-pure Python package - whereas the SQLCipher/sqlcipher3 installation is
-platform-dependent and can not be installed via ``pip``.
-
-#### Windows
-
-SQLCipher can be used by building the libary against an amalgamation with [sqlcipher3].
-For a detailed instruction, see the [installation guide][installation].
-
-#### MacOS
 
-For MacOS follow these steps:
-
-1) Install [Homebrew](https://brew.sh) if you do not have it on your machine.
-2) Install SQLCipher with `brew install SQLCipher`.
-3) With the python environment you are using to run pyrekordbox active execute the following:
-```shell
-git clone https://github.com/coleifer/sqlcipher3
-cd sqlcipher3
-SQLCIPHER_PATH=$(brew info sqlcipher | awk 'NR==4 {print $1; exit}'); C_INCLUDE_PATH="$SQLCIPHER_PATH"/include LIBRARY_PATH="$SQLCIPHER_PATH"/lib python setup.py build
-SQLCIPHER_PATH=$(brew info sqlcipher | awk 'NR==4 {print $1; exit}'); C_INCLUDE_PATH="$SQLCIPHER_PATH"/include LIBRARY_PATH="$SQLCIPHER_PATH"/lib python setup.py install
-```
-Make sure the `C_INCLUDE` and `LIBRARY_PATH` point to the installed SQLCipher path. It may differ on your machine.
-If you are having issues installing [sqlcipher3] on M1 Macs please refer to the
-[installation guide][installation].
+Unlocking the new Rekordbox 6 `master.db` database file requires [SQLCipher][sqlcipher].
+Pyrekordbox tries to install pre-built wheels with included sqlcipher binaries via the [sqlcipher3-wheels] package.
+If this fails, it can be installed manually following the [installation guide][installation].
 
 
 ## 🚀 Quick-Start
@@ -166,10 +145,10 @@ Alternatively the two paths can be specified in a configuration file under the s
 pyrekordbox.cfg and pyrekordbox.yaml.
 
 
-### Rekordbox 6 database
+### Rekordbox 6/7 database
 
-Rekordbox 6 now uses a SQLite database for storing the collection content.
-Unfortunatly, the new `master.db` SQLite database is encrypted using
+Rekordbox 6 and 7 use a SQLite database for storing the collection content.
+Unfortunatly, the `master.db` SQLite database is encrypted using
 [SQLCipher][sqlcipher], which means it can't be used without the encryption key.
 However, since your data is stored and used locally, the key must be present on the
 machine running Rekordbox.
@@ -199,6 +178,7 @@ content.Title = "New Title"
 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
 - ``DjmdSongPlaylist``: Songs in a playlist
 - ``DjmdAlbum``: Albums
@@ -388,7 +368,7 @@ the CI setup since it requires a working Rekordbox installation.
 
 [repo]: https://github.com/dylanljones/pyrekordbox
 [sqlcipher]: https://www.zetetic.net/sqlcipher/open-source/
-[sqlcipher3]: https://github.com/coleifer/sqlcipher3
+[sqlcipher3-wheels]: https://github.com/laggykiller/sqlcipher3
 [rekordcrate]: https://github.com/Holzhaus/rekordcrate
 [crate-digger]: https://github.com/Deep-Symmetry/crate-digger
 [supbox]: https://github.com/gabek/supbox

pyrekordbox-0.4.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+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,,

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

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

{pyrekordbox-0.3.2.dist-info → pyrekordbox-0.4.0.dist-info}/top_level.txt

@@ -1,3 +1 @@
-docs
 pyrekordbox
-tests

docs/Makefile

@@ -1,20 +0,0 @@
-# Minimal makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line, and also
-# from the environment for the first two.
-SPHINXOPTS    ?=
-SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = source
-BUILDDIR      = build
-
-# Put it first so that "make" without argument is like "make help".
-help:
-	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-
-.PHONY: help Makefile
-
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-%: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/make.bat

@@ -1,35 +0,0 @@
-@ECHO OFF
-
-pushd %~dp0
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set SOURCEDIR=source
-set BUILDDIR=build
-
-if "%1" == "" goto help
-
-%SPHINXBUILD% >NUL 2>NUL
-if errorlevel 9009 (
-	echo.
-	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
-	echo.installed, then set the SPHINXBUILD environment variable to point
-	echo.to the full path of the 'sphinx-build' executable. Alternatively you
-	echo.may add the Sphinx directory to PATH.
-	echo.
-	echo.If you don't have Sphinx installed, grab it from
-	echo.https://www.sphinx-doc.org/
-	exit /b 1
-)
-
-%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
-goto end
-
-:help
-%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
-
-:end
-popd

docs/source/_static/images/anlz_beat.svg

@@ -1,53 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg"
-     version="1.0" width="322" height="46"
-     viewBox="0 0 322 46">
-    <text x="21" y="8" font-family="Courier New, monospace" font-size="11"
-          dominant-baseline="middle" text-anchor="middle">0
-    </text>
-    <text x="61" y="8" font-family="Courier New, monospace" font-size="11"
-          dominant-baseline="middle" text-anchor="middle">1
-    </text>
-    <text x="101" y="8" font-family="Courier New, monospace" font-size="11"
-          dominant-baseline="middle" text-anchor="middle">2
-    </text>
-    <text x="141" y="8" font-family="Courier New, monospace" font-size="11"
-          dominant-baseline="middle" text-anchor="middle">3
-    </text>
-    <text x="181" y="8" font-family="Courier New, monospace" font-size="11"
-          dominant-baseline="middle" text-anchor="middle">4
-    </text>
-    <text x="221" y="8" font-family="Courier New, monospace" font-size="11"
-          dominant-baseline="middle" text-anchor="middle">5
-    </text>
-    <text x="261" y="8" font-family="Courier New, monospace" font-size="11"
-          dominant-baseline="middle" text-anchor="middle">6
-    </text>
-    <text x="301" y="8" font-family="Courier New, monospace" font-size="11"
-          dominant-baseline="middle" text-anchor="middle">7
-    </text>
-    <line x1="1" y1="15" x2="81" y2="15" stroke="#000000" stroke-width="1"/>
-    <line x1="1" y1="45" x2="81" y2="45" stroke="#000000" stroke-width="1"/>
-    <line x1="81" y1="15" x2="81" y2="45" stroke="#000000" stroke-width="1"/>
-    <line x1="1" y1="15" x2="1" y2="45" stroke="#000000" stroke-width="1"/>
-    <text font-size="18" font-family="Palatino, Georgia, Times New Roman, serif"
-          font-style="italic" x="41" y="31" text-anchor="middle"
-          dominant-baseline="middle">b
-        <tspan font-size="70%" dy="0.5ex" dominant-baseline="middle">num</tspan>
-    </text>
-    <line x1="81" y1="15" x2="161" y2="15" stroke="#000000" stroke-width="1"/>
-    <line x1="81" y1="45" x2="161" y2="45" stroke="#000000" stroke-width="1"/>
-    <line x1="161" y1="15" x2="161" y2="45" stroke="#000000" stroke-width="1"/>
-    <line x1="81" y1="15" x2="81" y2="45" stroke="#000000" stroke-width="1"/>
-    <text font-size="18" font-family="Palatino, Georgia, Times New Roman, serif"
-          font-style="italic" x="121" y="31" text-anchor="middle"
-          dominant-baseline="middle">tempo
-    </text>
-    <line x1="161" y1="15" x2="321" y2="15" stroke="#000000" stroke-width="1"/>
-    <line x1="161" y1="45" x2="321" y2="45" stroke="#000000" stroke-width="1"/>
-    <line x1="321" y1="15" x2="321" y2="45" stroke="#000000" stroke-width="1"/>
-    <line x1="161" y1="15" x2="161" y2="45" stroke="#000000" stroke-width="1"/>
-    <text font-size="18" font-family="Palatino, Georgia, Times New Roman, serif"
-          font-style="italic" x="241" y="31" text-anchor="middle"
-          dominant-baseline="middle">time
-    </text>
-</svg>