简单服务器设置

一个简单的 Python 项目，演示通过两种客户端-服务器通信模式（服务器发送事件 (SSE) 和 标准输入输出 (STDIO)）实现计算器操作。此项目非常适合学习基础的客户端-服务器架构和双模态通信。

文件结构

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) 的请求。
  • 客户端通过标准输入发送表达式，并通过标准输出接收结果。
  • 理想用于快速的本地计算，直接从终端输入。

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

安装与使用

先决条件：

• 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 处理计算。