#cqueues

This is a project of mine that has been sitting without a release for a long time now. With luapgsql recently getting the last fixes I was waiting for, I figured it's time to do a proper release.

cqueues-pgsql is a library that wraps luapgsql to be non-blocking when in a cqueues managed thread. The API should be the same as luapgsql; if it diverges, file a bug with me :)

Homepage: https://github.com/daurnimator/cqueues-pgsql Available on luarocks: https://luarocks.org/modules/daurnimator/cqueues-pgsql/

Q. What is luapgsql?

A. Bindings to libpq, i.e. a postgresql client. Homepage: https://github.com/arcapos/luapgsql/

Q. What is cqueues?

A. A library for cooperative threading in lua. Homepage: http://25thandclement.com/~william/projects/cqueues.html Github: https://github.com/wahern/cqueues

Q. When do I want to use cqueues-pgsql?

A. When you want to talk to postgres without blocking your entire application/thread.

Q. So I can only use it in a cqueues managed thread/application?

A. No! if used outside of a cqueues managed thread, cqueues-pgsql will appear to operate in a blocking manner. i.e. it will look and behave just like luapgsql.

Q. Show me an example!

A. That's not a question, but okay:

This snippet demonstrates listening for multiple protocol signatures on the one TCP port. I left off concurrency to make it easier to understand.

The TLS path will only work with the newly commited cqueues :starttls pushback, which runs userspace buffered data through the incoming BIO before reading off the socket.