97 lines
1.5 KiB
Markdown
97 lines
1.5 KiB
Markdown
# test_good
|
||
|
||
一个基于 Streamlit 的示例应用，展示各种数据可视化和交互功能。
|
||
|
||
## 功能特性
|
||
|
||
- 📊 多种图表类型（matplotlib、plotly）
|
||
- 📁 数据操作和处理
|
||
- 📝 交互式表单
|
||
- 🎨 可定制主题
|
||
- 📱 响应式布局
|
||
|
||
## 技术栈
|
||
|
||
- Python 3.14+
|
||
- Streamlit 1.52.1
|
||
- Matplotlib 3.10.8
|
||
- Plotly 6.5.0
|
||
- Pandas 2.3.3
|
||
- NumPy 2.3.5
|
||
|
||
## 快速开始
|
||
|
||
### 使用 uv（推荐）
|
||
|
||
```bash
|
||
# 安装依赖
|
||
uv sync
|
||
|
||
# 运行应用
|
||
uv run streamlit run app.py
|
||
```
|
||
|
||
### 使用传统方式
|
||
|
||
```bash
|
||
# 创建虚拟环境
|
||
python -m venv .venv
|
||
source .venv/bin/activate # Windows: .venv\Scripts\activate
|
||
|
||
# 安装依赖
|
||
pip install -r requirements.txt
|
||
|
||
# 运行应用
|
||
streamlit run app.py
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
test_good/
|
||
├── app.py # 主应用文件
|
||
├── main.py # 入口文件
|
||
├── pyproject.toml # 项目配置
|
||
├── justfile # 任务自动化
|
||
├── Dockerfile # Docker 配置
|
||
├── .dockerignore # Docker 忽略文件
|
||
└── README.md # 项目文档
|
||
```
|
||
|
||
## 使用 just
|
||
|
||
项目使用 justfile 进行任务管理：
|
||
|
||
```bash
|
||
# 查看所有可用命令
|
||
just --list
|
||
|
||
# 运行应用
|
||
just run
|
||
|
||
# 代码格式化
|
||
just fmt
|
||
|
||
# 代码检查
|
||
just lint
|
||
```
|
||
|
||
## Docker 部署
|
||
|
||
```bash
|
||
# 构建镜像
|
||
docker build -t test-good .
|
||
|
||
# 运行容器
|
||
docker run -p 8501:8501 test-good
|
||
```
|
||
|
||
## 开发指南
|
||
|
||
1. 代码风格遵循 PEP 8
|
||
2. 使用 ruff 进行代码格式化
|
||
3. 提交信息遵循 Conventional Commits 规范
|
||
|
||
## 许可证
|
||
|
||
MIT License |