HTTP library for Lua.

Features

• Optionally asynchronous (including DNS lookups and SSL)
• Compatible with Lua 5.1, 5.2, 5.3 and LuaJIT

Status

This project is a work in progress and not ready for production use.

Todo

• HTTP 1.1
• HTTP 2
  • HPACK
• Connection pooling
• socket.http compatibility layer
• Prosody net.http compatibility layer
• Handle redirects
• Be able to use a HTTP proxy
• Compression (e.g. gzip)

Installation

Dependencies

• cqueues
• luaossl
• fifo

If using lua < 5.3 you will need

• compat-5.3

If using lua 5.1 you will need

• luabitop (comes with LuaJIT) or a backported bit32

For running tests

• luacheck
• busted
• luacov

Development

Getting started

• Clone the repo:

  $ git clone https://github.com/daurnimator/lua-http.git
  $ cd lua-http
  

• Install dependencies

  $ luarocks install --only-deps http-scm-0.rockspec
  

• Lint the code (check for common programming errors)

  $ luacheck .
  

• Run tests and view coverage report (install tools first)

  $ busted -c
  $ luacov && less luacov.report.out
  

• Install your local copy:

  $ luarocks make http-scm-0.rockspec