py-server-demo / README.md
DW111D's picture
更新
d2a62e7
|
Raw History Blame Contribute Delete
2.12 kB
metadata
title: Comment System Demo
emoji: 💬
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit

Web Server Demo

基于 FastAPI 的用户管理 API 示例项目。

项目结构

web-server-demo/
├── main.py              # 应用入口
├── schemas/
│   ├── __init__.py
│   └── user.py          # 用户数据模型
├── routers/
│   ├── __init__.py
│   └── user.py          # CRUD 路由
├── venv/                # 虚拟环境
└── requirements.txt     # 依赖清单

快速开始

1. 创建并激活虚拟环境

python3 -m venv venv
source venv/bin/activate

2. 安装依赖

pip install fastapi uvicorn

3. 启动服务

uvicorn main:app --reload

4. 访问文档

API 接口

用户管理 /users

方法 路径 功能
POST /users/ 创建用户
GET /users/ 获取所有用户
GET /users/{user_id} 获取单个用户
PUT /users/{user_id} 更新用户
DELETE /users/{user_id} 删除用户

请求示例

创建用户

curl -X POST "http://127.0.0.1:8000/users/" \
  -H "Content-Type: application/json" \
  -d '{"username": "test", "email": "test@example.com", "age": 25}'

获取所有用户

curl http://127.0.0.1:8000/users/

获取单个用户

curl http://127.0.0.1:8000/users/1

更新用户

curl -X PUT "http://127.0.0.1:8000/users/1" \
  -H "Content-Type: application/json" \
  -d '{"username": "updated_name"}'

删除用户

curl -X DELETE http://127.0.0.1:8000/users/1

Docker 部署

本地构建运行

# 构建镜像
docker build -t web-server-demo .

# 运行容器
docker run -p 7860:7860 web-server-demo

部署到 Hugging Face Spaces

  1. 创建新的 Hugging Face Space,选择 Docker 类型
  2. 将项目代码推送到 Space 仓库
  3. Hugging Face 会自动构建并部署