rekordbox-edit 0.6.0.dev13__tar.gz → 0.6.0.dev29__tar.gz

rekordbox_edit-0.6.0.dev29/.github/actions/e2e/action.yml

@@ -0,0 +1,27 @@
+name: "Run E2E Tests"
+description: "Install platform ffmpeg, set up Python, run the e2e journey suite"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Setup UV
+      uses: ./.github/actions/install
+
+    - name: Install ffmpeg (macOS)
+      if: runner.os == 'macOS'
+      shell: bash
+      run: brew install ffmpeg
+
+    - name: Install ffmpeg (Windows)
+      if: runner.os == 'Windows'
+      shell: pwsh
+      run: choco install ffmpeg -y
+
+    - name: Run e2e suite
+      shell: bash
+      env:
+        RBE_RUN_E2E: "1"
+        TZ: "UTC"
+      run: |
+        : "${RBE_DB_VERSION:?RBE_DB_VERSION must be set by the caller (matrix dimension).}"
+        uv run pytest tests/e2e --snapshot-warn-unused

{rekordbox_edit-0.6.0.dev13 → rekordbox_edit-0.6.0.dev29}/.github/workflows/ci.yml

@@ -66,16 +66,41 @@ jobs:
 
       - name: Run unit tests
         uses: ./.github/actions/test
+
+  e2e-tests:
+    name: 🎚️ E2E
+    needs: code-change
+    if: ${{ needs.code-change.outputs.should_skip != 'true' && !fromJSON(needs.code-change.outputs.paths_result || '{}').code.should_skip }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: ["macos-latest", "windows-latest"]
+        python-version: ["3.11", "3.14"]
+        rb-version: ["6.8.6"]
+    runs-on: ${{ matrix.os }}
+    env:
+      OS: ${{ matrix.os }}
+      PYTHON: ${{ matrix.python-version }}
+      RBE_DB_VERSION: ${{ matrix.rb-version }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+
+      - name: Run e2e tests
+        uses: ./.github/actions/e2e
+
   all-green:
     name: ✅ All Green
     if: always()
     needs:
       - lint
       - unit-tests
+      - e2e-tests
     runs-on: Ubuntu-latest
 
     steps:
       - uses: re-actors/alls-green@05ac9388f0aebcb5727afa17fcccfecd6f8ec5fe # release/v1
         with:
-          allowed-skips: unit-tests, lint
+          allowed-skips: unit-tests, lint, e2e-tests
           jobs: ${{ toJSON(needs) }}

{rekordbox_edit-0.6.0.dev13 → rekordbox_edit-0.6.0.dev29}/.pre-commit-config.yaml

@@ -7,9 +7,12 @@ repos:
     rev: v6.0.0
     hooks:
     -   id: trailing-whitespace
+        exclude: '^tests/e2e/__snapshots__/'
     -   id: end-of-file-fixer
+        exclude: '^tests/e2e/__snapshots__/'
     -   id: check-yaml
     -   id: check-added-large-files
+        args: [--maxkb=1024]
     -   id: check-merge-conflict
     -   id: debug-statements
     -   id: check-toml

{rekordbox_edit-0.6.0.dev13 → rekordbox_edit-0.6.0.dev29}/CHANGELOG.md

@@ -1,6 +1,71 @@
-## v0.6.0.dev13 (2026-06-09)
-
-
+## v0.6.0.dev29 (2026-06-10)
+
+
+- test(e2e): update windows snapshot with unicode representation
+- test(e2e): force utf-8 encoding of stdout
+- test(e2e): align TZ to UTC
+- test(ci): parameterize the db version as an env var
+- ci(e2e): add windows-latest to the e2e matrix
+- test: add windows snapshots for e2e journey
+- test(e2e): parameterize snapshots by fixture DB
+- Routes the two contract snapshots through SNAPSHOT_KEY (macos/windows)
+so the Windows fixture can land its own snapshot alongside the macOS
+one. Docker reuses the macOS DB and therefore the macos key.
+Renames the existing snapshot entries to the [macos] variant.
+- test: adds 6.8.6 db fixture for windows
+- test(e2e): pretty-print JSON snapshots via JSONSnapshotExtension
+- The single-line raw CLI output made snapshot diffs unreadable when a contract
+field changed. Use syrupy's JSONSnapshotExtension for the search-json test:
+the parsed payload is dumped as indented JSON to its own .json file under
+__snapshots__/test_journey/, so post-update diffs land per-field.
+- The IDs snapshot stays on AmberExtension; it's already one short line.
+- ci(e2e): add macos-latest e2e job to the matrix and require it
+- Adds a new e2e-tests job to ci.yml matrix'd over macos-latest × Python
+{3.11, 3.14}, wiring it into the all-green aggregate so branch protection
+gates on it. Windows joins in a follow-up PR once a windows master.db
+fixture exists.
+- The composite action at .github/actions/e2e/ installs ffmpeg on the runner,
+sets RBE_RUN_E2E=1, and runs pytest against tests/e2e directly.
+- test(e2e): add docker leg and make targets
+- Local e2e validation runs through a Linux container; the conftest refuses to
+run on bare macOS/Windows. `make test-e2e-docker` builds the image (Python
+3.14 + ffmpeg + uv-synced project) and runs the journey suite;
+`make test-e2e-snapshot-update` regenerates snapshots inside the container so
+the host's working tree picks them up via the volume mount.
+- `make test-e2e` runs the suite directly with uv; useful inside the container
+itself or in CI runners where the platform check passes.
+- test(e2e): add journey suite, conftest, and macOS snapshots
+- A single ordered file walks search → edit → convert against the committed
+macOS master.6.8.6.db, exercising filter narrowing, dry-run safety, stdin-pipe
+edits, unicode metadata, and the convert row-swap. Snapshots lock the JSON
+and IDs print contracts for `search`.
+- The conftest gates the suite behind RBE_RUN_E2E=1 and refuses to run on
+macOS/Windows outside CI, pointing local users at the Docker leg. The
+canonical staging path is /private/tmp/rbedit-e2e/music — macOS resolves
+/tmp through that symlink, so the DB stores the canonical form.
+- Excludes tests/e2e/__snapshots__/ from the trailing-whitespace and
+end-of-file pre-commit hooks; syrupy-generated whitespace is meaningful.
+- test(e2e): register marker, exclude from default collection, add syrupy
+- Adds the `e2e` pytest marker, sets `norecursedirs` so default `make test` runs
+do not collect the suite, and pins syrupy>=5 for snapshot assertions.
+- test: add macos 6.8.6 db fixture
+- test(e2e): rename audio fixtures to property-encoded scheme
+- Filenames now describe the audio's discriminating properties
+(NN-<codec>-<rate>-<depth-or-bitrate>[-encmode].<ext>) so each file's purpose
+is obvious in a directory listing and in test code. Codec stays in the name
+even for unambiguous extensions to keep the convention uniform and to
+disambiguate ALAC vs AAC inside .m4a.
+- Required before Phase 3 (Rekordbox import) so master.db references the new
+paths. Generator script and library table updated in gist
+https://gist.github.com/jviall/18107ca35e0e7f38cf02ba50e3b9cc77
+- test(e2e): add 10-track audio fixture for end-to-end suite
+- Synthesized sine-wave audio covering FLAC (16/24-bit), ALAC, AIFF, WAV,
+MP3 (CBR + VBR), AAC, and a unicode-tagged FLAC. Used by the e2e journey
+suite (search/edit/convert) against the committed master.db fixtures.
+- Bumps pre-commit's check-added-large-files threshold to 1 MB to admit the
+WAV fixture (563 KB at 96 kHz / 24-bit / 2 s mono).
+- Generator script and Phase 3 (Rekordbox import) instructions:
+https://gist.github.com/jviall/18107ca35e0e7f38cf02ba50e3b9cc77
 - fix(query): order results by folder, then ID, for stable output
 - feat: adds global --database-path argument
 - chore(deps): update linters to v0.0.44 (#79)

rekordbox_edit-0.6.0.dev29/Makefile

@@ -0,0 +1,36 @@
+.PHONY: test test-e2e test-e2e-docker test-e2e-snapshot-update coverage lint format typecheck install-hooks run-hooks
+
+test:
+	uv run pytest tests
+
+RBE_DB_VERSION ?= 6.8.6
+
+test-e2e:
+	RBE_DB_VERSION=$(RBE_DB_VERSION) uv run pytest tests/e2e --snapshot-warn-unused
+
+test-e2e-docker:
+	RBE_DB_VERSION=$(RBE_DB_VERSION) docker compose run --rm e2e
+
+test-e2e-snapshot-update:
+	RBE_DB_VERSION=$(RBE_DB_VERSION) docker compose run --rm e2e uv run pytest tests/e2e --snapshot-update
+
+watch:
+	uv run ptw .
+
+coverage:
+	uv run pytest tests --cov=rekordbox_edit --junitxml=.coverage/junit.xml --cov-report=term-missing --cov-report=html --cov-report=xml
+
+lint:
+	uv run ruff check --fix
+
+format:
+	uv run ruff format
+
+typecheck:
+	uv run ty check
+
+install-hooks:
+	uv run pre-commit install --hook-type pre-commit --hook-type commit-msg
+
+run-hooks:
+	uv run pre-commit run --all-files

{rekordbox_edit-0.6.0.dev13 → rekordbox_edit-0.6.0.dev29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rekordbox-edit
-Version: 0.6.0.dev13
+Version: 0.6.0.dev29
 Summary: Tools for managing and modifying a RekordBox library en-masse
 Project-URL: Homepage, https://github.com/jviall/rekordbox-edit
 Project-URL: Repository, https://github.com/jviall/rekordbox-edit

rekordbox_edit-0.6.0.dev29/docker-compose.yml

@@ -0,0 +1,14 @@
+services:
+  e2e:
+    build:
+      context: .
+      dockerfile: tests/e2e/Dockerfile
+    environment:
+      RBE_RUN_E2E: "1"
+      RBE_DB_VERSION: "${RBE_DB_VERSION:?RBE_DB_VERSION must be set (e.g. 6.8.6)}"
+      TZ: "UTC"
+    volumes:
+      # Mount the source tree so generated snapshots flow back to the host;
+      # uv.lock is read from the image's pre-built .venv at /app/.venv.
+      - .:/app
+      - /app/.venv

{rekordbox_edit-0.6.0.dev13 → rekordbox_edit-0.6.0.dev29}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rekordbox-edit"
-version = "0.6.0.dev13"
+version = "0.6.0.dev29"
 description = "Tools for managing and modifying a RekordBox library en-masse"
 authors = [{ name = "James Viall", email= "jamesviall@pm.me"}]
 license = "MIT"
@@ -31,8 +31,15 @@ dev = [
     "pytest-watcher>=0.6.3,<1",
     "callee>=0.3.1,<1",
     "ty>=0.0.1,<1",
+    "syrupy>=5,<6",
 ]
 
+[tool.pytest.ini_options]
+markers = [
+    "e2e: end-to-end tests requiring audio fixtures and RBE_RUN_E2E=1",
+]
+norecursedirs = ["tests/e2e"]
+
 [project.urls]
 Homepage = "https://github.com/jviall/rekordbox-edit"
 Repository = "https://github.com/jviall/rekordbox-edit"

{rekordbox_edit-0.6.0.dev13 → rekordbox_edit-0.6.0.dev29}/rekordbox_edit/cli/main.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 """Command line interface for rekordbox-edit."""
 
+import io
 import logging
 import sys
 
@@ -30,6 +31,12 @@ cli.add_command(convert_command)
 
 def main():
     """Entry point for the CLI."""
+    # Force UTF-8 on the standard streams so non-ASCII titles, paths, and
+    # artist names survive piping on Windows (default cp1252 mangles them to
+    # '?'). This is the in-script equivalent of running with PYTHONUTF8=1.
+    for stream in (sys.stdin, sys.stdout, sys.stderr):
+        if isinstance(stream, io.TextIOWrapper):
+            stream.reconfigure(encoding="utf-8")
     try:
         setup_logging()
         logger.debug(f"Running with input: {' '.join(sys.argv)}")

rekordbox_edit-0.6.0.dev29/tests/e2e/Dockerfile

@@ -0,0 +1,14 @@
+FROM python:3.14-slim
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends ffmpeg make ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN pip install --no-cache-dir uv
+
+WORKDIR /app
+COPY . .
+RUN uv sync --frozen
+
+ENV RBE_RUN_E2E=1
+CMD ["make", "test-e2e"]