stemtrace 0.3.1__tar.gz → 0.3.3__tar.gz

{stemtrace-0.3.1 → stemtrace-0.3.3}/.bumpversion.toml

@@ -1,5 +1,5 @@
 [tool.bumpversion]
-current_version = "0.3.1"
+current_version = "0.3.3"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 commit = true

{stemtrace-0.3.1 → stemtrace-0.3.3}/.github/workflows/ci.yml

@@ -152,7 +152,7 @@ jobs:
         run: uvx twine check dist/*
 
       - name: Upload dist artifacts
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: dist
           path: dist/

{stemtrace-0.3.1 → stemtrace-0.3.3}/.github/workflows/e2e.yml

@@ -24,7 +24,7 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4
 
       - name: Select compose file and Celery env
         run: |
@@ -91,7 +91,7 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4
 
       - name: Select compose file and Celery env
         run: |
@@ -167,7 +167,7 @@ jobs:
           PLAYWRIGHT_BASE_URL: http://localhost:8000
 
       - name: Upload Playwright report
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         if: always()
         with:
           name: playwright-report-${{ matrix.broker }}
@@ -175,7 +175,7 @@ jobs:
           retention-days: 7
 
       - name: Upload test results
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         if: failure()
         with:
           name: playwright-test-results-${{ matrix.broker }}

{stemtrace-0.3.1 → stemtrace-0.3.3}/.github/workflows/release.yml

@@ -74,7 +74,7 @@ jobs:
         run: twine check dist/*
 
       - name: Upload dist artifacts
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: dist
           path: dist/
@@ -87,7 +87,7 @@ jobs:
       id-token: write
     steps:
       - name: Download dist artifacts
-        uses: actions/download-artifact@v7
+        uses: actions/download-artifact@v8
         with:
           name: dist
           path: dist/
@@ -104,8 +104,11 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@c7c53464625b32c7a7e944ae62b3e17d2b600130 # v3
+
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4
 
       - name: Log in to GitHub Container Registry
         uses: docker/login-action@v3
@@ -116,7 +119,7 @@ jobs:
 
       - name: Extract metadata
         id: meta
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
         with:
           images: ghcr.io/${{ github.repository }}
           tags: |
@@ -124,10 +127,11 @@ jobs:
             type=raw,value=latest
 
       - name: Build and push Docker image
-        uses: docker/build-push-action@v6
+        uses: docker/build-push-action@v7
         with:
           context: .
           push: true
+          platforms: linux/amd64,linux/arm64
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
           cache-from: type=gha
@@ -142,7 +146,7 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Download dist artifacts
-        uses: actions/download-artifact@v7
+        uses: actions/download-artifact@v8
         with:
           name: dist
           path: dist/

{stemtrace-0.3.1 → stemtrace-0.3.3}/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.3] - 2026-03-20
+
+### Added
+- Node alias from arguments: derive graph node display name from task args/kwargs via `node_alias_from_arguments` config option (thanks @ohadmata for the idea — #46, #48)
+- Docker: multi-architecture image builds (amd64 + arm64) (thanks @ohadmata — #51)
+
+### Fixed
+- Graph: order task nodes before synthetic container nodes (GROUP/CHORD) for correct rendering (thanks @codyburrito — #52)
+
+## [0.3.2] - 2026-02-28
+
+### Fixed
+- Redis transport: normalize `ssl_cert_reqs` URL parameter from `CERT_REQUIRED`/`CERT_NONE`/`CERT_OPTIONAL` to lowercase values expected by redis-py
+
 ## [0.3.1] - 2026-01-04
 
 ### Added

{stemtrace-0.3.1 → stemtrace-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stemtrace
-Version: 0.3.1
+Version: 0.3.3
 Summary: A lightweight Celery task flow visualizer
 Project-URL: Homepage, https://github.com/iansokolskyi/stemtrace
 Project-URL: Documentation, https://github.com/iansokolskyi/stemtrace#readme
@@ -56,7 +56,7 @@ Description-Content-Type: text/markdown
 
 **Zero-infrastructure Celery task flow visualizer**
 
-[![PyPI version](https://img.shields.io/badge/pypi-v0.3.1-darklime)](https://pypi.org/project/stemtrace)
+[![PyPI version](https://img.shields.io/badge/pypi-v0.3.3-darklime)](https://pypi.org/project/stemtrace)
 [![Python](https://img.shields.io/pypi/pyversions/stemtrace.svg)](https://pypi.org/project/stemtrace/)
 [![CI](https://github.com/iansokolskyi/stemtrace/actions/workflows/ci.yml/badge.svg)](https://github.com/iansokolskyi/stemtrace/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/iansokolskyi/stemtrace/graph/badge.svg)](https://codecov.io/gh/iansokolskyi/stemtrace)
@@ -250,6 +250,10 @@ stemtrace.init_worker(
     scrub_sensitive_data=True,                 # Scrub passwords, API keys, etc.
     additional_sensitive_keys=frozenset({"my_secret"}),  # Add custom keys
     safe_keys=frozenset({"public_key"}),       # Never scrub these keys
+
+    # UI display
+    node_alias_from_arguments="operator_type", # Use kwargs["operator_type"] as node name
+    # node_alias_from_arguments="0",           # Or use args[0] (digit string = positional index)
 )
 
 # Introspection (after init)

{stemtrace-0.3.1 → stemtrace-0.3.3}/README.md

@@ -2,7 +2,7 @@
 
 **Zero-infrastructure Celery task flow visualizer**
 
-[![PyPI version](https://img.shields.io/badge/pypi-v0.3.1-darklime)](https://pypi.org/project/stemtrace)
+[![PyPI version](https://img.shields.io/badge/pypi-v0.3.3-darklime)](https://pypi.org/project/stemtrace)
 [![Python](https://img.shields.io/pypi/pyversions/stemtrace.svg)](https://pypi.org/project/stemtrace/)
 [![CI](https://github.com/iansokolskyi/stemtrace/actions/workflows/ci.yml/badge.svg)](https://github.com/iansokolskyi/stemtrace/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/iansokolskyi/stemtrace/graph/badge.svg)](https://codecov.io/gh/iansokolskyi/stemtrace)
@@ -196,6 +196,10 @@ stemtrace.init_worker(
     scrub_sensitive_data=True,                 # Scrub passwords, API keys, etc.
     additional_sensitive_keys=frozenset({"my_secret"}),  # Add custom keys
     safe_keys=frozenset({"public_key"}),       # Never scrub these keys
+
+    # UI display
+    node_alias_from_arguments="operator_type", # Use kwargs["operator_type"] as node name
+    # node_alias_from_arguments="0",           # Or use args[0] (digit string = positional index)
 )
 
 # Introspection (after init)

{stemtrace-0.3.1 → stemtrace-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stemtrace"
-version = "0.3.1"
+version = "0.3.3"
 description = "A lightweight Celery task flow visualizer"
 readme = "README.md"
 license = { text = "MIT" }

{stemtrace-0.3.1 → stemtrace-0.3.3}/src/stemtrace/__init__.py

@@ -43,7 +43,7 @@ if TYPE_CHECKING:
     from celery import Celery
     from fastapi import FastAPI
 
-__version__ = "0.3.1"
+__version__ = "0.3.3"
 __all__ = [
     "ConfigurationError",
     "StemtraceConfig",
@@ -92,6 +92,8 @@ def init_worker(
     scrub_sensitive_data: bool = True,
     additional_sensitive_keys: frozenset[str] | None = None,
     safe_keys: frozenset[str] | None = None,
+    max_data_size: int = 10240,
+    node_alias_from_arguments: str | None = None,
 ) -> None:
     """Initialize stemtrace for Celery worker instrumentation.
 
@@ -105,6 +107,10 @@ def init_worker(
         scrub_sensitive_data: Whether to scrub sensitive keys (default: True).
         additional_sensitive_keys: Extra keys to treat as sensitive.
         safe_keys: Keys to never scrub (overrides sensitive).
+        max_data_size: Maximum size in bytes for serialized data (default: 10KB).
+        node_alias_from_arguments: Derive node display name from task arguments.
+            Pass a digit string to use args[index], a string key for kwargs[key],
+            or None to use the task name (default).
 
     Raises:
         ConfigurationError: If no broker URL can be determined.
@@ -127,6 +133,8 @@ def init_worker(
         scrub_sensitive_data=scrub_sensitive_data,
         additional_sensitive_keys=additional_sensitive_keys or frozenset(),
         safe_keys=safe_keys or frozenset(),
+        max_data_size=max_data_size,
+        node_alias_from_arguments=node_alias_from_arguments,
     )
     set_config(config)
 
@@ -150,6 +158,7 @@ def init_app(
     login_password: str | None = None,
     login_secret: str | None = None,
     login_ttl_seconds: int = 86400,
+    node_alias_from_arguments: str | None = None,
 ) -> StemtraceExtension:
     """Initialize stemtrace as a FastAPI extension.
 
@@ -171,6 +180,8 @@ def init_app(
             STEMTRACE_LOGIN_SECRET env var. If still missing, a random secret is
             generated (sessions invalidated on app restart).
         login_ttl_seconds: Session TTL in seconds (default: 24 hours).
+        node_alias_from_arguments: Derive graph node display name from task arguments.
+            Digit string for args[index], string for kwargs[key], or None (default).
 
     Returns:
         The initialized StemtraceExtension instance.
@@ -227,6 +238,7 @@ def init_app(
         max_nodes=max_nodes,
         auth_dependency=auth_dependency,
         form_auth_config=form_auth_config,
+        node_alias_from_arguments=node_alias_from_arguments,
     )
     extension.init_app(fastapi_app, prefix=prefix)
 

{stemtrace-0.3.1 → stemtrace-0.3.3}/src/stemtrace/library/config.py

@@ -16,6 +16,9 @@ class StemtraceConfig(BaseModel):
         scrub_sensitive_data: Whether to scrub sensitive keys.
         additional_sensitive_keys: Extra keys to treat as sensitive.
         safe_keys: Keys to never scrub (overrides sensitive).
+        node_alias_from_arguments: Derive graph node display name from task
+            arguments. Pass a string key to use kwargs[key], a digit string
+            to use args[index], or None to use the task name (default).
     """
 
     model_config = ConfigDict(frozen=True)
@@ -34,6 +37,9 @@ class StemtraceConfig(BaseModel):
     additional_sensitive_keys: frozenset[str] = Field(default_factory=frozenset)
     safe_keys: frozenset[str] = Field(default_factory=frozenset)
 
+    # UI display options
+    node_alias_from_arguments: str | None = None
+
 
 _config: StemtraceConfig | None = None
 

{stemtrace-0.3.1 → stemtrace-0.3.3}/src/stemtrace/library/transports/redis.py

@@ -21,6 +21,34 @@ logger = logging.getLogger(__name__)
 # Type alias for all events that can be consumed from the stream
 StreamEvent = TaskEvent | WorkerEvent
 
+# Mapping from CERT_* constants (used in URLs) to lowercase values expected by redis-py
+_SSL_CERT_REQS_MAP = {
+    "CERT_NONE": "none",
+    "CERT_OPTIONAL": "optional",
+    "CERT_REQUIRED": "required",
+}
+
+
+def _normalize_redis_ssl_params(url: str) -> str:
+    """Normalize ssl_cert_reqs in a Redis URL from CERT_* to lowercase.
+
+    redis-py expects lowercase values (none/optional/required) but URLs
+    commonly use the Python ssl module constants (CERT_NONE/CERT_REQUIRED).
+    """
+    from urllib.parse import parse_qs, urlencode, urlparse, urlunparse
+
+    parsed = urlparse(url)
+    if not parsed.query:
+        return url
+    params = parse_qs(parsed.query)
+    if "ssl_cert_reqs" not in params:
+        return url
+    raw = params["ssl_cert_reqs"][0]
+    normalized = _SSL_CERT_REQS_MAP.get(raw, raw)
+    params["ssl_cert_reqs"] = [normalized]
+    new_query = urlencode(params, doseq=True)
+    return urlunparse(parsed._replace(query=new_query))
+
 
 class RedisTransport:
     """Redis Streams-based event transport (XADD/XREAD)."""
@@ -129,6 +157,7 @@ class RedisTransport:
         """Create transport from Redis URL."""
         from redis import Redis as RedisClient
 
+        url = _normalize_redis_ssl_params(url)
         return cls(
             client=RedisClient.from_url(url, decode_responses=False),
             prefix=prefix,

{stemtrace-0.3.1 → stemtrace-0.3.3}/src/stemtrace/server/api/routes.py

@@ -123,9 +123,40 @@ def _node_to_response(node: TaskNode) -> TaskNodeResponse:
     )
 
 
+def _resolve_node_alias(node: TaskNode, key: str | None) -> str:
+    """Resolve display name for a graph node from task arguments.
+
+    When a key is configured, attempts to extract a value from the first
+    event's args (if key is a digit string) or kwargs (if key is a regular
+    string). Falls back to the node's registered task name.
+
+    Args:
+        node: Task node containing events with args/kwargs.
+        key: Digit string for args[index], string for kwargs[key],
+            or None to use the task name.
+
+    Returns:
+        Resolved display name for the node.
+    """
+    if key is None or not node.events:
+        return node.name
+
+    event = node.events[0]
+
+    if key.isdigit():
+        index = int(key)
+        if isinstance(event.args, list) and index < len(event.args):
+            return str(event.args[index])
+    elif isinstance(event.kwargs, dict) and key in event.kwargs:
+        return str(event.kwargs[key])
+
+    return node.name
+
+
 def _node_to_graph_response(
     node: TaskNode,
     all_nodes: dict[str, TaskNode] | None = None,
+    node_alias_key: str | None = None,
 ) -> GraphNodeResponse:
     """Convert TaskNode to graph response model.
 
@@ -134,6 +165,7 @@ def _node_to_graph_response(
     Args:
         node: Task node from graph store.
         all_nodes: All nodes dict for child lookup.
+        node_alias_key: Key to resolve display name from task arguments.
 
     Returns:
         GraphNodeResponse with timing from children.
@@ -159,15 +191,25 @@ def _node_to_graph_response(
     if first_seen and last_updated and first_seen != last_updated:
         duration_ms = int((last_updated - first_seen).total_seconds() * 1000)
 
+    # UI traversal is order-sensitive when callbacks can appear as both direct
+    # children and CHORD-linked nodes. Prefer TASK children first so callback
+    # branches render before synthetic containers.
+    children = node.children
+    if all_nodes is not None:
+        children = sorted(
+            node.children,
+            key=lambda c: getattr(all_nodes.get(c), "node_type", None) != "TASK",
+        )
+
     return GraphNodeResponse(
         task_id=node.task_id,
-        name=node.name,
+        name=_resolve_node_alias(node, node_alias_key),
         state=node.state,
         node_type=node.node_type,
         group_id=node.group_id,
         chord_id=node.chord_id,
         parent_id=node.parent_id,
-        children=node.children,
+        children=children,
         duration_ms=duration_ms,
         first_seen=first_seen,
         last_updated=last_updated,
@@ -289,6 +331,7 @@ def create_api_router(
     ws_manager: WebSocketManager | None = None,
     worker_registry: WorkerRegistry | None = None,
     broker_url: str | None = None,
+    node_alias_from_arguments: str | None = None,
 ) -> APIRouter:
     """Create REST API router with task and graph endpoints.
 
@@ -298,6 +341,8 @@ def create_api_router(
         ws_manager: Optional WebSocket manager.
         worker_registry: Optional worker registry for lifecycle tracking.
         broker_url: Optional Celery broker URL for on-demand inspection.
+        node_alias_from_arguments: Key to derive node display name from task
+            arguments. Digit string for args[index], string for kwargs[key].
 
     Returns:
         Configured API router.
@@ -562,7 +607,12 @@ def create_api_router(
             for child in store.get_children(root.task_id):
                 all_nodes[child.task_id] = child
         return GraphListResponse(
-            graphs=[_node_to_graph_response(r, all_nodes) for r in roots],
+            graphs=[
+                _node_to_graph_response(
+                    r, all_nodes, node_alias_key=node_alias_from_arguments
+                )
+                for r in roots
+            ],
             total=total,
             limit=limit,
             offset=offset,
@@ -586,7 +636,10 @@ def create_api_router(
         return GraphResponse(
             root_id=root_id,
             nodes={
-                tid: _node_to_graph_response(n, all_nodes) for tid, n in graph.items()
+                tid: _node_to_graph_response(
+                    n, all_nodes, node_alias_key=node_alias_from_arguments
+                )
+                for tid, n in graph.items()
             },
         )
 

{stemtrace-0.3.1 → stemtrace-0.3.3}/src/stemtrace/server/fastapi/extension.py

@@ -67,6 +67,7 @@ class StemtraceExtension:
         max_nodes: int = 10000,
         auth_dependency: Any = None,
         form_auth_config: FormAuthConfig | None = None,
+        node_alias_from_arguments: str | None = None,
     ) -> None:
         """Initialize extension with broker and transport configuration.
 
@@ -81,6 +82,8 @@ class StemtraceExtension:
             max_nodes: Maximum number of nodes to keep in memory.
             auth_dependency: Optional FastAPI dependency applied to all routes for authentication.
             form_auth_config: Optional cookie-session configuration used to protect WebSocket.
+            node_alias_from_arguments: Key to derive graph node display name from task
+                arguments. Digit string for args[index], string for kwargs[key].
         """
         self._broker_url = broker_url
         self._transport_url = transport_url or broker_url
@@ -103,6 +106,8 @@ class StemtraceExtension:
                 worker_registry=self._worker_registry,
             )
 
+        self._node_alias_from_arguments = node_alias_from_arguments
+
         self._store.add_listener(self._ws_manager.queue_event)
 
     @staticmethod
@@ -141,6 +146,7 @@ class StemtraceExtension:
             broker_url=self._broker_url,
             auth_dependency=self._auth_dependency,
             form_auth_config=self._form_auth_config,
+            node_alias_from_arguments=self._node_alias_from_arguments,
         )
 
         if self._serve_ui:

{stemtrace-0.3.1 → stemtrace-0.3.3}/src/stemtrace/server/fastapi/router.py

@@ -24,6 +24,7 @@ def create_router(
     broker_url: str | None = None,
     auth_dependency: Any = None,
     form_auth_config: FormAuthConfig | None = None,
+    node_alias_from_arguments: str | None = None,
 ) -> APIRouter:
     """Create API router. For embedded consumer, use StemtraceExtension."""
     if store is None:
@@ -40,6 +41,7 @@ def create_router(
         ws_manager,
         worker_registry,
         broker_url=broker_url,
+        node_alias_from_arguments=node_alias_from_arguments,
     )
     ws_router = create_websocket_router(ws_manager, form_auth_config=form_auth_config)