pyfloe 0.1.0__tar.gz

pyfloe-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+wheels/
+
+# Virtual environments
+.venv/
+
+# Tools
+.ruff_cache/
+.pytest_cache/
+.mypy_cache/
+
+# Coverage
+htmlcov/
+.coverage
+coverage.xml
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# MkDocs
+site/
+
+# OS
+.DS_Store
+Thumbs.db

pyfloe-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Edwardvaneechoud
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyfloe-0.1.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: pyfloe
+Version: 0.1.0
+Summary: Zero-dependency lazy dataframe. Lo-fi data processing for Python.
+Project-URL: Repository, https://github.com/Edwardvaneechoud/pyfloe
+Project-URL: Documentation, https://edwardvaneechoud.github.io/pyfloe/
+Author: Edward van Eechoud
+License-Expression: MIT
+License-File: LICENSE
+Keywords: csv,dataframe,etl,lazy,streaming
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# pyfloe
+
+**Zero-dependency, lazy dataframes for Python.**
+
+pyfloe is a pure-Python dataframe library with lazy evaluation, query optimization, and type safety — no external dependencies required.
+
+```python
+from pyfloe import Floe, read_csv, col, row_number
+
+result = (
+    read_csv("orders.csv")
+    .filter(col("amount") > 100)
+    .with_column("rank", row_number()
+        .over(partition_by="region", order_by="amount"))
+    .select("order_id", "region", "amount", "rank")
+    .sort("region", "rank")
+    .collect()
+)
+```
+
+## Installation
+
+```bash
+pip install pyfloe
+```
+
+## Key features
+
+- **Lazy evaluation** — operations build a query plan; data flows only when you collect
+- **Expression API** — composable column expressions with arithmetic, comparisons, string methods, and conditionals
+- **Window functions** — `row_number`, `rank`, `dense_rank`, `cumsum`, `lag`, `lead`, and more
+- **Datetime handling** — auto-detection from CSV, `.dt` accessor for extraction, truncation, and arithmetic
+- **Streaming I/O** — read and write CSV, TSV, JSONL, JSON, and fixed-width files with constant memory
+- **Query optimizer** — filter pushdown and column pruning
+- **Type safety** — TypedDict validation and `TypedFloe` for IDE-friendly typed results
+
+## Documentation
+
+Full documentation is available at [edwardvaneechoud.github.io/pyfloe](https://edwardvaneechoud.github.io/pyfloe/).
+
+## License
+
+MIT

pyfloe-0.1.0/README.md

@@ -0,0 +1,43 @@
+# pyfloe
+
+**Zero-dependency, lazy dataframes for Python.**
+
+pyfloe is a pure-Python dataframe library with lazy evaluation, query optimization, and type safety — no external dependencies required.
+
+```python
+from pyfloe import Floe, read_csv, col, row_number
+
+result = (
+    read_csv("orders.csv")
+    .filter(col("amount") > 100)
+    .with_column("rank", row_number()
+        .over(partition_by="region", order_by="amount"))
+    .select("order_id", "region", "amount", "rank")
+    .sort("region", "rank")
+    .collect()
+)
+```
+
+## Installation
+
+```bash
+pip install pyfloe
+```
+
+## Key features
+
+- **Lazy evaluation** — operations build a query plan; data flows only when you collect
+- **Expression API** — composable column expressions with arithmetic, comparisons, string methods, and conditionals
+- **Window functions** — `row_number`, `rank`, `dense_rank`, `cumsum`, `lag`, `lead`, and more
+- **Datetime handling** — auto-detection from CSV, `.dt` accessor for extraction, truncation, and arithmetic
+- **Streaming I/O** — read and write CSV, TSV, JSONL, JSON, and fixed-width files with constant memory
+- **Query optimizer** — filter pushdown and column pruning
+- **Type safety** — TypedDict validation and `TypedFloe` for IDE-friendly typed results
+
+## Documentation
+
+Full documentation is available at [edwardvaneechoud.github.io/pyfloe](https://edwardvaneechoud.github.io/pyfloe/).
+
+## License
+
+MIT

pyfloe-0.1.0/pyproject.toml

@@ -0,0 +1,60 @@
+[project]
+name = "pyfloe"
+version = "0.1.0"
+description = "Zero-dependency lazy dataframe. Lo-fi data processing for Python."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "Edward van Eechoud" }]
+keywords = ["dataframe", "lazy", "streaming", "etl", "csv"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Repository = "https://github.com/Edwardvaneechoud/pyfloe"
+Documentation = "https://edwardvaneechoud.github.io/pyfloe/"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pyfloe"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/pyfloe", "tests", "README.md", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 99
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["E402"]
+"src/pyfloe/expr.py" = ["E402"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "ruff>=0.4",
+    "mkdocs>=1.6",
+    "mkdocs-material>=9.5",
+    "mkdocstrings[python]>=0.27",
+]

pyfloe-0.1.0/src/pyfloe/__init__.py

@@ -0,0 +1,46 @@
+from .core import Floe, GroupByBuilder, TypedFloe
+from .expr import (
+    Agg,
+    AggFunc,
+    Col,
+    CumKind,
+    DateTrunc,
+    DateTruncUnit,
+    Expr,
+    Join,
+    JoinHow,
+    Lit,
+    RankKind,
+    col,
+    dense_rank,
+    lit,
+    rank,
+    row_number,
+    when,
+)
+from .io import (
+    read_csv,
+    read_fixed_width,
+    read_json,
+    read_jsonl,
+    read_parquet,
+    read_tsv,
+)
+from .plan import Optimizer
+from .schema import ColumnSchema, LazySchema
+from .stream import Stream, from_chunks, from_iter
+
+__all__ = [
+    'Floe', 'TypedFloe', 'GroupByBuilder',
+    'col', 'lit', 'rank', 'dense_rank', 'row_number', 'when',
+    'Expr', 'Col', 'Lit',
+    'LazySchema', 'ColumnSchema',
+    'Optimizer',
+    'Agg', 'AggFunc', 'Join', 'JoinHow', 'DateTrunc', 'DateTruncUnit',
+    'RankKind', 'CumKind',
+    'read_csv', 'read_tsv', 'read_jsonl', 'read_json',
+    'read_fixed_width', 'read_parquet',
+    'from_iter', 'from_chunks', 'Stream',
+]
+
+__version__ = '0.1.0'