Skip to main content

dlt-filesystem

Filesystem and blob storage sources and destinations for dlt.

dlt ships its own filesystem source, and this package is the delta over it:

  • 16 readers behind 19 routed format keys, against dlt's four. CSV (pyarrow, DuckDB and a headerless variant), JSON and JSONL, Parquet, ORC, Avro, Feather, BSON, spreadsheets (xlsx and ods), XML, YAML, MessagePack and CBOR.
  • A filesystem resource that refuses to load nothing. A concrete selection matching no file raises rather than returning an empty table; globs stay empty-safe.
  • A modification-date resolver that covers the schemes dlt's table does not, including r2, oss, hdfs, smb, ftp and webdav, and a pyarrow-backed client addressed as s3://.
  • An Arrow readinto shim, without which reading a .gz fails wherever isal is importable.

The entry points are a superset of dlt's own, so a pipeline already on dlt.sources.filesystem can move across without changing its call.

Install

pip install dlt-filesystem

The long-tail formats (XML, YAML, MessagePack, CBOR) carry their decoders in an extra:

pip install 'dlt-filesystem[iterable]'

Formats whose decoder is a sizeable or single-purpose package carry it in an extra of their own. Without it, the format still routes and its reader raises an error naming the extra to install.

Extra Formats
bson BSON
duckdb CSV read with DuckDB (csv_duckdb)
spreadsheet XLSX (read and write), ODS
vortex Vortex (Python 3.11+)
pip install 'dlt-filesystem[spreadsheet]'

Usage

import dlt
from dlt_filesystem.source.adapter import readers

pipeline = dlt.pipeline(destination="duckdb", dataset_name="inbox")
pipeline.run(
    readers(bucket_url="s3://bucket/prefix", file_glob="*.parquet").read_parquet()
)

Documentation

https://omniload.readthedocs.io/supported-sources/filesystem.html

License

MIT. See LICENSE.

Metadata

Release files for dlt-filesystem 0.21.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dlt-filesystem 0.21.0
File Size Uploaded Provenance
dlt_filesystem-0.21.0.tar.gz 163.6 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for dlt-filesystem 0.21.0
File Interpreter ABI Platform
dlt_filesystem-0.21.0-py3-none-any.whl Python 3 none any Details

Total release size: 287.4 kB

Release files / dlt_filesystem-0.21.0.tar.gz

Download URL dlt_filesystem-0.21.0.tar.gz
Size 163.6 kB
Tags Source
SHA-256 checksum
How to use checksums
b360cd728cb3007620274e37a197344c4a136848a42de4322513f6375e7ebed5
BLAKE2b-256 checksum
How to use checksums
324e75359ba956ac19c7bedc7d69a041845dda4d9b1796d01e0b6ed27199fa8e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / dlt_filesystem-0.21.0-py3-none-any.whl

Download URL dlt_filesystem-0.21.0-py3-none-any.whl
Size 123.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7fd9551cfbf067ba8b438dc397d332451a0abf55ba199efbbdc1751b75688c3e
BLAKE2b-256 checksum
How to use checksums
f8d22a859dc113d9c5d4c231c013a1693a1f1e815c427ea949497d1bf47650f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Security for dlt-filesystem 0.21.0

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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for dlt_filesystem-0.21.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page