Violet

Violet is a lightweight, Redis-inspired in-memory key–value store supporting strings, lists, and hashes with optional persistence. Ideal for caching, pub-sub systems, or prototyping distributed workflows.

---

Supported Commands

works in upper and lower cases.

Common

• STATUS: STATUS → returns connection status
• ECHO: ECHO <msg> → <msg>
• FLUSHALL: FLUSHALL → clear all data

Key/Value

• SET: SET <key> <value> → store string
• GET: GET <key> → retrieve string or nil
• KEYS: KEYS * → list all keys
• TYPE: TYPE <key> → string/list/hash/none
• DEL/UNLINK: DEL <key> → delete key
• EXPIRE: EXPIRE <key> <seconds> → set TTL
• RENAME: RENAME <old> <new> → rename key

Lists

• LGET: LGET <key> → all elements
• LLEN: LLEN <key> → length
• LPUSH/RPUSH: LPUSH <key> <v1> [v2 ...] / RPUSH → push multiple
• LPOP/RPOP: LPOP <key> / RPOP <key> → pop one
• LREM: LREM <key> <count> <value> → remove occurrences
• LINDEX: LINDEX <key> <index> → get element
• LSET: LSET <key> <index> <value> → set element

Hashes

• HSET: HSET <key> <field> <value>
• HGET: HGET <key> <field>
• HEXISTS: HEXISTS <key> <field>
• HDEL: HDEL <key> <field>
• HLEN: HLEN <key> → field count
• HKEYS: HKEYS <key> → all fields
• HVALS: HVALS <key> → all values
• HGETALL: HGETALL <key> → field/value pairs
• HMSET: HMSET <key> <f1> <v1> [f2 v2 ...]

---

Build and Run

To get Violet and its client, Red, up and running:

• Full Build (Server and Client): Clone the repo and run:

  ./buildall.sh

• Server-Only Build: If you only need the server:

  ./build.sh

• Launch: Navigate to build/ and run:

  ./violet <port [optional]>
  ./red <port [same as server, drop if none]>

---

Dependencies

• Red: The custom client for Violet.

---

Requirements

To build and run, you need:

• Unix/Unix-like system (Linux/macOS/WSL)
• gcc or clang
• cmake