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/).

[![DUB Package](https://img.shields.io/dub/v/eventcore.svg)](https://code.dlang.org/packages/eventcore)
[![Posix Build Status](https://travis-ci.org/vibe-d/eventcore.svg?branch=master)](https://travis-ci.org/vibe-d/eventcore)
[![Windows Build Status](https://ci.appveyor.com/api/projects/status/1a9r8sypyy9fq2j8/branch/master?svg=true)](https://ci.appveyor.com/project/s-ludwig/eventcore)


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

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

¹ planned, but not currenly implemented


Supported compilers
-------------------

The following compilers are tested and supported:

- DMD 2.082.0
- DMD 2.081.2
- DMD 2.080.1
- DMD 2.079.0
- DMD 2.078.3
- DMD 2.077.1
- DMD 2.076.1
- LDC 1.11.0
- LDC 1.10.0
- LDC 1.9.0
- LDC 1.8.0
- LDC 1.7.0
- LDC 1.6.0


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

Feature \ EventDriver | Select | Epoll | WinAPI  | Kqueue  | Libasync
----------------------|--------|-------|---------|---------|----------
TCP Sockets           | yes    | yes   | yes     | yes     | &mdash;
UDP Sockets           | yes    | yes   | yes     | yes     | &mdash;
USDS                  | yes    | yes   | &mdash; | yes     | &mdash;
DNS                   | yes    | yes   | yes     | yes     | &mdash;
Timers                | yes    | yes   | yes     | yes     | &mdash;
Events                | yes    | yes   | yes     | yes     | &mdash;
Unix Signals          | yes²   | yes   | &mdash; | &mdash; | &mdash;
Files                 | yes    | yes   | yes     | yes     | &mdash;
UI Integration        | yes¹   | yes¹  | yes     | yes¹    | &mdash;
File watcher          | yes²   | yes   | yes     | yes²    | &mdash;

¹ Manually, by adopting the X11 display connection socket

² Systems other than Linux use a polling implementation


### Open questions

- Error code reporting
- 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 DUB and AppVeyor badges. 2017-01-23 08:06:28 +00:00			`[![DUB Package](https://img.shields.io/dub/v/eventcore.svg)](https://code.dlang.org/packages/eventcore)`
			`[![Posix Build Status](https://travis-ci.org/vibe-d/eventcore.svg?branch=master)](https://travis-ci.org/vibe-d/eventcore)`
			`[![Windows Build Status](https://ci.appveyor.com/api/projects/status/1a9r8sypyy9fq2j8/branch/master?svg=true)](https://ci.appveyor.com/project/s-ludwig/eventcore)`
Add build badge to readme. 2016-06-18 05:32:17 +00:00
Add README.md. 2016-01-16 14:47:27 +00:00
			`Supported drivers and operating systems`
			`---------------------------------------`

Add more drivers/operating systems to the support matrix. 2017-01-22 10:46:48 +00:00			`Driver \| Linux \| Windows \| macOS \| FreeBSD \| Android \| iOS`
			`---------------------\|---------\|---------\|---------\|---------\|---------\|---------`
Update development status. 2017-01-25 15:14:42 +00:00			`SelectEventDriver \| yes \| yes \| yes \| yes¹ \| — \| —`
Add more drivers/operating systems to the support matrix. 2017-01-22 10:46:48 +00:00			`EpollEventDriver \| yes \| — \| — \| — \| — \| —`
			`WinAPIEventDriver \| — \| yes \| — \| — \| — \| —`
Update development status. 2017-01-25 15:14:42 +00:00			`KqueueEventDriver \| — \| — \| yes \| yes¹ \| — \| —`
Fix some errors in README. 2017-01-22 20:01:13 +00:00			`LibasyncEventDriver \| —¹\| —¹\| —¹\| —¹\| — \| —`
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

Test with LDC 1.1.0 final and add compiler support list to README. 2017-02-01 11:15:58 +00:00			`Supported compilers`
			`-------------------`

			`The following compilers are tested and supported:`

Upgrade compiler support to 2.076.1-2.082.0. 2018-10-02 09:13:11 +00:00			`- DMD 2.082.0`
			`- DMD 2.081.2`
			`- DMD 2.080.1`
Add DMD 2.079.0 support. 2018-03-03 17:40:36 +00:00			`- DMD 2.079.0`
Update compiler support. Drops 2.071.2 and adds 2.078.3. 2018-03-03 17:01:34 +00:00			`- DMD 2.078.3`
Test the latest compiler versions. 2017-12-17 11:09:29 +00:00			`- DMD 2.077.1`
			`- DMD 2.076.1`
Upgrade compiler support to 2.076.1-2.082.0. 2018-10-02 09:13:11 +00:00			`- LDC 1.11.0`
			`- LDC 1.10.0`
			`- LDC 1.9.0`
			`- LDC 1.8.0`
Update compiler support. Drops 2.071.2 and adds 2.078.3. 2018-03-03 17:01:34 +00:00			`- LDC 1.7.0`
Test the latest compiler versions. 2017-12-17 11:09:29 +00:00			`- LDC 1.6.0`
Test with LDC 1.1.0 final and add compiler support list to README. 2017-02-01 11:15:58 +00:00

Add README.md. 2016-01-16 14:47:27 +00:00			`Driver development status`
			`-------------------------`

Reformat the driver status table to be more compact. 2017-11-25 10:54:05 +00:00			`Feature \ EventDriver \| Select \| Epoll \| WinAPI \| Kqueue \| Libasync`
			`----------------------\|--------\|-------\|---------\|---------\|----------`
			`TCP Sockets \| yes \| yes \| yes \| yes \| —`
			`UDP Sockets \| yes \| yes \| yes \| yes \| —`
			`USDS \| yes \| yes \| — \| yes \| —`
			`DNS \| yes \| yes \| yes \| yes \| —`
			`Timers \| yes \| yes \| yes \| yes \| —`
			`Events \| yes \| yes \| yes \| yes \| —`
			`Unix Signals \| yes² \| yes \| — \| — \| —`
			`Files \| yes \| yes \| yes \| yes \| —`
			`UI Integration \| yes¹ \| yes¹ \| yes \| yes¹ \| —`
			`File watcher \| yes² \| yes \| yes \| yes² \| —`
Add more drivers/operating systems to the support matrix. 2017-01-22 10:46:48 +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`
Fix some errors in README. 2017-01-22 20:01:13 +00:00
Update README. 2017-11-20 23:02:33 +00:00			`² Systems other than Linux use a polling implementation`
Implement listening for signals based on signalfd(). 2016-10-16 19:06:11 +00:00
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`
			`- 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`