Installing / Upgrading¶
Monary is in the Python Package Index.
Installing from Source¶
You can install Monary from source, which provides the latest features (but may be unstable). Simply clone the repository and execute the installation command:
$ hg clone https://bitbucket.org/djcbeach/monary
$ cd monary
$ python setup.py install
Before you install Monary, you need to have the MongoDB C Driver installed.
If you are installing on Windows, there are some hints in windows_install.txt
Installing CMongo¶
Monary requires the MongoDB C Driver. To install the C driver, you can use a package manager or follow the instructions in the official MongoDB C Driver 1.0 Github. The MongoDB C Driver (libmongoc) uses the Bson library (libbson) which comes bundled.
Note
LIBMONGOC MUST BE COMPILED WITH SSL AND SASL.
Monary uses pkgconfig to find the libmongoc and libbson installations. If pkgconfig cannot find the libraries, it will look in the default locations: C:\Program Files\libmongoc and C:\Program Files\libbson for Windows, and /usr/local for other systems. If you cannot use pkgconfig and libmongoc and libbson are not installed in the default directories, you will need to pass the locations to the installation script:
$ python setup.py install --default-libmongoc C:\\usr --default-libbson C:\\usr
If you are installing via pip
, and libcmongo and libbson are not installed in the
default directories, you must pass --default-libmongoc
and --default-libbson
to pip using --install-option
.
Note
Monary assumes that libmongoc is installed so that the libraries are in <default-libmongoc>/lib. It also expects that the headers are located under <default-libmongoc>/include. This is also true for libbson.
Installing with pip¶
You can use pip to install monary in platforms other than Windows:
$ pip install monary
To get a specific version of monary:
$ pip install monary==0.4.0
To upgrade using pip:
$ pip install --upgrade monary
To specify the location of libcmongo and libbson:
$ pip install --install-option="--default-libmongoc" --install-option="C:\\usr"
--install-option="--default-libbson" --install-option="C:\\usr" monary
Note
Although Monary provides a Python package in .egg format, pip does not support installing from Python eggs. If you would like to install Monary with a .egg provided on PyPI, use easy_install instead.
Installing with easy_install¶
To use easy_install
from setuptools do:
$ easy_install monary
To upgrade:
$ easy_install -U monary
Installing with Wheels¶
Monary provides Python wheels for Windows and OSX. If you install from wheels, libmongoc must be installed in a default location. Download the wheel and install with:
$ pip install wheel
$ pip install monary-wheel.whl
Installing on Other Unix Distributions¶
Monary uses the MongoDB C driver. If you install Monary on Linux, BSD and Solaris, you’ll need to be able to compile the C driver with the GNU C compiler.