eventcore/README.md

EventCore
=========

This is a high-performance native event loop abstraction for D, focused on asynchronous I/O and GUI message integration. The API is callback (delegate) based. For a higher level fiber based abstraction, take a look at [vibe.d](https://vibed.org/).

[![Build Status](https://travis-ci.org/vibe-d/eventcore.svg?branch=master)](https://travis-ci.org/vibe-d/eventcore)


Supported drivers and operating systems
---------------------------------------

Driver            | Linux   | Windows | macOS   | FreeBSD
------------------|---------|---------|---------|--------
SelectEventDriver | yes     | yes     | yes¹    | yes¹
EpollEventDriver  | yes     | &mdash; | &mdash; | &mdash;
WinAPIEventDriver | &mdash; | yes     | &mdash; | &mdash;
KqueueEventDriver | &mdash; | &mdash; | yes¹    | yes¹

¹ planned, but not currenly implemented


Driver development status
-------------------------

Feature          | SelectEventDriver | EpollEventDriver | WinAPIEventDriver | KqueueEventDriver
-----------------|-------------------|------------------|-------------------|------------------
TCP Sockets      | yes               | yes              | &mdash;           | &mdash;          
UDP Sockets      | yes               | yes              | &mdash;           | &mdash;          
USDS             | yes               | yes              | &mdash;           | &mdash;          
DNS              | yes               | yes              | &mdash;           | &mdash;          
Timers           | yes               | yes              | yes               | &mdash;          
Events           | yes               | yes              | yes               | &mdash;          
Unix Signals     | yes²              | yes²             | &mdash;           | &mdash;          
Files            | yes               | yes              | yes               | &mdash;          
UI Integration   | yes¹              | yes¹             | yes               | &mdash;          
File watcher     | yes²              | yes²             | yes               | &mdash;          

¹ Manually, by adopting the X11 display connection socket
² Currently only supported on Linux


### Open questions

- Error code reporting
- Adopting existing file descriptors (done for files)
- Enqueued writes
- Use the type system to prohibit passing thread-local handles to foreign threads
Add README.md. 2016-01-16 14:47:27 +00:00			`EventCore`
			`=========`

			`This is a high-performance native event loop abstraction for D, focused on asynchronous I/O and GUI message integration. The API is callback (delegate) based. For a higher level fiber based abstraction, take a look at [vibe.d](https://vibed.org/).`

Add build badge to readme. 2016-06-18 05:32:17 +00:00			`[![Build Status](https://travis-ci.org/vibe-d/eventcore.svg?branch=master)](https://travis-ci.org/vibe-d/eventcore)`

Add README.md. 2016-01-16 14:47:27 +00:00
			`Supported drivers and operating systems`
			`---------------------------------------`

Improve table formatting 2017-01-22 08:46:31 +00:00			`Driver \| Linux \| Windows \| macOS \| FreeBSD`
			`------------------\|---------\|---------\|---------\|--------`
			`SelectEventDriver \| yes \| yes \| yes¹ \| yes¹`
			`EpollEventDriver \| yes \| — \| — \| —`
			`WinAPIEventDriver \| — \| yes \| — \| —`
			`KqueueEventDriver \| — \| — \| yes¹ \| yes¹`
Update README.md. 2016-06-24 12:22:08 +00:00
			`¹ planned, but not currenly implemented`
Add README.md. 2016-01-16 14:47:27 +00:00

			`Driver development status`
			`-------------------------`

Fix Windows driver name in README. 2016-10-19 12:29:18 +00:00			`Feature \| SelectEventDriver \| EpollEventDriver \| WinAPIEventDriver \| KqueueEventDriver`
			`-----------------\|-------------------\|------------------\|-------------------\|------------------`
Improve table formatting 2017-01-22 08:46:31 +00:00			`TCP Sockets \| yes \| yes \| — \| —`
			`UDP Sockets \| yes \| yes \| — \| —`
			`USDS \| yes \| yes \| — \| —`
			`DNS \| yes \| yes \| — \| —`
			`Timers \| yes \| yes \| yes \| —`
			`Events \| yes \| yes \| yes \| —`
			`Unix Signals \| yes² \| yes² \| — \| —`
			`Files \| yes \| yes \| yes \| —`
Implement socket adoption and fix wait loops on Windows for the Posix driver. 2017-01-22 09:43:18 +00:00			`UI Integration \| yes¹ \| yes¹ \| yes \| —`
Improve table formatting 2017-01-22 08:46:31 +00:00			`File watcher \| yes² \| yes² \| yes \| —`
Add some remaining TODOs to the README. 2016-10-07 17:40:18 +00:00
Implement socket adoption and fix wait loops on Windows for the Posix driver. 2017-01-22 09:43:18 +00:00			`¹ Manually, by adopting the X11 display connection socket`
Implement listening for signals based on signalfd(). 2016-10-16 19:06:11 +00:00			`² Currently only supported on Linux`

Add getaddrinfo based DNS lookup implementation. 2016-10-16 12:30:52 +00:00
Add another TODO item to the development state. 2017-01-22 10:39:41 +00:00			`### Open questions`
Add some remaining TODOs to the README. 2016-10-07 17:40:18 +00:00
			`- Error code reporting`
Update readme. 2017-01-22 02:09:55 +00:00			`- Adopting existing file descriptors (done for files)`
Add some remaining TODOs to the README. 2016-10-07 17:40:18 +00:00			`- Enqueued writes`
Add another TODO item to the development state. 2017-01-22 10:39:41 +00:00			`- Use the type system to prohibit passing thread-local handles to foreign threads`