redeflacue 0.1.0__tar.gz

redeflacue-0.1.0/.editorconfig

@@ -0,0 +1,19 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.{yml,yaml,toml,json}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+# Encoding fixtures must keep their legacy byte encoding.
+[tests/fixtures/*windows1251*]
+charset = unset

redeflacue-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: py${{ matrix.python-version }} / ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0 # hatch-vcs derives the version from git tags
+
+      - uses: astral-sh/setup-uv@v10.3.0
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }} # exported as UV_PYTHON
+
+      - name: Install sox (Linux)
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y sox libsox-fmt-all
+
+      - name: Install sox (macOS)
+        if: runner.os == 'macOS'
+        run: brew install sox
+
+      - run: uv sync --frozen
+      - run: uv run ruff check
+      - run: uv run ruff format --check
+      - run: uv run mypy src
+      - run: uv run pytest --cov --cov-report=xml
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v7
+        with:
+          files: coverage.xml
+          flags: py${{ matrix.python-version }}-${{ matrix.os }}
+          fail_ci_if_error: false
+          # Required for private repositories.
+          token: ${{ secrets.CODECOV_TOKEN }}

redeflacue-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,31 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  pypi:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    # PyPI trusted publisher: r8/redeflacue, release.yml, environment pypi.
+    environment:
+      name: pypi
+      url: https://pypi.org/p/redeflacue
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0 # hatch-vcs derives the version from the pushed tag
+
+      - uses: astral-sh/setup-uv@v10.3.0
+
+      - run: uv build
+
+      - name: Smoke-test the wheel
+        run: uv run --isolated --no-project --with dist/*.whl redeflacue --version
+
+      - run: uv publish --trusted-publishing always

redeflacue-0.1.0/.gitignore

@@ -0,0 +1,27 @@
+# Byte-compiled / cache
+__pycache__/
+*.py[cod]
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+
+# Environments
+.venv/
+venv/
+.env
+
+# Build / dist
+build/
+dist/
+*.egg-info/
+
+# Coverage
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store

redeflacue-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.17.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: local
+    hooks:
+      # Use the project environment because deflacue has no type stubs.
+      - id: mypy
+        name: mypy
+        entry: uv run mypy src
+        language: system
+        types: [python]
+        pass_filenames: false

redeflacue-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

redeflacue-0.1.0/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## [Unreleased]
+
+## [0.1.0] - 2026-10-10
+
+### Added
+
+- deflacue-compatible CLI (`redeflacue`, `python -m redeflacue`) with these flags:
+  `-d/--dest`, `-e/--encoding`, `-r/--recursive`, `--dry-run`, `-v/--verbose`; plus
+  `--version`.
+- Library API: `plan_extractions()`, `build_sox_command()`, `Extraction`.
+
+### Fixed
+
+- Track boundaries on non-44.1 kHz FLAC images. Cut points are passed to SoX as times instead of
+  44.1 kHz sample counts.
+
+[Unreleased]: https://github.com/r8/redeflacue/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/r8/redeflacue/releases/tag/v0.1.0

redeflacue-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Sergey Storchay
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

redeflacue-0.1.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.5
+Name: redeflacue
+Version: 0.1.0
+Summary: CUE + FLAC splitter that handles non-44.1 kHz audio
+Project-URL: Homepage, https://github.com/r8/redeflacue
+Project-URL: Issues, https://github.com/r8/redeflacue/issues
+Project-URL: Changelog, https://github.com/r8/redeflacue/blob/main/CHANGELOG.md
+Author-email: Sergey Storchay <r8@r8.com.ua>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Keywords: audio,cue,deflacue,flac,hi-res,sox,split
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Conversion
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: deflacue>=2.0.1
+Description-Content-Type: text/markdown
+
+# redeflacue
+
+`redeflacue` splits CUE + FLAC album images without assuming a 44.1 kHz sample rate.
+
+It uses [deflacue](https://github.com/idlesign/deflacue) to parse cue sheets and keeps its
+command-line interface, output layout, and tag mapping. The difference is in the arguments sent
+to SoX: cue positions are passed as times instead of sample counts. This avoids misplaced track
+boundaries on 96 kHz, 192 kHz, and other non-44.1 kHz files.
+
+## Install
+
+Install the package with `uv` or `pipx`:
+
+```sh
+uv tool install redeflacue
+# or
+pipx install redeflacue
+```
+
+SoX is also required:
+
+```sh
+sudo apt install sox libsox-fmt-all  # Debian / Ubuntu
+brew install sox                     # macOS
+```
+
+## Usage
+
+```sh
+# Split .cue files in a directory.
+redeflacue /home/me/cues/
+
+# Read Windows-1251 cue sheets recursively and choose an output directory.
+redeflacue -e windows-1251 -r -d /mnt/library/ /home/me/cues/
+
+# Print the SoX commands without running them.
+redeflacue --dry-run -v /home/me/cues/
+```
+
+| Flag | Description |
+| --- | --- |
+| `-d, --dest DIR` | Output root; defaults to `deflacue/` beside each cue sheet |
+| `-e, --encoding ENC` | Cue-sheet encoding, such as `windows-1251` |
+| `-r, --recursive` | Search subdirectories |
+| `--dry-run` | Print planned work without running SoX |
+| `-v, --verbose` | Print each SoX command |
+| `--version` | Print the version |
+
+Tracks are written to:
+
+```text
+<destination>/<performer>/<date - album>/<track number - title>.flac
+```
+
+The cue sheet supplies the track number, title, artist, album, genre, date, ISRC, and
+description tags.
+
+## Sample-rate fix
+
+deflacue stores cue positions as 44.1 kHz sample offsets and passes them to `sox trim` as sample
+counts. SoX interprets those counts using the input file's actual sample rate, so boundaries are
+wrong when that rate is not 44.1 kHz.
+
+A cue position is based on 75 frames per second. Because deflacue uses 588 samples per cue frame
+(`44100 / 75`), dividing its stored offset by 44100 recovers the cue time. redeflacue sends that
+time to SoX as `HH:MM:SS.ssssss`, which works independently of the input rate.
+
+## Python API
+
+```python
+from pathlib import Path
+
+from deflacue.parser import CueParser
+from redeflacue import build_sox_command, plan_extractions
+
+cue = CueParser.from_file(fpath=Path("album.cue")).run()
+for extraction in plan_extractions(cue, Path("."), Path("out")):
+    print(
+        build_sox_command(
+            extraction.src,
+            extraction.dst,
+            extraction.start_s,
+            extraction.end_s,
+            extraction.tags,
+        )
+    )
+```
+
+## Development
+
+```sh
+git clone https://github.com/r8/redeflacue.git
+cd redeflacue
+uv sync
+uv run pytest
+uv run ruff check
+uv run ruff format --check
+uv run mypy src
+```
+
+Integration tests are skipped when SoX is not installed.
+
+## License
+
+BSD-3-Clause. Cue-sheet parsing is provided by Igor Starikov's BSD-licensed
+[deflacue](https://github.com/idlesign/deflacue).

redeflacue-0.1.0/README.md

@@ -0,0 +1,106 @@
+# redeflacue
+
+`redeflacue` splits CUE + FLAC album images without assuming a 44.1 kHz sample rate.
+
+It uses [deflacue](https://github.com/idlesign/deflacue) to parse cue sheets and keeps its
+command-line interface, output layout, and tag mapping. The difference is in the arguments sent
+to SoX: cue positions are passed as times instead of sample counts. This avoids misplaced track
+boundaries on 96 kHz, 192 kHz, and other non-44.1 kHz files.
+
+## Install
+
+Install the package with `uv` or `pipx`:
+
+```sh
+uv tool install redeflacue
+# or
+pipx install redeflacue
+```
+
+SoX is also required:
+
+```sh
+sudo apt install sox libsox-fmt-all  # Debian / Ubuntu
+brew install sox                     # macOS
+```
+
+## Usage
+
+```sh
+# Split .cue files in a directory.
+redeflacue /home/me/cues/
+
+# Read Windows-1251 cue sheets recursively and choose an output directory.
+redeflacue -e windows-1251 -r -d /mnt/library/ /home/me/cues/
+
+# Print the SoX commands without running them.
+redeflacue --dry-run -v /home/me/cues/
+```
+
+| Flag | Description |
+| --- | --- |
+| `-d, --dest DIR` | Output root; defaults to `deflacue/` beside each cue sheet |
+| `-e, --encoding ENC` | Cue-sheet encoding, such as `windows-1251` |
+| `-r, --recursive` | Search subdirectories |
+| `--dry-run` | Print planned work without running SoX |
+| `-v, --verbose` | Print each SoX command |
+| `--version` | Print the version |
+
+Tracks are written to:
+
+```text
+<destination>/<performer>/<date - album>/<track number - title>.flac
+```
+
+The cue sheet supplies the track number, title, artist, album, genre, date, ISRC, and
+description tags.
+
+## Sample-rate fix
+
+deflacue stores cue positions as 44.1 kHz sample offsets and passes them to `sox trim` as sample
+counts. SoX interprets those counts using the input file's actual sample rate, so boundaries are
+wrong when that rate is not 44.1 kHz.
+
+A cue position is based on 75 frames per second. Because deflacue uses 588 samples per cue frame
+(`44100 / 75`), dividing its stored offset by 44100 recovers the cue time. redeflacue sends that
+time to SoX as `HH:MM:SS.ssssss`, which works independently of the input rate.
+
+## Python API
+
+```python
+from pathlib import Path
+
+from deflacue.parser import CueParser
+from redeflacue import build_sox_command, plan_extractions
+
+cue = CueParser.from_file(fpath=Path("album.cue")).run()
+for extraction in plan_extractions(cue, Path("."), Path("out")):
+    print(
+        build_sox_command(
+            extraction.src,
+            extraction.dst,
+            extraction.start_s,
+            extraction.end_s,
+            extraction.tags,
+        )
+    )
+```
+
+## Development
+
+```sh
+git clone https://github.com/r8/redeflacue.git
+cd redeflacue
+uv sync
+uv run pytest
+uv run ruff check
+uv run ruff format --check
+uv run mypy src
+```
+
+Integration tests are skipped when SoX is not installed.
+
+## License
+
+BSD-3-Clause. Cue-sheet parsing is provided by Igor Starikov's BSD-licensed
+[deflacue](https://github.com/idlesign/deflacue).

redeflacue-0.1.0/pyproject.toml

@@ -0,0 +1,88 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "redeflacue"
+dynamic = ["version"]
+description = "CUE + FLAC splitter that handles non-44.1 kHz audio"
+readme = "README.md"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+authors = [{ name = "Sergey Storchay", email = "r8@r8.com.ua" }]
+requires-python = ">=3.9"
+dependencies = ["deflacue>=2.0.1"]
+keywords = ["cue", "flac", "sox", "split", "hi-res", "audio", "deflacue"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Sound/Audio :: Conversion",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/r8/redeflacue"
+Issues = "https://github.com/r8/redeflacue/issues"
+Changelog = "https://github.com/r8/redeflacue/blob/main/CHANGELOG.md"
+
+[project.scripts]
+redeflacue = "redeflacue.cli:main"
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-cov>=5",
+    "ruff>=0.6",
+    "mypy>=1.10",
+]
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/redeflacue"]
+
+[tool.ruff]
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "RUF"]
+
+[tool.mypy]
+files = ["src"]
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+warn_return_any = true
+strict_equality = true
+
+[[tool.mypy.overrides]]
+module = ["deflacue", "deflacue.*"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = ["-ra", "--strict-markers"]
+markers = ["integration: requires sox binary"]
+
+[tool.coverage.run]
+source = ["redeflacue"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true

redeflacue-0.1.0/src/redeflacue/__init__.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("redeflacue")
+except PackageNotFoundError:  # pragma: no cover
+    __version__ = "0.0.0+unknown"
+
+from redeflacue.cli import main
+from redeflacue.processor import Extraction, plan_extractions
+from redeflacue.splitter import build_sox_command
+
+__all__ = ["Extraction", "__version__", "build_sox_command", "main", "plan_extractions"]

redeflacue-0.1.0/src/redeflacue/__main__.py

@@ -0,0 +1,3 @@
+from redeflacue.cli import main
+
+raise SystemExit(main())

redeflacue-0.1.0/src/redeflacue/cli.py

@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+import argparse
+import logging
+import shutil
+from collections.abc import Sequence
+from pathlib import Path
+
+from redeflacue import __version__
+from redeflacue.processor import iter_cue_files, process_cue
+
+LOGGER = logging.getLogger("redeflacue")
+
+
+def build_parser() -> argparse.ArgumentParser:
+    ap = argparse.ArgumentParser(
+        prog="redeflacue",
+        description="Split CUE + FLAC images without assuming a 44.1 kHz sample rate.",
+    )
+    ap.add_argument("source", type=Path, help="Directory containing .cue files")
+    ap.add_argument(
+        "-d",
+        "--dest",
+        type=Path,
+        default=None,
+        help="Output root (default: ./deflacue next to each cue)",
+    )
+    ap.add_argument(
+        "-e", "--encoding", default=None, help="Encoding of the .cue file (e.g. windows-1251)"
+    )
+    ap.add_argument("-r", "--recursive", action="store_true", help="Recurse into subdirectories")
+    ap.add_argument("--dry-run", action="store_true", help="Plan tracks without running SoX")
+    ap.add_argument("-v", "--verbose", action="store_true", help="Show each SoX command")
+    ap.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    return ap
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+
+    logging.basicConfig(
+        level=logging.DEBUG if args.verbose else logging.INFO,
+        format="%(levelname)s: %(message)s",
+    )
+
+    if shutil.which("sox") is None:
+        LOGGER.error("sox not found. Install: sudo apt install sox libsox-fmt-all")
+        return 1
+
+    src_root = args.source.resolve()
+    if not src_root.exists():
+        LOGGER.error("Path %s does not exist", src_root)
+        return 1
+
+    for cue in iter_cue_files(src_root, args.recursive):
+        target_root = (
+            args.dest.resolve() / cue.parent.name if args.dest else cue.parent / "deflacue"
+        )
+        if not args.dry_run:
+            target_root.mkdir(parents=True, exist_ok=True)
+        process_cue(cue, target_root, args.encoding, args.dry_run)
+
+    LOGGER.info("Done.")
+    return 0