Installation instructions
***************************

Python
=======
You need a python with setuptools, zlib, bz2 and ssl support.

Try that in your interpretery::

>>> import tarfile
>>> import zipfile
>>> import bz2
>>> import _ssl
>>> import zlib
>>> import setuptools
>>>

If you do not have that, you can give a try to my pyboostrapper that bootstrap
a python somewhere::

    wget http://hg.minitage.org/hg/minitage/shell/raw-file/tip/PyBootstrapper.sh
    chmod +x PyBootstrapper.sh
    ./PyBootstrapper.sh /path/to/pythonPrefix


Using virtualenv
=================
You 'd better to use `virtualenv <http://pypi.python.org/pypi/virtualenv/1.1>`_ ,
minitage fits well with it.

virtualenv is a tool that allow you to create isolated Python
environments.


    Here is how to set up an environment with it:

    - Install virtualenv::

        easy_install virtualenv #(maybe use sudo ;))

    - Install minitage prefix::

        virtualenv --no-site-packages  ~/minitage

    - activate it::

        source ~/minitage/bin/activate


    KEEP IN MIND THAT YOU MUST ACTIVATE VIRTUALENV AT ANY TIME YOU USE IT.


Installing minitage
====================

A stable version
-----------------

    Minitage is a classical python egg, you can get it throught easy_install.

    To install minitage in a stable version, follow those steps:

    - Install minitage::

        easy_install -U mercurial minitage.core

    - Sync its packages (all its minilays in minitage terminology).::

        minimerge -s


A develop version:
------------------
If you want to be bleeding edge and not lhave a 3 years old debianised
minitage, you can give a try to the egg in developement mode?

    If you need to, fire your virtualenv::

        source ~/minitage/bin/activate

    Get the sources::

        mkdir -p ~/repos/minitage
        cd ~/repos/minitage
        hg clone http://hg.minitage.org/hg/minitage/eggs/minitage.core
        hg clone http://hg.minitage.org/hg/minitage/eggs/minitage.recipe

    Or update them::

        hg pull -u -R ~/repos/minitage/minitage.core
        hg pull -u -R ~/repos/minitage/minitage.recipe


    Install/Reinstall minitage in develop mode::

        cd ~/repos/minitage/minitage.core
        python setup.py develop
        cd ~/repos/minitage/minitage.recipe
        python setup.py develop



Syncing packages
=================

    To sync all your minilays

        If you need to, fire your virtualenv::

            source ~/minitage/bin/activate

        Sync::

            minimerge -s

