Python applications that use Biolovision/VisioNature (VN) API to:

• download data from VN sites and stores it to a Postgresql database.
• update sightings directly in VN site

Applications are available either as:

• Python modules from PyPI
• Docker images from Docker Hub

They are tested under Linux Ubuntu >20 or Debian 10. Other Linux distributions could work. Windows is not tested at all and will probably not work.

See Documentation for more informations.

A thin Python layer on top of Biolovision API is provided, as described in API Manual.

These instructions present the steps required to install the Python applications.

Windows:

Install Python from Microsoft store

Add python script directory to Path, as described in How to add Python to Windows PATH.

Linux: add the following debian packages:

sudo apt -y install build-essential python3-dev python3-venv

Create a python virtual environment, activate it and update basic tools:

python3 -m venv env_VN
source env_VN/bin/activate
python -m pip install --upgrade pip

Install from PyPI:

pip install Client-API-VN

These instructions present the steps required to install the Docker applications:

docker pull dthonon/client-api-vn
docker run --name xfer_vn \
           --mount source=xfer_vn,target=/root \
           --workdir /root \
           --tty --interactive \
           dthonon/client-api-vn bash

This docker only contains the application and requires an external Postgresql database.

The following steps are the common to both Python and Docker installation.

See Documentation for more informations.

See Documentation for more informations.

For Linux and Postgresql installation, refer to Server installation.

Installation requires the following python module:

pip

All other python dependencies are managed by pip install.