SimpleServerSetup

SimpleServerSetup

一个简单的 Python 项目，通过两种客户端-服务器通信模式演示计算器运算：服务器发送事件（SSE） 和 标准输入/输出（STDIO）。本项目适合用于了解 Python 中的基本客户端-服务器架构和双模式通信。

---

文件结构

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）：一种 Web 技术，可让服务器通过 HTTP 向客户端推送实时更新。
• 标准输入/输出（STDIO）：传统的终端交互方式，用户通过键盘输入，输出内容则显示在屏幕上。

---

项目运作方式

SimpleServerSetup 支持以两种模式运行计算器服务：

• SSE 模式：

  • 服务器（server.py）会启动一个用于 SSE 的 HTTP 端点。
  • SSE 客户端（client-sse.py）连接到服务器，发送计算请求，并以实时事件流的形式接收结果。
  • 适用于需要实时更新的 Web 应用或联网应用。

• STDIO 模式：

  • 服务器（server.py）也可以处理来自命令行客户端（client-stdio.py）的请求。
  • 客户端通过标准输入发送表达式，并通过标准输出接收结果。
  • 适合直接在终端中进行快速的本地计算。

两种模式使用相同的服务器逻辑，确保计算行为一致。

---

安装与使用

前置条件：

• 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 执行计算。

---