Skip to main content

Internal client of trame

Project description

Test and Release

trame-client is the generic single page application that come with trame. trame-client provides the infrastructure on the client-side (browser) to connect to a trame server, synchronize its state with the server, make method call, load dynamically components and feed a dynamic template provided by the server.

This package is not supposed to be used by itself but rather should come as a dependency of trame. For any specificity, please refer to the trame documentation.

Installing

trame-client can be installed with pip:

pip install --upgrade trame-client

Usage

The Trame Tutorial is the place to go to learn how to use the library and start building your own application.

The API Reference documentation provides API-level documentation.

License

trame-client is made available under the MIT License. For more details, see LICENSE This license has been chosen to match the one use by Vue.js which is instrumental for making that library possible.

Community

Trame | Discussions | Issues | RoadMap | Contact Us

https://zenodo.org/badge/410108340.svg

Enjoying trame?

Share your experience with a testimonial or with a brand approval.

Runtime configuration

Trame client is the JS core of trame and can be tuned by url parameters. The table below list which parameters we process and how they affect the client.

URL parameters

enableSharedArrayBufferServiceWorker

When set this will load an extra script that will use a service worker to enable SharedArrayBuffer

ui

Layout name selector. When a trame app define several layout with different name, you can choose which layout should be displayed

remove

By default the URL will be cleaned from trame config parameters (sessionURL, sessionManagerURL, secret, application) but if additional parameters should be removed as well but used in the launcher config, this can be achieved by adding a &remove=param1,param2.

The table below leverage environment variables, mainly for the Jupyter Lab context and the iframe builder configuration.

Environment variables

TRAME_JUPYTER_ENDPOINT

Used by the trame-jupyter-extension

TRAME_JUPYTER_WWW

Used by the trame-jupyter-extension

JUPYTERHUB_SERVICE_PREFIX

Used to figure out server proxy path for iframe builder

HOSTNAME

When “jupyter-hub-host” is used as iframe builder, the hostname will be lookup using that environment variable

TRAME_IFRAME_BUILDER

Specify which iframe builder should be used. If not provided we try to do some smart detection

TRAME_IPYWIDGETS_DISABLE

Skip any iPyWidget iframe wrapping

Development

Build client side code base

cd vue[2,3]-app
npm install
npm run build            # build trame client application
cd -

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trame-client-3.4.0.tar.gz (230.7 kB view details)

Uploaded Source

Built Distribution

trame_client-3.4.0-py3-none-any.whl (236.3 kB view details)

Uploaded Python 3

File details

Details for the file trame-client-3.4.0.tar.gz.

File metadata

  • Download URL: trame-client-3.4.0.tar.gz
  • Upload date:
  • Size: 230.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.11.2 readme-renderer/44.0 requests/2.32.3 requests-toolbelt/1.0.0 urllib3/2.2.3 tqdm/4.66.5 importlib-metadata/8.5.0 keyring/25.4.1 rfc3986/2.0.0 colorama/0.4.6 CPython/3.10.15

File hashes

Hashes for trame-client-3.4.0.tar.gz
Algorithm Hash digest
SHA256 60df253adcf640df41e4e769cfe13f298f4a5b6883a604d603479c7bcd3da6cb
MD5 5186a7d86341af8d1de8edc647b0276a
BLAKE2b-256 03bb158bf55a32803383b6601d67c02222fa26046877b330cb5a17a19f042ea8

See more details on using hashes here.

Provenance

File details

Details for the file trame_client-3.4.0-py3-none-any.whl.

File metadata

  • Download URL: trame_client-3.4.0-py3-none-any.whl
  • Upload date:
  • Size: 236.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.11.2 readme-renderer/44.0 requests/2.32.3 requests-toolbelt/1.0.0 urllib3/2.2.3 tqdm/4.66.5 importlib-metadata/8.5.0 keyring/25.4.1 rfc3986/2.0.0 colorama/0.4.6 CPython/3.10.15

File hashes

Hashes for trame_client-3.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 59f45597fe18118d67f702b6d294c3bf75d1e84269dde0c0baa5da1a59d9a453
MD5 c8d318586991ba7260601d9bfdd39f5c
BLAKE2b-256 70e018fb220dc58f1ad32ac7a5246aaf8b56134ec1afa6e8cea8192437d9ba85

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page