Sparkless — PySpark-compatible DataFrames without the JVM
Install: pip install "sparkless>=4,<5"
Use Sparkless to run PySpark-style unit tests and local pipelines 10–100× faster in CI. Powered by the open-source Rust engine robin-sparkless (Polars execution).
Not a full cluster replacement. See Before you adopt for UDF, parity, and production caveats.
Choose your path
| I want to… | Start here |
|---|---|
| Use Sparkless in Python (tests, local pipelines) | python/README.md · pip install "sparkless>=4,<5" |
| Embed the Rust engine | docs/QUICKSTART.md · robin-sparkless = "4" on crates.io |
| Contribute | CONTRIBUTING.md · make check-full |
Full documentation: Read the Docs
Quick start (Python)
# Swap the import—everything else stays the same.
from sparkless.sql import SparkSession, functions as F
spark = SparkSession.builder.app_name("demo").get_or_create()
df = spark.createDataFrame([{"x": 1}, {"x": 2}])
df.filter(F.col("x") > 1).show()
pip install "sparkless>=4,<5"
More: Python getting started · Testing guide · FAQ
Why Sparkless (Python)?
- Familiar API —
SparkSession,DataFrame,Column, and PySpark-like functions so you can reuse patterns without the JVM. - Fast local execution — Runs natively (no JVM) and uses Polars for IO, expressions, and aggregations.
- Test the same suite two ways — Use
sparkless.testingto run tests with Sparkless (fast) or real PySpark (parity checks). - Optional “Spark-like” features — SQL, temp/global temp views,
saveAsTable, Delta, and JDBC (see python/README.md).
Features (Python surface)
| Area | What’s included |
|---|---|
| Core | SparkSession, DataFrame, Column, functions |
| IO | CSV, Parquet, JSON, Delta |
| Expressions | col, lit, when/otherwise, casts, null handling |
| Aggregates | count, sum, avg, min, max, groupBy().agg() |
| Window | row_number, rank, dense_rank, lag, lead, first_value, last_value via .over() |
| Arrays, strings, JSON | Common PySpark functions (explode, regexp_*, get_json_object, from_json, to_json, …) |
| SQL + views | spark.sql, temp/global temp views, saveAsTable, catalog().listTables() |
| JDBC | Read/write via spark.read.jdbc(...) / df.write.jdbc(...) |
Parity: 200+ fixtures validated against PySpark. Before you adopt · PySpark differences · Parity status
Installation
Python (sparkless v4) — recommended
pip install "sparkless>=4,<5"
Contributors: follow the uv environment, native build, and test workflow.
Rust engine (optional)
Most users should use the Python package above. To embed the engine in Rust:
[dependencies]
robin-sparkless = "4"
Optional features: sql, delta, jdbc, sqlite, jdbc_mysql. See docs/QUICKSTART.md.
Development
Prerequisites: Rust (see rust-toolchain.toml), Python 3.8+, uv. The contributor setup installs Maturin. Java only for SPARKLESS_TEST_MODE=pyspark.
See CONTRIBUTING.md for setup, make check-full, pytest, and maturin workflow.
| Command | Description |
|---|---|
make check-full |
Full CI-equivalent check (Rust + Python) |
pytest tests/ -v |
Python tests (sparkless backend) |
SPARKLESS_TEST_MODE=pyspark pytest tests/ -v |
Same tests against real PySpark |
make check |
Rust: format, clippy, audit, tests |
Documentation
| Resource | Description |
|---|---|
| Python package | Install, quick start, platform matrix, API overview |
| Read the Docs | Getting started, testing, migration, FAQ |
| Before you adopt | UDF limits, parity caveats, production notes |
| CONTRIBUTING | Dev setup and PR checklist |
| docs.rs | Rust API reference |
| Testing Guide | Dual-mode testing with sparkless.testing |
| PySpark Differences | Known divergences |
| RELEASING | Publishing to crates.io and PyPI |
See CHANGELOG.md for version history.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for sparkless 4.15.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| sparkless-4.15.3.tar.gz | 724.6 kB | Without provenance | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| sparkless-4.15.3-cp38-abi3-win_arm64.whl | CPython 3.8 | abi3 | Windows ARM64 | Details |
| sparkless-4.15.3-cp38-abi3-win_amd64.whl | CPython 3.8 | abi3 | Windows x86-64 | Details |
| sparkless-4.15.3-cp38-abi3-musllinux_1_2_x86_64.whl | CPython 3.8 | abi3 | Linux musl 1.2+ x86-64 | Details |
| sparkless-4.15.3-cp38-abi3-musllinux_1_2_aarch64.whl | CPython 3.8 | abi3 | Linux musl 1.2+ ARM64 | Details |
| sparkless-4.15.3-cp38-abi3-manylinux_2_28_aarch64.whl | CPython 3.8 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| sparkless-4.15.3-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.8 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| sparkless-4.15.3-cp38-abi3-macosx_11_0_arm64.whl | CPython 3.8 | abi3 | macOS 11.0+ ARM64 | Details |
| sparkless-4.15.3-cp38-abi3-macosx_10_12_x86_64.whl | CPython 3.8 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 323.4 MB
Release files / sparkless-4.15.3.tar.gz
| Download URL | sparkless-4.15.3.tar.gz |
|---|---|
| Size | 724.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c02ac703a0073fe5297132881684a16b779cd6fa375a900b543d17b5de60e8d3
|
|
BLAKE2b-256 checksum How to use checksums |
3c13b84245a045dceeef95eb9dcc6cfcbce85ded2df881f4655ba648e8359b31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / sparkless-4.15.3-cp38-abi3-win_arm64.whl
| Download URL | sparkless-4.15.3-cp38-abi3-win_arm64.whl |
|---|---|
| Size | 40.1 MB |
| Tags | CPython 3.8 Windows ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
7d20ef748f329dcd079f9624d19a691ad498a8363cf6cee0d30d2c3c7cf513b2
|
|
BLAKE2b-256 checksum How to use checksums |
88f655433c4ce3a66fcb0ce1c18f39d3bcaf8cdc58a2f2087b25894619b4e92e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / sparkless-4.15.3-cp38-abi3-win_amd64.whl
| Download URL | sparkless-4.15.3-cp38-abi3-win_amd64.whl |
|---|---|
| Size | 43.8 MB |
| Tags | CPython 3.8 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
0a957ccc782bd843c0bad26c881dd2a38fe33c3e055c753d6f729b5d476c7818
|
|
BLAKE2b-256 checksum How to use checksums |
5f093b6c9d0178e11b5d72defa755116b2e065eab7d8a9211ae643560e11deec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / sparkless-4.15.3-cp38-abi3-musllinux_1_2_x86_64.whl
| Download URL | sparkless-4.15.3-cp38-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 41.8 MB |
| Tags | CPython 3.8 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
305592f50d5cc35f430d800f7f5f464e680cd0c6d8bd7b8dfc2773e5f9d2c0a1
|
|
BLAKE2b-256 checksum How to use checksums |
0a68a29d5fb9807094eac0909b335eab462aa4a938935a2d067ad8b4d12f360d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / sparkless-4.15.3-cp38-abi3-musllinux_1_2_aarch64.whl
| Download URL | sparkless-4.15.3-cp38-abi3-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 39.0 MB |
| Tags | CPython 3.8 Linux musl 1.2+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
97c63713dd2d40f279bdfbf9ec10d5c9be23a9b5b293263ae2b6dca5df586c14
|
|
BLAKE2b-256 checksum How to use checksums |
c4bf985c478f1eaaec279cdb0c9caee92162a0d6d18bf382e8d439d4499c1923
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / sparkless-4.15.3-cp38-abi3-manylinux_2_28_aarch64.whl
| Download URL | sparkless-4.15.3-cp38-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 39.0 MB |
| Tags | CPython 3.8 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
b1490b0687fd7f7c939532d41dcaebf3f133593dc0589da83325c0a701c55249
|
|
BLAKE2b-256 checksum How to use checksums |
b674272ade2ed3aeaad054c0c898847b5503c019f502d1e58d113c3d56eeb8b2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / sparkless-4.15.3-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | sparkless-4.15.3-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 41.7 MB |
| Tags | CPython 3.8 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
b59715c70e2fe04237bdc96ee15d12c10594249818af9bc70b5e415bb8f15831
|
|
BLAKE2b-256 checksum How to use checksums |
48c418b22de42c61f4534e6a359528a74cdd27c2e086a842aff7b8cf79dc716f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / sparkless-4.15.3-cp38-abi3-macosx_11_0_arm64.whl
| Download URL | sparkless-4.15.3-cp38-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 37.3 MB |
| Tags | CPython 3.8 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
1ba316a96bc8017c4b39998a5024df70b12046f055ae56d2b132c8403f87fbc9
|
|
BLAKE2b-256 checksum How to use checksums |
608051ea8614b1b07f840c19a6bfdfeb61e30d3872cc680ce804aec8b39fb7e2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / sparkless-4.15.3-cp38-abi3-macosx_10_12_x86_64.whl
| Download URL | sparkless-4.15.3-cp38-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 40.0 MB |
| Tags | CPython 3.8 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
3492451227b0a5e983a5b2fcae32a85a48ca329de3520638f805204d919ca855
|
|
BLAKE2b-256 checksum How to use checksums |
4d2270804facc60acb11b3ba71c8d915c891eb088367160c6df232df1b707efd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Security for sparkless 4.15.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
