Showing the changes to doc/python_module.rst (1 of 2 files). Show all
Unified · Split
| @@ -3,28 +3,50 @@ · 2 unmodified lines | ||
| 3 | 3 | Installing aubio for Python |
| 4 | 4 | =========================== |
| 5 | 5 | |
| 6 | −The aubio extension for Python is available for Python 2.7 and Python 3. | |
| 6 | +aubio is available as a package for Python 2.7 and Python 3. The aubio | |
| 7 | +extension is written C using the `Python/C`_ and the `Numpy/C`_ APIs. | |
| 8 | + | |
| 9 | +.. _Python/C: https://docs.python.org/c-api/index.html | |
| 10 | +.. _Numpy/C: https://docs.scipy.org/doc/numpy/reference/c-api.html | |
| 11 | + | |
| 12 | +For general documentation on how to install Python packages, see `Installing | |
| 13 | +Packages`_. | |
| 7 | 14 | |
| 8 | 15 | Installing aubio with pip |
| 9 | 16 | ------------------------- |
| 10 | 17 | |
| 11 | −aubio can now be installed using ``pip``: | |
| 18 | +aubio can be installed from `PyPI`_ using ``pip``: | |
| 12 | 19 | |
| 13 | 20 | .. code-block:: console |
| 14 | 21 | |
| 15 | 22 | $ pip install aubio |
| 16 | 23 | |
| 17 | −Building the module | |
| 18 | −------------------- | |
| 24 | +See also `Installing from PyPI`_ for general documentation. | |
| 25 | + | |
| 26 | +.. note:: | |
| 27 | + | |
| 28 | + aubio is currently a `source only`_ package, so you will need a compiler to | |
| 29 | + install it from `PyPI`_. See also `Installing aubio with conda`_ for | |
| 30 | + pre-compiled binaries. | |
| 19 | 31 | |
| 20 | −From ``aubio`` source directory, run the following: | |
| 32 | +.. _PyPI: https://pypi.python.org/pypi/aubio | |
| 33 | +.. _Installing Packages: https://packaging.python.org/tutorials/installing-packages/ | |
| 34 | +.. _Installing from PyPI: https://packaging.python.org/tutorials/installing-packages/#installing-from-pypi | |
| 35 | +.. _source only: https://packaging.python.org/tutorials/installing-packages/#source-distributions-vs-wheels | |
| 36 | + | |
| 37 | +Installing aubio with conda | |
| 38 | +--------------------------- | |
| 39 | + | |
| 40 | +`Conda packages`_ are available through the `conda-forge`_ channel for Linux, | |
| 41 | +macOS, and Windows: | |
| 21 | 42 | |
| 22 | 43 | .. code-block:: console |
| 23 | 44 | |
| 24 | − $ ./setup.py clean | |
| 25 | − $ ./setup.py build | |
| 26 | − $ sudo ./setup.py install | |
| 45 | + $ conda config --add channels conda-forge | |
| 46 | + $ conda install -c conda-forge aubio | |
| 27 | 47 | |
| 48 | +.. _Conda packages: https://anaconda.org/conda-forge/aubio | |
| 49 | +.. _conda-forge: https://conda-forge.org/ | |
| 28 | 50 | |
| 29 | 51 | .. _py-doubleprecision: |
| 30 | 52 | |