Installation

This part of the documentation covers the installation of Eve. The first step to using any software package is getting it properly installed.

Distribute & Pip

Installing Eve is simple with pip:

$ pip install eve

or, with easy_install:

$ easy_install eve

But, you really shouldn’t do that.

Cheeseshop Mirror

If the Cheeseshop is down, you can also install Eve from one of the mirrors. Crate.io is one of them:

$ pip install -i http://simple.crate.io/ eve

Development Version

Eve is actively developed on GitHub, where the code is always available. If you want to work with the development version of Eve, there are two ways: you can either let pip pull in the development version, or you can tell it to operate on a git checkout. Either way, virtualenv is recommended.

Get the git checkout in a new virtualenv and run in development mode.

$ git clone http://github.com/nicolaiarocci/eve.git
Initialized empty Git repository in ~/dev/eve/.git/
$ cd eve
$ virtualenv venv --distribute
New python executable in venv/bin/python
Installing distribute............done.
$ . venv/bin/activate
$ python setup.py install
...
Finished processing dependencies for Eve

This will pull in the dependencies and activate the git head as the current version inside the virtualenv. Then all you have to do is run git pull origin to update to the latest version.

To just get the development version without git, do this instead:

$ mkdir eve
$ cd eve
$ virtualenv venv --distribute
$ . venv/bin/activate
New python executable in venv/bin/python
Installing distribute............done.
$ pip install git+git://github.com/nicolaiarocci/eve.git
...
Cleaning up...

And you’re done!