# pyhappy

**Repository Path**: eason0552/pyhappy

## Basic Information

- **Project Name**: pyhappy
- **Description**: Python Web 项目开发脚手架
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-02
- **Last Updated**: 2025-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PyHappy

Python Web 项目开发脚手架

## 技术架构

- 1、FastAPI web开发框架
- 2、SQLAlchemy ORM框架 (MySQL)
- 3、Dynaconf 配置管理
- 4、JWT + Passlib(hash加密)

## 项目目录结构

 <img src="D:\Assets\QQ20250602-214523.png" style="zoom:67%;" /> 

## 依赖库

```py
# Dynaconf 配置管理
pip install dynaconf -i https://mirrors.aliyun.com/pypi/simple/

# SQLAlchemy
pip install sqlalchemy -i https://mirrors.aliyun.com/pypi/simple/
pip install pymysql -i https://mirrors.aliyun.com/pypi/simple/

# FastAPI
pip install fastapi -i https://mirrors.aliyun.com/pypi/simple/
#  ASGI 服务器
pip install uvicorn -i https://mirrors.aliyun.com/pypi/simple/

# Form表单
pip install python-multipart -i https://mirrors.aliyun.com/pypi/simple/

# JWT Python-jose
pip install python-jose[cryptography] -i https://mirrors.aliyun.com/pypi/simple/

# Passlib 哈希加密
pip install passlib --upgrade -i https://mirrors.aliyun.com/pypi/simple/
pip install bcrypt==3.2.0 -i https://mirrors.aliyun.com/pypi/simple/ # 一个已知稳定的版本
```

运行以下命令安装 requirements.txt 中的所有依赖：

```py
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
```

## docs文档说明

运行main.py启动项目之后访问: http://127.0.0.1:8080/docs

<img src="D:\Assets\QQ20250602-215345.png" style="zoom:67%;" /> 

需要Token认证的接口，需要在docs文档中进行如下操作：

例如：

访问：根据用户名查询用户接口时

<img src="D:\Assets\QQ20250602-215651.png" style="zoom:67%;" /> 

点击权限认证的按钮：

<img src="D:\Assets\QQ20250602-215748.png" style="zoom:67%;" /> 

<img src="D:\Assets\QQ20250602-215850.png" style="zoom:67%;" /> 

## 响应模型说明

```py
{
  "code": 200,
  "message": "成功",
  "data": "string"
}
```

![](D:\Assets\QQ20250602-220133.png)