robotframework-dashboard 2.0.0__tar.gz → 2.2.0__tar.gz

{robotframework_dashboard-2.0.0/robotframework_dashboard.egg-info → robotframework_dashboard-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: robotframework-dashboard
-Version: 2.0.0
+Version: 2.2.0
 Summary: Output processor and dashboard generator for Robot Framework output files
 Home-page: https://github.com/marketsquare/robotframework-dashboard
 Author: Tim de Groot

{robotframework_dashboard-2.0.0 → robotframework_dashboard-2.2.0}/README.md

@@ -78,6 +78,7 @@ For detailed usage instructions, advanced examples, and full documentation, visi
 - 🔍 [**Filtering**](https://marketsquare.github.io/robotframework-dashboard/filtering.html) - Apply filters to analyze trends in your test data and highlight specific tags, amounts or datetime ranges.
 - 🎨 [**Customization**](https://marketsquare.github.io/robotframework-dashboard/customization.html) - Customize dashboard sections, graph layouts, and visualizations to suit your workflow.
 - ⚙️ [**Settings**](https://marketsquare.github.io/robotframework-dashboard/settings.html) - Configure dashboard preferences including themes, default views, graph options, and save your settings for consistent team-wide use.
+- 📐 [**Architecture**](https://marketsquare.github.io/robotframework-dashboard/architecture.html) - See how robotdashboard is structured internally, from CLI invocation to a rendered dashboard, in both Regular Mode and Server Mode.
 - 🖥️ [**Dashboard Server**](https://marketsquare.github.io/robotframework-dashboard/dashboard-server.html) - Host the dashboard for multi-user access, programmatic updates, and remote server integration.
 - 🗄️ [**Custom Database Class**](https://marketsquare.github.io/robotframework-dashboard/custom-database-class.html) - Extend or replace the default database backend to suit your storage needs, including SQLite, MySQL, or custom implementations.
 - 🔔 [**Listener Integration**](https://marketsquare.github.io/robotframework-dashboard/listener-integration.html) - Use a listener to automatically push test results to the dashboard for every executed run, integrating seamlessly into CI/CD pipelines.
@@ -122,4 +123,4 @@ This project is licensed under the MIT License.
 ## 🎬 RoboCon Talk
 See also my 2025 [RoboCon](https://robocon.io) talk, where I explain robotdashboard and its use cases. Note that the UI has improved significantly since then.
 
-[![Robocon 2025 talk](https://img.youtube.com/vi/olf1_pd9YfM/0.jpg)](https://www.youtube.com/watch?v=olf1_pd9YfM)
+[![Robocon 2025 talk](https://img.youtube.com/vi/olf1_pd9YfM/0.jpg)](https://www.youtube.com/watch?v=olf1_pd9YfM)

{robotframework_dashboard-2.0.0 → robotframework_dashboard-2.2.0}/robotframework_dashboard/arguments.py

@@ -4,8 +4,16 @@ from sys import exit
 from re import split
 from os import getcwd
 from os.path import join, exists
+from typing import NamedTuple
 from .version import __version__
 
+_VALID_LOG_TYPES = {"run", "suite", "test", "keyword", "all"}
+
+
+class LogRemovedConfig(NamedTuple):
+    types: list
+    path: str
+
 
 class dotdict(dict):
     """dot.notation access to dictionary attributes"""
@@ -61,6 +69,47 @@ class ArgumentParser:
             print("  ERROR: Mixing --projectversion and version_ tags not supported")
             exit(2)
 
+    def _process_remove_runs(self, parts):
+        """Process and validate the comma-separated --removeruns parts.
+
+        Detects a scoped-retention combination ('limit' + 'tags') and rewrites
+        it into the internal 'limit=N;tag=...' form so the limit acts on the
+        tagged subset instead of running as two independent operations. This
+        lets users write the combo with the regular comma separator (e.g.
+        '-r "limit=10,tag=nightly"') instead of ';'.
+
+        Scope note (matches issue #309): only 'limit' can be scoped by tags.
+        'age' + 'tags' is intentionally NOT supported here — combining them
+        just runs as two independent operations, same as on main.
+
+        Rules:
+        - No tags, or tags without a 'limit' partner -> no combination, every
+          part stays independent (unchanged behavior, including 'age'+'tags').
+        - Only one 'limit' may be combined with tags (error otherwise).
+        """
+        limit_parts = [p for p in parts if p.startswith("limit=")]
+        tag_parts = [p for p in parts if p.startswith("tag=")]
+        other_parts = [
+            p for p in parts if not (p.startswith("limit=") or p.startswith("tag="))
+        ]
+
+        if not tag_parts or not limit_parts:
+            return parts
+        if len(limit_parts) > 1:
+            print("  ERROR: Only one 'limit' may be combined with 'tag(s)'.")
+            exit(3)
+
+        tag_values = [p.replace("tag=", "") for p in tag_parts]
+        limit_value = limit_parts[0].replace("limit=", "")
+        combo = limit_parts[0] + "".join(f";tag={value}" for value in tag_values)
+        print(
+            f"  INFO: Combining 'limit' with 'tag(s)' -> keeping the {limit_value} most recent "
+            f"run(s) tagged with [{', '.join(tag_values)}] and removing older matching runs "
+            f"(runs without these tags are left untouched)."
+        )
+        # other independent options (index/run_start/alias) run before the combo
+        return other_parts + [combo]
+
     def _check_argument_warnings(self, arguments, outputs, outputfolderpaths, use_logs, generate_dashboard, no_autoupdate, offline_dependencies):
         """Checks for argument combinations that are valid but likely unintended and prints warnings"""
         no_outputs = not outputs and not outputfolderpaths
@@ -267,11 +316,33 @@ class ArgumentParser:
                 "  • '-r run_start=2024-07-30 15:27:20.184407' -> remove specified run\n"
                 "  • '-r alias=some_alias,tag=prod'\n"
                 "  • '-r limit=10' -> keep only the 10 most recent runs\n"
+                "  • '-r limit=10,tag=nightly' -> keep 10 newest 'nightly' runs, leave others\n"
+                "  • '-r age=10d' -> remove runs older than 10 days\n"
+                "  • '-r age=-10d' -> remove runs younger than 10 days\n"
+                "  • (y)ear/(d)ay/(h)our/(m)inute/(s)econd supported\n"
             ),
             action="append",
             nargs="*",
             default=None,
         )
+        db_group.add_argument(
+            "--logremoved",
+            metavar="TYPES_PATH",
+            help=(
+                "Log (append if file exists) run data to jsonl before removing from the db\n"
+                "  • Supply what types to log (default=all) and (optional) a path to the desired .jsonl\n"
+                "Examples:\n"
+                "  • '--logremoved \"/tmp/removed_runs.jsonl\"'\n"
+                "  • '--logremoved \"run:suite\"'\n"
+                "  • '--logremoved \"all:/tmp/removed_runs.jsonl\"'\n"
+            ),
+            action="store",
+            type=str,
+            nargs="?",
+            const="all",
+            default=None,
+            dest="logremoved",
+        )
         db_group.add_argument(
             "-c",
             "--databaseclass",
@@ -502,11 +573,13 @@ class ArgumentParser:
         # handles the processing of --removeruns
         remove_runs = None
         if arguments.removeruns:
-            remove_runs = []
+            raw_parts = []
             for runs in arguments.removeruns:
-                parts = str(runs[0]).split(",")
-                for part in parts:
-                    remove_runs.append(part)
+                for part in str(runs[0]).split(","):
+                    part = part.strip()
+                    if part:
+                        raw_parts.append(part)
+            remove_runs = self._process_remove_runs(raw_parts)
 
         # handles the boolean handling of relevant arguments
         generate_dashboard = self._normalize_bool(
@@ -602,6 +675,23 @@ class ArgumentParser:
         ssl_certfile = arguments.ssl_certfile
         ssl_keyfile = arguments.ssl_keyfile
 
+        # handles --logremoved: "type1:type2:path" or "path" or "type1:type2"
+        log_removed = None
+        if arguments.logremoved:
+            parts = arguments.logremoved.split(":")
+            types, remaining = [], list(parts)
+            # grab element types, leave path, for windows drive letter X: parse
+            for part in parts:
+                if part in _VALID_LOG_TYPES:
+                    types.append(part)
+                    remaining.pop(0)
+                else:
+                    break
+            if not types:
+                types = ["all"]
+            path = ":".join(remaining) if remaining else "robot_removed_runs.jsonl"
+            log_removed = LogRemovedConfig(types=types, path=path)
+
         # validates argument combinations
         self._check_argument_errors(arguments, outputs, outputfolderpaths, force_json_config, database_class)
         self._check_argument_warnings(arguments, outputs, outputfolderpaths, use_logs, generate_dashboard, no_autoupdate, offline_dependencies)
@@ -637,5 +727,6 @@ class ArgumentParser:
             "ssl_certfile": ssl_certfile,
             "ssl_keyfile": ssl_keyfile,
             "log_url": arguments.logurl,
+            "log_removed": log_removed,
         }
         return dotdict(provided_args)

{robotframework_dashboard-2.0.0 → robotframework_dashboard-2.2.0}/robotframework_dashboard/css/base.css

@@ -124,6 +124,14 @@ body {
 .boxplot-graph:hover svg,
 .shown-graph:hover svg,
 .hidden-graph:hover svg,
+.move-to-first-graph:hover svg,
+.move-to-last-graph:hover svg,
+.add-stat-widget-header:hover svg,
+.add-link-widget-header:hover svg,
+.add-section-header:hover svg,
+.delete-custom-stat-widget:hover svg,
+.delete-custom-link-widget:hover svg,
+.delete-custom-section:hover svg,
 .shown-section:hover svg,
 .hidden-section:hover svg,
 .collapse-icon:hover svg,
@@ -188,6 +196,14 @@ body.lock-scroll {
 .boxplot-graph,
 .shown-graph,
 .hidden-graph,
+.move-to-first-graph,
+.move-to-last-graph,
+.add-stat-widget-header,
+.add-link-widget-header,
+.add-section-header,
+.delete-custom-stat-widget,
+.delete-custom-link-widget,
+.delete-custom-section,
 .shown-section,
 .hidden-section,
 .move-up-table,

{robotframework_dashboard-2.0.0 → robotframework_dashboard-2.2.0}/robotframework_dashboard/css/components.css

@@ -152,53 +152,75 @@
   align-items: center;
 }
 
-/* Add Widget tile shown in customize-view mode */
-.add-stat-widget-tile {
-  cursor: pointer;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  border: 2px dashed var(--bs-border-color, rgba(128,128,128,0.4));
-  border-radius: 8px;
-  transition: border-color 0.15s, background-color 0.15s;
+/* Color picker buttons inside the Add Stat Widget modal */
+.stat-color-btn {
+  min-width: 60px;
 }
 
-.add-stat-widget-tile:hover {
-  border-color: var(--color-text);
-  background-color: rgba(128,128,128,0.08);
+/* "All" tab stat list inside the Add Stat Widget modal */
+.add-all-widgets-list {
+  max-height: 60vh;
+  overflow-y: auto;
 }
 
-.add-stat-widget-tile-inner {
+.add-all-widgets-row {
   display: flex;
-  flex-direction: column;
   align-items: center;
-  gap: 0.25rem;
-  transition: opacity 0.15s;
-  user-select: none;
+  gap: 0.5rem;
+  margin-bottom: 0.5rem;
 }
 
-.add-stat-widget-plus {
-  font-size: 2rem;
-  font-weight: 300;
-  line-height: 1;
+.add-all-widgets-row .form-check {
+  margin-bottom: 0;
 }
 
-.add-stat-widget-tile-label {
-  font-size: 0.8rem;
-  font-weight: 500;
+.add-all-widgets-row .add-all-widgets-title {
+  flex: 1 1 auto;
 }
 
-/* Color picker buttons inside the Add Stat Widget modal */
-.stat-color-btn {
-  min-width: 60px;
+.add-all-widgets-row .add-all-widgets-badge {
+  flex: 0 0 auto;
+}
+
+.add-all-widgets-group-heading {
+  font-weight: 600;
+  margin-top: 0.5rem;
+  margin-bottom: 0.25rem;
+}
+
+.add-all-widgets-group-heading:first-child {
+  margin-top: 0;
 }
 
-/* Delete button on custom stat widgets — pinned to top-right, out of flex flow */
-.delete-custom-stat-widget {
+/* Custom section divider bar rendered inside the unified GridStack */
+.custom-section-divider {
+  display: flex;
+  align-items: center;
+  padding: 0 1rem;
+  border-radius: 6px;
+  height: 100%;
+  width: 100%;
+  position: relative;
+}
+
+.custom-section-title {
+  flex: 1;
+  font-size: 1rem;
+  font-weight: 600;
+  text-align: center;
+  user-select: none;
+}
+
+/* Move to first/last + delete controls on custom widgets/sections — pinned to top-right,
+   out of flex flow, sized and spaced like the icons in graph headers */
+.custom-widget-move-controls {
   position: absolute;
   top: 5px;
   right: 5px;
   z-index: 1;
+  display: flex;
+  align-items: center;
+  gap: 8px;
 }
 
 /* Compact flex layout for custom stat widgets — works at any GridStack size */
@@ -222,7 +244,12 @@
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
-  max-width: calc(100% - 20px); /* leave room so text doesn't run under the delete button */
+  max-width: 100%;
+}
+
+/* Leave room for the move/delete controls pinned to the top-right in edit mode */
+.stat-widget-inner:has(.custom-widget-move-controls) .stat-widget-title {
+  max-width: calc(100% - 96px);
 }
 
 /* When the item is very short (h=1 row ≈ 60px) switch to a side-by-side row */
@@ -242,14 +269,25 @@
 .grid-stack-item[data-gs-h="1"] .stat-widget-title {
   flex: 1 1 0;
   text-align: left;
-  max-width: calc(100% - 40px); /* value + delete button */
+  max-width: calc(100% - 40px); /* leave room for the value */
+}
+
+/* Leave room for the move/delete controls pinned to the top-right in edit mode */
+.grid-stack-item[gs-h="1"] .stat-widget-inner:has(.custom-widget-move-controls) .stat-widget-title,
+.grid-stack-item[data-gs-h="1"] .stat-widget-inner:has(.custom-widget-move-controls) .stat-widget-title {
+  max-width: calc(100% - 136px); /* value + move/delete controls */
 }
 
 .grid-stack-item[gs-h="1"] .stat-value,
 .grid-stack-item[data-gs-h="1"] .stat-value {
   flex-shrink: 0;
   font-size: 1.1rem;
-  margin-right: 20px; /* keep clear of the absolute delete button */
+}
+
+/* Leave room for the move/delete controls pinned to the top-right in edit mode */
+.grid-stack-item[gs-h="1"] .stat-widget-inner:has(.custom-widget-move-controls) .stat-value,
+.grid-stack-item[data-gs-h="1"] .stat-widget-inner:has(.custom-widget-move-controls) .stat-value {
+  margin-right: 96px;
 }
 
 .grid-stack-item-content.blue-bg   { background-color: rgba(13, 110, 253, 0.15); }
@@ -257,6 +295,92 @@
 .grid-stack-item-content.red-bg    { background-color: rgba(206, 62, 1, 0.2);    }
 .grid-stack-item-content.yellow-bg { background-color: rgba(254, 216, 79, 0.2);  }
 
+/* ─── Custom link widget ─────────────────────────────────────────────────── */
+
+/* Inner layout — mirrors stat-widget-inner */
+.link-widget-inner {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  gap: 0.25rem;
+  height: 100%;
+  text-align: center;
+  overflow: hidden;
+}
+
+/* Label — main large text, like .stat-value */
+.link-widget-label {
+  margin: 0;
+  font-weight: 600;
+  font-size: 1.5rem;
+  line-height: 1.2;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  max-width: 100%;
+}
+
+/* URL preview — small muted text below the label */
+.link-widget-url {
+  font-size: 0.72rem;
+  opacity: 0.55;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  max-width: 100%;
+}
+
+/* Leave room for the move/delete controls pinned to the top-right in edit mode */
+.link-widget-inner:has(.custom-widget-move-controls) .link-widget-label,
+.link-widget-inner:has(.custom-widget-move-controls) .link-widget-url {
+  max-width: calc(100% - 96px);
+}
+
+/* Clickable in non-edit mode */
+.link-widget-clickable {
+  cursor: pointer;
+}
+
+/* Same padding as stat widget tiles */
+.grid-stack-item-content:has(.link-widget-inner) {
+  padding: 8px 12px;
+}
+
+/* h=1 compact row — mirrors stat widget compact layout */
+.grid-stack-item[gs-h="1"] .link-widget-inner,
+.grid-stack-item[data-gs-h="1"] .link-widget-inner {
+  flex-direction: row;
+  justify-content: space-between;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.grid-stack-item[gs-h="1"] .link-widget-label,
+.grid-stack-item[data-gs-h="1"] .link-widget-label {
+  flex: 1 1 0;
+  font-size: 1.1rem;
+  text-align: left;
+  max-width: calc(60% - 10px);
+}
+
+.grid-stack-item[gs-h="1"] .link-widget-url,
+.grid-stack-item[data-gs-h="1"] .link-widget-url {
+  flex-shrink: 0;
+  font-size: 0.72rem;
+  text-align: right;
+  max-width: 40%;
+}
+
+/* Leave room for the move/delete controls pinned to the top-right in edit mode */
+.grid-stack-item[gs-h="1"] .link-widget-inner:has(.custom-widget-move-controls) .link-widget-url {
+  max-width: calc(40% - 96px);
+  margin-right: 96px;
+}
+
+/* ─────────────────────────────────────────────────────────────────────────── */
+
 .fullscreen .stat-value {
   font-size: 4rem;
 }
@@ -299,6 +423,22 @@
   height: 200px;
 }
 
+/* relative run time, pinned to the bottom right corner of a run card without
+   affecting the layout of the stats/duration columns next to the donut */
+.overview-card .card-body {
+  position: relative;
+}
+
+.run-card-run-time {
+  position: absolute;
+  right: 1rem;
+  bottom: 0.55rem;
+  color: var(--color-text-muted);
+  cursor: help;
+  font-size: 0.85em;
+  white-space: nowrap;
+}
+
 .overview-card {
   cursor: pointer;
   min-width: 300px;
@@ -363,6 +503,13 @@
   gap: 8px;
 }
 
+/* Icon row in section card headers (add stat/link widget, add section, move/show/hide section) */
+.section-header-icons {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
 .grid-stack-item-content .graph-body {
   flex: 1 1 auto;
   display: flex;

{robotframework_dashboard-2.0.0 → robotframework_dashboard-2.2.0}/robotframework_dashboard/css/dark.css

@@ -1,5 +1,4 @@
 .modal-dialog {
-  background: var(--color-modal-bg);
   color: var(--color-text);
 }