Skip to main content

periplo

The API behind Periplo, an open-source console for Delta Lake data lakes: a catalog of the tables it is allowed to see and a read-only SQL endpoint over them, built on FastAPI and DataFusion.

This distribution contains only the Python package. The web console and the all-in-one container image are published from the same repository.

Install

pip install periplo

Python 3.12, 3.13 or 3.14 is required.

Run

PERIPLO_SOURCES_FILE=sources.yaml uvicorn --factory periplo.bootstrap:create_app

Every PERIPLO_* setting is documented in periplo.settings.

Embed

create_app is the composition root. A product built on Periplo passes its own implementations of the public ports through Extensions; any field left as None keeps the open, single-tenant default.

from periplo.bootstrap import create_app
from periplo.extensions import Extensions


def app():
    return create_app(extensions=Extensions(authenticator=MyAuthenticator()))

Extensions accepts an authenticator, tenants, authorizer, audit and orchestrators. Nothing is discovered implicitly: only what you pass in runs.

Documentation

https://massivedatascope.github.io/periplo/

License

AGPL-3.0-only.

Metadata

Release files for periplo 0.2.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 periplo 0.2.0
File Size Uploaded
periplo-0.2.0.tar.gz 119.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for periplo 0.2.0
File Interpreter ABI Platform
periplo-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 264.3 kB

Release files / periplo-0.2.0.tar.gz

Download URL periplo-0.2.0.tar.gz
Size 119.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a515b4e19c6ae9e91ed05ec0d0307f9badbaf65209e853571939217f0f4a7a47
BLAKE2b-256 checksum
How to use checksums
45c5890663338ef1a9b0346af54c8934e7e8a348c9eb57c9ee53976859d6f4f2
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 13, 2026.

Transparency log

Release files / periplo-0.2.0-py3-none-any.whl

Download URL periplo-0.2.0-py3-none-any.whl
Size 144.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a7825ddcf5edb323676fb50155e2a109635e669e91a4907e8fed1fe6cafb4cc5
BLAKE2b-256 checksum
How to use checksums
9c1bbdc304e7bcfe12ef28ca979a8ec9c3d9c19fb9b363e50fd4dd7561af41dc
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 13, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

0.1.0

2 release files

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