示例工程教程【免费下载链接】materialsBonus materials, exercises, and example projects for our Python tutorials项目地址https://gitcode.com/gh_mirrors/ma/materials点击查看免费下载本文基于开源仓库 materials 中 contact-book-python-textual 项目的source_code_step_3阶段文档展开。该阶段对应从零构建一个基于Python Textual SQLite的终端联系人应用RP Contacts的第三个里程碑搭建完整的主界面骨架DataTable 联系人列表 操作按钮面板 退出确认对话框并把项目打磨成可通过pip install -e .rpcontacts命令行一键启动的 Python 包。读完本文你将掌握 Textual 应用中compose()、BINDINGS、屏幕Screen与对话框Dialog的协作方式以及联系人应用分阶段落地的第一步把能跑起来变成界面成型。1. 项目背景RP Contacts 与 Textual 终端 GUIRP Contacts 是一个典型的终端联系人簿应用技术栈为 Python Textual终端 UI 框架 SQLite本地持久化。整个教程被拆分为 6 个递进阶段分别位于source_code_step_1 source_code_step_6逐步演进的可运行示例source_code最终完整版其中Step 3是教程的重要转折点前两步只提供了最基础的包结构而这一步开始真正构建 Textual 应用的主界面——联系人列表DataTable、操作面板Add / Delete / Clear All 按钮以及按下q时的退出确认对话框。也就是说Step 3 结束后应用虽然还没有接数据库增删改查那是后续步骤的工作但终端界面骨架已经完全成型且已经可以作为命令行工具启动。阶段对比从源码看Step 2 的 tui.py 与 Step 3 的 tui.py 内容完全一致说明 Step 3 的界面代码实际上是复用并稳定下来的而 Step 4 起ContactsApp才开始接收db参数并从 SQLite 加载数据见 Step 4 tui.py。因此 Step 3 文档的定位是把项目组织和启动方式打磨到可发布状态。2. 安装环境虚拟环境 依赖安装Step 3 的 README.md 给出了标准的安装流程全程在虚拟环境中进行# 1. 创建并激活 Python 虚拟环境 $ python -m venv ./venv $ source venv/bin/activate (venv) $ # 2. 安装项目依赖 (venv) $ python -m pip install -r requirements.txt本仓库中 source_code_step_3/requirements.txt 只声明了一个核心依赖textual0.75.1Textual 是该项目唯一的第三方运行时依赖版本被精确锁定为0.75.1。如果你的环境中同时需要安装 SQLite 驱动无需额外声明——sqlite3是 Python 标准库模块随解释器自带。这一点也可以在 database.py 的导入语句中得到印证import pathlib与import sqlite3均来自标准库。2.1 依赖锁定与复现性固定版本号0.75.1意味着项目在不同机器上安装时拿到的是同一版本的 Textual这保证了教程示例的 API如App、Screen、DataTable、Button.Pressed等行为一致终端渲染效果TCSS 样式、布局、颜色主题可复现排错时不必担心因 Textual 升级导致的行为漂移。3. 运行项目可编辑安装 rpcontacts 命令安装依赖后Step 3 文档给出的运行方式是两步走(venv) $ python -m pip install -e . (venv) $ rpcontactspip install -e .是editable可编辑安装它会在当前目录读取打包配置把rpcontacts包注册到当前虚拟环境同时生成rpcontacts控制台命令入口。之后每次修改源码命令都会直接使用最新代码无需重复安装——这正是分阶段教程的理想形态。rpcontacts命令能够直接呼出应用的原理在于包内的main.pyfrom rpcontacts.tui import ContactsApp def main(): app ContactsApp() app.run() if __name__ __main__: main()ContactsApp()实例化 Textual 应用app.run()启动事件循环并进入终端界面if __name__ __main__:使该文件支持python -m rpcontacts方式运行后续 Step 6 README 即采用python -m rpcontacts的启动方式。3.1 为什么是pip install -e .而不是直接python rpcontacts/tui.py可编辑安装带来的核心收益有三点命令名封装用户只需要记住rpcontacts无需关心包内部文件组织依赖自动管理安装过程会解析并安装 requirements.txt 中声明的 Textual开发体验-e标志保证源码改动即时生效符合教程分步迭代的开发节奏。4. 界面骨架源码解析tui.py 的两个核心类Step 3 的全部界面逻辑集中在 rpcontacts/tui.py 中共定义了两个类ContactsApp主应用与QuestionDialog退出确认对话框。4.1 ContactsApp主应用类from textual.app import App from textual.containers import Grid, Horizontal, Vertical from textual.screen import Screen from textual.widgets import Button, DataTable, Footer, Header, Label, Static class ContactsApp(App): CSS_PATH rpcontacts.tcss BINDINGS [ (m, toggle_dark, Toggle dark mode), (a, add, Add), (d, delete, Delete), (c, clear_all, Clear All), (q, request_quit, Quit), ]CSS_PATH rpcontacts.tcss声明应用的样式表文件。Textual 使用类 CSS 语法TCSS控制布局与外观这里指向同目录下的 rpcontacts.tcss应用启动时会自动加载。BINDINGS定义键盘快捷键到动作action的映射表每组由(按键, 动作名, 帮助说明)组成。这些动作由action_*方法实现按键动作方法功能说明maction_toggle_dark切换明暗主题self.dark not self.darkaaction_add添加联系人占位Step 5 才接入InputDialogdaction_delete删除联系人占位Step 6 才实现完整逻辑caction_clear_all清空全部联系人占位Step 6 实现qaction_request_quit弹出退出确认对话框说明Step 3 中a/d/c三个动作尚未绑定具体方法真正实现分别在 Step 5 tui.pyaction_addInputDialog与 Step 6 tui.pyaction_delete/action_clear_all中完成。Step 3 的绑定表更像是界面契约提前确定了快捷键布局。4.2 compose()声明式组装界面def compose(self): yield Header() contacts_list DataTable(classescontacts-list) contacts_list.focus() contacts_list.add_columns(Name, Phone, Email) contacts_list.cursor_type row contacts_list.zebra_stripes True add_button Button(Add, variantsuccess, idadd) add_button.focus() buttons_panel Vertical( add_button, Button(Delete, variantwarning, iddelete), Static(classesseparator), Button(Clear All, varianterror, idclear), classesbuttons-panel, ) yield Horizontal(contacts_list, buttons_panel) yield Footer()compose()是 Textual 应用声明界面的核心钩子通过yield按顺序产出控件最终界面结构为Header顶部标题栏 └── Horizontal横向布局 ├── DataTable联系人表格classcontacts-list └── Vertical操作按钮面板classbuttons-panel ├── Button Addvariantsuccess绿色 ├── Button Deletevariantwarning黄色 ├── Static分隔占位classseparator └── Button Clear Allvarianterror红色 Footer底部快捷键提示栏关键点逐条拆解DataTable列定义add_columns(Name, Phone, Email)创建三列表格cursor_type row光标以整行为单位移动为后续按行选中、删除联系人做准备zebra_stripes True开启斑马纹隔行变色提升长列表的可读性Button的variantTextual 内置按钮风格success绿、warning黄、error红在视觉上区分新增/警告/危险三类操作focus()顺序先让表格获得焦点再把焦点交给 Add 按钮保证键盘用户打开应用即可操作Static分隔器占据1fr弹性高度见 TCSS 中.separator { height: 1fr; }把 Delete 与 Clear All 按钮在垂直方向撑开形成间距。4.3 生命周期与退出逻辑def on_mount(self): self.title RP Contacts self.sub_title A Contacts Book App With Textual Python def action_toggle_dark(self): self.dark not self.dark def action_request_quit(self): def check_answer(accepted): if accepted: self.exit() self.push_screen(QuestionDialog(Do you want to quit?), check_answer)on_mount()应用挂载完成后设置窗口标题与副标题Header控件会自动展示这两行文本action_toggle_dark()翻转self.dark布尔值Textual 内置明暗两套配色主题按m即可即时切换action_request_quit()这是 Step 3 最有代表性的模式——push_screen()把一个模态ScreenQuestionDialog压入屏幕栈并传入回调check_answer当对话框通过dismiss()弹出返回值时回调被调用accepted为True才真正退出。这种先确认再退出的设计避免了误触q丢失数据对后续接上 SQLite 的联系人数据尤为重要。4.4 QuestionDialog模态确认对话框class QuestionDialog(Screen): def __init__(self, message, *args, **kwargs): super().__init__(*args, **kwargs) self.message message def compose(self): no_button Button(No, variantprimary, idno) no_button.focus() yield Grid( Label(self.message, idquestion), Button(Yes, varianterror, idyes), no_button, idquestion-dialog, ) def on_button_pressed(self, event): if event.button.id yes: self.dismiss(True) else: self.dismiss(False)QuestionDialog继承自Screen构成一个独立的模态屏幕构造时接收消息文本经compose()渲染为Grid中的Label焦点策略默认把焦点放在No按钮上用户按回车或空格是安全选项Yes需要显式操作才能触发——这是防误操作的标准交互设计dismiss(True/False)把结果传回发起方。主应用push_screen时传入的回调check_answer(accepted)据此决定是否调用self.exit()。5. 样式表解析rpcontacts.tcssrpcontacts.tcss 负责全部界面样式全部规则如下QuestionDialog { align: center middle; /* 对话框整体居中 */ } #question-dialog { grid-size: 2; /* 2 列网格 */ grid-gutter: 1 2; /* 行距 1、列距 2 */ grid-rows: 1fr 3; /* 第一行占 1fr第二行占 3 */ padding: 0 1; width: 60; height: 11; border: solid red; /* 红色实线边框 */ background: $surface; /* 使用主题表面色变量 */ } #question { column-span: 2; /* 横跨两列 */ height: 1fr; width: 1fr; content-align: center middle; /* 文本居中 */ } Button { width: 100%; } .contacts-list { width: 3fr; /* 表格占横向空间的 3 份 */ padding: 0 1; border: solid green; /* 绿色边框区分数据区 */ } .buttons-panel { align: center top; padding: 0 1; width: auto; border: solid red; /* 红色边框区分操作区 */ } .separator { height: 1fr; /* 弹性占位撑开按钮间距 */ }样式设计的要点fr弹性单位.contacts-list的width: 3fr让表格占据主要宽度Horizontal容器内其余空间留给按钮面板$surface变量Textual 的主题变量随明暗模式自动适配保证m切换主题时对话框配色正确#question-dialog的grid-rows: 1fr 3第一行放问题文本第二行放两个按钮形成标准的提问 选择对话框比例边框颜色区分区域数据区绿色边框、操作区红色边框、对话框红色边框终端界面上区域边界一目了然。6. Step 3 之后的演进路径理解 Step 3 的价值最好把它放进整个教程的时间线里看阶段新增内容关键源码Step 1–2项目包结构与最小 Textual 应用source_code_step_1Step 3界面骨架DataTable 按钮面板 退出对话框 可安装启动source_code_step_3Step 4ContactsApp接收db参数on_mount时从 SQLite 加载联系人source_code_step_4/rpcontacts/tui.pyStep 5新增InputDialog与action_add实现添加联系人source_code_step_5/rpcontacts/tui.pyStep 6实现action_delete/action_clear_all增删改查齐备source_code_step_6/rpcontacts/tui.py底层的数据层在 Step 3 已经就位本阶段 database.py 使用标准库sqlite3封装了Database类数据库文件默认位于用户主目录下的contacts.dbpathlib.Path().home() / contacts.db提供get_all_contacts()、add_contact()、delete_contact()、clear_all_contacts()等方法——这些方法会在后续步骤与界面动作一一对接。也就是说Step 3 的界面骨架与数据库封装并行就绪只是二者尚未在代码中握手。7. 小结从 Step 3 能带走什么Textual 应用三件套Appcompose()声明界面BINDINGS快捷键映射配合CSS_PATH指向的 TCSS 样式表模态交互模式push_screen(dialog, callback)dismiss(value)的推屏-弹值协作方式可复用于任何需要用户确认的场景退出、删除、清空可发布的项目形态pip install -e .注册rpcontacts命令包内__main__.py作为入口用户只需一条命令即可启动应用分步构建思路界面骨架Step 3→ 数据注入与加载Step 4→ 新增交互Step 5→ 删除/清空交互Step 6每一步都有可运行、可验证的成果。如果你手边有该仓库直接进入 contact-book-python-textual/source_code_step_3 目录按上文第 2、3 节的命令安装并运行按m切换主题、按q体验退出确认对话框即可完整体验 Step 3 的全部成果。赞分享示例工程教程【免费下载链接】materialsBonus materials, exercises, and example projects for our Python tutorials项目地址https://gitcode.com/gh_mirrors/ma/materials点击查看免费下载相关推荐用 Python 与 Textual 构建 RP Contacts 联系人簿 TUI安装运行与界面骨架源码解析用 Python 与 Textual 构建 RP Contacts 联系人簿 TUI安装运行与界面骨架源码解析 本篇技术指南以 contact book py示例工程教程用 Python、Textual 与 SQLite 构建 RP Contacts 终端联系人管理应用用 Python、Textual 与 SQLite 构建 RP Contacts 终端联系人管理应用 本篇技术指南以仓库中 contact book pytho示例工程教程RP Contacts 起步篇用 Python 与 Textual 构建终端通讯录应用source_code_step_1 安装运行与骨架剖析RP Contacts 起步篇用 Python 与 Textual 构建终端通讯录应用source_code_step_1 安装运行与骨架剖析 RP Co示例工程教程上一篇霞鹜臻楷AI赋能的中文加粗楷体解决屏幕阅读难题的字体革新下一篇更新页卡了多年OpenCore Legacy Patcher 让老 Mac 装到 macOS Sequoia免费且可回退创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考