🌜 lunetoile ⭐

A web server written in Lua.

There are two goals for this project.

1. Development with http frameworks , which need http server.
2. Packaging of projects using http frameworks, for local use on desktop.

How to

deps needed

1. Obviously, lua. Tested with 5.3 and 5.2 flavors, not with luajit (but should work).
2. luasocket. You can install it with luarocks package manager, or directly from your distribution (or from the sources). Package for Archlinux: lua-socket.
3. LFS. It's LuaFileSystem, used by the file manager. Install it the same way you did for luasocket. Package for Archlinux: lua-filesystem.

It is planned to provide an all-in-one distribution for packaging projects, but for the moment, you have to install yourself tho deps.

launch

Launch lunetoile.lua and it will serve you well (even so, read the alternatives)

built-in

There are some tools availables, for diagnostics or commons use.

You call them via the URL.

name	action	localhost only
/list	prints dir of path arguments	no (but chrooted)
/quit	end the server	yes
/whoami	returns client's header	no

🚧 TODO 🚧

• serving files to clients.
• File manager (upload and download files).
• parallelized clients.
• cookies. 🍪
• config file.
• https._{with localhost, seriously ?!}
• TODO list

Alternatives in Lua

This project is for private use, or at most, not farthest than your LAN.

Use these projects instead, if you plan to serve to the whole internet (you know ☣️ ☢️ …).

name	link
luahttp	https://github.com/daurnimator/lua-http
openresty	http://openresty.org/en/

Don't read this

lunetoile is a pseudo-word made with two french words : lune and étoile.

You can translate it as moonweb (moon ➡️ lua/lune , web ➡️ toile).

But in french, it means also moonstar, with the shared 'e' (lun(e) ➡️ moon , (e)toile ➡️ star).