Additional information for developers
=====================================

Installation method for developers
----------------------------------

Clone the repository of discopygal (or use a ZIP of it) and enter it::

    git clone https://bitbucket.org/taucgl/discopygal.git
    cd dicsopygal

Automatically with Pipenv
~~~~~~~~~~~~~~~~~~~~~~~~~

After pipenv is installed:

Install the virtual environment:

    .. code-block::

            pipenv install

    To use a specific Python version use the command::

        pipenv install --python <path_to_python_executable>

For purposes of developing the repo, like building docs or packages, install with the command::

        pipenv install --dev


To activate environment to run discopygal run::

    pipenv shell


Installing manually
~~~~~~~~~~~~~~~~~~~

Install CGALPY (don't install currently if installing discopygal from source using pipenv)

    Can be done simply with the command::

            pip install git+https://bitbucket.org/taucgl/cgal-python-bindings/src/master/

    (for full installation guide can be found here: https://bitbucket.org/taucgl/cgal-python-bindings/src/master/)

You can make sure that code works correctly by running the unit tests:

.. code-block::

    python -m unittest

Install additional packages using pip according to received errors

And to build (and install) the whl file, run the following in cmd/bash:

.. code-block::

    pip install build
    python ./scripts/build_package.py
    pip install dist/discopygal-taucgl-<version>.whl