🦫 Fast Time Server

Author: Mihai Criveti A minimal Go service that streams or returns the current UTC time over stdio, HTTP/JSON-RPC, or Server‑Sent Events (SSE).

---

Features

• Three transports: stdio, http (JSON‑RPC 2.0), and sse
• Single static binary (~2 MiB)
• Build-time version & date via main.appVersion, main.buildDate
• Cross-platform builds via make cross
• Dockerfile for lightweight container
• Linting (golangci-lint, staticcheck) and pre-commit support
• Unit tests with HTML coverage & Go benchmarks
• Load testing support using hey

Quick Start

git clone https://github.com/yourorg/fast-time-server.git
cd fast-time-server

# Build & run over stdio
make run

# HTTP JSON‑RPC on port 8080
make run-http

# SSE endpoint on port 8080
make run-sse

Installation

Requires Go 1.23+.

go install github.com/yourorg/fast-time-server@latest

Also available as releases.

CLI Flags

Flag	Default	Description
-transport	stdio	Options: stdio, http, sse, dual
-addr/-listen	0.0.0.0	Bind address for HTTP/SSE
-port	8080	Port for HTTP/SSE/dual
-auth-token	(empty)	Bearer token for SSE authentication

API Reference

HTTP (JSON‑RPC 2.0)

POST /http

Request:

{"jsonrpc":"2.0","method":"Time.Now","id":1}

Response:

{"jsonrpc":"2.0","result":"2025-06-21T12:34:56Z","id":1}

SSE

GET /sse (optional header: Authorization: Bearer <token>)

Outputs UTC timestamps every second:

data: 2025-06-21T12:34:56Z

Load Testing

Install the popular HTTP load tester hey:

brew install hey            # macOS
wget https://hey-release... # Linux prebuilt binary

Run a quick load test:

# 500 requests total, 50 concurrent, HTTP transport
hey -n 500 -c 50 http://localhost:8080/http

Generate detailed CSV output for analysis:

hey -n 1000 -c 100 -o csv http://localhost:8080/http > results.csv

Docker

make docker-build
make docker-run           # HTTP mode

Cross‑Compilation

make cross

Binaries appear under dist/fast-time-server-<os>-<arch>.

Development

Task	Command
Format & tidy	make fmt tidy
Lint & vet	make lint staticcheck vet
Run pre‑commit hooks	make pre-commit

Testing & Benchmarking

make test       # Unit tests (race detection)
make coverage   # HTML coverage report
make bench      # Go benchmarks

License

Apache 2.0