lua-resty-qless-web

Overview

Port of Moz's qless web interface to the Openresty environment.

Dependencies

• lua-resty-qless
• lua-resty-template

Methods

new

syntax: ok, err = Qless_web:new(opts)

opts is a table of options

• client must be an instance of lua-resty-qless
• uri_prefix defaults to /, sets the value prepended to all URIs

run

syntax: ok, err = qless_web:run()

Performs routing based on current uri. Requires a sub-location /__static configure to serve static assets

Config

init_by_lua '
    -- Require here to compile templates
    local Qless_Web = require("resty.qless-web")
';

location /web {

    default_type text/html;
    location /web/__static {
        internal;
        rewrite ^/web/__static(.*) $1 break;
        root /path/to/lua-resty-qless-web/static/;
    }

    content_by_lua '
        -- Connect Qless client
        local resty_qless = require "resty.qless"
        local qless, err = resty_qless.new(
            {
                redis = { host = "127.0.0.1", port = 6379 }
            },
            { database = 1 }
        )
        if not qless then
            return ngx.say("Qless.new(): ", err)
        end

        -- Create and run qless web
        local Qless_Web = require("resty.qless-web")
        local web = Qless_Web:new({ client = qless, uri_prefix = "/web" })

        web:run()
    ';
}