https://github.com/daurnimator/lua-http

HTTP Library for Lua. Supports HTTP(S) 1.0, 1.1 and 2.0; client and server.
https://github.com/daurnimator/lua-http

cqueues http http2 lua network

Last synced: about 14 hours ago
JSON representation

HTTP Library for Lua. Supports HTTP(S) 1.0, 1.1 and 2.0; client and server.

• Host: GitHub
• URL: https://github.com/daurnimator/lua-http
• Owner: daurnimator
• License: mit
• Created: 2015-01-29T02:09:13.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2024-09-08T14:17:59.000Z (5 months ago)
• Last Synced: 2025-01-24T03:29:47.633Z (8 days ago)
• Topics: cqueues, http, http2, lua, network
• Language: Lua
• Homepage: https://daurnimator.github.io/lua-http/
• Size: 1.89 MB
• Stars: 814
• Watchers: 37
• Forks: 82
• Open Issues: 61
• Metadata Files:
  • Readme: README.md
  • Changelog: NEWS
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# HTTP library for Lua.

## Features

  - Optionally asynchronous (including DNS lookups and TLS)

  - Supports HTTP(S) version 1.0, 1.1 and 2

  - Functionality for both client and server

  - Cookie Management

  - Websockets

  - Compatible with Lua 5.1, 5.2, 5.3, 5.4 and [LuaJIT](http://luajit.org/)

## Documentation

Can be found at [https://daurnimator.github.io/lua-http/](https://daurnimator.github.io/lua-http/)

## Status

[![Build Status](https://github.com/daurnimator/lua-http/workflows/ci/badge.svg)](https://github.com/daurnimator/lua-http/actions?query=workflow%3Aci)

[![Coverage Status](https://coveralls.io/repos/daurnimator/lua-http/badge.svg?branch=master&service=github)](https://coveralls.io/github/daurnimator/lua-http?branch=master)

[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/108/badge)](https://bestpractices.coreinfrastructure.org/projects/108)

# Installation

It's recommended to install lua-http by using [luarocks](https://luarocks.org/).

This will automatically install run-time lua dependencies for you.

    $ luarocks install http

## Dependencies

  - [cqueues](http://25thandclement.com/~william/projects/cqueues.html) >= 20161214 (Note: cqueues currently doesn't support Microsoft Windows operating systems)

  - [luaossl](http://25thandclement.com/~william/projects/luaossl.html) >= 20161208

  - [basexx](https://github.com/aiq/basexx/) >= 0.2.0

  - [lpeg](http://www.inf.puc-rio.br/~roberto/lpeg/lpeg.html)

  - [lpeg_patterns](https://github.com/daurnimator/lpeg_patterns) >= 0.5

  - [binaryheap](https://github.com/Tieske/binaryheap.lua) >= 0.3

  - [fifo](https://github.com/daurnimator/fifo.lua)

To use gzip compression you need **one** of:

  - [lzlib](https://github.com/LuaDist/lzlib) or [lua-zlib](https://github.com/brimworks/lua-zlib)

To check cookies against a public suffix list:

  - [lua-psl](https://github.com/daurnimator/lua-psl)

If using lua < 5.3 you will need

  - [compat-5.3](https://github.com/keplerproject/lua-compat-5.3) >= 0.3

If using lua 5.1 you will need

  - [luabitop](http://bitop.luajit.org/) (comes [with LuaJIT](http://luajit.org/extensions.html)) or a [backported bit32](https://luarocks.org/modules/siffiejoe/bit32)

### For running tests

  - [luacheck](https://github.com/mpeterv/luacheck)

  - [busted](http://olivinelabs.com/busted/)

  - [luacov](https://keplerproject.github.io/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](#for-running-tests))

    ```

    $ busted -c

    $ luacov && less luacov.report.out

    ```

  - Install your local copy:

    ```

    $ luarocks make http-scm-0.rockspec

    ```

## Generating documentation

Documentation is written in markdown and intended to be consumed by [pandoc](http://pandoc.org/). See the `doc/` directory for more information.