Hyperion

A lightweight key-value store HTTP server written in Rust using the Warp web framework.

Features

• Simple HTTP API for key-value operations
• In-memory storage using RwLock<HashMap> for thread-safe access
• Async/await with Tokio runtime

Prerequisites

• Rust 2024 edition

Installation

git clone https://github.com/egegunay/hyperion-rs.git
cd hyperion-rs
cargo build --release

Usage

Running the Server

cargo run

The server starts on http://127.0.0.1:3030.

API Endpoints

Method	Endpoint	Description
GET	/insert/{key}	Insert or increment a key (starts at 1)
GET	/read/{key}	Read the value of a key
GET	/update/{key}/{value}	Update a key to a specific value
GET	/delete/{key}	Delete a key

Examples

# Insert a new key (returns "1")
curl http://127.0.0.1:3030/insert/mykey

# Insert again to increment (returns "2")
curl http://127.0.0.1:3030/insert/mykey

# Read the value
curl http://127.0.0.1:3030/read/mykey

# Update to a specific value
curl http://127.0.0.1:3030/update/mykey/100

# Delete the key
curl http://127.0.0.1:3030/delete/mykey

Testing

cargo test

License

This project is open source.