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.1.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.1.0
File Size Uploaded
periplo-0.1.0.tar.gz 99.4 kB Details

Built distribution (wheel)

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

Total release size: 220.1 kB

Release files / periplo-0.1.0.tar.gz

Download URL periplo-0.1.0.tar.gz
Size 99.4 kB
Tags Source
SHA-256 checksum
How to use checksums
992c976b3b1c9dc39aa42bc915edde0aa23c27e9d7706b0f3dfcfa5e4a71c4b8
BLAKE2b-256 checksum
How to use checksums
00e62a2b03fdbd2e8adeae9c1881b1aba8289e50569b3578387b384ff8d804c8
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 Sep 29, 2026.

Transparency log

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

Download URL periplo-0.1.0-py3-none-any.whl
Size 120.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a763262602cfda0d1665cf59047ea2afa84f27f80dc134836cd6efce33928ddc
BLAKE2b-256 checksum
How to use checksums
99d2f4a631632ceea9d9ed6ef819486898bf48a1a9f43472b361a48cbcb56962
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 Sep 29, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.0 This release

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