Skip to content

csvdir

Read every CSV in a directory as one stream of rows. Treat a folder of CSV files as one dataset — discovery, headers, chunking (with validated chunksize), and optional pandas integration (CsvDirFile text stream) with zero runtime dependencies.

Beta software

APIs may evolve between releases. Pin versions in production and read Changelog when upgrading.

  • :material-rocket-launch:{ .lg .middle } Get started

    Install, mental model, and next steps in Getting started.

  • :material-book-open-variant:{ .lg .middle } Guides

    Iteration, headers, chunking, columns, discovery, encodings, and pandas in the Guides overview.

  • :material-tune:{ .lg .middle } Configuration

    Every read_dir and CsvDirFile parameter in Configuration reference.

  • :material-api:{ .lg .middle } API reference

    Factories, readers, iterators, and utilities in API reference.

  • :material-hammer-wrench:{ .lg .middle } Development

    Local setup, tests, linting, and doc builds in Development.

Install (quick)

pip install csvdir

Optional extras ([dev], [docs]) are described in Getting started.

Canonical README

The root README on GitHub remains the single source for PyPI: feature list, usage snippets, badges, and links to this site.