audio_samples 2.0.0

A typed audio processing library for Rust that treats audio as a first-class, invariant-preserving object rather than an unstructured numeric buffer.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

name: CI

on:
  push:
    branches: [main]
  pull_request:

env:
  CARGO_TERM_COLOR: always

jobs:
  fmt:
    name: rustfmt
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
        with:
          components: rustfmt
      - run: cargo fmt --all --check

  clippy:
    name: clippy
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
        with:
          components: clippy
      - uses: Swatinem/rust-cache@v2
      # Lint levels are configured via the [lints] table in Cargo.toml; `-D
      # warnings` is scoped to the clippy step (not a global RUSTFLAGS) so it
      # does not force every test/doc/build job to treat warnings as errors.
      - run: cargo clippy --all-targets --features full_no_plotting -- -D warnings
      - run: cargo clippy --all-targets --features full -- -D warnings

  test:
    name: test (${{ matrix.features }})
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        features:
          - ""                       # bare-bones (default)
          - "full_no_plotting"
          - "full"
          - "psychoacoustic random-generation"
          - "opus-codec random-generation"
          - "simd full_no_plotting"
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - name: test
        run: |
          if [ -z "${{ matrix.features }}" ]; then
            cargo test --no-default-features
          else
            cargo test --features "${{ matrix.features }}"
          fi

  doc:
    name: doc
    runs-on: ubuntu-latest
    # Docs must build warning-free: any rustdoc warning (broken intra-doc link,
    # redundant link target, bare URL, …) fails the build.
    env:
      RUSTDOCFLAGS: -D warnings
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - run: cargo doc --no-deps --features full_no_plotting
      - run: cargo doc --no-deps --features full

  msrv:
    name: msrv (1.87)
    runs-on: ubuntu-latest
    # KNOWN GAP: two call sites use `NonZero::div_ceil` (stable since 1.92), so
    # this currently does not build on the declared MSRV 1.87. Resolving it is an
    # MSRV bump or a rewrite of those sites — tracked separately, out of scope of
    # the lint-config migration. Left in place so the gap stays visible.
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@1.87.0
      - uses: Swatinem/rust-cache@v2
      - run: cargo build --features full_no_plotting

  feature-powerset:
    name: feature powerset (hack)
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - uses: taiki-e/install-action@cargo-hack
      - uses: Swatinem/rust-cache@v2
      # Exclude plotting/static-plots (heavy, pull a browser stack) and
      # educational (pulls `open`); they are covered by the `full` test job.
      - run: >
          cargo hack check --feature-powerset --depth 2 --no-dev-deps
          --exclude-features plotting,static-plots,educational,html_view,python