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.22.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.22.0
File Size Uploaded Provenance
dlt_filesystem-0.22.0.tar.gz 164.8 kB With provenance Details

Built distribution (wheel)

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

Total release size: 289.5 kB

Release files / dlt_filesystem-0.22.0.tar.gz

Download URL dlt_filesystem-0.22.0.tar.gz
Size 164.8 kB
Tags Source
SHA-256 checksum
How to use checksums
5f0dc96fa027691ad5b93848df0616430c87e6b0ae439c31920853291e20fc96
BLAKE2b-256 checksum
How to use checksums
a820b86f366d0371bdb57d3c68ef6c56432c8ca2aae13a067cb119ac69313671
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 22, 2026.

Transparency log

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

Download URL dlt_filesystem-0.22.0-py3-none-any.whl
Size 124.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
090dff98f8ef95631ec6fdd647e96bf95b41d62dd34a2f8d4a1a9bef6fae1ab4
BLAKE2b-256 checksum
How to use checksums
f7b718ecab633b1255492981f9a0eafafe3c071affc0ec715fb1b789219725a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 22, 2026.

Transparency log

Security for dlt-filesystem 0.22.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.22.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 22, 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