Metadata-Version: 2.4
Name: vtlengine
Version: 1.7.0
Summary: Run and Validate VTL Scripts
Keywords: vtl,sdmx,vtlengine,Validation and Transformation Language
Author-Email: MeaningfulData <info@meaningfuldata.eu>
Maintainer-Email: =?utf-8?q?Francisco_Javier_Hernandez_del_Ca=C3=B1o?= <javier.hernandez@meaningfuldata.eu>, =?utf-8?q?Alberto_Hernandez_del_Ca=C3=B1o?= <alberto.hernandez@meaningfuldata.eu>, Mateo de Lorenzo Argeles <mateo.delorenzo@meaningfuldata.eu>
License-Expression: AGPL-3.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Project-URL: Repository, https://github.com/Meaningful-Data/vtlengine
Project-URL: Documentation, https://docs.vtlengine.meaningfuldata.eu
Project-URL: MeaningfulData, https://www.meaningfuldata.eu/
Project-URL: IssueTracker, https://github.com/Meaningful-Data/vtlengine/issues
Project-URL: Authors, https://github.com/Meaningful-Data/vtlengine/graphs/contributors
Requires-Python: >=3.9
Requires-Dist: duckdb<1.5,>=1.4
Requires-Dist: pysdmx[xml]<2.0,>=1.15.1
Requires-Dist: jsonschema<5.0,>=3.2.0
Requires-Dist: sqlglot<23.0,>=22.2.0
Requires-Dist: pandas<3.0,>=2.1.4
Requires-Dist: networkx<3.0,>=2.8
Requires-Dist: pyarrow<20.0,>=14.0; python_version < "3.10"
Requires-Dist: pyarrow<25.0,>=14.0; python_version >= "3.10" and python_version < "3.14"
Requires-Dist: pyarrow<25.0,>=22.0; python_version >= "3.14"
Requires-Dist: numpy<2.1,>=2.0.2; python_version < "3.10"
Requires-Dist: numpy<2.5,>=2.2.0; python_version >= "3.10"
Requires-Dist: psutil<8.0,>=7.2
Description-Content-Type: text/markdown

# VTL Engine

|              |                                                                                                                                                                                |
|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Testing      | [![Testing](https://github.com/Meaningful-Data/vtlengine/actions/workflows/testing.yml/badge.svg)](https://github.com/Meaningful-Data/vtlengine/actions/workflows/testing.yml) |
| Package      | [![PyPI Latest Release](https://img.shields.io/pypi/v/vtlengine.svg)](https://pypi.org/project/vtlengine/)                                                                     |
| License      | [![License - AGPL 3.0](https://img.shields.io/pypi/l/vtlengine.svg)](https://github.com/Meaningful-Data/vtlengine/blob/main/LICENSE.md)                                        |
| Mentioned in | [![Mentioned in Awesome Official Statistics ](https://awesome.re/mentioned-badge.svg)](https://github.com/SNStatComp/awesome-official-statistics-software)                                               |

## Introduction

The VTL Engine is a Python library that allows you to validate, format and execute VTL scripts.

It is a Python-based library around
the [VTL Language 2.1](https://sdmx-twg.github.io/vtl/2.1/html/index.html).

## Useful Links

- [MeaningfulData: who we are](https://www.meaningfuldata.eu)
- [Documentation](https://docs.vtlengine.meaningfuldata.eu)
- [Source Code](https://github.com/Meaningful-Data/vtlengine)
- [Bug Tracker](https://github.com/Meaningful-Data/vtlengine/issues?q=is%3Aopen+is%3Aissue+label%3Abug)
- [New features Tracker](https://github.com/Meaningful-Data/vtlengine/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement)

## Installation

### Requirements

The VTL Engine requires Python 3.9 or higher.

### Install with pip

To install the VTL Engine on any Operating System, you can use pip:

```bash

pip install vtlengine

```

*Note: it is recommended to install the VTL Engine in a virtual environment.*

S3 URI support is provided by the DuckDB execution engine (`use_duckdb=True`). See the
[DuckDB Engine documentation](https://docs.vtlengine.meaningfuldata.eu/latest/duckdb_engine.html)
for details.

## Documentation

The documentation for the VTL Engine is available
at [docs.vtlengine.meaningfuldata.eu](https://docs.vtlengine.meaningfuldata.eu).