Metadata-Version: 2.4
Name: vtlengine
Version: 1.3.0rc6
Summary: Run and Validate VTL Scripts
License-Expression: AGPL-3.0
License-File: LICENSE.md
Keywords: vtl,sdmx,vtlengine,Validation and Transformation Language
Author: MeaningfulData
Author-email: info@meaningfuldata.eu
Maintainer: Francisco Javier Hernandez del Caño
Maintainer-email: javier.hernandez@meaningfuldata.eu
Requires-Python: >=3.9
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Typing :: Typed
Provides-Extra: all
Provides-Extra: s3
Requires-Dist: antlr4-python3-runtime (>=4.9,<4.10)
Requires-Dist: duckdb (>=1.4,<1.5)
Requires-Dist: fsspec (>=2022.11.0,<2023.0) ; extra == "all"
Requires-Dist: fsspec (>=2022.11.0,<2023.0) ; extra == "s3"
Requires-Dist: jsonschema (>=3.2.0,<5.0)
Requires-Dist: networkx (>=2.8,<3.0)
Requires-Dist: numpy (>=1.23.2,<2) ; python_version < "3.13"
Requires-Dist: numpy (>=2.1.0) ; python_version >= "3.13"
Requires-Dist: pandas (>=2.1.4,<3.0)
Requires-Dist: pysdmx[xml] (>=1.5.2,<2.0)
Requires-Dist: s3fs (>=2022.11.0,<2023.0) ; extra == "all"
Requires-Dist: s3fs (>=2022.11.0,<2023.0) ; extra == "s3"
Requires-Dist: sqlglot (>=22.2.0,<23.0)
Project-URL: Authors, https://github.com/Meaningful-Data/vtlengine/graphs/contributors
Project-URL: Documentation, https://docs.vtlengine.meaningfuldata.eu
Project-URL: IssueTracker, https://github.com/Meaningful-Data/vtlengine/issues
Project-URL: MeaningfulData, https://www.meaningfuldata.eu/
Project-URL: Repository, https://github.com/Meaningful-Data/vtlengine
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 extra

If you want to use the S3 functionality, you can install the VTL Engine with the `s3` extra:

```bash
pip install vtlengine[s3]
```

## Documentation

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