🚀 简单服务器设置
这是一个简单的 Python 项目，它通过两种客户端 - 服务器通信模式，即服务器发送事件 (SSE) 和标准输入输出 (STDIO)，实现了计算器操作。该项目非常适合初学者学习基础的客户端 - 服务器架构以及双模态通信。
🚀 快速开始
安装与使用
先决条件：需要安装 Python 3.7 或更高版本。
安装步骤：
git clone https://github.com/DionBenFernandes-Dev/SimpleServerSetup.git
cd SimpleServerSetup
pip install -r requirements.txt
运行项目：
- 启动服务器：
python server.py
- 使用 STDIO 客户端：
python client-stdio.py
按照提示输入表达式，即可立即接收计算结果。
- 使用 SSE 客户端：
python client-sse.py
此客户端会连接到服务器，并通过 SSE 处理计算。
✨ 主要特性
- 支持两种客户端 - 服务器通信模式，分别是服务器发送事件 (SSE) 和标准输入输出 (STDIO)，实现计算器操作。
- 两种模式使用相同的服务器逻辑，确保计算行为的一致性。
- 适合学习基础的客户端 - 服务器架构和双模态通信。
📦 安装指南
先决条件
需要安装 Python 3.7 或更高版本。
安装步骤
git clone https://github.com/DionBenFernandes-Dev/SimpleServerSetup.git
cd SimpleServerSetup
pip install -r requirements.txt
💻 使用示例
基础用法
SSE 模式
- 服务器 (
server.py) 启动一个用于 SSE 的 HTTP 终端点。 - SSE 客户端 (
client-sse.py) 连接到服务器，发送计算请求，并接收实时事件流结果。适用于需要实时更新的基于网络的应用程序。
STDIO 模式
- 服务器 (
server.py) 也可以处理来自命令行客户端 (client-stdio.py) 的请求。 - 客户端通过标准输入发送表达式，并通过标准输出接收结果。理想用于快速的本地计算，直接从终端输入。
高级用法
由于原文档未提及高级用法相关内容，暂不提供。
📚 详细文档
文件结构
SimpleServerSetup/
├── .gitignore
├── .python-version
├── README.md
├── client-sse.py
├── client-stdio.py
├── pyproject.toml
├── requirements.txt
├── server.py
├── uv.lock
| 属性 | 详情 |
|---|---|
| .gitignore | 指定 Git 忽略的文件和目录。 |
| .python-version | Python 版本管理文件。 |
| README.md | 项目文档。 |
| client-sse.py | 使用服务器发送事件 (SSE) 与服务器通信的 Python 客户端。 |
| client-stdio.py | 使用标准输入输出 (STDIO) 进行命令行交互的 Python 客户端。 |
| pyproject.toml | 项目元数据和构建配置。 |
| requirements.txt | 列出所需的 Python 包。 |
| server.py | 支持 SSE 和 STDIO 模式的主服务器逻辑。 |
| uv.lock | 依赖项锁定文件，用于可重复环境。 |
关键术语
- 服务器发送事件 (SSE)：一种网络技术，允许服务器通过 HTTP 推送实时更新到客户端。
- 标准输入输出 (STDIO)：传统的命令行交互方法，用户通过键盘提供输入，结果在屏幕上显示。
项目如何运行
SimpleServerSetup 允许您以两种模式运行计算器服务：
- SSE 模式：
- 服务器 (
server.py) 启动一个用于 SSE 的 HTTP 终端点。 - SSE 客户端 (
client-sse.py) 连接到服务器，发送计算请求，并接收实时事件流结果。 - 适用于需要实时更新的基于网络的应用程序。
- 服务器 (
- STDIO 模式：
- 服务器 (
server.py) 也可以处理来自命令行客户端 (client-stdio.py) 的请求。 - 客户端通过标准输入发送表达式，并通过标准输出接收结果。
- 理想用于快速的本地计算，直接从终端输入。 两种模式使用相同的服务器逻辑，确保一致的计算行为。
- 服务器 (