はじめに¶

PubSubTkで、型安全かつ疎結合なGUIアプリケーションを素早く開発しましょう。

1. インストール¶

pip install git+https://github.com/vavavavavavavavava/pubsubtk

2. 基本設計と主要パーツ¶

Store（状態管理）¶

Pydanticモデルでアプリケーションの状態を型安全に管理します。

from pydantic import BaseModel

class AppState(BaseModel):
    counter: int = 0

Container（状態連携UI）¶

状態を購読しUIを自動更新するスマート部品です。

from pubsubtk import ContainerComponentTk

class Main(ContainerComponentTk[AppState]):
    def setup_ui(self):
        ...
    def setup_subscriptions(self):
        self.sub_state_changed(self.store.state.counter, self.on_counter_changed)
    def on_counter_changed(self, _, new):
        ...

Presentational（純粋表示部品）¶

データを受け取って表示するだけのダム部品です。

from pubsubtk import PresentationalComponentTk

class CounterView(PresentationalComponentTk):
    def setup_ui(self):
        ...
    def update_data(self, value: int):
        ...

Processor（ロジック分離・状態操作）¶

ビジネスロジックや複雑な状態変化はProcessorに集約できます。

from pubsubtk import ProcessorBase, AutoNamedTopic
from enum import auto

class Events(AutoNamedTopic):
    INCREMENT = auto()

class MainProcessor(ProcessorBase[AppState]):
    def setup_subscriptions(self):
        self.subscribe(Events.INCREMENT, self.inc)
    def inc(self):
        ...

3. 最小アプリを作ってみる¶

from pubsubtk import TkApplication, ContainerComponentTk
from pydantic import BaseModel

class AppState(BaseModel):
    count: int = 0

class Main(ContainerComponentTk[AppState]):
    def setup_ui(self):
        import tkinter as tk
        self.label = tk.Label(self, text="0")
        self.label.pack()
        tk.Button(self, text="増やす", command=self.inc).pack()
    def setup_subscriptions(self):
        self.sub_state_changed(self.store.state.count, self.on_count)
    def on_count(self, _, new): self.label.config(text=str(new))
    def inc(self):
        state = self.store.get_current_state()
        self.pub_update_state(self.store.state.count, state.count + 1)

if __name__ == "__main__":
    app = TkApplication(AppState, title="Demo")
    app.switch_container(Main)
    app.run()

4. 複数画面／テンプレート／サブウィンドウ¶

複数画面: TemplateComponentTk と pub_switch_slot
サブウィンドウ: pub_open_subwindow

5. Storybook でコンポーネント開発¶

PubSubTkには、コンポーネントを独立して開発・テストできるStorybookが含まれています。

基本的な使い方¶

from pubsubtk.storybook import story, StorybookApplication

# ストーリーを定義
@story("Button.Primary")
def primary_button(ctx):
    import tkinter as tk
    button = tk.Button(ctx.parent, text="Primary Button")
    button.pack(padx=20, pady=20)
    return button

# Storybookアプリを起動
if __name__ == "__main__":
    app = StorybookApplication()
    app.run()

Knobによる動的コントロール¶

@story("Forms.Input")
def input_field(ctx):
    import tkinter as tk

    # Knobで動的に値を変更
    placeholder = ctx.knob("placeholder", str, "Enter text...")
    width = ctx.knob("width", int, 30, range_=(10, 50))
    readonly = ctx.knob("readonly", bool, False)

    entry = tk.Entry(
        ctx.parent, 
        width=width.value,
        state="readonly" if readonly.value else "normal"
    )
    entry.insert(0, placeholder.value)
    entry.pack(padx=20, pady=20)

    return entry

詳細はStorybookガイドを参照してください。

6. よくある開発Tips¶

テーマ切り替え（ThemedApplicationを利用）
状態のバリデーション
イベント駆動とUI分離パターン
デバッグ: enable_pubsub_debug_logging() でPubSubの動作を可視化