vivcpy 0.4.0

Python package to retrieve passport data from the Vitis International Variety Catalogue (VIVC).

vivcPy 🍇

A Python library for retrieving passport data from the Vitis International Variety Catalogue (VIVC). Its goal is to strengthen the digital ecosystem and interoperability within the viticulture sector by making variety data easily accessible. The VIVC variety number serves as a unique identifier to unambiguously reference grape varieties across digital tools, and this package allows you to programmatically retrieve and integrate that data into your workflows.

Currently, only passport data is covered. However, the VIVC database contains much more data that is not yet supported. Contributions are welcome!

Installation

pip install vivcpy

[!WARNING] This library is still in early development. Breaking changes may occur between versions, so pinning to a specific version is recommended.

Usage

from vivcpy.search import PassportDataSearch, PassportDataSearchParams
from vivcpy.enums import ColorOfBerrySkin, Species

params = PassportDataSearchParams(
    color_of_berry_skin=ColorOfBerrySkin.RED,
    species=Species.VITIS_VINIFERA_SUBSP_SATIVA,
)

for variety in PassportDataSearch(params):
    print(variety.prime_name)

Collect all results into a list:

varieties = list(PassportDataSearch(params))

Development

Install dev dependencies:

pip install -e ".[dev]"

Run tests:

python -m unittest tests

Format code:

black vivcpy tests