qplotter 1.6.0__py3-none-any.whl

qplot/configuration/themes/_base.py

@@ -0,0 +1,592 @@
+from __future__ import annotations
+
+from dataclasses import asdict, dataclass
+from string import Template
+
+import pyqtgraph as pg
+from PyQt6 import QtGui
+from PyQt6 import QtWidgets as qtw
+
+from ..fonts import FONT_SIZE_KEY
+
+
+@dataclass(frozen=True)
+class ThemePalette:
+    window_bg: str
+    panel_bg: str
+    panel_alt_bg: str
+    field_bg: str
+    field_alt_bg: str
+    button_bg: str
+    button_hover_bg: str
+    button_pressed_bg: str
+    text: str
+    text_strong: str
+    muted_text: str
+    disabled_text: str
+    selection_bg: str
+    selection_text: str
+    accent: str
+    accent_hover: str
+    accent_soft: str
+    accent_pressed: str
+    border: str
+    border_strong: str
+    menu_hover_bg: str
+    tab_bg: str
+    tab_selected_bg: str
+    tab_hover_bg: str
+    table_bg: str
+    table_alt_bg: str
+    table_hover_bg: str
+    header_bg: str
+    status_text: str
+    progress_text: str
+    splitter: str
+    scrollbar_bg: str
+    scrollbar_handle: str
+    scrollbar_handle_hover: str
+    danger: str
+    danger_bg: str
+    danger_pressed_bg: str
+
+
+_STYLESHEET_TEMPLATE = Template(
+    """
+    QMainWindow, QDialog, QColorDialog {
+        background-color: $window_bg;
+    }
+    QMainWindow, QDialog, QWidget {
+        font-size: 10pt;
+    }
+    QLabel {
+        color: $text;
+    }
+    QLabel#mainEmptyStateTitle {
+        color: $text_strong;
+        font-weight: 600;
+    }
+    QLabel#mainEmptyStateDetail {
+        color: $muted_text;
+    }
+    QTextEdit, QPlainTextEdit {
+        background-color: $field_bg;
+        color: $text;
+        selection-background-color: $selection_bg;
+        selection-color: $selection_text;
+        border: 1px solid transparent;
+    }
+    QFrame#mainEmptyState {
+        background-color: $panel_alt_bg;
+        border-top: 1px solid $border;
+        border-bottom: 1px solid $border;
+    }
+    QMenuBar {
+        background-color: $window_bg;
+        border-bottom: 1px solid $border;
+    }
+    QMenuBar::item {
+        color: $text;
+        spacing: 3px;
+        padding: 4px 4px;
+        background-color: $window_bg;
+    }
+    QMenuBar::item:selected {
+        background-color: $menu_hover_bg;
+        color: $text_strong;
+    }
+    QMenu {
+        background-color: $window_bg;
+    }
+    QMenu::item {
+        border-style: solid;
+        border-color: transparent;
+        border-left-width: 2px;
+        color: $text;
+        padding: 4px 17px;
+        background-color: $window_bg;
+    }
+    QMenu::item:selected {
+        border-left-color: $accent;
+        color: $text_strong;
+        padding-left: 15px;
+        padding-right: 7px;
+        background-color: $menu_hover_bg;
+    }
+    QLabel#plotStatusMessage {
+        color: $status_text;
+    }
+    QStatusBar {
+        background-color: $window_bg;
+        color: $status_text;
+        border-top: 1px solid $border;
+    }
+    QToolBar {
+        background-color: $panel_bg;
+        border: none;
+        border-bottom: 1px solid $border;
+        spacing: 6px;
+        padding: 2px 8px;
+    }
+    QToolBar QLabel {
+        color: $text;
+    }
+    QToolBar#plotRefreshToolbar {
+        /* Qt uses the largest padding edge as the toolbar frame width. */
+        padding: 2px;
+    }
+    QPushButton {
+        min-height: 20px;
+        border: 1px solid $border_strong;
+        border-radius: 5px;
+        padding: 1px 10px;
+        color: $text;
+        background-color: $button_bg;
+    }
+    QPushButton::default {
+        border-bottom: 1px solid $accent;
+    }
+    QPushButton:hover {
+        border: 1px solid $accent;
+        color: $text_strong;
+        background-color: $button_hover_bg;
+    }
+    QPushButton:pressed {
+        color: $text_strong;
+        background-color: $button_pressed_bg;
+    }
+    QPushButton:disabled {
+        border: 1px solid $border;
+        color: $disabled_text;
+        background-color: $panel_bg;
+    }
+    QToolButton {
+        border: 1px solid transparent;
+        border-bottom: 1px solid $accent;
+        color: $text;
+        padding: 2px;
+        background-color: $panel_bg;
+    }
+    QToolButton:hover {
+        border: 1px solid transparent;
+        border-bottom: 2px solid $accent_hover;
+        color: $text_strong;
+        padding-bottom: 1px;
+        background-color: $panel_bg;
+    }
+    QToolButton#databaseIconButton,
+    QToolButton#plotIconButton,
+    QToolButton#exportIconButton,
+    QToolButton#closeAllPlotsButton {
+        border: 1px solid $border_strong;
+        border-radius: 5px;
+        padding: 1px;
+        background-color: $button_bg;
+    }
+    QToolButton#databaseIconButton:hover,
+    QToolButton#plotIconButton:hover,
+    QToolButton#exportIconButton:hover {
+        border: 1px solid $accent;
+        background-color: $button_hover_bg;
+    }
+    QToolButton#databaseIconButton:pressed,
+    QToolButton#plotIconButton:pressed,
+    QToolButton#exportIconButton:pressed {
+        background-color: $button_pressed_bg;
+    }
+    QToolButton#closeAllPlotsButton {
+        margin-right: 8px;
+    }
+    QToolButton#closeAllPlotsButton:hover {
+        border: 1px solid $danger;
+        background-color: $danger_bg;
+    }
+    QToolButton#closeAllPlotsButton:pressed {
+        background-color: $danger_pressed_bg;
+    }
+    QLineEdit,
+    QSpinBox,
+    QDoubleSpinBox,
+    QTimeEdit,
+    QDateTimeEdit,
+    QDateEdit,
+    QComboBox,
+    QFontComboBox {
+        min-height: 20px;
+        border: 1px solid $border_strong;
+        border-radius: 5px;
+        padding: 0 6px;
+        color: $text;
+        background-color: $field_bg;
+        selection-background-color: $selection_bg;
+        selection-color: $selection_text;
+    }
+    QLineEdit:disabled,
+    QSpinBox:disabled,
+    QDoubleSpinBox:disabled,
+    QComboBox:disabled {
+        background-color: $panel_bg;
+        color: $disabled_text;
+        border: 1px solid $border;
+    }
+    QLineEdit#databasePathField {
+        background-color: $field_alt_bg;
+        color: $muted_text;
+    }
+    QSpinBox#heatmapAppearanceOpacity {
+        padding: 0 16px 0 4px;
+    }
+    QSpinBox#heatmapAppearanceOpacity QLineEdit {
+        padding: 0;
+    }
+    QComboBox:editable {
+        background-color: $field_bg;
+        color: $text;
+    }
+    QComboBox:on {
+        padding-top: 3px;
+        padding-left: 4px;
+    }
+    QComboBox QAbstractItemView {
+        border: 1px solid $accent;
+        background-color: $field_bg;
+        selection-background-color: $selection_bg;
+        selection-color: $selection_text;
+        color: $text;
+    }
+    QProgressBar {
+        text-align: center;
+        color: $progress_text;
+        border: 1px inset $border_strong;
+        border-radius: 10px;
+        background-color: $field_bg;
+    }
+    QProgressBar::chunk {
+        background-color: $accent;
+        border-radius: 5px;
+    }
+    QLCDNumber {
+        color: $accent_hover;
+    }
+    QCheckBox {
+        color: $text;
+        padding: 2px;
+        spacing: 6px;
+    }
+    QCheckBox:disabled {
+        color: $disabled_text;
+    }
+    QCheckBox:hover {
+        border-radius: 4px;
+        border: 1px solid $border_strong;
+        padding: 1px;
+        background-color: $panel_bg;
+    }
+    QCheckBox::indicator {
+        width: 14px;
+        height: 14px;
+    }
+    QRadioButton {
+        color: $text;
+        background-color: $window_bg;
+        padding: 1px;
+    }
+    QRadioButton::indicator:checked,
+    QRadioButton::indicator:!checked {
+        height: 10px;
+        width: 10px;
+        border: 1px solid $accent;
+        border-radius: 5px;
+    }
+    QRadioButton::indicator:checked {
+        background-color: $accent;
+    }
+    QRadioButton::indicator:!checked {
+        background-color: transparent;
+    }
+    QSplitter::handle:vertical {
+        background-color: $splitter;
+        height: 6px;
+        margin: 2px 0px;
+    }
+    QSplitter::handle:vertical:hover {
+        background-color: $accent;
+    }
+    QTabWidget {
+        color: $text;
+        background-color: $window_bg;
+    }
+    QTabWidget::pane {
+        border: 1px solid $border_strong;
+        border-radius: 6px;
+        background-color: $panel_bg;
+        top: -1px;
+    }
+    QTabBar::tab {
+        min-height: 24px;
+        min-width: 84px;
+        padding: 3px 10px;
+        margin-left: 0px;
+        border: 1px solid $border_strong;
+        border-left: none;
+        background-color: $tab_bg;
+        color: $muted_text;
+    }
+    QTabBar::tab:first {
+        border-left: 1px solid $border_strong;
+        border-top-left-radius: 6px;
+        border-bottom-left-radius: 6px;
+    }
+    QTabBar::tab:last {
+        border-top-right-radius: 6px;
+        border-bottom-right-radius: 6px;
+    }
+    QTabBar::tab:selected {
+        background-color: $tab_selected_bg;
+        color: $text_strong;
+        border: 1px solid $accent_hover;
+        padding: 3px 10px;
+    }
+    QTabBar::tab:hover {
+        background-color: $tab_hover_bg;
+        color: $text_strong;
+        border: 1px solid $accent_hover;
+        padding: 3px 10px;
+    }
+    QTabWidget#runDetailsTabs QTabBar::tab {
+        min-height: 18px;
+        min-width: 74px;
+        padding: 1px 8px;
+    }
+    QTabWidget#runDetailsTabs QTabBar::tab:selected,
+    QTabWidget#runDetailsTabs QTabBar::tab:hover {
+        padding: 1px 8px;
+    }
+    QTreeView,
+    QListView,
+    QTreeWidget,
+    QTableView,
+    QTableWidget {
+        background-color: $table_bg;
+        alternate-background-color: $table_alt_bg;
+        color: $text;
+        border: 1px solid $border_strong;
+        gridline-color: $border;
+        outline: 0;
+        selection-background-color: $selection_bg;
+        selection-color: $selection_text;
+        font-size: 10pt;
+    }
+    QTreeView::item,
+    QListView::item,
+    QTreeWidget::item,
+    QTableView::item,
+    QTableWidget::item {
+        padding: 2px 6px;
+        border: none;
+        color: $text;
+    }
+    QTreeView::item:selected,
+    QListView::item:selected,
+    QTreeWidget::item:selected,
+    QTableView::item:selected,
+    QTableWidget::item:selected {
+        background-color: $selection_bg;
+        color: $selection_text;
+    }
+    QTreeView::item:hover,
+    QListView::item:hover,
+    QTreeWidget::item:hover,
+    QTableView::item:hover,
+    QTableWidget::item:hover {
+        background-color: $table_hover_bg;
+        color: $text_strong;
+    }
+    QTreeView::branch {
+        background: transparent;
+        border: none;
+        margin: 0px;
+    }
+    QHeaderView::section {
+        background-color: $header_bg;
+        color: $text;
+        padding: 4px 8px;
+        border: none;
+        border-right: 1px solid $border_strong;
+        border-bottom: 1px solid $border_strong;
+    }
+    QTableWidget#detailsTable::item {
+        padding: 0px 6px;
+    }
+    QTableWidget#detailsTable QHeaderView::section {
+        padding: 1px 6px;
+        font-size: 9pt;
+    }
+    QListWidget {
+        background-color: $table_bg;
+        color: $text;
+        border: 1px solid $border_strong;
+        outline: 0;
+    }
+    QListWidget::item {
+        padding: 0px 0px;
+        border: none;
+    }
+    QListWidget::item:selected {
+        background-color: $selection_bg;
+        color: $selection_text;
+    }
+    QListWidget::item:hover {
+        background-color: $table_hover_bg;
+        color: $text_strong;
+    }
+    QScrollArea {
+        color: $text;
+        background-color: $window_bg;
+        border: none;
+    }
+    QScrollArea QWidget {
+        background-color: $window_bg;
+    }
+    QScrollBar:vertical {
+        width: 10px;
+        background: $scrollbar_bg;
+        margin: 0px;
+        border: none;
+    }
+    QScrollBar:horizontal {
+        height: 10px;
+        background: $scrollbar_bg;
+        margin: 0px;
+        border: none;
+    }
+    QScrollBar::handle:vertical,
+    QScrollBar::handle:horizontal {
+        background: $scrollbar_handle;
+        border-radius: 5px;
+        min-height: 20px;
+        min-width: 20px;
+        border: none;
+    }
+    QScrollBar::handle:vertical:hover,
+    QScrollBar::handle:horizontal:hover {
+        background: $scrollbar_handle_hover;
+    }
+    QScrollBar::add-line:vertical,
+    QScrollBar::sub-line:vertical,
+    QScrollBar::add-line:horizontal,
+    QScrollBar::sub-line:horizontal,
+    QScrollBar::up-arrow:vertical,
+    QScrollBar::down-arrow:vertical,
+    QScrollBar::left-arrow:horizontal,
+    QScrollBar::right-arrow:horizontal {
+        width: 0;
+        height: 0;
+        background: none;
+        border: none;
+    }
+    QSlider::groove:horizontal {
+        height: 5px;
+        background: $accent;
+    }
+    QSlider::groove:vertical {
+        width: 5px;
+        background: $accent;
+    }
+    QSlider::handle:horizontal,
+    QSlider::handle:vertical {
+        background: qlineargradient(x1:0, y1:0, x2:1, y2:1, stop:0 #b4b4b4, stop:1 #8f8f8f);
+        border: 1px solid #5c5c5c;
+        width: 14px;
+        height: 14px;
+        margin: -5px 0;
+        border-radius: 7px;
+    }
+    QSlider::add-page:horizontal,
+    QSlider::add-page:vertical {
+        background: $disabled_text;
+    }
+    QSlider::sub-page:horizontal,
+    QSlider::sub-page:vertical {
+        background: $accent;
+    }
+    """
+)
+
+
+def build_stylesheet(palette: ThemePalette) -> str:
+    """
+    Builds qPlot's shared application stylesheet from a palette.
+
+    """
+    return _STYLESHEET_TEMPLATE.substitute(asdict(palette))
+
+
+def color_list(names: list[str]) -> list:
+    """
+    Converts pyqtgraph color names into reusable QColor instances.
+
+    """
+    return [pg.mkColor(color) for color in names]
+
+
+class PlotTheme:
+    """
+    Shared pyqtgraph styling for qPlot themes.
+
+    """
+
+    plot_background = "w"
+    plot_foreground = "k"
+    plot_grid = "darkgray"
+    colors = color_list(["red", "green", "blue", "black", "darkcyan", "darkorange"])
+
+    @classmethod
+    def style_plotItem(cls, plot_win):
+        plot_item = plot_win.plot
+        plot_win.widget.setBackground(cls.plot_background)
+
+        width = plot_win.config.get("user_preference.axis_tick_width")
+        pen = pg.mkPen(cls.plot_foreground, width=width)
+        font = QtGui.QFont(qtw.QApplication.font())
+        font.setPointSize(plot_win.config.get(FONT_SIZE_KEY))
+
+        def style_axis(axis):
+            axis.setPen(pen)
+            axis.setTickPen(pen)
+            axis.setTextPen(pen)
+            axis.setTickFont(font)
+            axis.label.setFont(font)
+            # pyqtgraph otherwise halves the opacity at each successive tick
+            # level. Keep minor and subminor ticks visibly at the selected
+            # line weight rather than blending them into the heatmap.
+            axis.setStyle(tickAlpha=255)
+            # AxisItem clears its cached picture when its pens change, but
+            # does not schedule a repaint itself. This makes preference
+            # changes visible immediately, including minor tick levels.
+            axis.update()
+
+        for side in ["left", "bottom", "right", "top"]:
+            style_axis(plot_item.getAxis(side))
+
+        # A heatmap colour scale owns separate AxisItems from the plot. Style
+        # both the labelled axis and its mirrored tick-only axis when present.
+        colorbar = getattr(plot_win, "bar", None)
+        get_axis = getattr(colorbar, "getAxis", None)
+        if callable(get_axis):
+            for side in ["left", "bottom", "right", "top"]:
+                axis = get_axis(side)
+                if axis is not None:
+                    style_axis(axis)
+
+        plot_item.vb.gridPen = pg.mkPen(color=cls.plot_grid)
+        cls.set_line_colours(plot_item)
+        update_annotation = getattr(plot_win, "_update_plot_annotation", None)
+        if callable(update_annotation):
+            update_annotation()
+
+    @classmethod
+    def set_line_colours(cls, plot_item):
+        for index, line in enumerate(plot_item.listDataItems()):
+            color = cls.colors[index % len(cls.colors)]
+            line.setPen(pg.mkPen(color=color))

qplot/configuration/themes/blank.py

@@ -0,0 +1,17 @@
+import pyqtgraph as pg
+
+from ._base import PlotTheme, color_list
+
+
+class blank(PlotTheme):
+    main = ""
+    colors = color_list(["red", "green", "blue", "black", "darkcyan", "darkorange"])
+    plot_background = "w"
+    plot_foreground = "k"
+    plot_grid = "darkgray"
+    
+    @classmethod
+    def style_plotItem(cls, plot_win):
+        pg.setConfigOption('background', "w")
+        pg.setConfigOption('foreground', "k")
+        super().style_plotItem(plot_win)

qplot/configuration/themes/dark.py

@@ -0,0 +1,54 @@
+from ._base import (
+    PlotTheme,
+    ThemePalette,
+    build_stylesheet,
+    color_list,
+)
+
+_PALETTE = ThemePalette(
+    window_bg="#1f2026",
+    panel_bg="#202127",
+    panel_alt_bg="#20242a",
+    field_bg="#24262d",
+    field_alt_bg="#202127",
+    button_bg="#24262d",
+    button_hover_bg="#292d34",
+    button_pressed_bg="#123b36",
+    text="#c7d2e1",
+    text_strong="#ffffff",
+    muted_text="#aebacc",
+    disabled_text="#808086",
+    selection_bg="#0f766e",
+    selection_text="#ffffff",
+    accent="#16a085",
+    accent_hover="#37efba",
+    accent_soft="#183f3b",
+    accent_pressed="#123b36",
+    border="#343842",
+    border_strong="#474c57",
+    menu_hover_bg="#292d34",
+    tab_bg="#24262d",
+    tab_selected_bg="#0c625b",
+    tab_hover_bg="#183f3b",
+    table_bg="#1f2026",
+    table_alt_bg="#252730",
+    table_hover_bg="#24443f",
+    header_bg="#2a2d35",
+    status_text="#16a085",
+    progress_text="rgb(240, 240, 240)",
+    splitter="#343842",
+    scrollbar_bg="#252730",
+    scrollbar_handle="#6b7280",
+    scrollbar_handle_hover="#8d96a5",
+    danger="#f97316",
+    danger_bg="#3a2a22",
+    danger_pressed_bg="#4a2d1c",
+)
+
+
+class dark(PlotTheme):
+    main = build_stylesheet(_PALETTE)
+    colors = color_list(["red", "green", "blue", "white", "cyan", "yellow"])
+    plot_background = "k"
+    plot_foreground = "w"
+    plot_grid = "lightgray"

qplot/configuration/themes/light.py

@@ -0,0 +1,54 @@
+from ._base import (
+    PlotTheme,
+    ThemePalette,
+    build_stylesheet,
+    color_list,
+)
+
+_PALETTE = ThemePalette(
+    window_bg="#f0f0f0",
+    panel_bg="#eceef1",
+    panel_alt_bg="#f6f8fb",
+    field_bg="#ffffff",
+    field_alt_bg="#f8f9fb",
+    button_bg="#f7f8fa",
+    button_hover_bg="#ffffff",
+    button_pressed_bg="#e6f1ff",
+    text="#111827",
+    text_strong="#000000",
+    muted_text="#526173",
+    disabled_text="#a0a0a0",
+    selection_bg="#0a84ff",
+    selection_text="#ffffff",
+    accent="#0a84ff",
+    accent_hover="#075eb8",
+    accent_soft="#dcecff",
+    accent_pressed="#e6f1ff",
+    border="#d4d9e2",
+    border_strong="#b8bec7",
+    menu_hover_bg="#e0e0e0",
+    tab_bg="#f7f8fa",
+    tab_selected_bg="#dcecff",
+    tab_hover_bg="#eef6ff",
+    table_bg="#ffffff",
+    table_alt_bg="#f3f5f7",
+    table_hover_bg="#dcecff",
+    header_bg="#eef0f3",
+    status_text="#01664d",
+    progress_text="rgb(40, 40, 40)",
+    splitter="#d7dbe1",
+    scrollbar_bg="#eef0f3",
+    scrollbar_handle="#8b929b",
+    scrollbar_handle_hover="#66707c",
+    danger="#c2410c",
+    danger_bg="#fff7ed",
+    danger_pressed_bg="#ffedd5",
+)
+
+
+class light(PlotTheme):
+    main = build_stylesheet(_PALETTE)
+    colors = color_list(["red", "green", "blue", "black", "darkcyan", "darkorange"])
+    plot_background = "w"
+    plot_foreground = "k"
+    plot_grid = "darkgray"