Metadata-Version: 1.1
Name: pastream
Version: 0.0.2
Summary: UNKNOWN
Home-page: http://github.com/tgarc/pastream
Author: Thomas J. Garcia
Author-email: toemossgarcia@gmail.com
License: MIT
Description: .. image:: https://travis-ci.org/tgarc/pastream.svg?branch=add_wheels
            :target: https://travis-ci.org/tgarc/pastream
        
        .. image:: https://ci.appveyor.com/api/projects/status/wk52r5jy9ri7dsi9/branch/add_wheels?svg=true
            :target: https://ci.appveyor.com/project/tgarc/pastream/branch/add_wheels
        
        
        pastream Portaudio Streams for Python
        =======================================
        
        `pastream` builds on top of `portaudio <http://www.portaudio.com/>`__ and the
        excellent `sounddevice <http://github.com/spatialaudio/python-sounddevice>`__ python
        bindings to provide some more advanced functionality right out of the box.
        
        
        Features
        --------
        
        GIL-less Audio Callbacks
            Having the portaudio callback implemented in C means audio interrupts can be
            serviced quickly and reliably without ever needing to acquire the GIL.
        
        Expanded State Machine
            Adds the ability to differentiate whether a stream has been aborted or
            completed successfully even after the stream has finished.
        
        Input Stream iterators
            Efficiently retrieve live audio capture data through an iterable. Especially
            useful for audio analysis tasks.
        
        Reader/Writer Threads
            pastream simplifies the process of implementing stream reader and writer
            threads to manipulate and/or generate data in the background while leaving
            the main thread free for higher level management tasks.
        
        
        Dependencies
        ------------
        
        (Linux only) `PortAudio <http://www.portaudio.com>`__
        
        `sounddevice <http://github.com/spatialaudio/python-sounddevice>`__
        
        `soundfile <https://github.com/bastibe/PySoundFile>`__
        
        (Optional) `numpy <http://www.numpy.org/>`__
        
        
        Installation
        ------------
        
        For linux platforms a recent version of PortAudio is required. You can either
        install the latest from your package manager (libportaudio2 for
        debian/raspbian) or install the latest stable build from `here
        <http://www.portaudio.com/download.html>`__ (Recommended).
        
        If doing a fresh checkout::
        
            $ git clone --recursive http://github.com/tgarc/pastream
        
        If you already have a checkout::
        
            $ git submodule update --init
        
        Then do a pip install::
        
            $ pip install <path/to/checkout>
        
        Compilation
        ------------
        
        Note that you will need to have the proper build environment set up in order to
        compile pastream's C extensions.
        
        On linux platforms you'll simply need to have a C compiler installed - no extra
        development files are required.
        
        For Windows users this `document
        <https://packaging.python.org/extensions/#setting-up-a-build-environment-on-windows>`__
        will guide you through setting up a build environment for your Python
        version. To sum it up:
        
        For Python 2.7
            Install VS2008 from `here <https://www.microsoft.com/en-gb/download/details.aspx?id=44266>`__
        
        For Python 3.4
            Install Windows SDK for Windows 7 and .NET Framework 4  from `here <https://www.microsoft.com/en-gb/download/details.aspx?id=8279>`__
        
        For Python 3.5
            Install VS2015 from `here <https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx>`__
        
Platform: any
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Sound/Audio
