https://github.com/mah0x211/lua-net-http
http module for lua
https://github.com/mah0x211/lua-net-http
client http lua network server
Last synced: 3 days ago
JSON representation
http module for lua
- Host: GitHub
- URL: https://github.com/mah0x211/lua-net-http
- Owner: mah0x211
- Created: 2017-08-07T02:56:39.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-12-29T01:06:41.000Z (about 1 month ago)
- Last Synced: 2025-12-31T04:32:00.353Z (about 1 month ago)
- Topics: client, http, lua, network, server
- Language: Lua
- Homepage:
- Size: 500 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
lua-net-http
====
[](https://github.com/mah0x211/lua-net-http/actions/workflows/test.yml)
[](https://codecov.io/gh/mah0x211/lua-net-http)
http module for lua.
**NOTE: this module is under heavy development.**
***
## Installation
```
luarocks install net-http
```
## Usage
### Server
```lua
local format = string.format
local server = require('net.http.server')
local responder = require('net.http.responder')
-- create server with SO_REUSEADDR option
local s = server.new('127.0.0.1:8080', {
reuseaddr = true,
})
s:listen()
local conn = s:accept()
local req = conn:read_request()
-- dump request
print('REQUEST ===')
print(format('%s %s HTTP/%.1f', req.method, req.uri, req.version))
for _, k, v in req.header:pairs() do
print(format('%s: %s', k, v))
end
print('')
local content = req.content:read()
print(content)
print('')
-- reply response
local res = responder.new(conn)
res.header:set('content-type', 'text/plain')
res:ok('reply ' .. (content or '') .. '\n')
res:flush()
conn:close()
-- $ lua ./server.lua
-- REQUEST ===
-- GET / HTTP/1.1
-- User-Agent: lua-net-http
-- Content-Length: 11
-- Content-Type: application/octet-stream
-- Host: 127.0.0.1:8080
--
-- foo/bar/baz
```
### Client
```lua
local format = string.format
local fetch = require('net.http.fetch')
-- request to server
local res = fetch('http://127.0.0.1:8080', {
content = 'foo/bar/baz',
})
-- dump response
print('RESPONSE ===')
print(format('HTTP/%.1f %d %s', res.version, res.status, res.reason))
for _, k, v in res.header:pairs() do
print(format('%s: %s', k, v))
end
print('')
print(res.content:read())
print('')
-- $ lua ./client.lua
-- RESPONSE ===
-- HTTP/1.1 200 OK
-- Content-Length: 17
-- Content-Type: application/octet-stream
-- Date: Thu, 02 Jun 2022 23:48:17 GMT
--
-- reply foo/bar/baz
```