samplerdisc 0.5.1__tar.gz

samplerdisc-0.5.1/.dockerignore

@@ -0,0 +1,8 @@
+# Keep the build context to what the hatchling build needs: pyproject.toml,
+# src/, README.md and LICENSE are COPYed explicitly in the Containerfile, so
+# everything else is noise that only slows the build and busts its cache.
+*
+!pyproject.toml
+!README.md
+!LICENSE
+!src/

samplerdisc-0.5.1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

samplerdisc-0.5.1/.github/ISSUE_TEMPLATE/disc-wont-read.yml

@@ -0,0 +1,43 @@
+name: A disc won't read
+description: A disc image fails to list or extract, or yields fewer samples than it should
+labels: ["disc"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the report. **Do not attach the disc image or any extracted audio** — these are commercial libraries and this repo is public. A description of the failure is what we need, not the library itself.
+  - type: dropdown
+    id: container
+    attributes:
+      label: Container format
+      description: The kind of image file. Detect by signature if you're unsure — the extension is often wrong.
+      options:
+        - .mdx (DAEMON Tools, often compressed)
+        - .nrg (Nero)
+        - .bin / .iso (raw)
+        - .cue / .bin pair
+        - Other / not sure
+    validations:
+      required: true
+  - type: input
+    id: source
+    attributes:
+      label: Where the image came from
+      description: e.g. archive.org, a personal FTP, a physical rip you made. Don't link to copyrighted material.
+    validations:
+      required: false
+  - type: textarea
+    id: command
+    attributes:
+      label: Command and full output
+      description: The exact command you ran and everything it printed. Paste text, not a screenshot.
+      render: shell
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What you expected
+      description: How many volumes or samples you believe are on the disc, and which specific one fails if you know it.
+    validations:
+      required: false

samplerdisc-0.5.1/.github/ISSUE_TEMPLATE/new-format.yml

@@ -0,0 +1,33 @@
+name: Support a new format
+description: A container, filesystem, or sample format the tool doesn't handle yet
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        A new manufacturer is usually one new module in `fs/` and/or `sample/`, and nothing else — that separation is deliberate. Tell us which layer this is.
+  - type: dropdown
+    id: layer
+    attributes:
+      label: Which layer
+      options:
+        - Container (a new image wrapper, e.g. sector geometry / compression)
+        - Filesystem (how a sampler laid files onto the disc)
+        - Sample format (the bytes inside one file)
+        - Not sure
+    validations:
+      required: true
+  - type: input
+    id: hardware
+    attributes:
+      label: Sampler / hardware
+      description: e.g. E-mu ESI-32, Roland S-760, Ensoniq ASR-10
+    validations:
+      required: false
+  - type: textarea
+    id: what-we-know
+    attributes:
+      label: What's known about the format
+      description: Magic numbers, sector sizes, existing documentation or tools, sample images available. The more concrete the bytes, the better.
+    validations:
+      required: false

samplerdisc-0.5.1/.github/pull_request_template.md

@@ -0,0 +1,24 @@
+<!-- One deliverable per branch, one issue per deliverable. The issue is the spec. -->
+
+Closes #
+
+## What this changes
+
+
+
+## Which layer
+
+<!-- Keep the layers independent. Tick what this touches. -->
+
+- [ ] `container/` — sectors in, flat 2048-byte sectors out (no sampler knowledge)
+- [ ] `fs/` — a sampler filesystem
+- [ ] `sample/` — a sample format
+- [ ] `docs/` only
+
+## Checklist
+
+- [ ] No disc images or extracted audio added (CI enforces this; see [ADR-0008](docs/adr/0008-no-media-in-the-repo.md))
+- [ ] New format constants are documented in `docs/formats/` and asserted in a test
+- [ ] `uv run ruff check .` and `uv run ruff format --check .` pass
+- [ ] `uv run pytest -q` passes
+- [ ] `uv tool install --editable . && samplerdisc --version` works

samplerdisc-0.5.1/.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - run: uv sync --all-extras --dev
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Format
+        run: uv run ruff format --check .
+
+      - name: Test
+        run: uv run pytest -q
+
+      # A passing suite and a working installed entrypoint are not the same
+      # thing, and that gap is where a broken `bin` hides.
+      - name: Installed entrypoint
+        run: |
+          uv tool install --editable .
+          samplerdisc --version
+
+      # ADR-0008: no disc images or audio, ever. Enforced, not remembered.
+      - name: No media in tracked files
+        run: |
+          if git ls-files | grep -iE '\.(mdx|nrg|iso|img|bin|cue|mds|mdf|cdr|tao|wav|aif|aiff)$'; then
+            echo "::error::Disc image or audio file is tracked. See docs/adr/0008-no-media-in-the-repo.md"
+            exit 1
+          fi
+          echo "clean"
+
+  # The Containerfile is a runner for untrusted images (ADR-0038), and a
+  # Containerfile nobody builds is one that quietly stops working. This job
+  # builds it and smoke-tests the entrypoint. It is deliberately separate from
+  # `verify` and not part of branch protection's required check: a registry
+  # hiccup pulling the base image should not block a merge.
+  container:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build image
+        run: docker build -f Containerfile -t samplerdisc .
+
+      - name: Installed entrypoint
+        run: docker run --rm samplerdisc --version

samplerdisc-0.5.1/.github/workflows/release.yml

@@ -0,0 +1,71 @@
+name: Release
+
+# Publish to PyPI when a v* tag is pushed. The tag is the trigger, so a release
+# is `git tag vX.Y.Z && git push --tags` and nothing else — no token lives here.
+# Uploads go through PyPI Trusted Publishing (OIDC): PyPI is configured to trust
+# this repository's `pypi` environment, and the `publish` job mints a short-lived
+# credential per run. There is no API token to leak from a public repo.
+#
+# One-time setup on PyPI (Trusted Publisher, "pending" until the first release):
+#   https://pypi.org/manage/account/publishing/
+#     PyPI project name: samplerdisc
+#     Owner:             bmxcode
+#     Repository:        samplerdisc
+#     Workflow name:     release.yml
+#     Environment:       pypi
+# and create a repository environment named `pypi` (Settings -> Environments),
+# optionally restricted to tags matching v*.
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions: {}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      # The tag is the version, and a tag that disagrees with pyproject would
+      # publish the wrong number under the right name. Fail loud instead — the
+      # same "enforced, not remembered" reflex as the no-media check in ci.yml.
+      - name: Tag matches project version
+        run: |
+          tag="${GITHUB_REF_NAME#v}"
+          proj="$(uv version --short)"
+          if [ "$tag" != "$proj" ]; then
+            echo "::error::tag v$tag != pyproject version $proj"
+            exit 1
+          fi
+          echo "v$tag matches pyproject"
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Check metadata renders
+        run: uvx twine check dist/*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # OIDC token for Trusted Publishing; nothing else
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

samplerdisc-0.5.1/.gitignore

@@ -0,0 +1,44 @@
+# Disc images and extracted audio are never committed. See ADR-0008.
+# These are commercial sample libraries; the repo is public and git history
+# is exposed retroactively. This list comes before anything else on purpose.
+*.mdx
+*.nrg
+*.iso
+*.img
+*.bin
+*.cue
+*.mds
+*.mdf
+*.cdr
+*.tao
+*.ccd
+*.wav
+*.aif
+*.aiff
+out/
+discs/
+retro-sample-cds/
+
+# Archives holding disc images are the same rule: a .zip of a sample library
+# is still a sample library.
+*.zip
+*.7z
+*.rar
+*.tar
+*.tar.gz
+*.tgz
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+
+# Editor / OS
+.DS_Store
+.idea/
+.claude/