@@ -62,7 +62,7 @@ Installation
62
62
------------
63
63
64
64
The ``soundfile `` module depends on the Python packages CFFI and NumPy, and the
65
- system library libsndfile.
65
+ library libsndfile.
66
66
67
67
In a modern Python, you can use ``pip install soundfile `` to download
68
68
and install the latest release of the ``soundfile `` module and its
@@ -79,6 +79,24 @@ Binaries for Python Extension Packages <http://www.lfd.uci.edu/~gohlke/pythonlib
79
79
80
80
.. _Anaconda : https://www.continuum.io/downloads
81
81
82
+ Building
83
+ --------
84
+
85
+ ``Soundfile `` itself does not contain any compiled code and can be
86
+ bundled into a wheel with the usual ``python setup.py bdist_wheel ``.
87
+ However, ``soundfile `` relies on libsndfile, and optionally ships its
88
+ own copy of libsndfile in the wheel.
89
+
90
+ To build a binary wheel that contains libsndfile, make sure to
91
+ checkout and update the ``_soundfile_data `` submodule, then run
92
+ ``python setup.py bdist_wheel `` as usual. If the resulting file size
93
+ of the wheel is around one megabyte, a matching libsndfile has been
94
+ bundled (without libsndfile, it's around 25 KB).
95
+
96
+ To build binary wheels for all supported platforms, run ``python
97
+ build_wheels.py ``, which will ``python setup.py bdist_wheel `` for each
98
+ of the platforms we have precompiled libsndfiles for.
99
+
82
100
Error Reporting
83
101
---------------
84
102
0 commit comments