INSTALL.txt

======================================
INSTALL: pydabu -- Python data bubble
======================================

:Version: 2023-05-10
:Author: Daniel Mohr
:Email: daniel.mohr@dlr.de

.. contents::

.. footer::

   ###Page### / ###Total###


INSTALL: pydabu
+++++++++++++++


info
====


before you install
==================


Modules
-------

pydabu needs the following Python modules (most of them are standard and
already in your Python installation from a package management)

* argparse
* base64
* datetime
* getpass
* hashlib
* json
* jsonschema
* logging
* os
* os.path
* pkgutil
* re
* setuptools
* subprocess
* sys
* tempfile
* time
* types
* warnings

and the own modules which comes with this package. Most of the modules
are only necessary at runtime and only in some components.

You can also asked the installation routine/script for the Python modules::

  env python3 setup.py --help
  env python3 setup.py --requires

There is also a small extra command to check for availability of
necessary Python modules::

  env python3 setup.py check_modules

If you want to use this complete software you should have no modules
which are not available.

The following modules are optional:

* cfchecker.cfchecks
* netCDF4


unittests
---------

You can run a few unittests::

  env python3 setup.py run_unittest --src local

But the scripts are not tested before installing.
After installation you can run unittests on the scripts as well
(see :ref:`after you install.unittests`).

pytest
------

Instead of the standard module unittest you can also use pytest to run
all available unittests (including scripts)::

  env python3 setup.py run_pytest --src local

But the scripts are not tested before installing.
After installation you can run these tests on the scripts as well
(see :ref:`after you install.pytest`).


install by setup.py using pip
=============================

You can use the Python package manager system pip. This allows you to
handle dependencies, too.

global-install
--------------
To install this software global to / the following steps are to perform::

  tar xzf pydabu-*.tar.*
  cd pydabu-*/
  pip3 install --system .

Or you can directly install from the internet::

  pip3 install --system https://gitlab.com/dlr-pa/pydabu/-/archive/master/pydabu-master.zip

Then you can uninstall with this information.


home-install
------------
To install this software to your $HOME the following steps are to perform::

  tar xzf pydabu-*.tar.*
  cd pydabu-*/
  pip3 install --user .

Or you can directly install from the internet::

  pip3 install --user https://gitlab.com/dlr-pa/pydabu/-/archive/master/pydabu-master.zip

Then you can uninstall with this information.


uninstall
---------

If you have done the above installation you can use pip to uninstall::

  pip3 uninstall pydabu


hints (pip)
-----------

Keep in mind to have the right paths.

  For the above installation to $HOME the software installs in::

    ~/.local/bin
    ~/.local/lib/python*

  Please make sure to have these paths in $PATH and $PYTHONPATH, respectively.
  For example::

    export PATH=$PATH:~/.local/bin
    export PYTHONPATH=~/.local/lib/python3.6


after you install
=================

.. _after you install.unittests:

unittests (after installation)
------------------------------

Now you can run all available unittests (including scripts)::

  env python3 setup.py run_unittest

.. _after you install.pytest:

pytest (after installation)
---------------------------

Instead of the standard module unittest you can also use pytest to run
all available unittests (including scripts)::

  env python3 setup.py run_pytest

This command has a few interesting parameters, e. g.::

  env python3 setup.py run_pytest --parallel --coverage


hints
=====

Ubuntu 20.04 and 22.04
----------------------

You can find most necessary modules in the package management of Ubuntu 20.04,
e. g. ::

    sudo apt install python3-jsonschema python3-netcdf4 python3-pip python3-setuptools python3-wheel

The command check_netcdf_file of :program:`pydabu` needs the package
cfchecker.cfchecks which is not in the package management.
You can install it with pip, e. g.::

    sudo apt install libudunits2-0
    pip3 install cfchecker

To build the documentation you do not only need the above packages. In addition
we use sphinx-jsonschema, e. g.::

    sudo apt install latexmk make python3-recommonmark python3-sphinx python3-sphinx-argparse rsync texlive-fonts-recommended texlive-latex-extra texlive-latex-recommended
    pip3 install sphinx-jsonschema

For unning the tests with `pytest` you need::

    sudo apt install python3-pytest python3-pytest-cov python3-pytest-xdist


openSUSE Leap 15.4 and 15.5
---------------------------

To use :program:`pydabu` you need from the package management::

    zypper --non-interactive install gcc lsb-release netcdf-devel python3 python3-devel python3-jsonschema python3-numpy python3-pip python3-setuptools python3-wheel udunits2-devel

The command check_netcdf_file of :program:`pydabu` needs the package
cfchecker.cfchecks which is not in the package management.
You can install it with pip, e. g.::

    pip3 install --user netCDF4 cfchecker

For unning the tests with `pytest` you need::

    zypper --non-interactive install python3-pytest python3-pytest-cov python3-pytest-xdist