# How to install and test?

## How to install?

### Requirements

- python 2.7 or python 3.3 or newer

- pyparsing 2.0.3 or newer

### Package manager (recommended for those OS users)

- Archlinux

- Debian

### pip (recommended to other users)

To install with pip:

    pip install bibtexparser

### Manual installation (recommended for packagers)

Download the archive on Pypi.

    python setup.py install

## How to run the test suite?

This paragraph briefly describes how to run the test suite. This is useful for contributors, for packagers but also for users who wants to check their environment.

### Virtualenv

You can make a virtualenv. I like pew for that because the API is easier.

The first time, you need to make a virtualenv

    pew mkproject bibtexparser
    pip install -r requirements.txt
    python setup.py install
    nosetest

If you already have a virtualenv, you can use workon

    pew workon bibtexparser

### Tox

The advantage of Tox is that you can build and test the code against several versions of python. Of course, you need tox to be installed on your system. The configuration file is tox.ini, in the root of the project. There, you can change the python versions.

    tox # and nothing more :)