Mirror of the Rel4tion website/wiki source, view at <http://rel4tion.org>
Clone
HTTPS:
git clone https://vervis.peers.community/repos/yEzqv
SSH:
git clone USERNAME@vervis.peers.community:yEzqv
Branches
Tags
http-listen.mdwn
Links
- [[News]]
- [[Releases]]
- [[Forum]]
-
[[Tickets]]
[[!toc]]
Introduction
http-listen is a Haskell library for writing web listeners. Such a listener is a program which takes HTTP requests, like a web server, but it’s not limited in the way it can react to them. It can send an HTTP response, but it can also do anything else instead. For example, report the event to an IRC channel.
This library was started because [[fr33domlover]] wanted to write a handler for [[NotABug|https://notabug.org]] web hooks, and possibly some other servers, and existing HTTP server packages assume you want a web server which sends responses. http-listen hopefully fills the gap by providing a web listener which isn’t required to send HTTP responses.
The library does allow sending responses, and an actual web server can be written using it. But in that case you’ll probably want to use [[!hackage warp]] instead, which is probably more optimized and robust and has more features.
Download
Releases are made to Hackage: [[!hackage http-listen]]. The Darcs repository containing the source is here: [[!darcshub fr33domlover/http-listen]].
Documentation
See the Haddock generated pages and the source itself.
Freedom
http-listen is free software, and is committed to software freedom and to freedom in general. It is released to the public domain using the CC0 Public Domain Dedication. See [[/freedom]].
Bugs, Ideas, Tasks and Decisions
- [[tickets]]
- [[decisions]]