requestsとTkinterで作る偉人名言表示アプリケーションプロジェクト

python -m venv myenv

myenv\Scripts\activate

python3 -m venv myenv

source myenv/bin/activate

requests==2.32.4

pip install -r requirements.txt

# 必要なライブラリをインポート
import requests  # HTTP通信を行うためのライブラリ
import json      # JSONデータの処理用ライブラリ

class QuoteAPIManager:
    """名言APIとの通信を管理するクラス"""
    
    def __init__(self):
        """クラスの初期化メソッド"""
        # 使用する名言APIのベースURL
        self.api_url = "https://api.adviceslip.com/advice"
        # リクエストのタイムアウト時間（秒）
        self.timeout = 10
        # HTTPヘッダー情報
        self.headers = {
            'User-Agent': 'WisdomQuotesApp/1.0'  # アプリの識別情報
        }

    def test_api_connection(self):
        """APIとの接続をテストするメソッド"""
        try:
            # APIに対してGETリクエストを送信
            response = requests.get(
                self.api_url,           # リクエスト先のURL
                headers=self.headers,   # HTTPヘッダー情報
                timeout=self.timeout    # タイムアウト時間
            )
            
            # HTTPステータスコードが200番台かチェック
            response.raise_for_status()
            
            # レスポンスが正常に取得できた場合
            print("✓ API接続テスト成功")
            print(f"ステータスコード: {response.status_code}")                    # HTTPステータスコードを表示
            print(f"レスポンス時間: {response.elapsed.total_seconds():.2f}秒")     # 応答時間を表示
            
            return True  # 接続成功を返す
            
        except requests.exceptions.Timeout:
            # タイムアウトエラーの処理
            print("✗ API接続エラー: タイムアウトが発生しました")
            return False  # 接続失敗を返す
            
        except requests.exceptions.ConnectionError:
            # 接続エラーの処理
            print("✗ API接続エラー: インターネット接続を確認してください")
            return False  # 接続失敗を返す
            
        except requests.exceptions.RequestException as e:
            # その他のHTTPエラーの処理
            print(f"✗ API接続エラー: {str(e)}")
            return False  # 接続失敗を返す

    def fetch_random_quote(self):
        """ランダムな名言を取得するメソッド"""
        try:
            # APIに対してGETリクエストを送信
            response = requests.get(
                self.api_url,           # リクエスト先のURL
                headers=self.headers,   # HTTPヘッダー情報
                timeout=self.timeout    # タイムアウト時間
            )
            
            # HTTPステータスコードをチェック
            response.raise_for_status()
            
            # JSON形式のレスポンスを辞書型に変換
            quote_data = response.json()
            
            # Advice Slip APIの形式に合わせてデータを整理
            slip_data = quote_data.get('slip', {})                             # 'slip'キーのデータを取得
            quote_text = slip_data.get('advice', '名言を取得できませんでした')   # 名言テキストを取得
            
            # 取得したデータを整理して辞書形式で返す
            formatted_quote = {
                'content': quote_text,                # 名言の内容
                'id': slip_data.get('id', 0),         # 名言のID番号
                'length': len(quote_text),           # 名言の文字数
                'category': 'life wisdom'             # 名言のカテゴリ
            }
            
            return formatted_quote  # 整理されたデータを返す
            
        except requests.exceptions.RequestException as e:
            # エラーが発生した場合のデフォルトデータを返す
            error_quote = {
                'content': 'エラーが発生しました。しばらくしてからもう一度お試しください。',
                'id': 0,                    # エラー時のID
                'length': 0,                # エラー時の文字数
                'category': 'error'         # エラーカテゴリ
            }
            print(f"名言取得エラー: {str(e)}")  # エラー内容をコンソールに出力
            return error_quote  # エラー用のデータを返す

    def display_quote_info(self, quote_data):
        """名言データを整形して表示するメソッド"""
        # 見やすい区切り線を表示
        print("\n" + "="*60)
        print("💡 取得した名言情報")
        print("="*60)
        
        # 名言の内容を表示
        print(f"💬 名言: {quote_data['content']}")    # 名言のテキスト
        print(f"🔢 ID番号: {quote_data['id']}")           # 名言のID
        print(f"📏 文字数: {quote_data['length']}文字")    # 文字数
        print(f"📂 カテゴリ: {quote_data['category']}")    # カテゴリ情報
        
        # 区切り線で終了
        print("="*60 + "\n")

    def fetch_multiple_quotes(self, count=3):
        """指定した数の名言を取得するメソッド"""
        quotes_list = []          # 名言を格納するリスト
        successful_requests = 0   # 成功したリクエスト数のカウンター
        
        # 取得開始のメッセージを表示
        print(f"🔄 {count}個の名言を取得中...")
        
        # 指定された回数だけ名言を取得
        for i in range(count):
            # 進捗状況を表示
            print(f"取得中... ({i+1}/{count})")
            
            # 1つずつ名言を取得
            quote = self.fetch_random_quote()
            
            # エラーでない場合はリストに追加
            if quote['category'] != 'error':
                quotes_list.append(quote)      # 正常な名言をリストに追加
                successful_requests += 1        # 成功カウンターを増加
            
            # API負荷軽減のため少し待機
            import time
            time.sleep(0.5)  # 0.5秒待機
        
        # 取得完了のメッセージを表示
        print(f"✓ {successful_requests}個の名言を正常に取得しました\n")
        return quotes_list  # 取得した名言のリストを返す

    def calculate_quote_stats(self, quotes_list):
        """名言リストの統計情報を計算するメソッド"""
        # 名言リストが空の場合の処理
        if not quotes_list:
            return None  # 統計情報なしを返す
        
        # 文字数のリストを作成（リスト内包表記を使用）
        lengths = [quote['length'] for quote in quotes_list]
        
        # 統計情報を計算して辞書形式で格納
        stats = {
            'total_count': len(quotes_list),                    # 総名言数
            'avg_length': round(sum(lengths) / len(lengths), 1), # 平均文字数（小数点1桁）
            'max_length': max(lengths),                         # 最長文字数
            'min_length': min(lengths),                         # 最短文字数
            'total_chars': sum(lengths)                         # 総文字数
        }
        
        return stats  # 計算した統計情報を返す
    
    def display_stats(self, stats):
        """統計情報を表示するメソッド"""
        # 統計情報がない場合の処理
        if not stats:
            print("統計情報がありません")
            return
        
        # 統計情報を見やすく表示
        print("📊 名言統計情報")
        print("-" * 30)
        print(f"総名言数: {stats['total_count']}個")      # 総数
        print(f"平均文字数: {stats['avg_length']}文字")         # 平均
        print(f"最長文字数: {stats['max_length']}文字")         # 最大値
        print(f"最短文字数: {stats['min_length']}文字")         # 最小値
        print(f"総文字数: {stats['total_chars']}文字")          # 合計
        print("-" * 30 + "\n")

def main():
    """メインの実行関数"""
    # アプリケーション開始のメッセージ
    print("🌟 名言表示アプリケーション - API接続テスト")
    print("="*50)
    
    # QuoteAPIManagerのインスタンスを作成
    quote_manager = QuoteAPIManager()
    
    # API接続テストを実行
    print("1. API接続テストを開始...")
    connection_success = quote_manager.test_api_connection()  # 接続テストを実行
    
    # 接続に失敗した場合はプログラムを終了
    if not connection_success:
        print("API接続に失敗しました。プログラムを終了します。")
        return  # main関数を終了
    
    # 単一名言の取得テスト
    print("\n2. 単一名言の取得テスト...")
    single_quote = quote_manager.fetch_random_quote()      # 1つの名言を取得
    quote_manager.display_quote_info(single_quote)        # 取得した名言を表示
    
    # 複数名言の取得テスト
    print("3. 複数名言の取得テスト...")
    multiple_quotes = quote_manager.fetch_multiple_quotes(3) # 3つの名言を取得
    
    # 取得した複数の名言を順番に表示
    for idx, quote in enumerate(multiple_quotes, 1):         # インデックス付きでループ
        print(f"\n--- 名言 {idx} ---")
        quote_manager.display_quote_info(quote)           # 各名言を表示
    
    # 統計情報を計算して表示
    stats = quote_manager.calculate_quote_stats(multiple_quotes)  # 統計を計算
    quote_manager.display_stats(stats)                             # 統計情報を表示

# プログラムのエントリーポイント
if __name__ == "__main__":
    main()  # main関数を実行

python quote_display_app.py

# 必要なライブラリをインポート
import requests                # HTTP通信を行うためのライブラリ
import json                    # JSONデータの処理用ライブラリ
import tkinter as tk           # GUIアプリケーション作成用ライブラリ
from tkinter import messagebox # ダイアログボックス表示用モジュール
import time                    # 時間処理用ライブラリ

class QuoteDisplayGUI:
    """名言表示GUIを管理するクラス"""
    
    def __init__(self):
        """GUIクラスの初期化メソッド"""
        # APIマネージャーのインスタンスを作成
        self.api_manager = QuoteAPIManager()
        
        # メインウィンドウの作成と設定
        self.root = tk.Tk()  # tkinterのメインウィンドウを作成
        self.setup_window()  # ウィンドウの基本設定を実行
        
        # GUI要素用の変数を初期化
        self.quote_text = tk.StringVar()  # 名言表示用の文字列変数
        self.quote_text.set("「名言を取得」ボタンをクリックしてください")  # 初期メッセージを設定
        
        # ウィジェットを作成
        self.create_widgets()  # GUI部品を作成
        
        # レイアウトを設定
        self.setup_layout()    # ウィジェットの配置を設定

    def setup_window(self):
        """メインウィンドウの基本設定を行うメソッド"""
        # ウィンドウのタイトル設定
        self.root.title("人生の名言表示アプリ")
        
        # ウィンドウサイズの設定（幅x高さ）
        self.root.geometry("600x400")
        
        # ウィンドウの最小サイズを設定
        self.root.minsize(500, 300)
        
        # ウィンドウの背景色を設定（薄い青色）
        self.root.configure(bg='#f0f8ff')
        
        # ウィンドウを画面中央に配置
        self.center_window()
        
        # ウィンドウが閉じられる時の処理を設定
        self.root.protocol("WM_DELETE_WINDOW", self.on_closing)

    def center_window(self):
        """ウィンドウを画面中央に配置するメソッド"""
        # ウィンドウの更新を待つ
        self.root.update_idletasks()
        
        # 画面の幅と高さを取得
        screen_width = self.root.winfo_screenwidth()   # モニターの幅
        screen_height = self.root.winfo_screenheight() # モニターの高さ
        
        # ウィンドウの幅と高さを取得
        window_width = self.root.winfo_reqwidth()      # ウィンドウの幅
        window_height = self.root.winfo_reqheight()    # ウィンドウの高さ
        
        # 中央配置のための座標を計算
        x = (screen_width - window_width) // 2         # X座標（水平中央）
        y = (screen_height - window_height) // 2       # Y座標（垂直中央）
        
        # ウィンドウの位置を設定
        self.root.geometry(f"+{x}+{y}")

    def create_widgets(self):
        """GUI要素（ウィジェット）を作成するメソッド"""
        # タイトルラベルの作成
        self.title_label = tk.Label(
            self.root,                     # 親ウィンドウ
            text="💡 人生の名言 💡",    # 表示テキスト
            font=("Arial", 20, "bold"),    # フォント設定（Arial、サイズ20、太字）
            bg='#f0f8ff',                  # 背景色
            fg='#2c3e50'                   # 文字色（濃い青）
        )
        
        # 名言表示用のラベルを作成
        self.quote_label = tk.Label(
            self.root,                     # 親ウィンドウ
            textvariable=self.quote_text, # 表示する文字列変数
            font=("Arial", 12),            # フォント設定
            bg='#ffffff',                  # 背景色（白）
            fg='#34495e',                  # 文字色（グレー系）
            wraplength=450,                # 自動改行する幅
            justify='center',              # テキストの中央揃え
            relief='ridge',                # 境界線のスタイル（立体的）
            bd=3,                          # 境界線の太さ
            padx=20,                       # 水平方向の内側余白
            pady=20                        # 垂直方向の内側余白
        )
        
        # 名言取得ボタンの作成
        self.get_quote_button = tk.Button(
            self.root,                     # 親ウィンドウ
            text="名言を取得",         # ボタンのテキスト
            font=("Arial", 14, "bold"),    # フォント設定
            bg='#3498db',                  # ボタンの背景色（青）
            fg='black',                    # ボタンの文字色（黒）
            activebackground='#2980b9',    # クリック時の背景色（濃い青）
            activeforeground='black',      # クリック時の文字色（黒）
            padx=30,                       # 水平方向の内側余白
            pady=12,                       # 垂直方向の内側余白
            command=self.fetch_new_quote  # クリック時に実行する関数
        )
        
        # ステータス表示用のラベル
        self.status_label = tk.Label(
            self.root,                     # 親ウィンドウ
            text="準備完了",                # 初期表示テキスト
            font=("Arial", 10),            # フォント設定
            bg='#f0f8ff',                  # 背景色
            fg='#7f8c8d'                   # 文字色（薄いグレー）
        )

    def setup_layout(self):
        """ウィジェットのレイアウトを設定するメソッド"""
        # タイトルラベルを上部に配置
        self.title_label.pack(pady=(20, 15))  # 上側20px、下側15pxの余白で配置
        
        # 名言表示ラベルを中央に配置
        self.quote_label.pack(
            pady=25,        # 上下25pxの余白
            padx=20,        # 左右20pxの余白
            fill='both',    # 水平・垂直方向に拡張
            expand=True     # ウィンドウサイズ変更時に拡張
        )
        
        # 名言取得ボタンを中央に配置
        self.get_quote_button.pack(pady=15)  # 上下15pxの余白で配置
        
        # ステータスラベルを下部に配置
        self.status_label.pack(
            side='bottom',  # ウィンドウの下部に配置
            pady=15         # 上下15pxの余白
        )

    def fetch_new_quote(self):
        """新しい名言を取得してGUIに表示するメソッド"""
        # ステータス更新（取得中であることを表示）
        self.status_label.config(text="名言を取得中...")
        # ボタンを無効化（連続クリックを防止）
        self.get_quote_button.config(state='disabled')
        # GUI画面を即座に更新
        self.root.update()
        
        try:
            # APIから名言を取得
            quote_data = self.api_manager.fetch_random_quote()
            
            # エラーチェック
            if quote_data['category'] == 'error':
                # エラーダイアログを表示
                messagebox.showerror("エラー", quote_data['content'])
                # ステータスをエラー表示に更新
                self.status_label.config(text="エラーが発生しました")
                return  # 処理を終了
            
            # 名言テキストを更新（引用符で囲む）
            display_text = f'"{quote_data["content"]}"'
            self.quote_text.set(display_text)  # 表示テキストを更新
            
            # ステータス更新（ID番号と文字数を表示）
            self.status_label.config(text=f"ID: {quote_data['id']} | 文字数: {quote_data['length']}")
            
        except Exception as e:
            # 予期しないエラーの処理
            messagebox.showerror("予期しないエラー", f"名言の取得に失敗しました\n{str(e)}")
            # ステータスをエラー表示に更新
            self.status_label.config(text="エラーが発生しました")
        finally:
            # ボタンを再度有効化（エラーの有無に関わらず実行）
            self.get_quote_button.config(state='normal')
    
    def on_closing(self):
        """ウィンドウが閉じられる時の処理"""
        # 終了確認ダイアログを表示
        result = messagebox.askquestion("終了確認", "アプリケーションを終了しますか？")
        # ユーザーが「はい」を選択した場合
        if result == 'yes':
            self.root.destroy()  # ウィンドウを閉じる

    def run_application(self):
        """GUIアプリケーションを実行するメソッド"""
        # 起動メッセージをコンソールに表示
        print("🖥️  GUIアプリケーションを起動中...")
        
        # 初期接続テストを実行
        if not self.api_manager.test_api_connection():
            # 接続に失敗した場合は警告ダイアログを表示
            messagebox.showwarning(
                "接続警告", 
                "APIサーバーに接続できません。\nインターネット接続を確認してください。"
            )
        
        # メインループを開始（ここでGUIが表示される）
        self.root.mainloop()
        
        # アプリケーション終了時のメッセージ
        print("アプリケーションが終了しました")

# 以前のAPIテスト用のメイン関数（Step2で使用していたもの）
# def main():
#     """メインの実行関数"""
#     print("🌟 名言表示アプリケーション - API接続テスト")
#     print("="*50)
#     
#     # QuoteAPIManagerのインスタンスを作成
#     quote_manager = QuoteAPIManager()
#     
#     # API接続テストを実行
#     print("1. API接続テストを開始...")
#     connection_success = quote_manager.test_api_connection()
#     
#     if not connection_success:
#         print("API接続に失敗しました。プログラムを終了します。")
#         return
#     
#     print("\n2. 単一名言の取得テスト...")
#     # 1つの名言を取得してテスト
#     single_quote = quote_manager.fetch_random_quote()
#     quote_manager.display_quote_info(single_quote)
#     
#     print("3. 複数名言の取得テスト...")
#     # 3つの名言を取得してテスト
#     multiple_quotes = quote_manager.fetch_multiple_quotes(3)
#     
#     # 取得した複数の名言を順番に表示
#     for idx, quote in enumerate(multiple_quotes, 1):
#         print(f"\n--- 名言 {idx} ---")
#         quote_manager.display_quote_info(quote)
#     
#     # 統計情報を計算して表示
#     stats = quote_manager.calculate_quote_stats(multiple_quotes)
#     quote_manager.display_stats(stats)

def main():
    """GUIアプリケーションを起動するメイン関数"""
    # GUIアプリケーションのインスタンスを作成
    app = QuoteDisplayGUI()
    
    # アプリケーションを実行
    app.run_application()

# プログラムのエントリーポイント
if __name__ == "__main__":
    main()  # main関数を実行してアプリケーションを開始

python quote_display_app.py

# Virtual environment
myenv/

# Python cache files
__pycache__/
*.pyc
*.pyo

# IDE settings
.vscode/