graphica-plot 2.0.0__py3-none-any.whl

graphica/gui/mixins/ui_setup_mixin.py

@@ -0,0 +1,206 @@
+"""PlotterApp の一度きりの組み立て(シグナル、メニューバー、初めの画面の状態)と、ダークモードの切り替え。"""
+from PySide6.QtWidgets import QApplication
+
+from graphica.gui import app_settings
+from graphica.gui.theme import apply_theme
+from graphica.gui.dialogs import CommandPaletteDialog
+from graphica.gui.datasets.actions_menu import populate_dataset_actions_menu
+from graphica.gui.menu_bar import build_menu_bar
+
+
+class UISetupMixin:
+    def _connect_signals(self):
+        """画面の部品のシグナルをつなぐ。__init__ から1回だけ。同じシグナルに複数つなぐものは、つないだ順に呼ばれる。"""
+        self._connect_layout_signals()
+        self._connect_axis_setting_signals()
+        self._connect_dataset_signals()
+
+    def _create_menu_bar(self):
+        build_menu_bar(self)
+
+    def _populate_dataset_menu(self):
+        populate_dataset_actions_menu(self, self._dataset_menu)
+
+    def _collect_menu_actions(self):
+        """
+        メニューの全項目を、階層のパス付きで集める(コマンドパレット・クイックアクセス・ショートカット一覧が使う)。
+        区切り線・空の項目・サブメニュー自体は除く。「最近使ったファイル」はコマンドではないので除く。
+
+        最上位のメニューは menuBar().actions() から .menu() で辿らず、組み立て時に持たせた self._file_menu などを使う
+        (辿ると、参照が切れたときにメニューごと回収されることがある)。「最近使ったファイル」の判定も、QMenu の
+        同一性ではなく持たせてある self._recent_files_menu_action で行う(繰り返すうちに QMenu の同一性が崩れ、
+        除いたはずの子の項目が混ざることがあった)。
+        """
+        results = []
+        recent_files_action = getattr(self, '_recent_files_menu_action', None)
+
+        def walk(menu, path):
+            for action in menu.actions():
+                if action.isSeparator() or menu is self.recent_files_menu:
+                    continue
+                if action is recent_files_action:
+                    continue
+                submenu = action.menu()
+                if submenu is not None:
+                    if submenu is not self.recent_files_menu:
+                        walk(submenu, path + [action.text().replace('&', '')])
+                else:
+                    text = action.text().replace('&', '').strip()
+                    if text:
+                        results.append((path + [text], action))
+
+        # 「データセット」メニューは含めない。開くたびに作り直すので、候補がそのときの選択で変わり、
+        # ピン留めの識別子も安定しない(作り直すサブメニューを辿るとメニューの回収も起きやすい)
+        top_menus = [self._file_menu, self._edit_menu, self._view_menu, self._help_menu]
+        # 「プラグイン」メニューは、プラグインが何も登録していなければ作られない
+        plugin_menu = getattr(self, '_plugin_menu', None)
+        if plugin_menu is not None:
+            top_menus.append(plugin_menu)
+        for top_menu in top_menus:
+            walk(top_menu, [top_menu.title().replace('&', '')])
+        return results
+
+    def _on_show_command_palette(self):
+        dialog = CommandPaletteDialog(self._collect_menu_actions, self)
+        dialog.exec()
+
+    def _on_toggle_dark_mode(self, checked):
+        """アプリ全体の配色(Qt のパレットと QSS)と、このタブのグラフ・アイコンを切り替える。"""
+        apply_theme(QApplication.instance(), checked)
+        self.canvas.dark_mode = checked
+        app_settings.DARK_MODE.write(self.settings, checked)
+        self._update_plot(light=True)  # 軸の数は変わらないので軽い描き直しでよい
+        # 以下は作ったときにテーマの色を焼き込んでいるので、描き直す:
+        # タイトルと軸ラベルのプレビュー
+        self._refresh_all_label_previews()
+        # 色欄の見本の枠
+        self.color_picker_widget.refresh_theme()
+        self.gradient_color2_picker.refresh_theme()
+        # matplotlib のツールバーのアイコン
+        self._refresh_mpl_toolbar_icons()
+        # 自前の SVG アイコン
+        self._refresh_custom_svg_icons()
+        # 開いたままのデータエディタ(除外した行の背景色)
+        if getattr(self, 'data_editor_dialog', None) is not None:
+            self.data_editor_dialog._populate_table()
+        # 開いたままのヘルプ(表の見出しの色)
+        for dialog_attr in ('help_dialog', 'calc_help_dialog'):
+            dialog = getattr(self, dialog_attr, None)
+            if dialog is not None and hasattr(dialog, 'refresh_theme'):
+                dialog.refresh_theme()
+        # QSS はアプリ全体に効くが、グラフ・アイコン・メニューのチェックはタブごとなので、ほかのタブにも当てる
+        self._sync_dark_mode_to_sibling_tabs(checked)
+
+    def _sync_dark_mode_to_sibling_tabs(self, checked):
+        """ほかのタブにも同じダークモードを当てる(QSS はアプリ全体だが、グラフやアイコンはタブごと)。"""
+        main_app_window = self.window()
+        tab_widget = getattr(main_app_window, 'tab_widget', None)
+        if tab_widget is None:
+            return
+        for i in range(tab_widget.count()):
+            tab = tab_widget.widget(i)
+            if tab is None or tab is self:
+                continue
+            if not hasattr(tab, 'dark_mode_action') or not hasattr(tab, 'canvas'):
+                continue
+            if tab.canvas.dark_mode == checked:
+                continue
+            tab.canvas.dark_mode = checked
+            app_settings.DARK_MODE.write(tab.settings, checked)
+            # toggled を出すと、そのタブがまたほかのタブへ当て直しを連鎖させるので、シグナルを止めてチェックだけ揃える
+            tab.dark_mode_action.blockSignals(True)
+            tab.dark_mode_action.setChecked(checked)
+            tab.dark_mode_action.blockSignals(False)
+            tab._update_plot(light=True)
+            tab._refresh_all_label_previews()
+            tab.color_picker_widget.refresh_theme()
+            tab.gradient_color2_picker.refresh_theme()
+            tab._refresh_mpl_toolbar_icons()
+            tab._refresh_custom_svg_icons()
+
+    def _refresh_mpl_toolbar_icons(self):
+        """
+        matplotlib のツールバーのアイコンを今のパレットで読み直す。matplotlib は作ったときに一度だけ明暗を決めるので、
+        ダークモードを切り替えても古い色のまま残る。非公開の toolitems/_actions を使うので、無ければ何もしない。
+        """
+        toolbar = getattr(self, 'mpl_toolbar', None)
+        if toolbar is None:
+            return
+        toolitems = getattr(toolbar, 'toolitems', None)
+        actions = getattr(toolbar, '_actions', None)
+        if toolitems is None or actions is None:
+            return
+        for text, _tooltip_text, image_file, callback in toolitems:
+            if text is None:
+                continue
+            action = actions.get(callback)
+            if action is not None:
+                action.setIcon(toolbar._icon(image_file + '.png'))
+
+    def _refresh_custom_svg_icons(self):
+        """
+        自前の SVG アイコンを今のテーマで作り直す。_svg_icon() は作るときに色を決めるだけで、
+        setIcon() 済みのアイコンは変わらない(ダイアログは開くたびに作るので対象外)。
+        """
+        from graphica.gui.main_window import _svg_icon
+
+        if hasattr(self, 'cursor_action'):
+            self.cursor_action.setIcon(_svg_icon("pointer"))
+        if hasattr(self, 'annotation_action'):
+            self.annotation_action.setIcon(_svg_icon("message-2"))
+        if hasattr(self, 'layout_edit_action'):
+            self.layout_edit_action.setIcon(_svg_icon("layout-grid"))
+        if hasattr(self, 'reset_zoom_action'):
+            self.reset_zoom_action.setIcon(_svg_icon("refresh"))
+        if hasattr(self, 'stats_toolbar_button'):
+            self.stats_toolbar_button.setIcon(_svg_icon("chart-histogram"))
+        if hasattr(self, 'manage_palette_action'):
+            self.manage_palette_action.setIcon(_svg_icon("palette", size=16))
+        if hasattr(self, 'colormap_assign_action'):
+            self.colormap_assign_action.setIcon(_svg_icon("palette", size=16))
+
+        for button, (icon_name, _label) in getattr(self, '_dataset_action_button_icons', {}).items():
+            button.setIcon(_svg_icon(icon_name, size=18))
+        for button, icon_name in getattr(self, '_field_icon_buttons', {}).items():
+            button.setIcon(_svg_icon(icon_name, size=16))
+        for toggle_button in getattr(self, '_collapsible_toggle_buttons', []):
+            toggle_button.setIcon(
+                _svg_icon("chevron-down" if toggle_button.isChecked() else "chevron-right", size=14)
+            )
+        # プロパティ欄の節の見出しも同じ矢印
+        for entry in getattr(self, '_prop_sections', {}).values():
+            button = entry['toggle']
+            button.setIcon(
+                _svg_icon("chevron-down" if button.isChecked() else "chevron-right", size=13)
+            )
+
+    def _set_initial_ui_state(self):
+
+            self.ui.x_autoscale_checkbox.setChecked(True)
+            self.ui.y_autoscale_checkbox.setChecked(True)
+            self.ui.legend_visible_checkbox.setChecked(True)
+
+
+            self.y2_label_text_label.setVisible(False)
+            self.y2_label_text_edit.setVisible(False)
+            self.tick_direction_y2_label.setVisible(False)
+            self.major_tick_direction_y2_combo.setVisible(False)
+            self.minor_tick_direction_y2_combo.setVisible(False)
+
+            self.fit_info_label.setVisible(False)
+            self.fit_info_textedit.setVisible(False)
+
+            self.ui.grid_visible_checkbox.setChecked(False)
+            self.ui.minor_grid_visible_checkbox.setChecked(False)
+
+            self.ui.spine_width_spinbox.setValue(self._spine_width)
+            self.ui.tick_width_spinbox.setValue(self._tick_width)
+
+            # チェックの状態に合わせて関係する欄の有効/無効を揃える
+            self._on_x_minor_tick_visibility_changed()
+            self._on_y_minor_tick_visibility_changed()
+            self._on_grid_visibility_changed()
+            self._on_legend_visibility_changed() # 凡例関連のUIを有効化
+            self._refresh_y2_axis_state()
+
+            self.property_panel.update_ui_state()

graphica/gui/notify.py

@@ -0,0 +1,61 @@
+"""利用者へのメッセージと問い合わせ(ファイル・文字の入力)の窓口。
+
+Qt の静的メソッドを同じ引数でそのまま呼ぶだけで、文言・題・ボタン・既定のボタン・親・戻り値は呼ぶ側が決める。
+呼ぶときにクラスの属性を引くので、テストは QMessageBox などのクラスの属性を差し替えれば、どの画面の通知も記録できる。
+crash_handler は例外処理の最中に動くので、ここを通さない(import の順と初期化の失敗を避ける)。
+"""
+from typing import Any
+
+from PySide6.QtWidgets import QFileDialog, QInputDialog, QMessageBox
+
+
+def information(*args: Any, **kwargs: Any) -> Any:
+    return QMessageBox.information(*args, **kwargs)
+
+
+def warning(*args: Any, **kwargs: Any) -> Any:
+    return QMessageBox.warning(*args, **kwargs)
+
+
+def critical(*args: Any, **kwargs: Any) -> Any:
+    return QMessageBox.critical(*args, **kwargs)
+
+
+def question(*args: Any, **kwargs: Any) -> Any:
+    return QMessageBox.question(*args, **kwargs)
+
+
+def about(*args: Any, **kwargs: Any) -> Any:
+    return QMessageBox.about(*args, **kwargs)
+
+
+def get_open_file_name(*args: Any, **kwargs: Any) -> Any:
+    return QFileDialog.getOpenFileName(*args, **kwargs)
+
+
+def get_open_file_names(*args: Any, **kwargs: Any) -> Any:
+    return QFileDialog.getOpenFileNames(*args, **kwargs)
+
+
+def get_save_file_name(*args: Any, **kwargs: Any) -> Any:
+    return QFileDialog.getSaveFileName(*args, **kwargs)
+
+
+def get_existing_directory(*args: Any, **kwargs: Any) -> Any:
+    return QFileDialog.getExistingDirectory(*args, **kwargs)
+
+
+def get_text(*args: Any, **kwargs: Any) -> Any:
+    return QInputDialog.getText(*args, **kwargs)
+
+
+def get_int(*args: Any, **kwargs: Any) -> Any:
+    return QInputDialog.getInt(*args, **kwargs)
+
+
+def get_double(*args: Any, **kwargs: Any) -> Any:
+    return QInputDialog.getDouble(*args, **kwargs)
+
+
+def get_item(*args: Any, **kwargs: Any) -> Any:
+    return QInputDialog.getItem(*args, **kwargs)

graphica/gui/panels/__init__.py

@@ -0,0 +1,43 @@
+"""画面の欄をまとめる部品(gui/panels/*.py)と、PlotterApp に部品の名前を出す窓口。
+
+欄のウィジェットと状態はタブが持ち、部品は欄の読み書き・処理・信号の配線を持つ。PlotterApp は各部品の EXPOSED_NAMES を
+同じ名前の属性として出し、読み書きを部品へ回す(テスト・メニュー・ほかの部品が今までの名前で使うため。monkeypatch も部品に届く)。
+"""
+from graphica.gui.panels.axis_settings import AxisSettingsPanel
+from graphica.gui.panels.dataset_tree import DatasetTreePanel
+
+__all__ = ["PANEL_CLASSES", "create_panels", "expose_panel_names"]
+
+PANEL_CLASSES = {
+    "axis_settings": AxisSettingsPanel,
+    "dataset_tree": DatasetTreePanel,
+}
+
+
+def create_panels(app):
+    return {key: panel_class(app) for key, panel_class in PANEL_CLASSES.items()}
+
+
+class _PanelName:
+    """PlotterApp の属性として、部品の同じ名前の属性を読み書きする。"""
+
+    def __init__(self, panel_key, name):
+        self._panel_key = panel_key
+        self._name = name
+
+    def __get__(self, app, owner=None):
+        if app is None:
+            # クラスから引いたとき(メニューの表の検査など)は、部品のクラスの同じ名前を返す
+            return getattr(PANEL_CLASSES[self._panel_key], self._name, self)
+        return getattr(app.panels[self._panel_key], self._name)
+
+    def __set__(self, app, value):
+        setattr(app.panels[self._panel_key], self._name, value)
+
+
+def expose_panel_names(app_class):
+    for key, panel_class in PANEL_CLASSES.items():
+        for name in panel_class.EXPOSED_NAMES:
+            if any(name in klass.__dict__ for klass in app_class.__mro__):
+                raise TypeError(f"{app_class.__name__}.{name} は部品 {key} の名前とぶつかる")
+            setattr(app_class, name, _PanelName(key, name))