Client_API_VN 2.12.0

Python API to Biolovision API and applications using it

Presentation

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.

Installation - Python

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

Installation - Docker

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.

Getting Started - transfer_vn

See Documentation for more informations.

Getting Started - update_vn

See Documentation for more informations.

Prerequisites

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.