An asynchronous programming library for GNU Guile

Jan Nieuwenhuizen ff48f246f6 web server: Treat upgrade requests as case-insensitive. 7 months ago
8sync ff48f246f6 web server: Treat upgrade requests as case-insensitive. 7 months ago
build-aux bac983c63c build: Add `git-to-changelog' and make use of it in `Makefile.am'. 4 years ago
demos 8bdfa5c8f8 actors: Switch over to using wrap-rmeta-slot for build-actions. 2 years ago
doc c344305a29 doc: Fix initial sleeper. 7 months ago
tests cef6072905 rmeta-slot: Rename wrap-rmeta-slot to build-rmeta-slot. 2 years ago
.gitignore 30403f4eb4 build: Add gendocs. 2 years ago
8sync.scm 1dec705a02 Add toplevel 8sync.scm file. 3 years ago
COPYING ab8b595ef6 Rename LICENSE -> COPYING 4 years ago
COPYING-gplv3.txt 302b13a687 Add GPLv3 and a simple README 4 years ago
INSTALL f3705f0b00 Add generic GNU style INSTALL file 3 years ago
Makefile.am 41b32934e3 rmeta-slot: New module for recursive meta-slot access. 2 years ago
NEWS fa598a979d Add NEWS for 8sync 0.4.2 2 years ago
README 74ee41326b README: Mention COPYING 3 years ago
bootstrap.sh 2425363fe0 Adding automake stuff 4 years ago
configure.ac 8cbb7f2222 8sync 0.4.2 2 years ago
env.in 2425363fe0 Adding automake stuff 4 years ago
guix.scm 027301aa7a guix: Bump to guile-2.2 7 months ago
pre-inst-env.in 2425363fe0 Adding automake stuff 4 years ago

README

8sync: an asynchronous programming library for Guile
====================================================

GNU 8sync (pronounced "eight-sync") is an asynchronous programming
library for [GNU Guile](https://www.gnu.org/software/guile/).

Be warned: it is early days for the 8sync project. New contributors
and users are more than welcome, but beware API instability.

Some features:
- An asynchronous event loop! Non-blocking on ports and file access.
- Easy to use! The =8sync= operator lets you write
asynchronous code that looks simple while avoiding callback hell.
This happens through the magic of
[delimited continuations](https://www.gnu.org/software/guile/manual/html_node/Prompts.html).
([Hence the %](https://www.gnu.org/software/guile/manual/html_node/Shift-and-Reset.html#Shift-and-Reset)!)
- Provides building blocks on which you can build other asynchronous
frameworks or paradigms on top of it (some of which will be
included in the future), like:
- an actor model implementation
- the propagator model
- web frameworks
- your very heart's desire!

See INSTALL for install instructions. It's the usual GNU process!


How do I use it?
----------------

For now, read the source ;)

Hey, I ought to get some docs up, right? Soon, I promise!


License
-------

Everything in here is LGPL v3 or later, as published by the Free
Software Foundation (see COPYING), with exceptions below:

- Some autotools related files are under the GPL v3 or later in the
toplevel directory (their headers will say). I guess if you
compile things using them, maybe this project becomes GPL v3 or
later? I don't think so because the build tools themselves aren't
linked, but I can't be sure. If you really care, consider this
whole project GPL v3 or later optionally... anyway a
COPYING-gplv3.txt is included for these reasons.