lor

A fast and minimalist web framework based on OpenResty.

Account

sumory

Repo

$ opm get sumory/lor

Lor

[!https://travis-ci.org/sumory/lor.svg?branch=master](https://travis-ci.org/sumory/lor) [!GitHub release](https://github.com/sumory/lor/releases/latest) [!license](https://github.com/sumory/lor/blob/master/LICENSE)

<a href="./README_zh.md" style="font-size:13px">中文</a> <a href="./README.md" style="font-size:13px">English</a>

A fast and minimalist web framework based on OpenResty.

    local lor = require("lor.index")
    local app = lor()
    
    app:get("/", function(req, res, next)
        res:send("hello world!")
    end)
    
    app:run()

Examples

Installation

1) shell

    git clone https://github.com/sumory/lor
    cd lor
    make install

LOR_HOME and LORD_BIN are supported by Makefile, so the following command could be used to customize installation:

    make install LOR_HOME=/path/to/lor LORD_BIN=/path/to/lord

2) opm

opm install is supported from v0.2.2.

    opm install sumory/lor

lord cli is not supported with this installation.

3) homebrew

you can use homebrew-lor on Mac OSX.

    $ brew tap syhily/lor
    $ brew install lor

Features

Routing like Sinatra which is a famous Ruby framework
Similar API with Express, good experience for Node.js or Javascript developers
Middleware support
Group router support
Session/Cookie/Views supported and could be redefined with Middleware
Easy to build HTTP APIs, web site, or single page applications

Docs & Community

Website and Documentation.
Github Organization for Official Middleware & Modules.

Quick Start

A quick way to get started with lor is to utilize the executable cli tool lord to generate an scaffold application.

lord is installed with lor framework. it looks like:

    $ lord -h
    lor ${version}, a Lua web framework based on OpenResty.
    
    Usage: lord COMMAND [OPTIONS]
    
    Commands:
     new [name]             Create a new application
     start                  Starts the server
     stop                   Stops the server
     restart                Restart the server
     version                Show version of lor
     help                   Show help tips

Create app:

    $ lord new lor_demo

Start server:

    $ cd lor_demo && lord start

Visit http://localhost:8888.

Tests

Install busted, then run test

    busted spec/*

Homebrew

https://github.com/syhily/homebrew-lor maintained by @syhily

Contributors

License

MIT

Authors

Sumory Wu (@sumory)

License

mit

Dependencies

p0pr0ck5/lua-resty-cookie >= 0.01, bungle/lua-resty-template >= 1.9

Versions

sumory/lor 0.3.3 by sumory

A fast and minimalist web framework based on OpenResty. 2017-08-05 11:28:01
sumory/lor 0.3.2 by sumory

A fast and minimalist web framework based on OpenResty. 2017-07-03 14:14:41
sumory/lor 0.3.1 by sumory

A fast and minimalist web framework based on OpenResty. 2017-04-16 11:35:48
sumory/lor 0.3.0 by sumory

A fast and minimalist web framework based on OpenResty. 2017-02-11 08:20:18
sumory/lor 0.2.6 by sumory

A fast and minimalist web framework based on OpenResty. 2016-11-26 10:42:57
sumory/lor 0.2.4 by sumory

A fast and minimalist web framework based on OpenResty. 2016-11-25 07:18:27
sumory/lor 0.2.2 by sumory

A fast and minimalist web framework based on OpenResty. 2016-10-01 07:52:55
sumory/lor 0.2.1 by sumory

A fast and minimalist web framework based on OpenResty. 2016-10-01 07:43:02
sumory/lor 0.2.0 by sumory

A fast and minimalist web framework based on OpenResty. 2016-10-01 07:12:14