Astra Trails

Examples, hacks & tricks around Astra - a web server runtime for Lua.

• Middleware: Introducing pattern for middleware.

server:get("/sunny-day", logger(html(sunny_day)))
server:get("/normal-day", chain { logger, html } (normal_day))
server:get("/favourite-day", chain { ctx, logger, insert_datetime, html } (favourite_day))

• Routes grouping: How to register a group of routes in one place

Routes(server) {
    base_middleware = ctx,
    { "GET",         "/",       homepage },
    { "POST",        "/",       add_homepage_info },
    { "GET",         "/hi",     just_hi },
    { "STATIC_FILE", "/main",   "main.lua" },
    { "STATIC_DIR",  "/public", "public" },
    scope "/api" {            
        scope "/v1" {
            { "GET", "/favlangs", favlangs },
        },
        scope "/v2" {
            base_middleware = html,
            { "GET", "/favlangs", favlangs2 },
        },
    },
}

• Hot reload: A way to hot reload your code! Very convenient during development.
• Templating with Lustache: Full overview of Mustache templates in pure Lua
• Runtime utils: Explicit cooperative multitasking
• Other useful code: It is what it is

---

• Quickstart: The Trails project template. The archived template can be downloaded directly from the releases