µWeb

µWeb is developed on, and intended primarily to run on Debian GNU-Linux. As such, installation instructions will focus on getting µWeb running on that family of platforms

h1. Installation

The easiest way to install µWeb is to get it from the Python Package Index (https://pypi.python.org/pypi/uWeb). For most Linux there is a commandline application @pip@ which facilitaties easy installation of packages from the Package Index. To begin, install @pip@ on Debian:

<pre><code class="bash">
sudo apt-get install python-pip
</code></pre>

After this, µWeb can be installed with the following command:

<pre><code class="bash">
sudo pip install uweb
</code></pre>

This pulls in all the necessary requirements automatically and installs and configures them for you.

h3. MySQL support

µWeb requires a MySQL connector binary, which @pip@ will attempt to compile from source for you. If this is undesired (because it requires development headers for MySQL and Python, and some other packages), this MySQL requirement can be fulfilled by installing that package separately:

<pre><code class="bash">
sudo apt-get install python-mysqldb
</code></pre>

h1. Upgrading

The easiest way to upgrade µWeb to the latest release is to use @pip@ again:

<pre><code class="bash">
sudo pip install --upgrade uweb
</code></pre>

This will also automatically update all dependencies of µWeb if they have changed. If you run into missing dependencies for the MySQL connector (as explained in the section above, _MySQL support_), the easiest way to perform the upgrade is to remove and reinstall in one go:

<pre><code class="bash">
sudo pip uninstall uweb && sudo pip install uweb
</code></pre>

h1. Installation on OS X 10.9

Install Homebrew (http://brew.sh) or update:

<pre><code class="bash">
brew update
</code></pre>

Run

<pre><code class="bash">
brew doctor
</code></pre>

and fix any issues.

Install mySQL:

<pre><code class="bash">
brew install mysql
</code></pre>

Install @pip@: pip:

<pre><code class="bash">
sudo easy_install pip
</code></pre>

Set flags prior to installing uWeb to prevent Clang error (see this page for further info: http://stackoverflow.com/questions/22313407/clang-error-unknown-argument-mno-fused-madd-python-package-installation-fa): clang error:

<pre><code class="bash">
export CFLAGS=-Qunused-arguments; CFLAGS=-Qunused-arguments
</code></pre>

<pre><code class="bash">
export CPPFLAGS=-Qunused-arguments
</code></pre>

See this page for further info: http://stackoverflow.com/questions/22313407/clang-error-unknown-argument-mno-fused-madd-python-package-installation-fa

Now install uWeb:

<pre><code class="bash">
sudo -E pip install uweb
</code></pre>