add mac os x error and a TL;DR shortcut

[Imported from Trac: page CompileError, version 10]
zooko 2013-04-03 12:36:31 +00:00
parent 5bd9d42f06
commit 3f0306f869

@ -4,18 +4,28 @@ See also [Installation](Installation) for pre-built packages for your operating
Sometimes running `python setup.py build` results in an error message about a compile failure. This page will tell you how to get past that problem. Sometimes running `python setup.py build` results in an error message about a compile failure. This page will tell you how to get past that problem.
A typical error message when building is: A typical error message when building on Windows is:
``` ```
distutils.errors.DistutilsError: Setup script exited with error: Unable to find vcvarsall.bat distutils.errors.DistutilsError: Setup script exited with error: Unable to find vcvarsall.bat
``` ```
That's on Windows. On Linux a typical error message is: On Linux a typical error message is:
``` ```
error: Python.h: No such file or directory error: Python.h: No such file or directory
``` ```
On Mac OS X a typical error message is:
```
unable to execute clang: No such file or directory
```
### in brief
The short version, for people who don't want to read this whole page is: write to the tahoe-dev mailing list and ask if some volunteer will kindly build a binary package of the necessary library for your operating system and your version of Python. In your request, include: 1. the entire output from your attempt to build (which will include an error message like one of those above), 2. what operating system you are using, 3. what version of Python you are using (`python -V`), 4. some nice words like "please" and "thank you".
### Why This Happens ### Why This Happens
First of all, the Tahoe-LAFS software itself is written in 100% pure Python and never gets compiled. However, Tahoe-LAFS uses several libraries which themselves contain native C or C++ code that needs to be compiled. Currently there are six such libraries that Tahoe-LAFS uses: `Twisted`, `pyOpenSSL`, `pycrypto`, `pycryptopp`, `zfec`, and `zope.interface`. First of all, the Tahoe-LAFS software itself is written in 100% pure Python and never gets compiled. However, Tahoe-LAFS uses several libraries which themselves contain native C or C++ code that needs to be compiled. Currently there are six such libraries that Tahoe-LAFS uses: `Twisted`, `pyOpenSSL`, `pycrypto`, `pycryptopp`, `zfec`, and `zope.interface`.