Add stats attribute

Author: mgeier

doc/index.rst

@@ -10,7 +10,7 @@ API Documentation
 .. automodule:: rtmixer
 
 .. autoclass:: Mixer
-   :members: play_buffer, play_ringbuffer, actions, cancel, wait
+   :members: play_buffer, play_ringbuffer, actions, cancel, wait, stats
    :undoc-members:
 
 .. autoclass:: Recorder

setup.py

@@ -21,7 +21,7 @@
     install_requires=[
         'CFFI>=1',  # for _cffi_backend
         'pa_ringbuffer',  # for init()
-        'sounddevice>0.3.6',
+        'sounddevice>0.3.9',
     ],
     author='Matthias Geier',
     author_email='Matthias.Geier@gmail.com',

src/rtmixer.py

@@ -47,6 +47,18 @@ def actions(self):
         self._drain_result_q()
         return self._actions
 
+    @property
+    def stats(self):
+        """Get over-/underflow statistics from an *inactive* stream.
+
+        To get statistics from an :attr:`~sounddevice.Stream.active`
+        stream, use `fetch_and_reset_stats()`.
+
+        """
+        if self.active:
+            raise RuntimeError('Accessing .stats on an active stream')
+        return _ffi.new('struct stats*', self._state.stats)
+
     def cancel(self, action, time=0, allow_belated=True):
         """Initiate stopping a running action.