Bindings to the libuv library for asynchronous IO. Not yet ready for much of anything, still a working prototype. Kept in sync with the latest Janet from master, and is not guaranteed to work with anything but.
[sudo] jpm install https://github.com/janet-lang/juv.git
Make sure you have cloned the libuv submodule as well. You can use git submodule update --init --recursive to do this.
jpm build
See the test directory for test scripts and programs.
jpm test
juv puts a thin abstraction over libuv to be completely fiber based instead of
callback based. This means all libuv calls that would normally take a callback
instead take a fiber, either explicitly or by capturing the current fiber. When
the asynchronous event happens and the C callback is called, the fiber is resumed
with the event's payload.
To suspend a fiber until some next event, call a juv function that
captures the current fiber, and then yield to the main event loop. When the
event fires, the fiber will be resumed with the resulting payload
(much of the file API will work like this.) Such functions
must be called inside this event loop.
Using Janet's multiple signal types, we could designate a user signal, such
as :user9, for all libuv related scheduling. This would make it very unlikely
for juv to interfere with other uses of yield in the program not related
to scheduling. For now, we use yield for convenience and easy of prototyping.