用途
streamlit-uv-development 面向使用 uv 作为包管理器开发 Streamlit 应用的场景,围绕项目初始化、依赖管理、本地运行、测试和部署,给出一套可参考的开发流程与代码模板,用于加速 Streamlit 应用从搭建到交付的过程。
主要能力
- 项目初始化:使用
uv init创建项目,用uv add streamlit添加依赖,并生成主入口app.py。 - 应用运行:通过
uv run streamlit run app.py启动应用,可附加端口、无头模式等参数。 - 项目结构建议:给出多页面
pages/、components/、utils/、tests/、.streamlit/等目录布局,并建议提交uv.lock。 - 依赖与工具配置:示例
pyproject.toml中包含 streamlit、pandas、plotly 依赖,以及 pytest、pytest-playwright、ruff 等开发依赖和测试、lint 配置。 - 单元测试:演示对不依赖 Streamlit 上下文的业务逻辑与工具函数进行测试。
- 组件与交互测试:使用 Streamlit 内置的
AppTest无头测试应用加载、下拉框、按钮、表单等交互,并可预置session_state。 - 端到端测试:基于 Playwright 启动 Streamlit 服务并进行浏览器级测试,覆盖页面渲染、侧边栏导航、数据输入与结果展示。
- 测试夹具:提供 DataFrame、AppTest 实例及带 session state 的 fixture 示例。
- 开发模式:热重载、多页面应用开发、secrets 管理、session state 管理、缓存(
cache_data/cache_resource)、错误处理、表单批量输入。 - 部署:给出使用 uv 官方镜像的多阶段 Dockerfile 与健康检查配置。
使用方式
按资料中的命令初始化项目并添加依赖,创建 app.py 后用 uv run streamlit run app.py 运行。测试方面,单元测试执行 uv run pytest tests/test_utils.py -v;端到端测试需先运行 uv run playwright install chromium,再执行 uv run pytest tests/e2e/ -v。部署时可参考给出的 Dockerfile 构建镜像并以 8501 端口运行。
适用场景
适合希望以 uv 统一管理 Streamlit 项目依赖、需要在本地开发中引入单元测试与浏览器级端到端测试、或计划用 Docker 部署 Streamlit 应用的开发者。资料还覆盖了 session state、缓存、secrets、错误处理等常见开发模式,可作为日常开发参考。
限制
资料以技能说明和代码示例形式提供,未说明该技能自身的安装方式、版本兼容范围、授权协议或收费信息,这些内容暂未提供。示例中的依赖版本、端口和测试等待时间等需按实际项目调整。