Registry / data / vtlengine

vtlengine

JSON →
library1.9.0pypypi✓ verified 81d ago

vtlengine is a Python library for running and validating VTL (Validation and Transformation Language) scripts. Version 1.6.8 supports Python >=3.9 and provides an interpreter with a pandas backend. It is released on PyPI with roughly monthly updates.

pip install vtlengine
INSTALL
IMPORT
SIG · VTLENGINE
V
vtlengine
datapythonv1.9.0
Install
15.2s avg
Import
Disk
423MB
Pass rate
5/ 10
Env Coverage5 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v1.9.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.95 runs
build_error
glibc
py 3.103.95 runs
installs and imports cleanly · install 15.2s · import 0.000s · 413MB
423MB installed
● package 423MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

API
from vtlengine import API
from vtlengine import Engine
Interpreter
from vtlengine import Interpreter
run
from vtlengine import run

Demonstrates basic VTL script execution using the Engine class with pandas DataFrames.

from vtlengine import Engine import pandas as pd from datetime import date # Sample data input_ds = pd.DataFrame({ 'id1': ['A', 'B'], 'id2': ['X', 'Y'], 'meas1': [10, 20], 'meas2': [5.5, 7.2] }) # Define VTL script vtl_script = """ define operator mul(a, b) returns c tr := a * b / 2 end operator """ # Initialize engine engine = Engine() # Run VTL script with datasets result = engine.run(vtl_script, datasets={'input_ds': input_ds}) print(result['output_ds'])
Debug
Known issues
breakingThe 'pandas' backend is the default and only supported backend. Using 'pandas' as the backend parameter is required; omitting it uses pandas, but explicitly passing other backends (e.g., 'spark') will raise an error.
fix
Always use backend='pandas' or omit the parameter.
affects: >=1.0.0
deprecatedThe legacy time period representation (time_period_output_format='legacy') was added in 1.6.0 but is deprecated and will be removed in a future version.
fix
Use ISO 8601 format (default) or the new custom format.
affects: 1.6.0 - 1.6.8
gotchaDataFrame columns not matching the DataStructure (if provided) will raise an error since v1.6.4. Ensure column names and types align exactly.
fix
Define DataStructure or ensure DataFrame columns match exactly.
affects: >=1.6.4
Upgrade
Version history
1.9.0latest on PyPI · released Jun 17, 2026
Audit
Dependencies
pandasrequiredRequired for DataFrame input/output.
Agent activity
21 hits · last 30 days
node
18
OpenAI (training)
1
Resources
vtlengine — pip install vtlengine · libregistry