.. _installation_development:

Development Environment
=======================

Installing the Module
----------------------

Installation in Standard Mode
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Install the latest stable released and all its requirements into your virtual
Python environment:

.. code-block:: bash

    $ source ~/bin/virtualenv3/bin/activate
    (virtualenv3)$ pip install --extra-index-url=https://pypi.chrysal.io CioWarehouse2

Create a directory to deploy your instance and retrieve an example of
configuration files:

.. code-block:: bash

    $ wget https://pypi.chrysal.io/conf/CioWarehouse2.zip
    $ unzip CioWarehouse2.zip
    $ rm -f CioWarehouse2.zip

You could update your installation with the following command:

.. code-block:: bash

    (virtualenv3)$ pip install --extra-index-url=https://pypi.chrysal.io -U Chrysalio CioWarehouse2

Now, you can activate your module by adding in your ``development.ini`` the
following options:

.. code-block:: ini

    [app:main]
    chrysalio.includes =
        chrysalio.includes.cache,
        chrysalio.includes.modules,
        ciowarehouse2

    [CioWarehouse2]
    backend.host = localhost
    backend.port = 6540
    locations =
        private:%(here)s/__Warehouses/Private,
        local:%(here)s/__Warehouses/Local,
        remote:%(here)s/__Warehouses/Remote,
        no-vcs:%(here)s/__Warehouses/NoVcs
    managers.root = %(here)s/__Var/Managers
    managers.develop = true
    restful.key = ciosekreet
    restful.token_ttl = 1.0


Installation in Development Mode
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If you want to use the release still in development, follow these steps:

.. code-block:: bash

    $ mkdir ~/Repositories
    $ cd ~/Repositories
    $ git clone https://gitlab.iinov.com/chrysalio/CioWarehouse2.git
    $ source ~/bin/virtualenv3/bin/activate
    (virtualenv3)$ cd CioWarehouse2
    (virtualenv3)$ pip install -e ".[development]"