feat: high-quality resampler

.github/workflows/ci.yml

@@ -11,14 +11,27 @@ env:
   CARGO_INCREMENTAL: 0
 
 jobs:
+  msrv:
+    name: Get MSRV
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.get-msrv.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Read MSRV from Cargo.toml
+        id: get-msrv
+        run: |
+          version=$(grep -m1 '^rust-version' Cargo.toml | sed -E 's/.*"([^"]+)".*/\1/')
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+
   tests:
     name: Tests
+    needs: msrv
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
         os: [macos-latest, windows-latest, ubuntu-latest]
-        toolchain: ["1.89"]
         include:
           - os: macos-latest
             MACOS: true
@@ -31,8 +44,8 @@ jobs:
         run: sudo apt-get update && sudo apt-get install --yes --no-install-recommends libasound2-dev pkg-config libjack-jackd2-dev libjack-jackd2-0 libdbus-1-dev libpipewire-0.3-dev
         if: contains(matrix.os, 'ubuntu')
 
-      - name: Install ${{ matrix.toolchain }} toolchain
-        run: rustup toolchain install ${{ matrix.toolchain }} && rustup default ${{ matrix.toolchain }}
+      - name: Install ${{ needs.msrv.outputs.version }} toolchain
+        run: rustup toolchain install ${{ needs.msrv.outputs.version }} && rustup default ${{ needs.msrv.outputs.version }}
 
       - name: Install stable toolchain for clippy
         run: rustup toolchain install stable

CHANGELOG.md

@@ -16,6 +16,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - All sources now implement `Iterator::size_hint()`.
 - `Chirp` now implements `try_seek`.
 - Added `DEFAULT_SAMPLE_RATE` set to match `cpal::SAMPLE_RATE_48K`.
+- Added `Source::resample` and `ResampleConfig` for high-quality sample rate conversion.
 
 ### Changed
 
@@ -25,6 +26,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Explicitly document the requirement for sources to return complete frames.
 - Ensured decoders to always return complete frames, as well as `TakeDuration` when expired.
 - Breaking: `Zero::new_samples()` now returns `Result<Self, ZeroError>` requiring a frame-aligned number of samples.
+- Breaking: `SampleRateConverter` now wraps a `Source` instead of an `Iterator` and takes a `ResampleConfig`.
 - Improved queue, buffer, mixer and sample rate conversion performance.
 - Default sample rate changed from 44.1 kHz to 48 kHz consistently.
 - `open_sink_or_fallback` now tries 48 kHz and 44.1 kHz before the device's maximum sample rate.
@@ -91,6 +93,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `Source::dither()` function for applying dithering
 - Added `64bit` feature to opt-in to 64-bit sample precision (`f64`).
 - Added `SampleRateConverter::inner` to get underlying iterator by ref.
+- Added `Resample` source for high-quality sample rate conversion.
+- Added `FromIter` source that wraps a sample iterator.
+- Added `ChannelCountConverter::inner()` for immutable access to the underlying iterator.
+- `ChannelCountConverter` now implements `Source`.
+- Added `FromIter::{inner, inner_mut, into_inner}` accessor methods.
 
 ### Fixed
 
@@ -104,6 +111,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Fixed `Empty` source to properly report exhaustion.
 - Fixed `Zero::current_span_len` returning remaining samples instead of span length.
 
+### Deprecated
+- `SampleRateConverter` is deprecated in favor of using `Resample` with `FromIter`.
+- `FromFactoryIter` type is deprecated, renamed to `FromFn`.
+- `from_factory()` function is deprecated, renamed to `from_fn()`.
+
 ### Changed
 
 - Breaking: _Sink_ terms are replaced with _Player_ and _Stream_ terms replaced
@@ -125,6 +137,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Upgraded `cpal` to v0.17.
 - Clarified `Source::current_span_len()` contract documentation.
 - Improved queue, mixer and sample rate conversion performance.
+- `SampleRateConverter` uses the new `Resample` source for better quality.
+- Renamed `FromIter` for sequencing multiple sources to `Chain`.
+- Renamed `FromFactoryIter` for generating sources from a function to `FromFn`.
 
 ## Version [0.21.1] (2025-07-14)