Simpleserversetup

🚀 Simple Server Setup

A simple Python project demonstrating calculator operations through two client-server communication modes: Server-Sent Events (SSE) and Standard Input/Output (STDIO). This project is ideal for learning basic client-server architectures and dual-modal communication.

🚀 Quick Start

✨ Features

• Demonstrates calculator operations using two communication modes: SSE and STDIO.
• Suitable for learning basic client-server architectures.
• Ensures consistent calculation behavior across different modes.

📦 Installation

Prerequisites:

• Python 3.7 or higher

git clone https://github.com/DionBenFernandes-Dev/SimpleServerSetup.git
cd SimpleServerSetup
pip install -r requirements.txt

💻 Usage Examples

Basic Usage

Start the server:

python server.py

Advanced Usage

Use the STDIO client

python client-stdio.py

Follow the prompts to enter expressions and receive results immediately.

Use the SSE client

python client-sse.py

This client will connect to the server and handle calculations via SSE.

📚 Documentation

File Structure

SimpleServerSetup/
├── .gitignore
├── .python-version
├── README.md
├── client-sse.py
├── client-stdio.py
├── pyproject.toml
├── requirements.txt
├── server.py
├── uv.lock

Key Terms

• Server-Sent Events (SSE): A web technology that allows servers to push real-time updates to clients over HTTP.
• Standard Input/Output (STDIO): A traditional command-line interaction method where users provide input via the keyboard, and results are displayed on the screen.

How the Project Runs

SimpleServerSetup allows you to run the calculator service in two modes:

• SSE Mode:

  • The server (server.py) starts an HTTP endpoint for SSE.
  • The SSE client (client-sse.py) connects to the server, sends calculation requests, and receives real-time event stream results.
  • Suitable for web-based applications that require real-time updates.

• STDIO Mode:

  • The server (server.py) can also handle requests from the command-line client (client-stdio.py).
  • The client sends expressions via standard input and receives results via standard output.
  • Ideal for quick local calculations directly from the terminal.

Both modes use the same server logic, ensuring consistent calculation behavior.