Metadata-Version: 2.3
Name: esgvoc
Version: 0.1.2
Summary: python library and CLI to interact with WCRP CV
Project-URL: Repository, https://github.com/ESPRI-Mod/cmipld
Author-email: TROUSSELLIER Laurent <laurent.troussellier@ipsl.fr>, Gardoll Sébastien <sebastien@gardoll.fr>
Requires-Python: >=3.12
Requires-Dist: idna>=3.10
Requires-Dist: pydantic>=2.9.2
Requires-Dist: pyld>=2.0.4
Requires-Dist: requests>=2.32.3
Requires-Dist: sqlalchemy>=2.0.36
Requires-Dist: sqlmodel>=0.0.22
Requires-Dist: toml>=0.10.2
Requires-Dist: typer>=0.15.0
Description-Content-Type: text/markdown


# Esgvoc Library

Esgvoc is a Python library designed to simplify interaction with controlled vocabularies (CVs) used in climate data projects. It supports querying, caching, and validating terms across various CV repositories like the Universe and project-specific repositories (e.g., CMIP6Plus).

---

## Features

- **Query controlled vocabularies**:
  - Retrieve terms, collections, or descriptors.
  - Perform cross-validation and search operations.

- **Caching**:
  - Download CVs to a local database for offline use.
  - Keep the local cache up-to-date.

- **Validation**:
  - Validate strings against CV terms and templates.
  - Supports case-sensitive, wildcard, and approximate matching.

---

## Installation

Esgvoc is available on PyPI. Install it with pip:

```bash
pip install esgvoc
```

in order to get the latest possible CV 


```bash
esgvoc install
```
