longlink 0.1.49

Python SDK for building and packaging LongLink applications.

LongLink SDK

Python SDK for building and packaging LongLink applications, including shared organization models, synchronization helpers, and migrations.

Website   -   Docs   -   Issues

Gettin started

longlink init

See xLongLink/sample for a minimal LongLink application that demonstrates SDK setup, XML pages, translations, routes, tests, and Docker image builds.

Development

make sdk

This builds the SDK web bundle, recreates sdk/dev, links that generated app to the local SDK source, and starts the SDK development app. Do not keep manual changes in sdk/dev; it is recreated by this command.

Requirements: Python 3.14 or newer, uv, and Docker if you want to build an image. See CONTRIBUTING.md for more details.

Testing

uv sync --extra dev
uv run pytest tests

The longlink package owns the shared-schema model and migration definitions as well as application migration tooling. The Platform API executes shared migrations and writes with control-plane credentials; application runtimes use the same shared model with read-only database access.

Storage

The LongLink Platform provides one physical bucket per Organization and scopes each runtime with these variables:

Variable	Purpose
LONGLINK_STORAGE_BUCKET	Physical Organization bucket.
LONGLINK_STORAGE_PREFIX	Application storage prefix under that bucket.
LONGLINK_STORAGE_REGION	Provider signing region when required.
LONGLINK_STORAGE_SHARED_PREFIX	Organization shared-storage prefix under the bucket.

Pass the bucket and the relevant prefix to create_fs. The returned filesystem treats that prefix as its root, so Application code uses only paths relative to its scoped view. Development and testing can leave all four values unset to use the local and in-memory filesystem roots.

---

LongLink 2026

License   -   Contributing   -   Contact

---