# 運(yùn)行命令行交互式工具
gui_builtin_explorer.py

# 運(yùn)行GUI圖形界面工具
gui_builtin_explorer.py

# 運(yùn)行完整測(cè)試套件
gui_builtin_explorer.py

gui_builtin_explorer.py

gui_builtin_explorer.py

gui_builtin_explorer.py

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Python內(nèi)置函數(shù)GUI瀏覽器

基于tkinter的圖形界面工具，提供直觀的函數(shù)瀏覽和學(xué)習(xí)體驗(yàn)。
用戶(hù)可以通過(guò)點(diǎn)擊函數(shù)名查看詳細(xì)信息和示例代碼。

功能特性:
- 分類(lèi)瀏覽內(nèi)置函數(shù)
- 點(diǎn)擊查看函數(shù)詳細(xì)信息
- 實(shí)時(shí)代碼演示
- 搜索功能
- 美觀的GUI界面

作者: AI助手
創(chuàng)建時(shí)間: 2024
"""

import tkinter as tk
from tkinter import ttk, scrolledtext, messagebox
import sys
import io
from contextlib import redirect_stdout, redirect_stderr
from python_builtin_functions import PythonBuiltinFunctions

class BuiltinFunctionGUI:
    """
    Python內(nèi)置函數(shù)GUI瀏覽器
    
    提供圖形界面來(lái)瀏覽和學(xué)習(xí)Python內(nèi)置函數(shù)
    """
    
    def __init__(self, root):
        self.root = root
        self.parser = PythonBuiltinFunctions()
        self.current_function = None
        
        # 設(shè)置窗口
        self.setup_window()
        
        # 創(chuàng)建界面
        self.create_widgets()
        
        # 加載數(shù)據(jù)
        self.load_functions()
    
    def setup_window(self):
        """
        設(shè)置主窗口
        """
        self.root.title("Python內(nèi)置函數(shù)大全 - GUI瀏覽器")
        self.root.geometry("1200x800")
        self.root.minsize(1000, 600)
        
        # 設(shè)置圖標(biāo)和樣式
        try:
            self.root.iconbitmap(default="python.ico")
        except:
            pass  # 如果沒(méi)有圖標(biāo)文件就忽略
        
        # 配置樣式
        style = ttk.Style()
        style.theme_use('clam')
    
    def create_widgets(self):
        """
        創(chuàng)建界面組件
        """
        # 主框架
        main_frame = ttk.Frame(self.root, padding="10")
        main_frame.grid(row=0, column=0, sticky=(tk.W, tk.E, tk.N, tk.S))
        
        # 配置網(wǎng)格權(quán)重
        self.root.columnconfigure(0, weight=1)
        self.root.rowconfigure(0, weight=1)
        main_frame.columnconfigure(1, weight=2)
        main_frame.rowconfigure(1, weight=1)
        
        # 標(biāo)題
        title_label = ttk.Label(main_frame, text="?? Python內(nèi)置函數(shù)大全", 
                               font=('Arial', 16, 'bold'))
        title_label.grid(row=0, column=0, columnspan=3, pady=(0, 10))
        
        # 左側(cè)面板 - 函數(shù)列表
        self.create_function_list_panel(main_frame)
        
        # 右側(cè)面板 - 詳細(xì)信息
        self.create_detail_panel(main_frame)
        
        # 底部面板 - 代碼演示
        self.create_demo_panel(main_frame)
    
    def create_function_list_panel(self, parent):
        """
        創(chuàng)建函數(shù)列表面板
        """
        # 左側(cè)框架
        left_frame = ttk.LabelFrame(parent, text="?? 函數(shù)列表", padding="5")
        left_frame.grid(row=1, column=0, sticky=(tk.W, tk.E, tk.N, tk.S), padx=(0, 5))
        left_frame.columnconfigure(0, weight=1)
        left_frame.rowconfigure(2, weight=1)
        
        # 搜索框
        search_frame = ttk.Frame(left_frame)
        search_frame.grid(row=0, column=0, sticky=(tk.W, tk.E), pady=(0, 5))
        search_frame.columnconfigure(1, weight=1)
        
        ttk.Label(search_frame, text="?? 搜索:").grid(row=0, column=0, padx=(0, 5))
        self.search_var = tk.StringVar()
        self.search_var.trace('w', self.on_search_change)
        search_entry = ttk.Entry(search_frame, textvariable=self.search_var)
        search_entry.grid(row=0, column=1, sticky=(tk.W, tk.E))
        
        # 分類(lèi)選擇
        category_frame = ttk.Frame(left_frame)
        category_frame.grid(row=1, column=0, sticky=(tk.W, tk.E), pady=(0, 5))
        category_frame.columnconfigure(1, weight=1)
        
        ttk.Label(category_frame, text="?? 分類(lèi):").grid(row=0, column=0, padx=(0, 5))
        self.category_var = tk.StringVar()
        self.category_combo = ttk.Combobox(category_frame, textvariable=self.category_var,
                                          state="readonly")
        self.category_combo.grid(row=0, column=1, sticky=(tk.W, tk.E))
        self.category_combo.bind('<<ComboboxSelected>>', self.on_category_change)
        
        # 函數(shù)列表
        list_frame = ttk.Frame(left_frame)
        list_frame.grid(row=2, column=0, sticky=(tk.W, tk.E, tk.N, tk.S))
        list_frame.columnconfigure(0, weight=1)
        list_frame.rowconfigure(0, weight=1)
        
        # 創(chuàng)建Treeview
        self.function_tree = ttk.Treeview(list_frame, columns=('category',), show='tree headings')
        self.function_tree.heading('#0', text='函數(shù)名')
        self.function_tree.heading('category', text='分類(lèi)')
        self.function_tree.column('#0', width=120)
        self.function_tree.column('category', width=100)
        
        # 滾動(dòng)條
        tree_scroll = ttk.Scrollbar(list_frame, orient="vertical", command=self.function_tree.yview)
        self.function_tree.configure(yscrollcommand=tree_scroll.set)
        
        self.function_tree.grid(row=0, column=0, sticky=(tk.W, tk.E, tk.N, tk.S))
        tree_scroll.grid(row=0, column=1, sticky=(tk.N, tk.S))
        
        # 綁定選擇事件
        self.function_tree.bind('<<TreeviewSelect>>', self.on_function_select)
    
    def create_detail_panel(self, parent):
        """
        創(chuàng)建詳細(xì)信息面板
        """
        # 右側(cè)框架
        right_frame = ttk.LabelFrame(parent, text="?? 函數(shù)詳情", padding="5")
        right_frame.grid(row=1, column=1, sticky=(tk.W, tk.E, tk.N, tk.S), padx=5)
        right_frame.columnconfigure(0, weight=1)
        right_frame.rowconfigure(5, weight=1)
        
        # 函數(shù)名
        self.func_name_var = tk.StringVar(value="請(qǐng)選擇一個(gè)函數(shù)")
        func_name_label = ttk.Label(right_frame, textvariable=self.func_name_var,
                                   font=('Arial', 14, 'bold'), foreground='blue')
        func_name_label.grid(row=0, column=0, sticky=(tk.W, tk.E), pady=(0, 10))
        
        # 描述
        ttk.Label(right_frame, text="?? 描述:", font=('Arial', 10, 'bold')).grid(row=1, column=0, sticky=tk.W)
        self.description_var = tk.StringVar()
        description_label = ttk.Label(right_frame, textvariable=self.description_var,
                                     wraplength=400, justify=tk.LEFT)
        description_label.grid(row=2, column=0, sticky=(tk.W, tk.E), pady=(0, 10))
        
        # 語(yǔ)法
        ttk.Label(right_frame, text="?? 語(yǔ)法:", font=('Arial', 10, 'bold')).grid(row=3, column=0, sticky=tk.W)
        self.syntax_var = tk.StringVar()
        syntax_label = ttk.Label(right_frame, textvariable=self.syntax_var,
                                font=('Consolas', 9), foreground='darkgreen',
                                wraplength=400, justify=tk.LEFT)
        syntax_label.grid(row=4, column=0, sticky=(tk.W, tk.E), pady=(0, 10))
        
        # 參數(shù)說(shuō)明
        ttk.Label(right_frame, text="?? 參數(shù):", font=('Arial', 10, 'bold')).grid(row=5, column=0, sticky=(tk.W, tk.N))
        
        # 參數(shù)文本框
        param_frame = ttk.Frame(right_frame)
        param_frame.grid(row=6, column=0, sticky=(tk.W, tk.E, tk.N, tk.S), pady=(0, 10))
        param_frame.columnconfigure(0, weight=1)
        param_frame.rowconfigure(0, weight=1)
        
        self.param_text = scrolledtext.ScrolledText(param_frame, height=4, wrap=tk.WORD,
                                                   font=('Arial', 9))
        self.param_text.grid(row=0, column=0, sticky=(tk.W, tk.E, tk.N, tk.S))
        
        # 返回類(lèi)型
        ttk.Label(right_frame, text="?? 返回類(lèi)型:", font=('Arial', 10, 'bold')).grid(row=7, column=0, sticky=tk.W)
        self.return_type_var = tk.StringVar()
        return_type_label = ttk.Label(right_frame, textvariable=self.return_type_var,
                                     font=('Arial', 9), foreground='purple')
        return_type_label.grid(row=8, column=0, sticky=(tk.W, tk.E), pady=(0, 10))
    
    def create_demo_panel(self, parent):
        """
        創(chuàng)建代碼演示面板
        """
        # 底部框架
        bottom_frame = ttk.LabelFrame(parent, text="?? 代碼演示", padding="5")
        bottom_frame.grid(row=2, column=0, columnspan=2, sticky=(tk.W, tk.E, tk.N, tk.S), pady=(10, 0))
        bottom_frame.columnconfigure(0, weight=1)
        bottom_frame.rowconfigure(1, weight=1)
        
        # 按鈕框架
        button_frame = ttk.Frame(bottom_frame)
        button_frame.grid(row=0, column=0, sticky=(tk.W, tk.E), pady=(0, 5))
        
        # 運(yùn)行演示按鈕
        self.demo_button = ttk.Button(button_frame, text="?? 運(yùn)行演示", 
                                     command=self.run_demo, state='disabled')
        self.demo_button.grid(row=0, column=0, padx=(0, 10))
        
        # 清空輸出按鈕
        clear_button = ttk.Button(button_frame, text="??? 清空輸出", 
                                 command=self.clear_output)
        clear_button.grid(row=0, column=1)
        
        # 示例代碼標(biāo)簽
        self.example_var = tk.StringVar()
        example_label = ttk.Label(button_frame, textvariable=self.example_var,
                                 font=('Consolas', 9), foreground='darkblue')
        example_label.grid(row=0, column=2, padx=(20, 0))
        
        # 輸出文本框
        output_frame = ttk.Frame(bottom_frame)
        output_frame.grid(row=1, column=0, sticky=(tk.W, tk.E, tk.N, tk.S))
        output_frame.columnconfigure(0, weight=1)
        output_frame.rowconfigure(0, weight=1)
        
        self.output_text = scrolledtext.ScrolledText(output_frame, height=8, wrap=tk.WORD,
                                                    font=('Consolas', 9), bg='#f0f0f0')
        self.output_text.grid(row=0, column=0, sticky=(tk.W, tk.E, tk.N, tk.S))
    
    def load_functions(self):
        """
        加載函數(shù)數(shù)據(jù)
        """
        # 獲取所有分類(lèi)
        categories = set()
        for info in self.parser.functions_info.values():
            categories.add(info['category'])
        
        # 設(shè)置分類(lèi)下拉框
        category_list = ['全部'] + sorted(list(categories))
        self.category_combo['values'] = category_list
        self.category_combo.set('全部')
        
        # 加載所有函數(shù)
        self.refresh_function_list()
    
    def refresh_function_list(self, search_text='', category='全部'):
        """
        刷新函數(shù)列表
        
        Args:
            search_text: 搜索文本
            category: 選擇的分類(lèi)
        """
        # 清空現(xiàn)有項(xiàng)目
        for item in self.function_tree.get_children():
            self.function_tree.delete(item)
        
        # 過(guò)濾函數(shù)
        filtered_functions = []
        for func_name, info in self.parser.functions_info.items():
            # 分類(lèi)過(guò)濾
            if category != '全部' and info['category'] != category:
                continue
            
            # 搜索過(guò)濾
            if search_text and search_text.lower() not in func_name.lower():
                continue
            
            filtered_functions.append((func_name, info))
        
        # 按函數(shù)名排序
        filtered_functions.sort(key=lambda x: x[0])
        
        # 添加到樹(shù)形控件
        for func_name, info in filtered_functions:
            self.function_tree.insert('', 'end', text=func_name, 
                                     values=(info['category'],), tags=(func_name,))
    
    def on_search_change(self, *args):
        """
        搜索文本變化事件
        """
        search_text = self.search_var.get()
        category = self.category_var.get()
        self.refresh_function_list(search_text, category)
    
    def on_category_change(self, event):
        """
        分類(lèi)選擇變化事件
        """
        search_text = self.search_var.get()
        category = self.category_var.get()
        self.refresh_function_list(search_text, category)
    
    def on_function_select(self, event):
        """
        函數(shù)選擇事件
        """
        selection = self.function_tree.selection()
        if not selection:
            return
        
        item = selection[0]
        func_name = self.function_tree.item(item, 'text')
        
        if func_name in self.parser.functions_info:
            self.show_function_details(func_name)
    
    def show_function_details(self, func_name):
        """
        顯示函數(shù)詳細(xì)信息
        
        Args:
            func_name: 函數(shù)名
        """
        self.current_function = func_name
        info = self.parser.functions_info[func_name]
        
        # 更新界面
        self.func_name_var.set(f"{func_name}()")
        self.description_var.set(info['description'])
        self.syntax_var.set(info['syntax'])
        self.return_type_var.set(info['return_type'])
        self.example_var.set(f"示例: {info['example']}")
        
        # 更新參數(shù)說(shuō)明
        self.param_text.delete(1.0, tk.END)
        self.param_text.insert(1.0, info['parameters'])
        
        # 啟用演示按鈕
        self.demo_button.config(state='normal')
    
    def run_demo(self):
        """
        運(yùn)行函數(shù)演示
        """
        if not self.current_function:
            return
        
        try:
            # 捕獲輸出
            stdout_capture = io.StringIO()
            stderr_capture = io.StringIO()
            
            with redirect_stdout(stdout_capture), redirect_stderr(stderr_capture):
                self.parser._run_demonstration(self.current_function)
            
            stdout_output = stdout_capture.getvalue()
            stderr_output = stderr_capture.getvalue()
            
            # 顯示輸出
            self.output_text.insert(tk.END, f"\n=== {self.current_function}() 演示 ===\n")
            
            if stdout_output:
                self.output_text.insert(tk.END, stdout_output)
            
            if stderr_output:
                self.output_text.insert(tk.END, f"錯(cuò)誤輸出:\n{stderr_output}")
            
            self.output_text.insert(tk.END, "\n" + "="*50 + "\n")
            
            # 滾動(dòng)到底部
            self.output_text.see(tk.END)
        
        except Exception as e:
            self.output_text.insert(tk.END, f"\n演示運(yùn)行出錯(cuò): {str(e)}\n")
            self.output_text.see(tk.END)
    
    def clear_output(self):
        """
        清空輸出
        """
        self.output_text.delete(1.0, tk.END)
        self.output_text.insert(1.0, "?? 輸出區(qū)域已清空，點(diǎn)擊'運(yùn)行演示'查看函數(shù)演示結(jié)果\n")


def main():
    """
    主函數(shù)
    """
    # 創(chuàng)建主窗口
    root = tk.Tk()
    
    # 創(chuàng)建應(yīng)用
    app = BuiltinFunctionGUI(root)
    
    # 設(shè)置初始提示
    app.output_text.insert(1.0, 
        "?? 歡迎使用Python內(nèi)置函數(shù)GUI瀏覽器！\n\n"
        "?? 使用說(shuō)明:\n"
        "1. 在左側(cè)選擇函數(shù)分類(lèi)或使用搜索功能\n"
        "2. 點(diǎn)擊函數(shù)名查看詳細(xì)信息\n"
        "3. 點(diǎn)擊'運(yùn)行演示'查看函數(shù)使用示例\n"
        "4. 在此區(qū)域查看演示輸出結(jié)果\n\n"
        "?? 提示: 選擇一個(gè)函數(shù)開(kāi)始探索吧！\n"
        "="*50 + "\n"
    )
    
    # 運(yùn)行主循環(huán)
    root.mainloop()


if __name__ == "__main__":
    main()