8fb33ddd49
we *really* should not paper over underruns, as they require attention. however, the previous attempt (c2a6b6e) caused an exception to be thrown (see #130), which was a bit excessive, and was consequently reverted (438e52e). so instead we make the handling consistent with what we do in read(): return the verbatim -EPIPE in this case. this can be simply ignored, and the next write will resume the stream, so this is mostly backwards- compatible (the failing write will be discarded and would need repeating, but that will just cause a skip after the interruption, which does not seem particularly relevant). as a drive-by, again stop using snd_pcm_recover(), as it still just obfuscates the snd_pcm_prepare() call it does in the end.
PyAlsaAudio
For documentation, see http://larsimmisch.github.io/pyalsaaudio/
Author: Casper Wilstrup (cwi@aves.dk)
Maintainer: Lars Immisch (lars@ibp.de)
This package contains wrappers for accessing the ALSA API from Python. It is currently fairly complete for PCM devices, and has some support for mixers.
If you find bugs in the wrappers please open an issue in the issue tracker. Please don't send bug reports regarding ALSA specifically. There are several bugs in the ALSA API, and those should be reported to the ALSA team - not me.
This software is licensed under the PSF license - the same one used by the majority of the python distribution. Basically you can use it for anything you wish (even commercial purposes). There is no warranty whatsoever.
Installation
PyPI
To install pyalsaaudio via pip (or easy_install):
$ pip install pyalsaaudio
Manual installation
Note: the wrappers need a kernel with ALSA support, and the ALSA library and headers. The installation of these varies from distribution to distribution.
On Debian or Ubuntu, make sure to install libasound2-dev. On Arch,
install alsa-lib. When in doubt, search your distribution for a
package that contains libasound.so and asoundlib.h.
First, get the sources and change to the source directory:
$ git clone https://github.com/larsimmisch/pyalsaaudio.git
$ cd pyalsaaudio
Then, build:
$ python setup.py build
And install:
$ sudo python setup.py install
Using the API
The API documentation is included in the doc subdirectory of the source distribution; it is also online on http://larsimmisch.github.io/pyalsaaudio/.
There are some example programs included with the source:
- playwav.py plays back a wav file
- playbacktest.py plays back raw sound data read from stdin
- recordtest.py captures sound from the microphone and writes it raw to stdout.
- mixertest.py can be used to manipulate the mixers.