mino

module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: MIT

README

Mino

Start with one package. Grow at your own pace.
A progressive Go toolkit. Small packages, familiar APIs.

English  ·  简体中文  ·  Documentation  ·  API

Progressive
Start with a utility package. Grow into a service.
Adopt on demand
Use each package independently. Compose them as needed.
Lightweight
A compact implementation. Only the Go standard library at runtime.
Fast
Fast route matching. Low-overhead middleware composition.
Intuitive
Standard HTTP types, familiar contexts, and Go error chains.
Delightful DX
Clean, consistent APIs for binding, validation, and responses.

Quick start

Requires Go 1.23+.

go get github.com/hainuoli/mino/rest
mux := rest.NewMux()

mux.Get("/", func(w http.ResponseWriter, r *http.Request) {
	httpx.OkJSON(w, "Hello, Mino!")
})

http.ListenAndServe(":8080", mux)

Run the complete example → · Explore progressive adoption →

Bring your existing handlers

Replace the http.ServeMux constructor and keep your registrations.

- mux := http.NewServeMux()
+ mux := rest.NewMux()

 mux.HandleFunc("GET /users/{id}", getUser)

Keep your handlers, middleware, and r.PathValue. Enable path cleaning, escaped-path matching, and slash redirects as your existing service requires.

ServeMux migration guide →

Performance

Median ns/op. Lower is better.

Workload Mino Gin Chi go-zero router
Static route 85.5 101.2 220.3 123.4
One path parameter 183.0 127.0 343.5 385.2
Three path parameters 274.5 197.6 499.1 679.2
1,000 static routes 131.3 170.6 355.1 5,328.0
Five middleware layers 254.9 279.1 410.7 304.4
Route + JSON response 178.5 217.9 316.5 219.5

Apple M4 · macOS arm64 · Go 1.25.4 · 2026-11-15. Five 1-second runs, -cpu=1.

Benchmark setup and parameter-route cost

Gin v1.12.0 · Chi v5.5.0 · go-zero v1.10.3.

In-process ServeHTTP benchmarks with identical response work and no default middleware. go-zero uses its standalone router. Network and business logic are excluded.

Mino writes parameters through Request.SetPathValue so handlers can use r.PathValue. For these fresh requests, Go 1.25.4 initializes a parameter map; Gin reuses a pooled parameter slice. This accounts for Mino's additional parameter-storage allocations.

Methodology, allocation analysis, and raw results →

Small footprint

86.6 KiB of source. Zero third-party runtime dependencies.

All six packages total 2,003 production code lines. In a minimal HTTP server, the Mino router adds 88 KiB over the standard-library baseline.

Source and binary measurements
Production source Code lines Size
Core utilities 283 11.7 KiB
Router + middleware composition 1,417 59.8 KiB
HTTP helpers 303 15.2 KiB
All six packages 2,003 86.6 KiB

Code lines exclude comments and blank lines. Source size includes comments and whitespace. Tests, examples, and tools are excluded from both counts.

Minimal HTTP server Binary size
net/http baseline 5.30 MiB
Mino router 5.39 MiB

Go 1.25.4 · linux/amd64 · CGO disabled · -trimpath -ldflags='-s -w'. Both binaries include the Go runtime.

Fixtures and measurement details →

Explore Mino

Getting started · Packages · Guides and examples · API reference

Contributing · Security · MIT License

Directories

Path Synopsis
core

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL