cqueues

Continuation Queues: Embeddable asynchronous networking, threading, and notification framework for Lua on Unix.

$ luarocks install cqueues

cqueues is a type of event loop for Lua, except it's not a classic event loop. It doesn't use callbacks—neither as part of the API nor internally—but instead you communicate with an event controller by the yielding and resumption of Lua coroutines using objects that adhere to a simple interface.

cqueues are also stackable. Each instantiated cqueue is a pollable object which can be polled from another cqueue, or another event loop system entirely. The design is meant to be unintrusive, composable, and embeddable within existing applications—such as Apache or Nginx—or used standalone. It maintains no global state and never blocks your thread of execution.

cqueues includes a sockets library with DNS, buffering, end-of-line translation, SSL/TLS, and descriptor passing support builtin. Domain querying, connection establishment, and SSL negotiation are handled transparently as part of a state machine entered with every I/O operation, so users can read and write immediately upon instantiating the object, as if opening a regular file.

cqueues also includes modules for handling signals, threads, and file change notifications using native kernel facilities—such as signalfd on Linux, or Solaris PORT_SOURCE_FILE for file events—and accessible through easy to use interfaces which abstract the different kernel facilities.

Additional modules include a light-weight user-defined event system using the condition variable pattern, and a comprehensive interface for DNS querying.

Versions

20200726.54-04 years ago27,028 downloads
20200726.53-04 years ago31,729 downloads
20200726.52-04 years ago36,075 downloads
20200726.51-04 years ago646,996 downloads
20200603.53-04 years ago658 downloads
20200603.52-04 years ago365 downloads
20200603.51-04 years ago14,116 downloads
20190813.53-05 years ago3,622 downloads
20190813.52-05 years ago1,843 downloads
20190813.51-05 years ago71,196 downloads
20190731.53-05 years ago266 downloads
20190731.52-05 years ago1,773 downloads
20190731.51-05 years ago3,838 downloads
20171014.53-07 years ago5,495 downloads
20171014.52-07 years ago2,097 downloads
20171014.51-07 years ago61,736 downloads
20161215.53-07 years ago1,474 downloads
20161215.52-07 years ago974 downloads
20161215.51-07 years ago2,984 downloads
20161214.53-07 years ago119 downloads
20161214.52-07 years ago82 downloads
20161214.51-07 years ago293 downloads
20161018.53-08 years ago370 downloads
20161018.52-08 years ago295 downloads
20161018.51-08 years ago1,118 downloads
20160812.53-18 years ago100 downloads
20160812.53-08 years ago(revision: 2)221 downloads
20160812.52-18 years ago90 downloads
20160812.52-08 years ago(revision: 2)282 downloads
20160812.51-18 years ago154 downloads
20160812.51-08 years ago(revision: 2)645 downloads
20160808.53-08 years ago(revision: 2)64 downloads
20160808.52-08 years ago(revision: 2)71 downloads
20160808.51-08 years ago(revision: 2)101 downloads
20160316.53-08 years ago522 downloads
20160316.52-08 years ago505 downloads
20160316.51-08 years ago1,526 downloads
20150907.53-09 years ago353 downloads
20150907.52-09 years ago380 downloads
20150907.51-09 years ago1,172 downloads
20150119.53-19 years ago(revision: 2)55 downloads
20150119.53-09 years ago32 downloads
20150119.52-19 years ago50 downloads
20150119.52-09 years ago258 downloads
20150119.51-19 years ago(revision: 2)112 downloads
20150119.51-09 years ago203 downloads
scm-54dev4 years ago43 downloads
scm-53dev8 years ago(revision: 5)165 downloads
scm-52dev8 years ago(revision: 6)20,019 downloads
scm-51dev8 years ago(revision: 5)141 downloads

Dependencies

lua == 5.4

Dependency for

circle, cqueues-pgsql, daemonparts, diskqueue, hectorm-fork-http, http, l, lacord, lredis, lua-irc, prosody, prosody, quest, redis-client, telegram, themoonlitknot, t-mq-amqp, tulip, wch, web-driver, xcq-subprocess

Labels

Manifests