PudimServer Documentation

A Lua library to build simple, lightweight, and customizable HTTP servers, with support for CORS, pipeline handlers, cache, dynamic routes, query parsing, native HTTPS, cooperative concurrency, and hot reload without a file watcher.

Lua 5.4+ LuaSocket lua-cjson loglua luasec (optional)

Installation

luarocks install PudimServer --local

Basic server

local PudimServer = require("PudimServer")

local server = PudimServer:Create{ Port = 8080 }

server:Routes("/", function(req, res)
    return res:response(200, "Hello World!")
end)

server:Run()

Main features

Static and dynamic routing (/users/:id)
Query string parsing into req.query
Handler pipeline with next()
CORS with automatic preflight handling
In-memory cache with TTL
Native HTTPS with luasec
Cooperative concurrency (coroutines)
Hot reload without watcher (package.loaded invalidation)

Getting Started

Set up and run your first server in 5 minutes.

Modules

API docs split by module with quick index.

Examples

Practical scenarios ready to run.