pyvrl

What it is and what it does

pyVRL is a Python binding to Vector's VRL, a domain-specific language for data transformation. It lets you define data remapping logic as VRL programs and apply them to Python dictionaries through a Transform object. The package compiles to native code via Rust, providing performance benefits for data pipeline operations.

The typical workflow is to instantiate a Transform with a VRL program string, then call its remap() method on data dictionaries. VRL supports field manipulation, function calls (like upcase! and uuid_v7()), and conditional logic. The project is minimal and dormant—last updated in May 2024—with no runtime dependencies beyond Python itself.

Use it for:

• Transform and normalize structured data fields in ETL pipelines using VRL syntax
• Apply consistent remapping rules to event or log data before storage or downstream processing
• Generate derived fields (like UUIDs or transformed values) during data ingestion workflows

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Exposes Vector's VRL (Vector Remap Language) to Python, enabling fast data transformation and remapping using VRL programs.

Yes, if you are already using Vector and want to apply VRL transforms within Python code. The permissive license and zero runtime dependencies make it low-risk to add. However, the project's dormant status and lack of documentation beyond a single example mean you should verify that VRL's feature set meets your transformation needs and be prepared to work from the Vector VRL documentation directly.

Install

pyvrl on PyPI

pip install pyvrl

uv add pyvrl

poetry add pyvrl

Installing pyvrl

Before you install

Medium install friction due to compiled wheels across multiple platforms and Python versions. Project is dormant since May 2024 with no recent maintenance activity, though the repository remains active.

License in practice

Licensed under MIT (permissive), allowing broad use, modification, and distribution with minimal restrictions.

Quickstart

pip install pyVRL

from pyvrl import Transform
data = {"x": "foo"}
vrl_program = '.y = "bar"\n.x = upcase!(.x)\n.'
transform = Transform(vrl_program)
output = transform.remap(data)

Requires Python 3.10 or later; compiled wheels are provided for common platforms but may require building from source on unsupported architectures.

Verify before relying

• Whether VRL program syntax and capabilities are documented beyond the single example provided
• Performance characteristics and typical use-case scale compared to native Python transforms
• Whether the project will receive updates for future Python versions beyond 3.10+

Package facts

Evidence: pyVRL-0.0.2-cp310-cp310-macosx_10_12_x86_64.whl; pyVRL-0.0.2-cp310-cp310-macosx_11_0_arm64.whl; pyVRL-0.0.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; pyVRL-0.0.2-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl; pyVRL-0.0.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl; pyVRL-0.0.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl; pyVRL-0.0.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; pyVRL-0.0.2-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl; pyVRL-0.0.2-cp310-none-win32.whl; pyVRL-0.0.2-cp310-none-win_amd64.whl; pyVRL-0.0.2-cp311-cp311-macosx_10_12_x86_64.whl; pyVRL-0.0.2-cp311-cp311-macosx_11_0_arm64.whl; pyVRL-0.0.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; pyVRL-0.0.2-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl; pyVRL-0.0.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl; pyVRL-0.0.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl; pyVRL-0.0.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; pyVRL-0.0.2-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl; pyVRL-0.0.2-cp311-none-win32.whl; pyVRL-0.0.2-cp311-none-win_amd64.whl

Tags

More Utilities packages