async_lua_ev.c

/**
 * Create a table for ev.Async that gives access to the constructor for
 * async objects.
 *
 * [-0, +1, ?]
 */
static int luaopen_ev_async(lua_State *L) {
    lua_pop(L, create_async_mt(L));

    lua_createtable(L, 0, 1);

    lua_pushcfunction(L, async_new);
    lua_setfield(L, -2, "new");

    return 1;
}

/**
 * Create the async metatable in the registry.
 *
 * [-0, +1, ?]
 */
static int create_async_mt(lua_State *L) {

    static luaL_Reg fns[] = {
        { "send",          async_send },
        { "stop",          async_stop },
        { "start",         async_start },
        { NULL, NULL }
    };
    luaL_newmetatable(L, ASYNC_MT);
    add_watcher_mt(L);
    luaL_setfuncs(L, fns, 0);

    return 1;
}

/**
 * Create a new async object.  Arguments:
 *   1 - callback function.
 *
 * @see watcher_new()
 *
 * [+1, -0, ?]
 */
static int async_new(lua_State* L) {
    ev_async*  async;

    async = watcher_new(L, sizeof(ev_async), ASYNC_MT);
    ev_async_init(async, &async_cb );
    return 1;
}

/**
 * @see watcher_cb()
 *
 * [+0, -0, m]
 */
static void async_cb(struct ev_loop* loop, ev_async* async, int revents) {
    watcher_cb(loop, async, revents);
}

/**
 * Sends/signals/activates the given "ev_async" watcher, that is, feeds an
 * "EV_ASYNC" event on the watcher into the event loop, and instantly returns.
 *
 * Usage:
 *     async:send(loop)
 *
 * [+0, -0, e]
 */
static int async_send(lua_State *L) {
    ev_async*       async  = check_async(L, 1);
    struct ev_loop* loop   = *check_loop_and_init(L, 2);

    ev_async_send(loop, async);

    return 0;
}

/**
 * Stops the async so it won't be called by the specified event loop.
 *
 * Usage:
 *     async:stop(loop)
 *
 * [+0, -0, e]
 */
static int async_stop(lua_State *L) {
    ev_async*       async  = check_async(L, 1);
    struct ev_loop* loop   = *check_loop_and_init(L, 2);

    loop_stop_watcher(L, 2, 1);
    ev_async_stop(loop, async);

    return 0;
}

/**
 * Starts the async so it won't be called by the specified event loop.
 *
 * Usage:
 *     async:start(loop [, is_daemon])
 *
 * [+0, -0, e]
 */
static int async_start(lua_State *L) {
    ev_async*       async  = check_async(L, 1);
    struct ev_loop* loop   = *check_loop_and_init(L, 2);
    int is_daemon          = lua_toboolean(L, 3);

    ev_async_start(loop, async);
    loop_start_watcher(L, 2, 1, is_daemon);

    return 0;
}