import os
import sys
from io import BytesIO
import numpy as np
from numpy.testing import (assert_equal, assert_, assert_array_equal,
break_cycles, suppress_warnings, IS_PYPY)
import pytest
from pytest import raises, warns
from scipy.io import wavfile
def datafile(fn):
return os.path.join(os.path.dirname(__file__), 'data', fn)
def test_read_1():
# 32-bit PCM (which uses extensible format)
for mmap in [False, True]:
filename = 'test-44100Hz-le-1ch-4bytes.wav'
rate, data = wavfile.read(datafile(filename), mmap=mmap)
assert_equal(rate, 44100)
assert_(np.issubdtype(data.dtype, np.int32))
assert_equal(data.shape, (4410,))
del data
def test_read_2():
# 8-bit unsigned PCM
for mmap in [False, True]:
filename = 'test-8000Hz-le-2ch-1byteu.wav'
rate, data = wavfile.read(datafile(filename), mmap=mmap)
assert_equal(rate, 8000)
assert_(np.issubdtype(data.dtype, np.uint8))
assert_equal(data.shape, (800, 2))
del data
def test_read_3():
# Little-endian float
for mmap in [False, True]:
filename = 'test-44100Hz-2ch-32bit-float-le.wav'
rate, data = wavfile.read(datafile(filename), mmap=mmap)
assert_equal(rate, 44100)
assert_(np.issubdtype(data.dtype, np.float32))
assert_equal(data.shape, (441, 2))
del data
def test_read_4():
# Contains unsupported 'PEAK' chunk
for mmap in [False, True]:
with suppress_warnings() as sup:
sup.filter(wavfile.WavFileWarning,
"Chunk .non-data. not understood, skipping it")
filename = 'test-48000Hz-2ch-64bit-float-le-wavex.wav'
rate, data = wavfile.read(datafile(filename), mmap=mmap)
assert_equal(rate, 48000)
assert_(np.issubdtype(data.dtype, np.float64))
assert_equal(data.shape, (480, 2))
del data
def test_read_5():
# Big-endian float
for mmap in [False, True]:
filename = 'test-44100Hz-2ch-32bit-float-be.wav'
rate, data = wavfile.read(datafile(filename), mmap=mmap)
assert_equal(rate, 44100)
assert_(np.issubdtype(data.dtype, np.float32))
assert_(data.dtype.byteorder == '>' or (sys.byteorder == 'big' and
data.dtype.byteorder == '='))
assert_equal(data.shape, (441, 2))
del data
def test_5_bit_odd_size_no_pad():
# 5-bit, 1 B container, 5 channels, 9 samples, 45 B data chunk
# Generated by LTspice, which incorrectly omits pad byte, but should be
# readable anyway
for mmap in [False, True]:
filename = 'test-8000Hz-le-5ch-9S-5bit.wav'
rate, data = wavfile.read(datafile(filename), mmap=mmap)
assert_equal(rate, 8000)
assert_(np.issubdtype(data.dtype, np.uint8))
assert_equal(data.shape, (9, 5))
# 8-5 = 3 LSBits should be 0
assert_equal(data & 0b00000111, 0)
# Unsigned
assert_equal(data.max(), 0b11111000) # Highest possible
assert_equal(data[0, 0], 128) # Midpoint is 128 for <= 8-bit
assert_equal(data.min(), 0) # Lowest possible
del data
def test_12_bit_even_size():
# 12-bit, 2 B container, 4 channels, 9 samples, 72 B data chunk
# Generated by LTspice from 1 Vpk sine waves
for mmap in [False, True]:
filename = 'test-8000Hz-le-4ch-9S-12bit.wav'
rate, data = wavfile.read(datafile(filename), mmap=mmap)
assert_equal(rate, 8000)
assert_(np.issubdtype(data.dtype, np.int16))
assert_equal(data.shape, (9, 4))
# 16-12 = 4 LSBits should be 0
assert_equal(data & 0b00000000_00001111, 0)
# Signed
assert_equal(data.max(), 0b01111111_11110000) # Highest possible
assert_equal(data[0, 0], 0) # Midpoint is 0 for >= 9-bit
assert_equal(data.min(), -0b10000000_00000000) # Lowest possible
del data
def test_24_bit_odd_size_with_pad():
# 24-bit, 3 B container, 3 channels, 5 samples, 45 B data chunk
# Should not raise any warnings about the data chunk pad byte
filename = 'test-8000Hz-le-3ch-5S-24bit.wav'
rate, data = wavfile.read(datafile(filename), mmap=False)
assert_equal(rate, 8000)
assert_(np.issubdtype(data.dtype, np.int32))
assert_equal(data.shape, (5, 3))
# All LSBytes should be 0
assert_equal(data & 0xff, 0)
# Hand-made max/min samples under different conventions:
# 2**(N-1) 2**(N-1)-1 LSB
assert_equal(data, [[-0x8000_0000, -0x7fff_ff00, -0x200],
[-0x4000_0000, -0x3fff_ff00, -0x100],
[+0x0000_0000, +0x0000_0000, +0x000],
[+0x4000_0000, +0x3fff_ff00, +0x100],
[+0x7fff_ff00, +0x7fff_ff00, +0x200]])
# ^ clipped
def test_20_bit_extra_data():
# 20-bit, 3 B container, 1 channel, 10 samples, 30 B data chunk
# with extra data filling container beyond the bit depth
filename = 'test-8000Hz-le-1ch-10S-20bit-extra.wav'
rate, data = wavfile.read(datafile(filename), mmap=False)
assert_equal(rate, 1234)
assert_(np.issubdtype(data.dtype, np.int32))
assert_equal(data.shape, (10,))
# All LSBytes should still be 0, because 3 B container in 4 B dtype
assert_equal(data & 0xff, 0)
# But it should load the data beyond 20 bits
assert_((data & 0xf00).any())
# Full-scale positive/negative samples, then being halved each time
assert_equal(data, [+0x7ffff000, # +full-scale 20-bit
-0x7ffff000, # -full-scale 20-bit
+0x7ffff000 >> 1, # +1/2
-0x7ffff000 >> 1, # -1/2
+0x7ffff000 >> 2, # +1/4
-0x7ffff000 >> 2, # -1/4
+0x7ffff000 >> 3, # +1/8
-0x7ffff000 >> 3, # -1/8
+0x7ffff000 >> 4, # +1/16
-0x7ffff000 >> 4, # -1/16
])
def test_36_bit_odd_size():
# 36-bit, 5 B container, 3 channels, 5 samples, 75 B data chunk + pad
filename = 'test-8000Hz-le-3ch-5S-36bit.wav'
rate, data = wavfile.read(datafile(filename), mmap=False)
assert_equal(rate, 8000)
assert_(np.issubdtype(data.dtype, np.int64))
assert_equal(data.shape, (5, 3))
# 28 LSBits should be 0
assert_equal(data & 0xfffffff, 0)
# Hand-made max/min samples under different conventions:
# Fixed-point 2**(N-1) Full-scale 2**(N-1)-1 LSB
correct = [[-0x8000_0000_0000_0000, -0x7fff_ffff_f000_0000, -0x2000_0000],
[-0x4000_0000_0000_0000, -0x3fff_ffff_f000_0000, -0x1000_0000],
[+0x0000_0000_0000_0000, +0x0000_0000_0000_0000, +0x0000_0000],
[+0x4000_0000_0000_0000, +0x3fff_ffff_f000_0000, +0x1000_0000],
[+0x7fff_ffff_f000_0000, +0x7fff_ffff_f000_0000, +0x2000_0000]]
# ^ clipped
assert_equal(data, correct)
def test_45_bit_even_size():
# 45-bit, 6 B container, 3 channels, 5 samples, 90 B data chunk
filename = 'test-8000Hz-le-3ch-5S-45bit.wav'
rate, data = wavfile.read(datafile(filename), mmap=False)
assert_equal(rate, 8000)
assert_(np.issubdtype(data.dtype, np.int64))
assert_equal(data.shape, (5, 3))
# 19 LSBits should be 0
assert_equal(data & 0x7ffff, 0)
# Hand-made max/min samples under different conventions:
# Fixed-point 2**(N-1) Full-scale 2**(N-1)-1 LSB
correct = [[-0x8000_0000_0000_0000, -0x7fff_ffff_fff8_0000, -0x10_0000],
[-0x4000_0000_0000_0000, -0x3fff_ffff_fff8_0000, -0x08_0000],
[+0x0000_0000_0000_0000, +0x0000_0000_0000_0000, +0x00_0000],
[+0x4000_0000_0000_0000, +0x3fff_ffff_fff8_0000, +0x08_0000],
[+0x7fff_ffff_fff8_0000, +0x7fff_ffff_fff8_0000, +0x10_0000]]
# ^ clipped
assert_equal(data, correct)
def test_53_bit_odd_size():
# 53-bit, 7 B container, 3 channels, 5 samples, 105 B data chunk + pad
filename = 'test-8000Hz-le-3ch-5S-53bit.wav'
rate, data = wavfile.read(datafile(filename), mmap=False)
assert_equal(rate, 8000)
assert_(np.issubdtype(data.dtype, np.int64))
assert_equal(data.shape, (5, 3))
# 11 LSBits should be 0
assert_equal(data & 0x7ff, 0)
# Hand-made max/min samples under different conventions:
# Fixed-point 2**(N-1) Full-scale 2**(N-1)-1 LSB
correct = [[-0x8000_0000_0000_0000, -0x7fff_ffff_ffff_f800, -0x1000],
[-0x4000_0000_0000_0000, -0x3fff_ffff_ffff_f800, -0x0800],
[+0x0000_0000_0000_0000, +0x0000_0000_0000_0000, +0x0000],
[+0x4000_0000_0000_0000, +0x3fff_ffff_ffff_f800, +0x0800],
[+0x7fff_ffff_ffff_f800, +0x7fff_ffff_ffff_f800, +0x1000]]
# ^ clipped
assert_equal(data, correct)
def test_64_bit_even_size():
# 64-bit, 8 B container, 3 channels, 5 samples, 120 B data chunk
for mmap in [False, True]:
filename = 'test-8000Hz-le-3ch-5S-64bit.wav'
rate, data = wavfile.read(datafile(filename), mmap=False)
assert_equal(rate, 8000)
assert_(np.issubdtype(data.dtype, np.int64))
assert_equal(data.shape, (5, 3))
# Hand-made max/min samples under different conventions:
# Fixed-point 2**(N-1) Full-scale 2**(N-1)-1 LSB
correct = [[-0x8000_0000_0000_0000, -0x7fff_ffff_ffff_ffff, -0x2],
[-0x4000_0000_0000_0000, -0x3fff_ffff_ffff_ffff, -0x1],
[+0x0000_0000_0000_0000, +0x0000_0000_0000_0000, +0x0],
[+0x4000_0000_0000_0000, +0x3fff_ffff_ffff_ffff, +0x1],
[+0x7fff_ffff_ffff_ffff, +0x7fff_ffff_ffff_ffff, +0x2]]
# ^ clipped
assert_equal(data, correct)
del data
def test_unsupported_mmap():
# Test containers that cannot be mapped to numpy types
for filename in {'test-8000Hz-le-3ch-5S-24bit.wav',
'test-8000Hz-le-3ch-5S-36bit.wav',
'test-8000Hz-le-3ch-5S-45bit.wav',
'test-8000Hz-le-3ch-5S-53bit.wav',
'test-8000Hz-le-1ch-10S-20bit-extra.wav'}:
with raises(ValueError, match="mmap.*not compatible"):
rate, data = wavfile.read(datafile(filename), mmap=True)
def test_rifx():
# Compare equivalent RIFX and RIFF files
for rifx, riff in {('test-44100Hz-be-1ch-4bytes.wav',
'test-44100Hz-le-1ch-4bytes.wav'),
('test-8000Hz-be-3ch-5S-24bit.wav',
'test-8000Hz-le-3ch-5S-24bit.wav')}:
rate1, data1 = wavfile.read(datafile(rifx), mmap=False)
rate2, data2 = wavfile.read(datafile(riff), mmap=False)
assert_equal(rate1, rate2)
assert_equal(data1, data2)
def test_read_unknown_filetype_fail():
# Not an RIFF
for mmap in [False, True]:
filename = 'example_1.nc'
with open(datafile(filename), 'rb') as fp:
with raises(ValueError, match="CDF.*'RIFF' and 'RIFX' supported"):
wavfile.read(fp, mmap=mmap)
def test_read_unknown_riff_form_type():
# RIFF, but not WAVE form
for mmap in [False, True]:
filename = 'Transparent Busy.ani'
with open(datafile(filename), 'rb') as fp:
with raises(ValueError, match='Not a WAV file.*ACON'):
wavfile.read(fp, mmap=mmap)
def test_read_unknown_wave_format():
# RIFF and WAVE, but not supported format
for mmap in [False, True]:
filename = 'test-8000Hz-le-1ch-1byte-ulaw.wav'
with open(datafile(filename), 'rb') as fp:
with raises(ValueError, match='Unknown wave file format.*MULAW.*'
'Supported formats'):
wavfile.read(fp, mmap=mmap)
def test_read_early_eof_with_data():
# File ends inside 'data' chunk, but we keep incomplete data
for mmap in [False, True]:
filename = 'test-44100Hz-le-1ch-4bytes-early-eof.wav'
with open(datafile(filename), 'rb') as fp:
with warns(wavfile.WavFileWarning, match='Reached EOF'):
rate, data = wavfile.read(fp, mmap=mmap)
assert data.size > 0
assert rate == 44100
# also test writing (gh-12176)
data[0] = 0
def test_read_early_eof():
# File ends after 'fact' chunk at boundary, no data read
for mmap in [False, True]:
filename = 'test-44100Hz-le-1ch-4bytes-early-eof-no-data.wav'
with open(datafile(filename), 'rb') as fp:
with raises(ValueError, match="Unexpected end of file."):
wavfile.read(fp, mmap=mmap)
def test_read_incomplete_chunk():
# File ends inside 'fmt ' chunk ID, no data read
for mmap in [False, True]:
filename = 'test-44100Hz-le-1ch-4bytes-incomplete-chunk.wav'
with open(datafile(filename), 'rb') as fp:
with raises(ValueError, match="Incomplete chunk ID.*b'f'"):
wavfile.read(fp, mmap=mmap)
def test_read_inconsistent_header():
# File header's size fields contradict each other
for mmap in [False, True]:
filename = 'test-8000Hz-le-3ch-5S-24bit-inconsistent.wav'
with open(datafile(filename), 'rb') as fp:
with raises(ValueError, match="header is invalid"):
wavfile.read(fp, mmap=mmap)
# signed 8-bit integer PCM is not allowed
# unsigned > 8-bit integer PCM is not allowed
# 8- or 16-bit float PCM is not expected
# g and q are platform-dependent, so not included
@pytest.mark.parametrize("dt_str", ["<i2", "<i4", "<i8", "<f4", "<f8",
">i2", ">i4", ">i8", ">f4", ">f8", '|u1'])
@pytest.mark.parametrize("channels", [1, 2, 5])
@pytest.mark.parametrize("rate", [8000, 32000])
@pytest.mark.parametrize("mmap", [False, True])
@pytest.mark.parametrize("realfile", [False, True])
def test_write_roundtrip(realfile, mmap, rate, channels, dt_str, tmpdir):
dtype = np.dtype(dt_str)
if realfile:
tmpfile = str(tmpdir.join('temp.wav'))
else:
tmpfile = BytesIO()
data = np.random.rand(100, channels)
if channels == 1:
data = data[:, 0]
if dtype.kind == 'f':
# The range of the float type should be in [-1, 1]
data = data.astype(dtype)
else:
data = (data*128).astype(dtype)
wavfile.write(tmpfile, rate, data)
rate2, data2 = wavfile.read(tmpfile, mmap=mmap)
assert_equal(rate, rate2)
assert_(data2.dtype.byteorder in ('<', '=', '|'), msg=data2.dtype)
assert_array_equal(data, data2)
# also test writing (gh-12176)
if realfile:
data2[0] = 0
else:
with pytest.raises(ValueError, match='read-only'):
data2[0] = 0
if realfile and mmap and IS_PYPY and sys.platform == 'win32':
# windows cannot remove a dead file held by a mmap but not collected
# in PyPy; since the filename gets reused in this test, clean this up
break_cycles()
break_cycles()
@pytest.mark.parametrize("dtype", [np.float16])
def test_wavfile_dtype_unsupported(tmpdir, dtype):
tmpfile = str(tmpdir.join('temp.wav'))
rng = np.random.default_rng(1234)
data = rng.random((100, 5)).astype(dtype)
rate = 8000
with pytest.raises(ValueError, match="Unsupported"):
wavfile.write(tmpfile, rate, data)