# grpc_demo_py

**Repository Path**: futurelei/grpc_demo_py

## Basic Information

- **Project Name**: grpc_demo_py
- **Description**: Python gRPC 入门到实战
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gRPC Python 课程体系

gRPC 微服务通信完整学习路径，从入门到实战。

## 课程列表

| 课程 | 名称 | 难度 | 描述 |
|------|------|------|------|
| [01](./courses/course_01_hello_world/README.md) | Hello World | ⭐ | 最小可运行示例，掌握 gRPC 基础 |
| [02](./courses/course_02_complex_data/README.md) | 复杂数据通信 | ⭐⭐ | 大数据量传输，体现 Protobuf 优势 |
| [03](./courses/course_03_timeout/README.md) | 超时处理 | ⭐⭐ | 客户端/服务端超时配置 |
| [04](./courses/course_04_retry/README.md) | 重试机制 | ⭐⭐ | gRPC 内置重试策略 |
| [05](./courses/course_05_reconnection/README.md) | 断线重连 | ⭐⭐⭐ | 自动重连、心跳检测 |
| [06](./courses/course_06_stream/README.md) | 流式传输 | ⭐⭐⭐ | 服务端流、客户端流、双向流 |
| [07](./courses/course_07_auth/README.md) | 认证机制 | ⭐⭐⭐ | SSL/TLS 认证、Token 认证 |

## 学习路径建议

```
入门 → 进阶 → 实战

课程1 → 课程2 → 课程3 → 课程4 → 课程5 → 课程6 → 课程7
  ↓       ↓        ↓       ↓       ↓        ↓       ↓
基础    数据格式   超时     重试    连接保活   流式    安全
```

## 环境要求

- Python 3.8+
- grpcio >= 1.50.0
- grpcio-tools >= 1.50.0

安装：
```bash
pip install grpcio grpcio-tools
```

## 快速开始

每个课程都有独立的文件夹，进入对应课程目录按照 README 操作即可。

```bash
cd courses/course_01_hello_world
```

## 课程简介

### 课程1: Hello World
最基础的 gRPC 示例，包含：
- 简单 proto 定义
- 服务端实现
- 客户端调用

### 课程2: 复杂数据通信
展示 gRPC 在复杂场景下的优势：
- 嵌套消息结构
- 数组、字典、枚举
- 性能测试（QPS、延迟、并发）
- HTTP vs gRPC 对比测试

### 课程3: 超时处理
gRPC 超时机制：
- 客户端超时设置
- 服务端超时检测
- 截止时间传播

### 课程4: 重试机制
gRPC 内置重试：
- 重试策略配置
- 指数退避
- 幂等性保证

### 课程5: 断线重连
连接管理：
- 健康检测
- 自动重连
- 连接状态监听

### 课程6: 流式传输
gRPC 流式特性：
- 服务端流式
- 客户端流式
- 双向流式

### 课程7: 认证机制
安全通信：
- SSL/TLS 加密
- Token 认证
- 拦截器实现