# Python学习仓库

**Repository Path**: xccgitee/python-learning-repository

## Basic Information

- **Project Name**: Python学习仓库
- **Description**: python工具应用示例仓库：收藏测试相关demo
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-18
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python学习仓库

## 📖 项目介绍

这是一个Python工具应用示例仓库，收集了各种实用的Python项目demo，涵盖了Web服务器、OTA升级、MQTT通信、HTTP服务等多个应用场景。每个项目都是独立的，可以单独运行和学习。

## 🏗️ 项目结构

```
python-learning-repository/
├── 001_OTA/                    # OTA固件升级服务器
│   ├── file.py                # Flask Web服务器
│   ├── templates/             # HTML模板
│   ├── file/                  # 固件文件存储
│   ├── dist/                  # 打包后的可执行文件
│   └── 使用说明.txt           # 使用说明
├── 002_mqttOTA/               # MQTT OTA升级管理系统
│   ├── app.py                 # Flask Web应用
│   ├── models.py              # 数据模型
│   ├── config.py              # 配置管理
│   ├── templates/             # HTML模板
│   ├── static/                # 静态资源
│   └── data/                  # 数据存储
├── 003_httpServer/            # HTTP POST服务器
│   ├── http_server.py         # 主服务器
│   ├── test_client.py         # 测试客户端
│   ├── log_viewer.py          # 日志查看工具
│   ├── logs/                  # 日志文件
│   └── README.md              # 详细文档
└── README.md                  # 项目总览
```

## 🚀 快速开始

### 环境要求

- Python 3.6+
- 各项目具体依赖请查看对应目录下的 `requirements.txt`

### 项目列表

| 项目 | 描述 | 技术栈 | 状态 |
|------|------|--------|------|
| [001_OTA](./001_OTA/) | 固件远程升级Web服务器 | Flask, HTML | ✅ 完成 |
| [002_mqttOTA](./002_mqttOTA/) | MQTT OTA升级管理系统 | Flask, MQTT, WebSocket | ✅ 完成 |
| [003_httpServer](./003_httpServer/) | HTTP POST数据接收服务器 | Python标准库 | ✅ 完成 |

## 📋 项目详情

### 001_OTA - 固件升级服务器
- **功能**: 提供Web界面进行固件文件上传和管理
- **特性**: 支持多种文件格式，版本管理，文件下载
- **部署**: 可打包为exe文件独立运行
- **文档**: [使用说明](./001_OTA/使用说明.txt)

### 002_mqttOTA - MQTT升级管理
- **功能**: 基于MQTT协议的设备升级管理系统
- **特性**: 设备监控、升级管理、用户认证、数据可视化
- **技术**: Flask + MQTT + WebSocket + CSV数据存储
- **文档**: 详见项目目录

### 003_httpServer - HTTP数据服务器
- **功能**: 接收设备HTTP POST请求的服务器
- **特性**: 多格式支持、详细日志、请求追踪、跨域支持
- **技术**: Python标准库，无外部依赖
- **文档**: [详细文档](./003_httpServer/README.md)

## 🛠️ 安装和使用

### 1. 克隆仓库
```bash
git clone <repository-url>
cd python-learning-repository
```

### 2. 选择项目
每个项目都是独立的，可以单独运行：

```bash
# OTA升级服务器
cd 001_OTA
python file.py

# MQTT OTA管理系统
cd 002_mqttOTA
pip install -r requirements.txt
python app.py

# HTTP POST服务器
cd 003_httpServer
python http_server.py
```

### 3. 查看文档
每个项目都有详细的文档说明，请查看对应目录下的README或说明文件。

## 🔧 开发说明

### 项目特点
- **独立性**: 每个项目都是独立的，可以单独运行
- **实用性**: 所有项目都是实际应用场景的demo
- **学习性**: 代码结构清晰，适合学习参考
- **可扩展**: 提供了良好的扩展基础

### 技术栈
- **Web框架**: Flask
- **通信协议**: HTTP, MQTT
- **数据存储**: CSV, JSON, 文件系统
- **前端**: HTML, CSS, JavaScript
- **部署**: PyInstaller打包

## 📚 学习资源

### 相关技术文档
- [Flask官方文档](https://flask.palletsprojects.com/)
- [MQTT协议介绍](https://mqtt.org/)
- [HTTP协议详解](https://developer.mozilla.org/zh-CN/docs/Web/HTTP)
- [Python标准库](https://docs.python.org/zh-cn/3/library/)

### 项目学习路径
1. **入门**: 从003_httpServer开始，了解HTTP服务器基础
2. **进阶**: 学习001_OTA，掌握Web应用开发
3. **高级**: 研究002_mqttOTA，学习复杂系统设计

## 🤝 参与贡献

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 📞 联系方式

如有问题或建议，请通过以下方式联系：
- 提交 Issue
- 发送邮件
- 项目讨论区

---

**版本**: 1.0.0  
**更新日期**: 2025-01-12  
**维护者**: Python学习仓库团队