# rust-pcre
[Rust](https://github.com/mozilla/rust) 0.8+ wrapper for [libpcre](http://pcre.org/) 8.20+.

## Quick Start

### General setup
If you have not done so already, you need to set up your rustpkg path:

    test ! -d ~/.rust && mkdir ~/.rust
    cd ~/.rust
    rustpkg init

### Mac OS X

Mac OS 10.7 ships with version 8.02 of libpcre, so you'll need to install a newer version of the pcre library.

[Homebrew](http://brew.sh/) is highly recommended for installing this project's dependencies. With Homebrew, installing the latest versions of Rust and libpcre is as simple as:

    brew install rust pcre

To upgrade:

    brew update && brew upgrade rust pcre

With Rust and libpcre 8.20+ installed:

    make install

## Development

Patches and GitHub pull requests (PRs) are always welcome.

To run the tests:

    make test

# rust-pcre
[Rust](https://github.com/mozilla/rust) 0.8+ wrapper for [libpcre](http://pcre.org/) 8.20+.

## Quick Start

### General setup
If you have not done so already, you need to set up your rustpkg path:

    test ! -d ~/.rust && mkdir ~/.rust
    cd ~/.rust
    rustpkg init

### Debian

Debian Squeeze's package for libpcre is for version 8.02 of the library, which is too old. If running Debian Squeeze, you will have to compile libpcre 8.20+ from source. (Tip: [GNU Stow](http://www.gnu.org/software/stow/) is an excellent tool for maintaining the `/usr/local` directory.)

On Debian Wheezy and newer, install the `libpcre3-dev` package:

    sudo apt-get install libpcre3-dev


### Fedora

Install the `pcre-devel` package.

### Mac OS X

Mac OS 10.7 ships with version 8.02 of libpcre, so you'll need to install a newer version of the pcre library.

[Homebrew](http://brew.sh/) is highly recommended for installing this project's dependencies. With Homebrew, installing the latest versions of Rust and libpcre is as simple as:

    brew install rust pcre

To upgrade:

    brew update && brew upgrade rust pcre

With Rust and libpcre 8.20+ installed:

    make install

### Ubuntu
The libpcre packages for Ubuntu 10.04 LTS 'Lucid Lynx' and Ubuntu 12.04 LTS 'Precise Pangolin' are too old. If running lucid or precise, you will have to compile libpcre 8.20+ from source. (Tip: [GNU Stow](http://www.gnu.org/software/stow/) is an excellent tool for maintaining the `/usr/local` directory.)

On Ubuntu 12.10 'Quantal Quetzal' and newer, install the `libpcre3-dev` package:

    sudo apt-get install libpcre3-dev

## Development

Patches and GitHub pull requests (PRs) are always welcome.

To run the tests:

    make test

Add setup instructions for Debian, Fedora, and Ubuntu
Add setup instructions for Debian, Fedora, and Ubuntu

refs #2
