cuallee

library0.15.4pypypi✓ verified 89d ago

Cuallee is a Python library for data validation on DataFrame APIs including Snowflake/Snowpark, Apache PySpark, and Pandas. It provides declarative check rules to validate data quality. Current version is 0.15.4, requiring Python >=3.10. Active development with frequent releases.

data testing

pip install cuallee

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CUALLEE

cuallee

datapythonv0.15.4

Install

2.2s avg

Import

93ms

Disk

20MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.15.4 · 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.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.076s · 22.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.2s · import 0.072s · 23MB

20MB installed

● package 20MB

Code

Verified usage

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

Check

✓ from cuallee import Check

CheckLevel

✓ from cuallee import CheckLevel

Basic usage: create a Check, add rules, validate a DataFrame, and check pass/fail.

import pandas as pd from cuallee import Check, CheckLevel # Create a sample DataFrame df = pd.DataFrame({'id': [1, 2, 3], 'value': [10, 20, 30]}) # Define check rules check = Check(CheckLevel.WARNING, 'my_check') check.is_complete('id') check.is_unique('id') check.is_greater_than('value', 5) # Validate and get results results = check.validate(df) print(results) # Use ok() to check if all passed if check.ok(df): print("All checks passed!") else: print("Some checks failed.")

Debug

Known issues

gotchaCheck.ok() method requires recomputing validation; prefer storing results if you need both results and pass/fail.

fix

Store validation results with `result = check.validate(df)`, then use `result.status[result.status == 'PASS'].all()` or similar.

affects: >=0.15.0

gotchaDuckDB relation objects must be registered before passing to cuallee, otherwise error: 'DuckDbPyRelation' object has no attribute 'columns'.

fix

Use `duckdb.register('my_view', relation)` and then pass the registered name or the connection's table.

affects: >=0.15.0

breakingPython 3.9 support dropped, requires Python >=3.10 as of version 0.14.1.

fix

Upgrade Python to 3.10 or higher.

affects: >=0.14.1

Errors

Common errors & fixes

AttributeError: 'DuckDbPyRelation' object has no attribute 'columns'

Passing a DuckDB relation object directly without registering it first.

fix

Register the relation with DuckDB before passing: `duckdb.register('temp', relation)` then use the registered name or a connection.

ModuleNotFoundError: No module named 'cuallee'

Forgetting to install the library.

fix

Run `pip install cuallee`.

TypeError: Check.validate() got an unexpected keyword argument 'verbose'

Using old API that expected 'verbose' parameter; removed in newer versions.

fix

Remove 'verbose' from validate() call; use `print(results)` instead.

Upgrade

Version history

0.15.4latest on PyPI · released Oct 7, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

13 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/canimus/cuallee ↗

packagehttps://pypi.org/project/cuallee/ ↗

homepagehttps://cuallee.com ↗