❓ FAQ

What versions of Polars are supported?

Short answer: Polars == 1.29.0 is supported.

Long answer: We recommend handling most of the heavy lifting on the DataFusion side (e.g., using SQL and views) and relying on Polars’ streaming capabilities primarily for projection, filtering and sinking results. Right now, Polars 1.29.0 is the last version that supports pyo3 0.24.x that is required by DataFusion. With the most recet version of polars-bio (0.13.0) we migrated to the Polars new streaming engine.
What to do if I get Illegal instruction (core dumped) when using polars-bio? This error is likely due to the fact that the ABI of the polars-bio wheel package does not match the ABI of the Python interpreter. To fix this, you can build the wheel package from source. See Quickstart for more information.
```
#/var/log/syslog

polars-bio-intel kernel: [ 1611.175045] traps: python[8844] trap invalid opcode ip:709d3ec253cc sp:7ffcc28754e8 error:0 in polars_bio.abi3.so[709d36533000+9aab000]
```
How to build the documentation? To build the documentation, you need to install the polars-bio package and then run the following command in the root directory of the repository:
```
MKDOCS_EXPORTER_PDF=false JUPYTER_PLATFORM_DIRS=1 mkdocs serve  -w polars_bio
```
Some pages of the documentation take a while to build—to speed up the process, you can disable dynamic content rendering:
```
MKDOCS_EXPORTER_PDF=false ENABLE_MD_EXEC=false ENABLE_MKDOCSTRINGS=false ENABLE_JUPYTER=false JUPYTER_PLATFORM_DIRS=1 mkdocs serve
```

How to build the source code and install in the current virtual environment?

RUSTFLAGS="-Ctarget-cpu=native" maturin develop --release  -m Cargo.toml

How to run the integration tests? To run the integration tests, you need to have the azure-cli, docker, and pytest installed. Then, you can run the following commands:
```
cd it
source bin/start.sh
JUPYTER_PLATFORM_DIRS=1 pytest it_object_storage_io.py -o log_cli=true --log-cli-level=INFO
source bin/stop.sh
```
Check the README in it directory for more information.