• Optionally asynchronous (including DNS lookups and SSL)
• Supports HTTP version 1.0, 1.1 and 2
• Functionality for both client and server
• Websockets
• Compatible with Lua 5.1, 5.2, 5.3 and LuaJIT

Can be found at https://daurnimator.github.io/lua-http/

• HTTP client API is reaching stability
• The HTTP server API is still changing

It's recommended to install lua-http by using luarocks. This will automatically install run-time lua dependencies for you.

$ luarocks install --server=http://luarocks.org/dev http

• cqueues >= 20150907
• luaossl >= 20150727
• basexx >= 0.2.0
• lpeg_patterns >= 0.2
• fifo

To use gzip compression you need one of:

• lzlib or lua-zlib

If using lua < 5.3 you will need

• compat-5.3 >= 0.3

If using lua 5.1 you will need

• luabitop (comes with LuaJIT) or a backported bit32

• luacheck
• busted
• luacov

• 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
  

Documentation is written in markdown and intended to be consumed by pandoc

• To generate self-contained HTML documentation:

  $ pandoc -t html5 --template=doc/template.html --section-divs --self-contained --toc -c doc/site.css doc/index.md doc/metadata.yaml
  

• To generate a pdf manual:

  $ pandoc -s -t latex -V documentclass=article -V classoption=oneside -V links-as-notes -V geometry=a4paper,includeheadfoot,margin=2.54cm doc/index.md doc/metadata.yaml -o lua-http.pdf