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.14.0.tar.gz (38.2 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.14.0-py3-none-any.whl (44.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: trame_server-3.14.0.tar.gz
  • Upload date:
  • Size: 38.2 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.14.0.tar.gz
Algorithm Hash digest
SHA256 ca4d8f6ba7e46b81bfe9e3f7eb83de3df9d35abb0f0921ba0cf00286a26756ea
MD5 20f8b4910574cf11c4c1c5589c7473e0
BLAKE2b-256 137713c4e6831375d65c802c4a2bc4100aae37e41f52c1442f6d705a0a7d86a5

See more details on using hashes here.

Provenance

The following attestation bundles were made for trame_server-3.14.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.14.0-py3-none-any.whl.

File metadata

  • Download URL: trame_server-3.14.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.14.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3519e99fdb962d0ecf29f0e8f969c84280ba0ef71d2cafe84a97e8b31d8052bd
MD5 2ceb42e2c87d3b2d3704c3903e831826
BLAKE2b-256 1290fdef3d3d732d25114d15ffcebf32d6664c67beea5cb8d9e3f675d2675327

See more details on using hashes here.

Provenance

The following attestation bundles were made for trame_server-3.14.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