SuperAPI AI 工具集

streamlit-uv-development

编程与开发

查看项目

更新于 11-13 22:07

技能介绍

用途

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、错误处理等常见开发模式,可作为日常开发参考。

限制

资料以技能说明和代码示例形式提供,未说明该技能自身的安装方式、版本兼容范围、授权协议或收费信息,这些内容暂未提供。示例中的依赖版本、端口和测试等待时间等需按实际项目调整。