trame-common

What it is and what it does

trame-common is a lightweight, dependency-free utility library designed to centralize shared code across the trame ecosystem. It provides decorators, asset handlers, code execution helpers, and object utilities that were previously scattered across trame-client, trame-server, and the main trame package. The library is organized into focused modules: assets (file and MIME type handling), decorators (function and class decorators), exec (async, throttle, debounce, threading), obj (common trame object helpers), and utils (general utilities).

While the package is primarily intended as a dependency for other trame packages rather than direct installation, it can be used independently if you need specific helper functions or classes. The zero runtime dependencies keep it lightweight, though some modules may require optional dependencies that should be specified by consuming code.

Use it for:

• Reduce code duplication when building multiple trame packages that share common utilities and decorators.
• Access centralized asset and MIME type handling for local and remote files across trame applications.
• Use common execution helpers (debounce, throttle, async) without reimplementing them in each trame component.
• Build trame widgets or server extensions that need standard object and component utilities.
• Maintain consistent decorator patterns across a trame-based application ecosystem.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides shared helper functions, decorators, and utility classes for trame packages to use across server, client, and widget contexts without duplicating code.

Yes, if you are developing trame packages or extensions that need shared utilities. Install it as a dependency of another trame package (trame, trame-server, trame-client) or directly if you are building custom trame components. The zero runtime dependencies and active maintenance make it safe to add. The early-stage classifier (Planning) is inconsistent with active releases but does not indicate instability.

Install

trame-common on PyPI

pip install trame-common

uv add trame-common

poetry add trame-common

Installing trame-common

Before you install

Low install friction with no runtime dependencies. Active maintenance with a release 7 days ago. Marked as early-stage (Development Status 1 - Planning) despite active updates.

License in practice

Licensed under Apache License 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart

pip install trame-common

from trame_common.decorators import debounce
from trame_common.assets import get_mime_type
from trame_common.exec import create_task

Requires Python 3.10 or later.

Verify before relying

• Whether the package is truly intended for direct use or only as a transitive dependency of other trame packages.
• What specific helper classes and functions are exported and their stability across versions.
• Whether extra dependencies mentioned in the description are optional or required for certain modules.

Package facts

Evidence: trame_common-1.2.7-py3-none-any.whl

Tags

More Scientific/Engineering packages