KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

in-memory-cache-over-http

★ 48 Open GitHub ↗

⛷️ In-memory key/value cache server over HTTP with no dependencies.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ⛷️ in-memory-cache-over-http

> My blog post: [Cloning Memcached with Go](https://healeycodes.com/go/tutorial/beginners/showdev/2019/10/21/cloning-memcached-with-go.html)

[![](https://github.com/healeycodes/in-memory-cache-over-http/workflows/Go/badge.svg)](https://github.com/healeycodes/in-memory-cache-over-http/actions?query=workflow%3AGo)

An in-memory key/value cache server over HTTP with no dependencies.

Keys and values are strings. Integer math can be applied in some situations (like Memcached does).

The caching method is Least Recently Used (LRU).

### Install

`go get healeycodes/in-memory-cache-over-http`

### Setup

- Set your PORT environmental variable.
- Set APP_ENV to `production` to turn off logging.
- Set SIZE to limit the number of key/value pairs, (0 is default - unlimited).

```bash
# Linux/macOS
export PORT=8000
export APP_ENV=production

# Command Prompt
set PORT=8000
set APP_ENV=production

# PowerShell
$env:PORT = "8000"
$env:APP_ENV = "production"
```

- Run

`go run .\main.go`

- Build

`go build`

### Usage

Adding an expire parameter is always optional. Not setting it, or setting it to zero means that the key will not expire. It uses **Unix time**.

Example usage.

Set `name` to be `Andrew` with an expire time of `01/01/2030 @ 12:00am (UTC)`

GET `localhost:8000/set?key=name&value=Andrew&expire=1893456000` (204 status code)

Retrieve the value located at `name`.

GET `localhost:8000/get?key=name` (200 status code, body: `Andrew`)

### Methods

#### Set (params: key, value, expire) `/set`

Set a key/value. Existing will be overwritten.

#### Get `/get`

Get a value from a key.

#### Delete (params: key) `/delete`

Delete a key.

#### CheckAndSet (params: key, value, expire, compare) `/checkandset`

Set a key/value if the current value at that key matches the compare.