Skip to main content
Test and Release Code Coverage

trame-server is the server implementation of trame. This Python library provide the server implementation of the shared state and controller along with the definition of the web server. The web server aims to be flexible so it can be use within a Jupyter environment or as a standalone desktop application.

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-server can be installed with pip:

pip install --upgrade trame-server

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.

Environments variables

  • TRAME_LOG_NETWORK : Path to log file for capturing network exchange. (default: None)

  • TRAME_WS_MAX_MSG_SIZE : Maximum size in bytes of any ws message. (default: 10MB)

  • TRAME_WS_HEART_BEAT : Time in second before assuming the server is non-responsive. (default: 30s)

  • TRAME_DESKTOP_DEBUG : If defined it will allow user to inspect the web content in desktop mode

  • TRAME_SERVER : If set to true, this will prevent browser from opening by default

Life cycle callbacks

Life cycle events are directly managed on the application controller and are prefixed with on_*.

  • on_server_start : Executed at server.start() call while passing the server as argument.

  • on_server_bind : WSLinkServer is getting bound to trame so you can attach your own routes. Its instance will be passed as argument to callback.

  • on_server_ready : All protocols initialized and available for client to connect

  • on_client_connected : Connection established to server

  • on_client_exited : Linked to browser “beforeunload” event

  • on_server_exited : Trame is exiting its event loop

  • on_error : JS error forwarded (msg:str) on the python

  • on_exception : Server exception occurred when interacting with the UI. The exception instance is provided as arg.

  • on_server_reload : If callback registered it can be use to hot_reload methods like the UI.

License

trame-server is made available under the Apache License, Version 2.0. For more details, see LICENSE

Community

Trame | Discussions | Issues | Contact Us

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

Enjoying trame?

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

Download files

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

Source Distribution

trame_server-3.13.0.tar.gz (38.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

trame_server-3.13.0-py3-none-any.whl (44.7 kB view details)

Uploaded Python 3

File details

Details for the file trame_server-3.13.0.tar.gz.

File metadata

  • Download URL: trame_server-3.13.0.tar.gz
  • Upload date:
  • Size: 38.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for trame_server-3.13.0.tar.gz
Algorithm Hash digest
SHA256 39120ae2519ca602a0986186949f97ed7923525cc97a6ede8e56263a7f48549f
MD5 ad1bc91403a0a8cb0a330bde18d9ab63
BLAKE2b-256 45adf7b1e4251cea21638102548b16985a3b4aea2924eebb60aa782e5e068680

See more details on using hashes here.

Provenance

The following attestation bundles were made for trame_server-3.13.0.tar.gz:

Publisher: test_and_release.yml on Kitware/trame-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file trame_server-3.13.0-py3-none-any.whl.

File metadata

  • Download URL: trame_server-3.13.0-py3-none-any.whl
  • Upload date:
  • Size: 44.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for trame_server-3.13.0-py3-none-any.whl
Algorithm Hash digest
SHA256 80c6a5c317204a1d1d0930582ac2a49efc3fa3273226e141e71aa0348c3dca2a
MD5 73b34f57b6afa49469789acba59e8a25
BLAKE2b-256 0df584826f15b84f4f0fe871bc4dbe509d85c3572601144d1fb49a886cbe1eea

See more details on using hashes here.

Provenance

The following attestation bundles were made for trame_server-3.13.0-py3-none-any.whl:

Publisher: test_and_release.yml on Kitware/trame-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page