The luahop from armatys

luahop's Introduction

LuaHop - Beautiful Lua event loop.

It runs on *BSD (using kqueue) and Linux (using epoll). By using LuaHop, you can create event handlers for reading/writing on file descriptors. You can also set timeouts and intervals.

Requirements

Premake - used for Makefile generation (premake)
On Linux: kernel 2.6.25 and glibc >= 2.8

Compilation

Use premake to generate appropriate build files. E.g run premake4 gmake to generate a Makefile. Then execute make config=release32 or make config=release64 to compile.

Usage:

File descriptors:

To use LuaHop, you may need also a socket library. Take a look at LuaAnet. Probably, you could also use LuaSocket, but I haven't tested it yet.

require "anet"
require "luahop"

local loop = luahop.new()
local fd, err = anet.tcpserver(8080, "127.0.0.1")
anet.nonblock(fd)

local function readclient(soc)
	while true do
		local n, msg = anet.read(soc, 4096)
		print("Read " .. n .. " bytes")
		
		if n > 0 then
			io.write(msg)
		elseif n < 0 then
			-- print error message
			print(msg)
			break
		elseif n == 0 then
			-- closed connection
			loop:removeListener(soc, "r")
			anet.close(soc)
		end
	end
end

local function handleclient(c, ip, port)
	print("New client: " .. tostring(ip) .. ":" .. tostring(port))
	anet.nonblock(c)
	loop:setListener(c, "r", function()
		readclient(c)
	end)
end

-- adding "read" (accepting connection) callback
loop:setListener(fd, "r", function()
	local cfd, ip, port = anet.accept(fd, true, true)
	handleclient(cfd, ip, port)
end)

while true do
	loop:poll()
end

Timers:

You can create timeouts and intervals.

local timeout = loop:setTimeout({ms:100}, function()
    print("Timeout, called once, after 100 ms.")
end)

local interval = loop:setInterval({s:1}, function()
    print("Interval, called every 1 second.")
end)

-- to clear timeout or interval
clearTimer(timeout)
clearTimer(interval)

luahop's People