lange-python 0.3.12

A bundeld set of tools, clients for the lange-suite of tools and more.

lange-python

Python helpers and clients for Lange services.

Distribution CLI

Publish a distribution artifact to the app services distribution system:

export LANGE_LABS_API_KEY="your-api-key"
lange distribution publish \
  --path ./dist/app.dmg \
  --version 1.2.3 \
  --distribution-name desktop-app \
  --os macos

Apply a macOS app update after downloading the published zip artifact:

from pathlib import Path

from lange.distribution import DistributionClient

client = DistributionClient(distribution_name="desktop-app", api_key="your-api-key")

update_metadata = client.update(
    current_version="1.2.3",
    installed_app_path=Path("/Applications/Desktop App.app"),
)

print(update_metadata["version"])
# The caller should now shut down so the detached helper can replace the app bundle.

The distribution client also exposes status and reload() for refresh-aware integrations:

client = DistributionClient(distribution_name="desktop-app", api_key="your-api-key")

latest_version = client.search_for_update("1.2.3")
print(client.status)  # connected

client.reload()  # repeats the last update check
client.reload(api_key=None)  # clears authentication and marks the client unauthenticated

Tunnel worker

from lange.tunnel import Tunnel

tunnel = Tunnel(
    host="wss://tunnel.lange-labs.com",
    api_key="your-bearer-token",
    target="http://localhost:3000",
)

tunnel.start()
# ...
tunnel.reload()  # restarts the connection flow with the current API key
tunnel.reload(api_key=None)  # clears authentication and leaves the client unauthenticated
tunnel.stop()

Tunnel clients also expose a status property with one of: "unauthenticated", "off", "pending", "connected", or "failed".