PySide6 実践講座 #1 プロジェクト設計 — 習慣トラッカーを作りながら学ぶアプリ構造

daily/
├── pyproject.toml
└── src/daily/
    ├── __main__.py        # エントリーポイント: python -m daily
    ├── app.py             # QApplication の生成と組み立て
    ├── ui/                # 画面: ウィジェット、ウィンドウ、ビュー用モデル
    │   └── main_window.py
    ├── core/              # ルール: 習慣・連続記録の計算など Qt と無関係なロジック
    │   └── habits.py
    └── data/              # 保存: SQLite アクセス(第 2 回で実装)
        └── repository.py

uv init daily --package
cd daily
uv add pyside6
uv add --dev pytest pytest-qt

# src/daily/ui/main_window.py
from PySide6.QtWidgets import (
    QHBoxLayout, QLabel, QMainWindow, QPushButton,
    QStackedWidget, QVBoxLayout, QWidget,
)


class MainWindow(QMainWindow):
    def __init__(self) -> None:
        super().__init__()
        self.setWindowTitle("Daily")
        self.resize(480, 640)

        # 画面の枠: 今はプレースホルダー、次回以降で実際の画面に差し替え
        self.pages = QStackedWidget()
        self.pages.addWidget(QLabel("今日"))     # index 0: 第 3 回で実装
        self.pages.addWidget(QLabel("統計"))     # index 1: 第 4 回で実装
        self.pages.addWidget(QLabel("設定"))     # index 2: 第 6 回で実装

        nav = QVBoxLayout()
        for i, name in enumerate(["今日", "統計", "設定"]):
            btn = QPushButton(name)
            btn.clicked.connect(lambda _=False, idx=i: self.pages.setCurrentIndex(idx))
            nav.addWidget(btn)
        nav.addStretch()

        root = QWidget()
        layout = QHBoxLayout(root)
        layout.addLayout(nav)
        layout.addWidget(self.pages, stretch=1)
        self.setCentralWidget(root)

# src/daily/app.py
import sys

from PySide6.QtWidgets import QApplication

from daily.ui.main_window import MainWindow


def main() -> int:
    app = QApplication(sys.argv)
    app.setApplicationName("daily")
    app.setOrganizationName("daily-app")   # 第 6 回の QSettings がこの値を使います
    window = MainWindow()
    window.show()
    return app.exec()

# src/daily/__main__.py
import sys

from daily.app import main

sys.exit(main())