Metadata-Version: 2.5
Name: pipeloom-pandas
Version: 0.7.0
Summary: pandas engine for pipeloom: eager DataFrames and file tables.
Project-URL: Repository, https://github.com/emanuel-luis/pipeloom
Project-URL: Documentation, https://emanuel-luis.github.io/pipeloom/
Project-URL: Changelog, https://github.com/emanuel-luis/pipeloom/blob/main/CHANGELOG.md
Author-email: Emanuel Luis <emanuel.filho08@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: data-engineering,pandas,pipelines,pipeloom
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: pandas<4,>=2.3.3
Requires-Dist: pipeloom~=0.7.0
Requires-Dist: pyarrow>=22
Description-Content-Type: text/markdown

# pipeloom-pandas

The [pandas](https://pandas.pydata.org) engine for [pipeloom](https://github.com/emanuel-luis/pipeloom).

```console
$ pip install "pipeloom[pandas]"
```

Select it in a target:

```yaml
targets:
  dev:
    engine: {kind: pandas}
    catalog: {kind: filesystem, root: warehouse}
```

- Relations are eager `DataFrame`s. Python models receive `DataFrame` inputs, or Narwhals frames
  with `frame_api: narwhals`.
- No SQL models and no views: validation rejects them (PLC502, PLC507).
- Reads `parquet`, `csv`, `json` and `ndjson` sources. Writes tables through the `filesystem`
  catalog with the `append`, `overwrite`, `merge` and `replace_partitions` strategies, and an
  idempotency token makes a repeated write a no-op.
- Supports `incremental` models, the schema-change policy and expectations with quarantine.

Documentation: https://emanuel-luis.github.io/pipeloom/latest/plugins/pandas/

License: Apache-2.0.
