qvd 0.6.2

High-performance library for reading, writing and converting Qlik QVD files with Parquet/Arrow/DataFusion support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

# qvd

[![Crates.io](https://img.shields.io/crates/v/qvd.svg)](https://crates.io/crates/qvd)
[![PyPI](https://img.shields.io/pypi/v/qvdrs.svg)](https://pypi.org/project/qvdrs/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

High-performance Rust library for reading, writing, converting and merging Qlik QVD files.

> **Disclaimer:** This project is **not** affiliated with Qlik Technologies or QlikTech. QVD is a proprietary format; all trademarks belong to Qlik. This library was built from scratch using publicly available information. See [LEGAL.md](LEGAL.md) for details.

## Features

- **Read/Write** QVD with byte-identical roundtrip (tested on 399 files up to 2.8 GB)
- **Streaming** chunk-based reader for large files
- **EXISTS()** O(1) index + filtered reads (2.5x faster than Qlik Sense)
- **Concatenate** — pure append with strict/union schema modes
- **PK Merge** — upsert/dedup by primary key (replace/skip/error). First QVD library with this
- **Parquet/Arrow** — bidirectional conversion, `write_arrow()` for direct Arrow-to-QVD
- **DuckDB / DataFusion** — register QVD as SQL tables
- **Python** — PyArrow, pandas, Polars via zero-copy Arrow bridge
- **CLI** — inspect, convert, filter, head

## Quick Start

```toml
# Cargo.toml
qvd = "0.6.2"
```
```rust
let table = qvd::read_qvd_file("data.qvd")?;
qvd::write_qvd_file(&table, "copy.qvd")?;
```

```bash
pip install qvdrs
```
```python
import qvd
table = qvd.read_qvd("data.qvd")
table.save("copy.qvd")
```

## Documentation

| | |
|---|---|
| [Rust Examples](docs/rust_examples.md) | Read/write, streaming, EXISTS, Parquet, Arrow, concat, PK merge, DataFusion |
| [Python Examples](docs/python_examples.md) | Read/write, Arrow, pandas, Polars, DuckDB, concat, PK merge, workflows |
| [API Reference](docs/api_reference.md) | Full API tables for Rust and Python |
| [Release Notes](RELEASE_NOTES.md) | Changelog for all versions |

## License

MIT — Stanislav Chernov ([@bintocher](https://github.com/bintocher))